@codewizard-dt/bootstrap 2.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/build.yml +88 -0
- package/.github/workflows/security.yml +24 -0
- package/.gitleaks.toml +15 -0
- package/README.md +472 -0
- package/bin/cli.js +47 -0
- package/lib/README.md +27 -0
- package/lib/hooks/README.md +316 -0
- package/lib/hooks/env-file-guard.js +45 -0
- package/lib/hooks/git-protected-ops-block.js +77 -0
- package/lib/hooks/lib/serena-languages.js +158 -0
- package/lib/hooks/lib/serena.js +787 -0
- package/lib/hooks/mv-absolute-path-block.js +53 -0
- package/lib/hooks/serena-bash-grep-block.js +501 -0
- package/lib/hooks/serena-edit-guard.js +74 -0
- package/lib/hooks/serena-first-glob-guard.js +94 -0
- package/lib/hooks/serena-first-guard.js +74 -0
- package/lib/hooks/serena-first-read-guard.js +167 -0
- package/lib/hooks/serena-pre-delegation.js +117 -0
- package/lib/hooks/serena-session-reset.js +45 -0
- package/lib/hooks/serena-usage-tracker.js +186 -0
- package/lib/hooks/serena-write-guard.js +58 -0
- package/lib/prompts/README.md +16 -0
- package/lib/prompts/migrate-wiki.md +111 -0
- package/lib/prompts/setup-deployment.md +322 -0
- package/lib/prompts/setup-design-system.md +162 -0
- package/lib/prompts/setup-strict-typechecks.md +139 -0
- package/lib/scripts/README.md +49 -0
- package/lib/scripts/bootstrap-serena.sh +145 -0
- package/lib/scripts/build-mcp-guide.sh +108 -0
- package/lib/scripts/install-global.sh +78 -0
- package/lib/scripts/install-mcps.sh +131 -0
- package/lib/scripts/lib.sh +154 -0
- package/lib/scripts/merge-gitignore.sh +65 -0
- package/lib/scripts/migrate-project.sh +273 -0
- package/lib/scripts/setup-deployment.sh +104 -0
- package/lib/scripts/setup-project.sh +55 -0
- package/lib/scripts/setup-runner.sh +99 -0
- package/lib/scripts/setup-strict-typechecks.sh +29 -0
- package/lib/scripts/startup.sh +42 -0
- package/lib/scripts/sync-wiki-scaffold.sh +104 -0
- package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
- package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
- package/lib/scripts/templates/gitignore +136 -0
- package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
- package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
- package/lib/scripts/templates/guides/stubs/context7.md +26 -0
- package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
- package/lib/scripts/templates/guides/stubs/serena.md +219 -0
- package/lib/scripts/templates/wiki/conventions.md +100 -0
- package/lib/scripts/templates/wiki/dashboard.html +1733 -0
- package/lib/scripts/templates/wiki/hot.md +21 -0
- package/lib/scripts/templates/wiki/index.md +46 -0
- package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/log.md +14 -0
- package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
- package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
- package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
- package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
- package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
- package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
- package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
- package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
- package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
- package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
- package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
- package/lib/scripts/update-project.sh +75 -0
- package/lib/scripts/wiki-dashboard-server.js +146 -0
- package/lib/skills/README.md +146 -0
- package/lib/skills/anti-slop/SKILL.md +183 -0
- package/lib/skills/bug-close/SKILL.md +136 -0
- package/lib/skills/bug-file/SKILL.md +114 -0
- package/lib/skills/bug-triage/SKILL.md +140 -0
- package/lib/skills/company-align/SKILL.md +203 -0
- package/lib/skills/debug-logs/SKILL.md +129 -0
- package/lib/skills/decision-create/SKILL.md +220 -0
- package/lib/skills/decision-finalize/SKILL.md +181 -0
- package/lib/skills/decision-next/SKILL.md +129 -0
- package/lib/skills/decision-walkthrough/SKILL.md +169 -0
- package/lib/skills/demo/SKILL.md +183 -0
- package/lib/skills/elevator-pitch/SKILL.md +125 -0
- package/lib/skills/eval-create/SKILL.md +344 -0
- package/lib/skills/eval-gap/SKILL.md +150 -0
- package/lib/skills/eval-run/SKILL.md +214 -0
- package/lib/skills/extract-feature/SKILL.md +344 -0
- package/lib/skills/flashcard/SKILL.md +513 -0
- package/lib/skills/frontend-taste/SKILL.md +184 -0
- package/lib/skills/gap-assess/SKILL.md +97 -0
- package/lib/skills/git-commit/SKILL.md +164 -0
- package/lib/skills/lint/SKILL.md +99 -0
- package/lib/skills/marp-slideshow/SKILL.md +212 -0
- package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
- package/lib/skills/now/SKILL.md +36 -0
- package/lib/skills/port-feature/SKILL.md +315 -0
- package/lib/skills/power-mode/SKILL.md +184 -0
- package/lib/skills/primer/SKILL.md +84 -0
- package/lib/skills/project-readme/SKILL.md +166 -0
- package/lib/skills/req-compile/SKILL.md +131 -0
- package/lib/skills/req-create/SKILL.md +124 -0
- package/lib/skills/req-extract-decisions/SKILL.md +241 -0
- package/lib/skills/req-finalize/SKILL.md +251 -0
- package/lib/skills/req-retire/SKILL.md +185 -0
- package/lib/skills/req-update/SKILL.md +265 -0
- package/lib/skills/research/SKILL.md +250 -0
- package/lib/skills/research-company/SKILL.md +345 -0
- package/lib/skills/roadmap-add/SKILL.md +238 -0
- package/lib/skills/roadmap-create/SKILL.md +223 -0
- package/lib/skills/roadmap-next/SKILL.md +132 -0
- package/lib/skills/security-audit/SKILL.md +246 -0
- package/lib/skills/serena-config/SKILL.md +92 -0
- package/lib/skills/simplify/SKILL.md +227 -0
- package/lib/skills/tackle/SKILL.md +156 -0
- package/lib/skills/task-add/SKILL.md +208 -0
- package/lib/skills/task-audit/SKILL.md +294 -0
- package/lib/skills/task-trash/SKILL.md +115 -0
- package/lib/skills/task-update/SKILL.md +136 -0
- package/lib/skills/uat-auto/SKILL.md +69 -0
- package/lib/skills/uat-auto-plus/SKILL.md +115 -0
- package/lib/skills/uat-generate/SKILL.md +289 -0
- package/lib/skills/uat-skip/SKILL.md +169 -0
- package/lib/skills/uat-walk/SKILL.md +164 -0
- package/lib/skills/uat-walk/UAT-CORE.md +140 -0
- package/lib/skills/update-docs/SKILL.md +75 -0
- package/lib/skills/wiki-archive/SKILL.md +96 -0
- package/lib/skills/wiki-ingest/SKILL.md +139 -0
- package/lib/skills/wiki-lint/SKILL.md +131 -0
- package/lib/skills/wiki-query/SKILL.md +71 -0
- package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
- package/lib/skills/wiki-tidy/SKILL.md +107 -0
- package/package.json +32 -0
- package/raw/.gitkeep +0 -0
- package/raw/design-principles.md +65 -0
- package/raw/guides/command-anti-patterns.md +79 -0
- package/raw/guides/deployment-strategy.md +448 -0
- package/raw/guides/evals-framework.md +452 -0
- package/raw/guides/mcp-tools.md +335 -0
- package/raw/guides/task-spec.md +79 -0
- package/raw/guides/type-checking-templates/README.md +112 -0
- package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
- package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
- package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
- package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
- package/raw/harness-notes.md +20 -0
- package/raw/house-style/components/Badge.tsx +16 -0
- package/raw/house-style/components/Button.tsx +32 -0
- package/raw/house-style/components/Card.tsx +26 -0
- package/raw/house-style/components/Chip.tsx +57 -0
- package/raw/house-style/components/IconButton.tsx +67 -0
- package/raw/house-style/components/Modal.tsx +18 -0
- package/raw/house-style/components/Stepper.tsx +141 -0
- package/raw/house-style/components/icons.tsx +128 -0
- package/raw/house-style/preview/src/index.css +46 -0
- package/raw/house-style/tokens/tailwind.preset.ts +49 -0
- package/raw/house-style/tokens/tokens.json +62 -0
- package/raw/llm-wiki-2.md +162 -0
- package/raw/llm-wiki.md +75 -0
- package/raw/research/dark-mode-theme/index.md +85 -0
- package/raw/research/dark-mode-theme/sources.md +49 -0
- package/raw/research/serena-mcp-disconnect/index.md +81 -0
- package/raw/research/serena-mcp-disconnect/sources.md +87 -0
- package/raw/research/wiki-tooling-improvements/index.md +126 -0
- package/raw/research/wiki-tooling-improvements/sources.md +73 -0
- package/raw/software-factory-case-study.pdf +0 -0
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: decision-create
|
|
3
|
+
description: Create a Decision Group file in wiki/work/decisions/ with one or more proposed decisions, table-only comparisons, and mermaid flowcharts
|
|
4
|
+
category: planning
|
|
5
|
+
model: claude-opus-4-8
|
|
6
|
+
effort: high
|
|
7
|
+
argument-hint: <decision topic, group title, or "group: <title>" for an explicit multi-decision file>
|
|
8
|
+
disable-model-invocation: false
|
|
9
|
+
user-invocable: true
|
|
10
|
+
---
|
|
11
|
+
**Prereqs:** obey `.docs/guides/mcp-tools.md`; run /primer if not done this session.
|
|
12
|
+
**Run `/research <topic>` on the decision topic BEFORE drafting any decision block. Do not skip.**
|
|
13
|
+
**Read `wiki/work/decisions/lifecycle.md` first** — it defines the Decision Group model, supersession rule, relationship graph, and index format this command must respect.
|
|
14
|
+
|
|
15
|
+
# Create Decision
|
|
16
|
+
|
|
17
|
+
Create a **Decision Record** file — a **Decision Group** of one or more architecturally significant decisions sharing context, documented together. Each decision tracks its own `Status`, `Date`, `Deciders`, `Tags`, and supersession independently.
|
|
18
|
+
|
|
19
|
+
Format: a hybrid of [Nygard 2011](https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions) + [MADR 4.0](https://adr.github.io/madr/), extended with this project's per-decision status model. **Append-only history:** when a later decision overrides an earlier one, write a **new** decision (new file, or a new `D*` block in a related file) that supersedes the old — never rewrite the past.
|
|
20
|
+
|
|
21
|
+
**Topic**: $ARGUMENTS
|
|
22
|
+
|
|
23
|
+
## When to write
|
|
24
|
+
|
|
25
|
+
See the lifecycle doc's "When to Write" / "When NOT to Write" tables. In short: write when at least one decision affects structure, NFRs, dependencies, interfaces, or construction techniques **and** is hard to reverse. Skip bug fixes, refactors, naming, trivially reversible choices. If it doesn't clear the bar, stop and tell the user — don't pad the log.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Step 1: Parse topic, recall context
|
|
30
|
+
1. Extract the core topic from `$ARGUMENTS`; too vague ("auth") → `AskUserQuestion` to narrow.
|
|
31
|
+
2. Decide single vs group (Step 1.5).
|
|
32
|
+
3. Recall Serena memories that may inform any decision: `list_memories` (filter by topic), `read_memory` for architecture/gotcha/integration memories touching the topic.
|
|
33
|
+
4. Read `CLAUDE.md`, `PROJECT_STATUS.md` (if present), `wiki/work/decisions/lifecycle.md`, and a sample of recent decisions for local conventions.
|
|
34
|
+
|
|
35
|
+
## Step 1.5: Single vs Decision Group triage
|
|
36
|
+
Use the lifecycle doc's "When to Group vs Split":
|
|
37
|
+
|
|
38
|
+
| Signal | Group | Split (write one now, `/decision-create` again later) |
|
|
39
|
+
|--------|-------|-------|
|
|
40
|
+
| Shared context, drivers, deciders | ✅ | — |
|
|
41
|
+
| Tightly coupled (one constrains the next) | ✅ | — |
|
|
42
|
+
| Different areas with little overlap | — | ✅ |
|
|
43
|
+
| Different audiences / timelines | — | ✅ |
|
|
44
|
+
| One much larger than the others | — | ✅ |
|
|
45
|
+
|
|
46
|
+
Default to **single-decision** unless `$ARGUMENTS` starts with `group:` or the user lists multiple. When in doubt, ask with the table visible. If grouping, request a list (one short title each, 2-6).
|
|
47
|
+
|
|
48
|
+
## Step 2: Locate directory, assign number
|
|
49
|
+
1. Find/create `wiki/work/decisions/`. If creating, add a `lifecycle.md` index and confirm via `AskUserQuestion` first.
|
|
50
|
+
2. Read `lifecycle.md` for the current chain, area conventions, graph.
|
|
51
|
+
3. Next file number: `list_dir` on `wiki/work/decisions/` **and** `wiki/work/decisions/archive/` (skip either that doesn't exist) — highest 4-digit prefix across both + 1 (first is `0001`). Never re-use a number; archived/superseded decisions keep theirs forever.
|
|
52
|
+
4. Derive the file slug — names the **group**, lowercase dash-separated ≤60 chars (single: `DEC-0007-session-storage-strategy.md`; group: `DEC-0007-session-management.md`).
|
|
53
|
+
|
|
54
|
+
## Step 2.5: Detect existing decision area (per-decision supersession check, mandatory)
|
|
55
|
+
Prevents two parallel `accepted` decisions in one area (breaks the chain). Per planned decision:
|
|
56
|
+
1. `list_dir` + `Read` every existing decision file (exclude `lifecycle.md`).
|
|
57
|
+
2. For each existing `accepted` block, score: **Tier 1** ≥1 shared tag · **Tier 2** decision-title noun overlap · **Tier 3** file-slug stem overlap (only when both single-decision files).
|
|
58
|
+
3. Build a candidate table per planned decision (Planned Decision, Existing Decision, Overlap Tier, Likely Same Area?).
|
|
59
|
+
4. Any `Yes`/`Maybe` → surface in Step 4 and offer to set `Supersedes`; else the block enters a fresh area.
|
|
60
|
+
|
|
61
|
+
## Step 3: Research each decision
|
|
62
|
+
**Invoke `/research <topic>` for each decision** — call the skill directly, not ad-hoc searches. Don't proceed to Step 4 until research for every planned decision is done. Each must produce:
|
|
63
|
+
|
|
64
|
+
| Section (per decision) | Research must produce |
|
|
65
|
+
|------------------------|----------------------|
|
|
66
|
+
| Context | code state for *this decision*; constraints from prior decisions; business/compliance forces |
|
|
67
|
+
| Decision Drivers | concrete forces: perf budgets, team skill, security, ecosystem fit, deadline |
|
|
68
|
+
| Considered Options | ≥2 viable options (Context7 for lib/framework docs; Brave 1/sec sequential for ecosystem patterns) |
|
|
69
|
+
| Pros & Cons | symmetric per option |
|
|
70
|
+
| Consequences | real follow-on: new deps, migration cost, what gets harder/easier |
|
|
71
|
+
| Validation | measurable signal + threshold + timeframe (E-C-A-D-R "R") |
|
|
72
|
+
|
|
73
|
+
Group members may share evidence sources (Shared Context), but each block needs its own drivers/options/consequences. If a block lacks evidence for an option/driver, **drop it** rather than fabricate; note the gap in Step 9.
|
|
74
|
+
|
|
75
|
+
## Step 4: Clarify with the user (mandatory)
|
|
76
|
+
`AskUserQuestion`, **per decision**, at minimum: (1) **Status** — strongly prefer `proposed` (default); may differ per block. (2) **Recommended option** — present research-backed rec with the comparison table; user confirms/overrides. (3) **Deciders** — owner of *this* decision (may differ per block; default git user). (4) **Tags (mandatory, non-empty)** — 1-3 short tags identifying this block's area (required for supersession detection). (5) **Supersedes** — if Step 2.5 surfaced candidates, ask which (if any): `DEC-NNNN#DM`, `none`, or "decide at finalize time".
|
|
77
|
+
|
|
78
|
+
**Refuse to write the file if any block has empty `Tags`.** For groups, batch all decisions' questions in one `AskUserQuestion` when feasible, but keep questions per-decision.
|
|
79
|
+
|
|
80
|
+
## Step 5: Generate the file
|
|
81
|
+
Write to `wiki/work/decisions/DEC-NNNN-<group-slug>.md` using this template. **Tables only, mermaid for flows** — mandatory in every block.
|
|
82
|
+
|
|
83
|
+
````markdown
|
|
84
|
+
# DEC-NNNN: <Decision-Group Title>
|
|
85
|
+
|
|
86
|
+
> Decision Group covering <area-1>, <area-2>, <area-3>.
|
|
87
|
+
|
|
88
|
+
- **File created**: YYYY-MM-DD
|
|
89
|
+
- **Last updated**: YYYY-MM-DD
|
|
90
|
+
- **Tags (group)**: <umbrella tags shared by all decisions, optional>
|
|
91
|
+
|
|
92
|
+
## Shared Context
|
|
93
|
+
|
|
94
|
+
<Context applying to every decision in the group; don't restate per block. Link code areas (repo-relative), prior decisions ([[DEC-NNNN-slug|DEC-NNNN#DM: title]]), external constraints.>
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## D1. <Short Title — Verb Phrase>
|
|
99
|
+
|
|
100
|
+
- **Status**: <proposed | accepted | deprecated | superseded by DEC-XX#DY>
|
|
101
|
+
- **Date**: YYYY-MM-DD
|
|
102
|
+
- **Deciders**: <names or roles>
|
|
103
|
+
- **Consulted**: <optional>
|
|
104
|
+
- **Informed**: <optional>
|
|
105
|
+
- **Supersedes**: <DEC-MMMM#DK | none>
|
|
106
|
+
- **Tags**: <area-1>, <area-2>
|
|
107
|
+
|
|
108
|
+
### Context (decision-specific)
|
|
109
|
+
<Applies to D1 but not siblings; reference Shared Context when possible.>
|
|
110
|
+
|
|
111
|
+
### Decision Drivers
|
|
112
|
+
| # | Driver | Why it matters |
|
|
113
|
+
|---|--------|----------------|
|
|
114
|
+
| 1 | <e.g. p99 latency budget < 200ms> | <consequence if violated> |
|
|
115
|
+
|
|
116
|
+
### Considered Options
|
|
117
|
+
| Option | One-line summary (≤15 words) |
|
|
118
|
+
|--------|------------------|
|
|
119
|
+
| **A. <name>** | <…> |
|
|
120
|
+
| **B. <name>** | <…> |
|
|
121
|
+
|
|
122
|
+
### Option Comparison
|
|
123
|
+
| Criterion | Option A | Option B |
|
|
124
|
+
|-----------|----------|----------|
|
|
125
|
+
| Meets driver 1 | ✅ | ⚠️ |
|
|
126
|
+
| Implementation cost | Low | Med |
|
|
127
|
+
| Operational cost | Low | Low |
|
|
128
|
+
| Reversibility | Easy | Hard |
|
|
129
|
+
|
|
130
|
+
### Trade-off Detail per Option
|
|
131
|
+
#### Option A: <name>
|
|
132
|
+
| Aspect | Assessment |
|
|
133
|
+
|--------|------------|
|
|
134
|
+
| Pros | <comma-separated or short prose> |
|
|
135
|
+
| Cons | <…> |
|
|
136
|
+
| Risks | <known unknowns> |
|
|
137
|
+
| Exit cost | <how hard to walk away later> |
|
|
138
|
+
|
|
139
|
+
<Repeat the same 4-row Aspect table for each remaining option (B, C, …).>
|
|
140
|
+
|
|
141
|
+
### Decision Outcome
|
|
142
|
+
**Chosen option**: **<Option X — name>**, because <one-sentence justification anchored to the highest-priority driver>.
|
|
143
|
+
|
|
144
|
+
### Decision Flow
|
|
145
|
+
<Mermaid block when the decision involves a flow/sequence/state transition; skip only for purely static choices.>
|
|
146
|
+
```mermaid
|
|
147
|
+
flowchart LR
|
|
148
|
+
...
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### Consequences
|
|
152
|
+
| Type | Consequence |
|
|
153
|
+
|------|-------------|
|
|
154
|
+
| ✅ Positive | <e.g. eliminates current bottleneck> |
|
|
155
|
+
| ⚠️ Negative | <e.g. adds new operational dependency> |
|
|
156
|
+
| 🔁 Follow-up | <e.g. write task: instrument metric> |
|
|
157
|
+
|
|
158
|
+
### Validation
|
|
159
|
+
| Signal | Threshold | When measured |
|
|
160
|
+
|--------|-----------|---------------|
|
|
161
|
+
| <e.g. p99 latency> | < 200ms | 30 days post-deploy |
|
|
162
|
+
|
|
163
|
+
### Links
|
|
164
|
+
- Related decisions: [[DEC-NNNN-slug|DEC-NNNN#DM: title]]
|
|
165
|
+
- Supersedes: [[DEC-MMMM-slug|DEC-MMMM#DK: title]] (if applicable)
|
|
166
|
+
- Source task(s): `wiki/work/tasks/TASK-NNN-slug.md`
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## D2. <Short Title of Decision 2>
|
|
171
|
+
- **Status**: <independent of D1>
|
|
172
|
+
- **Supersedes**: … · **Tags**: …
|
|
173
|
+
<repeat the full D1 block structure>
|
|
174
|
+
|
|
175
|
+
## D3. ...
|
|
176
|
+
````
|
|
177
|
+
|
|
178
|
+
**Single-decision files** have one `D1` block and no `D2`/`D3`; `Shared Context` may merge into D1's `### Context` or be omitted.
|
|
179
|
+
|
|
180
|
+
## Step 6: Maintain the Decision Index
|
|
181
|
+
1. Append to `wiki/work/decisions/index.md`: `- [DEC-NNNN — Title](DEC-NNNN-slug.md) — one-line summary · D1 proposed`.
|
|
182
|
+
2. Add **one row per decision** to the Index in `wiki/work/decisions/lifecycle.md` (a 3-decision file adds 3 rows). Columns: `File`, `Decision`, `Title`, `Decision Area`, `Status`, `Date`, `Deciders`, `Supersedes`, `Superseded By` (see lifecycle doc spec).
|
|
183
|
+
3. **If any decision was drafted `accepted` AND supersedes an existing one** (rare), apply the two-block cross-reference rule per pair, atomically:
|
|
184
|
+
- **Superseded block:** `Status: accepted` → `superseded by DEC-N#DX`; callout `> **Superseded by [[DEC-NNNN-slug\|DEC-N#DX: title]]** on YYYY-MM-DD` directly under that decision's H2.
|
|
185
|
+
- **Superseded block's siblings:** untouched.
|
|
186
|
+
- **New block:** `Supersedes` metadata; `### Links` references `[[DEC-MMMM-slug\|DEC-MMMM#DK: title]]`.
|
|
187
|
+
- **Index:** two rows updated (superseder gets `Supersedes`; superseded gets `Status` + `Superseded By`).
|
|
188
|
+
- **Graph:** new node; supersession edge; superseded node's class flipped.
|
|
189
|
+
**Default to `proposed`** — create-time supersession is rare; `/decision-finalize` enforces it atomically.
|
|
190
|
+
4. Don't delete/mutate existing index rows beyond what supersession requires (append-mostly).
|
|
191
|
+
|
|
192
|
+
## Step 7: Append to `wiki/log.md` (`Edit`, never `echo >>`)
|
|
193
|
+
`## [YYYY-MM-DD] decision-create | DEC-NNNN <Decision-Group Title>`
|
|
194
|
+
|
|
195
|
+
## Step 8: Cross-link from related artifacts
|
|
196
|
+
For any decision prompted by an active task/feature, link both ways (`Read` then `Edit`, never `echo >>`/`sed`): in the source task file append `**Decision**: [[DEC-NNNN-slug|DEC-NNNN#DM: title]]`; in the decision's `### Links` list the source task path.
|
|
197
|
+
|
|
198
|
+
## Step 9: Update memories
|
|
199
|
+
If a decision establishes a non-obvious pattern, integration constraint, or gotcha: `mcp__serena__write_memory` (topic-hierarchical name, e.g. `architecture/data-layer/cache-strategy`), referencing `DEC-NNNN#DM` not just the file. Skip self-documenting decisions.
|
|
200
|
+
|
|
201
|
+
## Step 10: Report
|
|
202
|
+
Tabular summary: File path, Decisions in file (`D1: <title>`, …), Status per decision, Supersession queued for finalize? (per decision), Index updated (N rows), Graph updated (only if any drafted `accepted`), Log appended, Suggested next steps (`/decision-finalize <file>#D1`, …). Note any decision dropped for lack of evidence under a "Gaps" section.
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## Output formatting rules (mandatory — override default style)
|
|
207
|
+
1. **All comparisons are tables** — no bullet pros/cons or option summaries. Writing `- Good/Bad, because …` → convert to a table row.
|
|
208
|
+
2. **Mermaid for any flow/sequence/before-after** — static choices may skip; when in doubt, include.
|
|
209
|
+
3. **One decision per `D*` block** — never cover two; split into `D1`/`D2`.
|
|
210
|
+
4. **Stable decision IDs** — `D2` stays `D2` forever, even if `D1` is later deprecated; never renumber siblings.
|
|
211
|
+
5. **Present tense, full sentences** — "We will use Redis as the session cache", not "Redis chosen".
|
|
212
|
+
6. **Immutable per decision once accepted** — never edit an accepted block's content; write a superseding decision instead. Only allowed in-place edits: status change (accepted → superseded) + the supersession callout.
|
|
213
|
+
|
|
214
|
+
## CRITICAL rules
|
|
215
|
+
1. **Max 3 sub-processes at a time** if delegating research; **always terminate processes when done**.
|
|
216
|
+
2. **Never invent options or consequences** — every option backed by Step 3 research; every consequence a real implication.
|
|
217
|
+
3. **Tables not bullets** for every comparison — hard rule.
|
|
218
|
+
4. **Mermaid for flows** — include unless purely static.
|
|
219
|
+
5. **Per-decision metadata mandatory** — `Status`/`Date`/`Deciders`/`Tags` non-empty on every block; `Tags` non-empty required for supersession detection.
|
|
220
|
+
6. **Decisions in a group are independent units** — never assume sibling status, deciders, or supersession on behalf of a block.
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: decision-finalize
|
|
3
|
+
description: Finalize a single proposed decision block; run E-C-A-D-R audit, supersession check, and flip status to accepted
|
|
4
|
+
category: planning
|
|
5
|
+
model: claude-sonnet-4-6
|
|
6
|
+
effort: high
|
|
7
|
+
argument-hint: <path/to/decision.md#DM, NNNN-slug#DM, or NNNN#DM>
|
|
8
|
+
disable-model-invocation: false
|
|
9
|
+
user-invocable: true
|
|
10
|
+
---
|
|
11
|
+
**Prereqs:** obey `.docs/guides/mcp-tools.md`; run /primer if not done this session.
|
|
12
|
+
**Read `wiki/work/decisions/lifecycle.md` first** — it defines the Decision Group model, the per-decision supersession rule, the two-block cross-reference rule, and the relationship graph that finalization must keep in sync.
|
|
13
|
+
|
|
14
|
+
# Finalize Decision
|
|
15
|
+
|
|
16
|
+
Take a **single proposed decision block** in a decision file, surface every open question/placeholder, ratify it with the user, **enforce the supersession rule** against any prior accepted decision in the same area, then flip *that decision's* status to **accepted**.
|
|
17
|
+
|
|
18
|
+
Each decision is finalized **independently** — a file with three proposed decisions takes three invocations; **sibling decisions are never touched**. Once accepted, a decision is immutable; to change it, write a successor via `/decision-create` and finalize it to supersede the old one.
|
|
19
|
+
|
|
20
|
+
**Target**: $ARGUMENTS
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Step 1: Locate the (file, decision) pair
|
|
25
|
+
|
|
26
|
+
| Input | Resolution |
|
|
27
|
+
|-------|------------|
|
|
28
|
+
| `<path>#DM` | file as-is; decision = `DM` |
|
|
29
|
+
| `<NNNN-slug>#DM` | search `wiki/work/decisions/` for `NNNN-slug.md` |
|
|
30
|
+
| `<NNNN>#DM` | pad to 4 digits; `find_file` mask `NNNN-*.md` |
|
|
31
|
+
| `<path>`/`<NNNN-slug>`, file has **one** proposed decision | auto-resolve to it |
|
|
32
|
+
| same, **multiple** proposed | list them, `AskUserQuestion` to pick |
|
|
33
|
+
| Empty/missing | list every `proposed` decision across all files (one row per `DEC-NNNN#DM`), ask user |
|
|
34
|
+
|
|
35
|
+
Can't locate file or decision → **stop and report**; never invent or create.
|
|
36
|
+
|
|
37
|
+
## Step 2: Read and audit the target block
|
|
38
|
+
|
|
39
|
+
1. `Read` the file; locate the `## DM. <title>` H2 and everything to the next `## D*` or EOF.
|
|
40
|
+
2. **Verify status is `proposed`:** `accepted` → stop (immutable; suggest `/decision-create` successor). `deprecated`/`superseded by …` → stop (no longer authoritative).
|
|
41
|
+
3. **Audit the target block only** (siblings out of scope) for unresolved content:
|
|
42
|
+
|
|
43
|
+
| Gap | Detection |
|
|
44
|
+
|-----|-----------|
|
|
45
|
+
| Placeholder text | `<...>`, `TBD`, `TODO`, `???`, `FIXME`, `[fill in]`, HTML comments |
|
|
46
|
+
| Empty table cells | only `…`/`...`/placeholder dashes/whitespace |
|
|
47
|
+
| Empty driver/option/consequence rows | substance column blank or templated |
|
|
48
|
+
| Missing chosen option | `### Decision Outcome` with no bolded option |
|
|
49
|
+
| Missing/blank `Date` | blank, `YYYY-MM-DD`, or future |
|
|
50
|
+
| Missing `Deciders` | blank or `<names or roles>` |
|
|
51
|
+
| Missing `Tags` | empty (required for supersession detection) |
|
|
52
|
+
| Missing validation signals | `### Validation` empty or all placeholders |
|
|
53
|
+
| Missing flow diagram | flow/sequence/before-after decision has no mermaid (skip if purely static) |
|
|
54
|
+
| Asymmetric option analysis | some options have full pro/con tables, others don't |
|
|
55
|
+
| Bullet-list comparisons | `- Good/Bad, because …` → convert to tables |
|
|
56
|
+
| Stale "Considered Options" | option in trade-offs but missing from matrix (or vice versa) |
|
|
57
|
+
|
|
58
|
+
4. **Build an Audit Report** in context: file, decision (`DM — title`), current status, siblings + their status (out of scope), gaps found (N), then a gaps table (priority, section, gap, resolution strategy).
|
|
59
|
+
|
|
60
|
+
## Step 2.5: Supersession check (mandatory, per-decision)
|
|
61
|
+
|
|
62
|
+
The rule operates **per decision, across every file**. Procedure:
|
|
63
|
+
1. `list_dir` `wiki/work/decisions/` (exclude `lifecycle.md`); `Read` each, walk every `## D*`, collect `Status: accepted` blocks.
|
|
64
|
+
2. Score each candidate: **Tier 1** ≥1 shared tag · **Tier 2** sub-title noun-phrase overlap · **Tier 3** file-slug stem overlap (only when both are the sole `D1` of single-decision files) · **Tier 4** explicit `Supersedes:` already in target (authoritative — verify the named target exists and is `accepted`).
|
|
65
|
+
3. Build a candidate report (Candidate, Status, Tags overlap, Title overlap, Slug overlap, Verdict).
|
|
66
|
+
|
|
67
|
+
**Resolution:**
|
|
68
|
+
| Situation | Action |
|
|
69
|
+
|-----------|--------|
|
|
70
|
+
| Zero candidates | continue — fresh area |
|
|
71
|
+
| One candidate, all signals strong | `AskUserQuestion`, default "supersede this candidate" |
|
|
72
|
+
| Multiple | ranked list; user picks at most one |
|
|
73
|
+
| Candidate is `proposed` | skip (only `accepted` can be superseded); flag two-proposed-in-area as a consolidation hint |
|
|
74
|
+
| Candidate already `superseded by DEC-X#DY` | walk the chain to DEC-X#DY (the area's head) and supersede that instead |
|
|
75
|
+
| User declares "different area" despite signals | honor it; recommend revising target's tags to keep detection clean |
|
|
76
|
+
|
|
77
|
+
Persist the supersession target (or explicit "none") for Step 4. Do NOT proceed without resolving this.
|
|
78
|
+
|
|
79
|
+
## Step 3: Present audit, resolve open questions
|
|
80
|
+
|
|
81
|
+
1. Present the audit report as one tabular summary — never bullets.
|
|
82
|
+
2. Resolve gaps via `AskUserQuestion` in priority order: (1) chosen option not specified — everything flows from it; (2) empty decision drivers; (3) empty option trade-offs; (4) empty `Tags` (supersession detection); (5) empty consequences; (6) missing validation signals (E-C-A-D-R "R", Definition of Done); (7) Date/Deciders/Supersedes metadata.
|
|
83
|
+
3. **Question style:** frame with context from this block (not siblings); for the chosen option show the comparison table inline; for trade-offs/consequences ask focused questions; for validation demand ≥1 **measurable** signal with threshold + timeframe.
|
|
84
|
+
4. **Format-correction gaps** (bullet→table, asymmetric tables, missing mermaid) need no questions — fix in Step 4.
|
|
85
|
+
|
|
86
|
+
## Step 4: Apply edits to the target block
|
|
87
|
+
|
|
88
|
+
**`Edit` only** (never `sed`/`awk`/`echo >>`). **Touch only the target block; siblings are inviolate.** Order:
|
|
89
|
+
1. Fill resolved content — each placeholder/empty row/TBD → user's confirmed answer; one `Edit` per distinct old_string, constrained to the target block via unique surrounding text.
|
|
90
|
+
2. Bold the chosen option in `### Decision Outcome`.
|
|
91
|
+
3. Convert any bullet-list comparisons to tables (within this block).
|
|
92
|
+
4. Add the mermaid diagram if flagged missing.
|
|
93
|
+
5. Update metadata: `Status` → `accepted`; `Date` → today (overwrite if blank/wrong, preserve if user wants original); `Deciders` → confirmed; `Tags` → confirmed non-empty; `Supersedes` → `DEC-MMMM#DK` or `none`.
|
|
94
|
+
6. **If Step 2.5 named a supersession target**, apply the two-block cross-reference rule **atomically** (both change or neither); target may be in the same or a different file:
|
|
95
|
+
- **This decision (superseder):** `Supersedes: DEC-MMMM#DK` in metadata; `### Links` lists `Supersedes [[MMMM-slug\|DEC-MMMM#DK: title]]`.
|
|
96
|
+
- **Superseded block:** flip `Status: accepted` → `Status: superseded by DEC-NNNN#DX`; insert callout `> **Superseded by [[NNNN-slug\|DEC-NNNN#DX: title]]** on YYYY-MM-DD` directly **under that decision's H2** (not the file H1), between the H2 and its metadata bullets so a reader sees it first.
|
|
97
|
+
- **Superseded decision's siblings:** untouched.
|
|
98
|
+
7. Update `Last updated` in the file front matter to today — the only file-level edit.
|
|
99
|
+
|
|
100
|
+
## Step 5: Re-audit before finalizing
|
|
101
|
+
|
|
102
|
+
Re-read the target block. Finalize **only when all** hold:
|
|
103
|
+
- [ ] No placeholder text in the target block
|
|
104
|
+
- [ ] Every option in `### Considered Options` has a complete trade-off table
|
|
105
|
+
- [ ] The criterion comparison matrix has no empty cells
|
|
106
|
+
- [ ] `### Decision Outcome` names a bolded chosen option with a one-sentence justification
|
|
107
|
+
- [ ] `### Consequences` has ≥1 positive and ≥1 negative row, no placeholders
|
|
108
|
+
- [ ] `### Validation` has ≥1 row with a concrete signal, threshold, and timeframe (E-C-A-D-R "R")
|
|
109
|
+
- [ ] No bullet-list comparisons remain — every comparison is a table
|
|
110
|
+
- [ ] If flow/sequence/before-after, a mermaid block is present
|
|
111
|
+
- [ ] `Status: accepted`, `Date` today (or user-confirmed), `Deciders` filled, `Tags` non-empty
|
|
112
|
+
- [ ] If Step 2.5 named a target, **both** blocks updated atomically (target's `Supersedes`+`Links`; superseded block's `Status`+callout)
|
|
113
|
+
- [ ] No other accepted decision in the same area exists across the log (no parallel `accepted` after this finalize)
|
|
114
|
+
- [ ] **Sibling decisions in this file are byte-for-byte unchanged**
|
|
115
|
+
|
|
116
|
+
Any failure → return to the relevant step. **Do not flip to `accepted` while gaps remain.**
|
|
117
|
+
|
|
118
|
+
## Step 6: Update index and relationship graph (`wiki/work/decisions/lifecycle.md`)
|
|
119
|
+
|
|
120
|
+
1. **Index — target row:** `Status` → `accepted`; `Date` → today; `Supersedes` → `[[MMMM-slug\|DEC-MMMM#DK: title]]` if named else `—`; `Superseded By` → `—`.
|
|
121
|
+
2. **Index — superseded row (if any):** `Status` → `superseded by DEC-NNNN#DX`; `Superseded By` → `[[NNNN-slug\|DEC-NNNN#DX: title]]`.
|
|
122
|
+
3. **Relationship Graph** (mermaid `flowchart`): add a node for `DEC-NNNN#DM` (title + date); if superseding, add an edge superseded→new labelled `superseded by` with date; update `class` lines (new → `accepted`, superseded → `superseded`); if still placeholder, replace with a real graph for the chain; subgraphs may group per file or per area.
|
|
123
|
+
|
|
124
|
+
If `lifecycle.md` doesn't exist, create it from the template under `/decision-create` Step 6. **Verify all three sections agree** before saving (index saying `superseded` while the graph shows the node `accepted` is a broken commit).
|
|
125
|
+
|
|
126
|
+
## Step 6.5: Family index + archive if fully terminal
|
|
127
|
+
|
|
128
|
+
A group stays in `wiki/work/decisions/index.md` only while ≥1 block is `proposed`.
|
|
129
|
+
- Proposed blocks remain → update the row's per-decision note (e.g. `D1 accepted, D2 proposed`); don't move the file.
|
|
130
|
+
- No proposed blocks remain (all `accepted`/`superseded`):
|
|
131
|
+
1. Delete the group's row from `index.md`.
|
|
132
|
+
2. `git mv wiki/work/decisions/<file>.md wiki/work/decisions/archive/<file>.md` (Bash — `git mv` only).
|
|
133
|
+
3. Append to `wiki/work/decisions/archive/index.md` (dominant final status — `accepted` unless all `superseded`): `| [[DEC-NNNN]] | <Title> | accepted | YYYY-MM-DD |`.
|
|
134
|
+
|
|
135
|
+
`Read` then `Edit` for all index edits — never `sed`.
|
|
136
|
+
|
|
137
|
+
## Step 7: Append log entry (`wiki/log.md`, `Edit` — never `echo >>`)
|
|
138
|
+
- No supersession: `## [YYYY-MM-DD] decision-accepted | DEC-NNNN#DM <Decision Title>`
|
|
139
|
+
- Supersession: `## [YYYY-MM-DD] decision-superseded | DEC-MMMM#DK superseded by DEC-NNNN#DM`
|
|
140
|
+
|
|
141
|
+
## Step 8: Cross-link follow-up work
|
|
142
|
+
|
|
143
|
+
Scan `### Consequences` for `🔁 Follow-up` rows (suggest only, never auto-create):
|
|
144
|
+
| Type | Suggestion |
|
|
145
|
+
|------|-----------|
|
|
146
|
+
| Implementation ("write task: …") | `/task-add <desc referencing DEC-NNNN#DM>` |
|
|
147
|
+
| Time-based revisit ("revisit in 6 months") | offer `/schedule` for the revisit date |
|
|
148
|
+
| Metric to instrument | `/task-add` or fold into an existing task — ask the user |
|
|
149
|
+
|
|
150
|
+
## Step 9: Update memory if a new pattern emerges
|
|
151
|
+
|
|
152
|
+
If the accepted decision creates a non-obvious pattern, integration constraint, or gotcha: `mcp__serena__write_memory` (topic-hierarchical name, e.g. `architecture/data-layer/cache-strategy`), referencing `DEC-NNNN#DM` not just the file; prefer `edit_memory` if a memory already covers the area.
|
|
153
|
+
|
|
154
|
+
## Step 10: Refresh the hot cache
|
|
155
|
+
|
|
156
|
+
Accepting a decision is durable, cross-session-relevant wiki state. Run the **Hot Cache Refresh** procedure — defined in `/wiki-ingest` Step 8 (`lib/skills/wiki-ingest/SKILL.md`) — to regenerate `wiki/hot.md` in full, surfacing this newly accepted decision (and any supersession) under Recent Changes. Do not restate the procedure here; follow it as written.
|
|
157
|
+
|
|
158
|
+
## Step 11: Report
|
|
159
|
+
|
|
160
|
+
Table: Decision (`DEC-NNNN#DM`), File, Old→New status (`proposed → accepted`), Gaps resolved (count), Format fixes (count), Supersession (`DEC-MMMM#DK` or `none`), Sibling decisions + status (unchanged), Index updated, Graph updated, Log appended, Suggested next steps (`/task-add …`, `/schedule …`, `/decision-finalize <file>#Dother`, `/decision-next`). Mention remaining proposed siblings. If the group is now fully terminal, note the file moved to `archive/` (Step 6.5) — `[[DEC-NNNN]]` cross-refs stay valid regardless of location.
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Output formatting rules (mandatory)
|
|
165
|
+
|
|
166
|
+
1. **Tables not bullets** — every comparison and audit summary, in output and edits.
|
|
167
|
+
2. **One Edit per gap** — surgical; don't rewrite whole blocks for one placeholder.
|
|
168
|
+
3. **Never alter accepted decisions** — refuse an already-accepted target; suggest `/decision-create`.
|
|
169
|
+
4. **Never touch sibling decisions** — only the target (plus the superseded block if applicable).
|
|
170
|
+
5. **Present tense, full sentences** when filling content.
|
|
171
|
+
6. **No fabrication** — if the user lacks an answer (e.g. concrete validation thresholds), keep `proposed`, mark the section honestly, and report remaining gaps.
|
|
172
|
+
|
|
173
|
+
## CRITICAL rules
|
|
174
|
+
|
|
175
|
+
1. **Status flip is one-way and final** — only after every Step 5 item passes.
|
|
176
|
+
2. **Supersession is atomic and bidirectional** — new block, superseded block, index, and graph all change together or none do.
|
|
177
|
+
3. **Per-decision scope** — only the target block; siblings byte-for-byte unchanged at the end.
|
|
178
|
+
4. **No parallel `accepted` in the same area** — the chain invariant; if you can't resolve which supersedes which, leave `proposed` and report.
|
|
179
|
+
5. **Never `sed`/`echo >>`/`cat <<EOF`** — always `Edit`.
|
|
180
|
+
6. **Never auto-create tasks or schedules** — suggest them.
|
|
181
|
+
7. **Max 3 sub-processes at a time** if delegating; **always terminate processes when done**.
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: decision-next
|
|
3
|
+
description: Find the first accepted decision missing a task reference; surface suggested /task-add command
|
|
4
|
+
category: researching
|
|
5
|
+
model: claude-haiku-4-5-20251001
|
|
6
|
+
argument-hint: "[optional: path to a specific decision file or NNNN prefix to scope the search]"
|
|
7
|
+
disable-model-invocation: false
|
|
8
|
+
user-invocable: true
|
|
9
|
+
---
|
|
10
|
+
**Prereqs:** obey `.docs/guides/mcp-tools.md`.
|
|
11
|
+
|
|
12
|
+
# Decision Next Task
|
|
13
|
+
|
|
14
|
+
Scan accepted decisions for ones missing a task reference and surface the first gap.
|
|
15
|
+
|
|
16
|
+
**Task-linked** = every accepted decision has a `Source task(s):` line with at least one task path (i.e. no task-less accepted decisions remain).
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
**Scope**: $ARGUMENTS
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Step 0: Resolve the Search Scope
|
|
25
|
+
|
|
26
|
+
Parse `$ARGUMENTS`:
|
|
27
|
+
|
|
28
|
+
| Input | Resolution |
|
|
29
|
+
|-------|------------|
|
|
30
|
+
| Empty | Search all decision files in `wiki/work/decisions/` (exclude `lifecycle.md`) |
|
|
31
|
+
| File path (e.g. `wiki/work/decisions/DEC-0007-session.md`) | Scope to that file only |
|
|
32
|
+
| `NNNN-slug` (e.g. `0007-session`) | Locate `NNNN-slug.md` in `wiki/work/decisions/` |
|
|
33
|
+
| `NNNN` or plain number (e.g. `7` or `007`) | Pad to 4 digits; `mcp__serena__find_file` with mask `NNNN-*.md` |
|
|
34
|
+
|
|
35
|
+
Use `mcp__serena__find_file` and `mcp__serena__list_dir` for all discovery — never `bash`.
|
|
36
|
+
|
|
37
|
+
If `wiki/work/decisions/` cannot be found, STOP and report: `No decisions directory found. Run /decision-create to start one.`
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Step 1: Enumerate Decision Files
|
|
42
|
+
|
|
43
|
+
Use `mcp__serena__list_dir` on `wiki/work/decisions/` to collect all `*.md` files **except `lifecycle.md`**.
|
|
44
|
+
|
|
45
|
+
Sort files by their 4-digit numeric prefix ascending (lowest number first) so you scan in chronological decision order.
|
|
46
|
+
|
|
47
|
+
If `$ARGUMENTS` scoped to a single file, the list contains only that file.
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Step 2: Scan Each File for Task-less Accepted Decisions
|
|
52
|
+
|
|
53
|
+
For each file (in order), use `Read` to load it, then:
|
|
54
|
+
|
|
55
|
+
1. **Parse every `## D*` decision block** — each H2 matching `## D\d+\.` is a decision block. Collect blocks in document order.
|
|
56
|
+
|
|
57
|
+
2. **For each decision block, check**:
|
|
58
|
+
- `Status: accepted` — only accepted decisions need follow-up tasks; skip `proposed`, `deprecated`, `superseded by …`
|
|
59
|
+
- `### Links` section contains a `Source task(s):` line with at least one `wiki/work/tasks/` path (or relative `../tasks/` path)
|
|
60
|
+
|
|
61
|
+
3. **A decision is task-less if**:
|
|
62
|
+
- Its status is `accepted`, AND
|
|
63
|
+
- Its `### Links` section is absent, OR has no `Source task(s):` line, OR the `Source task(s):` line is blank / contains only a placeholder
|
|
64
|
+
|
|
65
|
+
4. **Record per-file tracking**:
|
|
66
|
+
- `accepted_count` — number of accepted decisions in this file
|
|
67
|
+
- `task_less` — list of task-less decisions found
|
|
68
|
+
|
|
69
|
+
5. **Record the first task-less decision found** (file path + decision ID + decision title). After recording it, continue scanning the remaining files only to check completeness — do not surface more gaps.
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## Step 3: Verify the Task File Actually Exists (only when a link is present)
|
|
74
|
+
|
|
75
|
+
If a decision has a `Source task(s):` line with one or more paths, verify at least one of the referenced task files still exists using `mcp__serena__find_file`. If every listed task file is missing (moved, deleted, renamed), treat the decision as task-less and surface it as if no link were present, but note the broken link.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Step 4: Report
|
|
80
|
+
|
|
81
|
+
Choose the matching shape:
|
|
82
|
+
|
|
83
|
+
### A. No task-less accepted decision found
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
All accepted decisions have task references. Nothing to action.
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### B. Task-less decision found — no broken link
|
|
90
|
+
|
|
91
|
+
```
|
|
92
|
+
DEC-NNNN#DM: <Decision Title>
|
|
93
|
+
File: wiki/work/decisions/DEC-NNNN-slug.md
|
|
94
|
+
Status: accepted — no task linked
|
|
95
|
+
|
|
96
|
+
Suggested next step:
|
|
97
|
+
/task-add <short action derived from the decision title, e.g. "Implement <title>"> --decision NNNN#DM
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Append a one-sentence reminder of what the decision chose (pulled from `### Decision Outcome`) so the user knows what the task should implement.
|
|
101
|
+
|
|
102
|
+
### C. Task-less decision found — broken link (file missing)
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
DEC-NNNN#DM: <Decision Title>
|
|
106
|
+
File: wiki/work/decisions/DEC-NNNN-slug.md
|
|
107
|
+
Status: accepted — task link broken (referenced file not found)
|
|
108
|
+
Broken link: <original path from Source task(s):>
|
|
109
|
+
|
|
110
|
+
Suggested next steps:
|
|
111
|
+
• Search wiki/work/tasks/ for the task by ID — files never move; check its status: frontmatter
|
|
112
|
+
• Or create a replacement: /task-add <short action> --decision DEC-NNNN#DM
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### D. Scoped file has no accepted decisions
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
<file path> has no accepted decisions. Run /decision-finalize <file>#DM to accept a proposed decision.
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Constraints
|
|
124
|
+
|
|
125
|
+
- Use only `mcp__serena__list_dir`, `mcp__serena__find_file`, `Read`, and `AskUserQuestion`.
|
|
126
|
+
- Never use `bash` for reads (`cat`, `find`, `grep`, `sed`, `ls`).
|
|
127
|
+
- Stop at the **first** gap — do not enumerate all gaps. The user runs `/decision-next` again after actioning each one.
|
|
128
|
+
- Keep the report terse — one block, no preamble, no closing summary.
|
|
129
|
+
- There is no `completed/` subdirectory and no `git mv` — decision files stay at their stable `wiki/work/decisions/` path permanently.
|