feat(directives): harvest 8 directives from feature_flags/RAG/cache/knowledge styleguides + 4 new styleguides

This commit is contained in:
ed
2026-07-02 22:17:20 -04:00
parent 09d6a9c7c8
commit cdc0f1405c
8 changed files with 436 additions and 0 deletions
@@ -0,0 +1,39 @@
# knowledge_harvest_pattern — v1
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/knowledge_artifacts.md` §"0. The one-glance directory layout" (lines 9-26) + §1 (lines 28-44). This is the baseline encoding — the directory-tree-plus-rationale style currently in production.
Future variants will test alternative encodings (rule-only, table-only) against this baseline.
**Source:** `conductor/code_styleguides/knowledge_artifacts.md:9-44`
---
## 0. The one-glance directory layout
```
~/.manual_slop/knowledge/
├── facts.md # - {statement} {provenance}
├── decisions.md # - {statement, reason} {provenance}
├── questions.md # - {question} {provenance}
├── playbooks.md # - **{name}**: {steps} {provenance}
├── tasks.md # ## Open / ## Done
├── files/
│ └── {file_id}.md # per-file notes (keyed by inode)
├── digest.md # bounded 4KB; the projection; "delete to turn off"
├── ledger.json # sha256-of-content audit log
└── prompts/
└── harvest-conversation.md # user-editable harvest prompt
```
## 1. The category files (the source of truth)
### 1.1 `facts.md` (durable statements)
```markdown
# Facts
- The MCP dispatch uses a flat if/elif chain. 4 places, 45 tools. [from: 2026-05-12-investigate-dispatch, 2026-05-12]
- ai_client.py has 5 separate per-provider history lists, each with their own lock. Switching providers mid-session loses history. [from: 2026-05-13-state-mutation-matrix, 2026-05-13]
- RAG is opt-in. Default-off in new projects. [from: 2026-06-12-rag-discipline, 2026-06-12]
```
**The shape:** `- {statement} {provenance}`. Plain markdown. Append-only. User-editable.