Private
Public Access
feat(directives): harvest 8 directives from feature_flags/RAG/cache/knowledge styleguides + 4 new styleguides
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user