$npx -y skills add kv0906/pm-kit --skill decideLog a decision with context, alternatives considered, and rationale. Use for "/decide project: using websocket over polling" or "/decide project: chose React for frontend".
| 1 | # /decide — Decision Logging |
| 2 | |
| 3 | Record decisions with context and alternatives. |
| 4 | |
| 5 | ## Context |
| 6 | |
| 7 | Today's date: `!date +%Y-%m-%d` |
| 8 | Recent decisions: `!ls decisions/*/*.md 2>/dev/null | tail -10` |
| 9 | |
| 10 | Reference template: @_templates/decision.md |
| 11 | Config: @_core/config.yaml |
| 12 | Processing logic: @_core/PROCESSING.md |
| 13 | |
| 14 | ## Input |
| 15 | |
| 16 | User input: $ARGUMENTS |
| 17 | |
| 18 | ## Processing Steps |
| 19 | |
| 20 | 1. **Parse Input** |
| 21 | - Extract project (before colon) |
| 22 | - Extract decision statement |
| 23 | - Look for alternatives: "over", "instead of", "vs", "considered" |
| 24 | - Extract context if provided |
| 25 | |
| 26 | 2. **Create Decision Note** |
| 27 | - Filename: `decisions/{project}/{date}-{slug}.md` |
| 28 | - Apply template with: |
| 29 | - Decision statement |
| 30 | - Alternatives considered |
| 31 | - Context/rationale |
| 32 | - Add `## Links` section |
| 33 | |
| 34 | 3. **Auto-Link** |
| 35 | - Search for related docs in `docs/{project}/` |
| 36 | - Add backlinks to relevant docs |
| 37 | |
| 38 | 4. **Update References** |
| 39 | - Add to project index if exists |
| 40 | |
| 41 | 5. **Append to Vault Log** |
| 42 | - Append entry to `01-index/_vault-log.md` (see `.claude/rules/vault-log.md`) |
| 43 | - Action: `decision` |
| 44 | - Details: the decision statement in ~10 words |
| 45 | |
| 46 | ## Output |
| 47 | |
| 48 | ``` |
| 49 | Created: decisions/{project}/{date}-{slug}.md |
| 50 | Decision: {decision} |
| 51 | Alternatives: {count} considered |
| 52 | ``` |