Use to permanently record a project decision, convention, pattern, or known issue into the knowledge base (docs/) — triggers on explicit save intent ("remember this", "save this", "document this"), decision or convention announcements ("we decided", "settled on", "the rule is"), or triage output classifying new items to capture. Distinct from conversational memory — this writes to docs/.
Capture knowledge from conversation context into docs/ as markdown nodes. Save immediately — asking confirmation interrupts flow and discourages capture.
Precondition: if triage has not run this session, run /autology:triage-knowledge first.
Capture the items triage classified as new (→ capture):
When NOT to capture:
| Type | Signals |
|---|
| decision | "chose", "decided", "selected", "adopted" |
| component | "created", "built", "implemented", new service/module |
| convention | "always", "never", "must", "should", "the rule is" |
| concept | lifecycle, workflow, domain model, process |
| pattern | reusable approach, strategy, pattern |
| issue | bug, technical debt, bottleneck, known problem |
| session | work session summary, "finished", "completed" |
type = primary classification (what kind?); tags = cross-cutting topics (what about?).
Use triage's new items list as the capture scope:
New items from triage (→ capture):
- [item description] — no matching node
Suggested relations: [[foo]], [[bar]] (shared tags: architecture)
- [item description] — no matching node
Suggested relations: none
Not every triage item needs its own file. Before creating, ask: does this item have enough standalone substance to be useful on its own, or is it a detail of something larger?
type: decision node, not a footnote in the component doc.The deciding criterion is not length but kind: a choice made with rationale → own node; a behavioral detail of an implementation → fold. When folding, capture the detail in the parent node's body. This keeps the graph navigable — thin stub nodes add noise without adding reach.
For each new item that warrants its own node, create docs/{title-slug}.md:
---