- After completing work, BEFORE PR creation (reflect mode)
- When recovering from context loss (recovery priming)
Knowledge Categories
| Category | File | Content | |----------|------|---------| | Critical Rules | facts.jsonl | MUST FOLLOW constraints | | Gotchas | gotchas.jsonl | Common pitfalls | | Patterns | patterns.jsonl | Codebase best practices | | Decisions | decisions.jsonl | Architectural choices with rationale | | Anti-Patterns | anti-patterns.jsonl | What NOT to do | | Codebase Facts | codebase-facts.jsonl | Structural information | | API Behaviors | api-behaviors.jsonl | Undocumented quirks |
Process
Prime Mode
- Load knowledge base files for work type
- Surface MUST FOLLOW rules first
- Present GOTCHAS and PATTERNS
- Load relevant DECISIONS
Reflect Mode
- Extract patterns from completed work
- Identify gotchas from review failures
- Record architectural decisions with rationale
- Persist to .beads/knowledge/
Tool Use
Invoke via babysitter process: methodologies/metaswarm/metaswarm-knowledge-cycle