Maintain a decisions/ directory where each decision is a standalone markdown file with YAML frontmatter. An index.md manifest is regenerated on every invocation for fast scanning.
| domain | Product, Data Engineering, Design, Architecture, Operations, Strategy | | status | Active, Proposed, Superseded, Revisited, Deprecated | | method | analysis, discussion, constraint, default, research, prototype, stakeholder-input |
Also capture: decision statement, options considered (with pros/cons), rationale, expected outcome, related DEC-XXXX IDs, 2-5 lowercase tags, and context (summary, conversation highlights, actions performed, artifacts).
Capture project decisions into a per-file system in a decisions/ directory. Each decision is a markdown file with YAML frontmatter (queryable metadata) and full context (rationale, options, conversation highlights, artifacts). An auto-generated _index.md provides fast scanning. Use when: (1) User invokes /DL or /DecisionLog, (2) User says 'log this decision', 'capture this decision', 'record decision', 'update the decision log', (3) User asks 'what decisions have we made', or (4) User asks for context on a past decision. Source: bjg4/decision-log-skill.