@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.
Files changed (186) hide show
  1. package/.github/workflows/build.yml +88 -0
  2. package/.github/workflows/security.yml +24 -0
  3. package/.gitleaks.toml +15 -0
  4. package/README.md +472 -0
  5. package/bin/cli.js +47 -0
  6. package/lib/README.md +27 -0
  7. package/lib/hooks/README.md +316 -0
  8. package/lib/hooks/env-file-guard.js +45 -0
  9. package/lib/hooks/git-protected-ops-block.js +77 -0
  10. package/lib/hooks/lib/serena-languages.js +158 -0
  11. package/lib/hooks/lib/serena.js +787 -0
  12. package/lib/hooks/mv-absolute-path-block.js +53 -0
  13. package/lib/hooks/serena-bash-grep-block.js +501 -0
  14. package/lib/hooks/serena-edit-guard.js +74 -0
  15. package/lib/hooks/serena-first-glob-guard.js +94 -0
  16. package/lib/hooks/serena-first-guard.js +74 -0
  17. package/lib/hooks/serena-first-read-guard.js +167 -0
  18. package/lib/hooks/serena-pre-delegation.js +117 -0
  19. package/lib/hooks/serena-session-reset.js +45 -0
  20. package/lib/hooks/serena-usage-tracker.js +186 -0
  21. package/lib/hooks/serena-write-guard.js +58 -0
  22. package/lib/prompts/README.md +16 -0
  23. package/lib/prompts/migrate-wiki.md +111 -0
  24. package/lib/prompts/setup-deployment.md +322 -0
  25. package/lib/prompts/setup-design-system.md +162 -0
  26. package/lib/prompts/setup-strict-typechecks.md +139 -0
  27. package/lib/scripts/README.md +49 -0
  28. package/lib/scripts/bootstrap-serena.sh +145 -0
  29. package/lib/scripts/build-mcp-guide.sh +108 -0
  30. package/lib/scripts/install-global.sh +78 -0
  31. package/lib/scripts/install-mcps.sh +131 -0
  32. package/lib/scripts/lib.sh +154 -0
  33. package/lib/scripts/merge-gitignore.sh +65 -0
  34. package/lib/scripts/migrate-project.sh +273 -0
  35. package/lib/scripts/setup-deployment.sh +104 -0
  36. package/lib/scripts/setup-project.sh +55 -0
  37. package/lib/scripts/setup-runner.sh +99 -0
  38. package/lib/scripts/setup-strict-typechecks.sh +29 -0
  39. package/lib/scripts/startup.sh +42 -0
  40. package/lib/scripts/sync-wiki-scaffold.sh +104 -0
  41. package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
  42. package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
  43. package/lib/scripts/templates/gitignore +136 -0
  44. package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
  45. package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
  46. package/lib/scripts/templates/guides/stubs/context7.md +26 -0
  47. package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
  48. package/lib/scripts/templates/guides/stubs/serena.md +219 -0
  49. package/lib/scripts/templates/wiki/conventions.md +100 -0
  50. package/lib/scripts/templates/wiki/dashboard.html +1733 -0
  51. package/lib/scripts/templates/wiki/hot.md +21 -0
  52. package/lib/scripts/templates/wiki/index.md +46 -0
  53. package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
  54. package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
  55. package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
  56. package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
  57. package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
  58. package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
  59. package/lib/scripts/templates/wiki/log.md +14 -0
  60. package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
  61. package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
  62. package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
  63. package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
  64. package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
  65. package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
  66. package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
  67. package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
  68. package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
  69. package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
  70. package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
  71. package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
  72. package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
  73. package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
  74. package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
  75. package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
  76. package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
  77. package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
  78. package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
  79. package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
  80. package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
  81. package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
  82. package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
  83. package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
  84. package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
  85. package/lib/scripts/update-project.sh +75 -0
  86. package/lib/scripts/wiki-dashboard-server.js +146 -0
  87. package/lib/skills/README.md +146 -0
  88. package/lib/skills/anti-slop/SKILL.md +183 -0
  89. package/lib/skills/bug-close/SKILL.md +136 -0
  90. package/lib/skills/bug-file/SKILL.md +114 -0
  91. package/lib/skills/bug-triage/SKILL.md +140 -0
  92. package/lib/skills/company-align/SKILL.md +203 -0
  93. package/lib/skills/debug-logs/SKILL.md +129 -0
  94. package/lib/skills/decision-create/SKILL.md +220 -0
  95. package/lib/skills/decision-finalize/SKILL.md +181 -0
  96. package/lib/skills/decision-next/SKILL.md +129 -0
  97. package/lib/skills/decision-walkthrough/SKILL.md +169 -0
  98. package/lib/skills/demo/SKILL.md +183 -0
  99. package/lib/skills/elevator-pitch/SKILL.md +125 -0
  100. package/lib/skills/eval-create/SKILL.md +344 -0
  101. package/lib/skills/eval-gap/SKILL.md +150 -0
  102. package/lib/skills/eval-run/SKILL.md +214 -0
  103. package/lib/skills/extract-feature/SKILL.md +344 -0
  104. package/lib/skills/flashcard/SKILL.md +513 -0
  105. package/lib/skills/frontend-taste/SKILL.md +184 -0
  106. package/lib/skills/gap-assess/SKILL.md +97 -0
  107. package/lib/skills/git-commit/SKILL.md +164 -0
  108. package/lib/skills/lint/SKILL.md +99 -0
  109. package/lib/skills/marp-slideshow/SKILL.md +212 -0
  110. package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
  111. package/lib/skills/now/SKILL.md +36 -0
  112. package/lib/skills/port-feature/SKILL.md +315 -0
  113. package/lib/skills/power-mode/SKILL.md +184 -0
  114. package/lib/skills/primer/SKILL.md +84 -0
  115. package/lib/skills/project-readme/SKILL.md +166 -0
  116. package/lib/skills/req-compile/SKILL.md +131 -0
  117. package/lib/skills/req-create/SKILL.md +124 -0
  118. package/lib/skills/req-extract-decisions/SKILL.md +241 -0
  119. package/lib/skills/req-finalize/SKILL.md +251 -0
  120. package/lib/skills/req-retire/SKILL.md +185 -0
  121. package/lib/skills/req-update/SKILL.md +265 -0
  122. package/lib/skills/research/SKILL.md +250 -0
  123. package/lib/skills/research-company/SKILL.md +345 -0
  124. package/lib/skills/roadmap-add/SKILL.md +238 -0
  125. package/lib/skills/roadmap-create/SKILL.md +223 -0
  126. package/lib/skills/roadmap-next/SKILL.md +132 -0
  127. package/lib/skills/security-audit/SKILL.md +246 -0
  128. package/lib/skills/serena-config/SKILL.md +92 -0
  129. package/lib/skills/simplify/SKILL.md +227 -0
  130. package/lib/skills/tackle/SKILL.md +156 -0
  131. package/lib/skills/task-add/SKILL.md +208 -0
  132. package/lib/skills/task-audit/SKILL.md +294 -0
  133. package/lib/skills/task-trash/SKILL.md +115 -0
  134. package/lib/skills/task-update/SKILL.md +136 -0
  135. package/lib/skills/uat-auto/SKILL.md +69 -0
  136. package/lib/skills/uat-auto-plus/SKILL.md +115 -0
  137. package/lib/skills/uat-generate/SKILL.md +289 -0
  138. package/lib/skills/uat-skip/SKILL.md +169 -0
  139. package/lib/skills/uat-walk/SKILL.md +164 -0
  140. package/lib/skills/uat-walk/UAT-CORE.md +140 -0
  141. package/lib/skills/update-docs/SKILL.md +75 -0
  142. package/lib/skills/wiki-archive/SKILL.md +96 -0
  143. package/lib/skills/wiki-ingest/SKILL.md +139 -0
  144. package/lib/skills/wiki-lint/SKILL.md +131 -0
  145. package/lib/skills/wiki-query/SKILL.md +71 -0
  146. package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
  147. package/lib/skills/wiki-tidy/SKILL.md +107 -0
  148. package/package.json +32 -0
  149. package/raw/.gitkeep +0 -0
  150. package/raw/design-principles.md +65 -0
  151. package/raw/guides/command-anti-patterns.md +79 -0
  152. package/raw/guides/deployment-strategy.md +448 -0
  153. package/raw/guides/evals-framework.md +452 -0
  154. package/raw/guides/mcp-tools.md +335 -0
  155. package/raw/guides/task-spec.md +79 -0
  156. package/raw/guides/type-checking-templates/README.md +112 -0
  157. package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
  158. package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
  159. package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
  160. package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
  161. package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
  162. package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
  163. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
  164. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
  165. package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
  166. package/raw/harness-notes.md +20 -0
  167. package/raw/house-style/components/Badge.tsx +16 -0
  168. package/raw/house-style/components/Button.tsx +32 -0
  169. package/raw/house-style/components/Card.tsx +26 -0
  170. package/raw/house-style/components/Chip.tsx +57 -0
  171. package/raw/house-style/components/IconButton.tsx +67 -0
  172. package/raw/house-style/components/Modal.tsx +18 -0
  173. package/raw/house-style/components/Stepper.tsx +141 -0
  174. package/raw/house-style/components/icons.tsx +128 -0
  175. package/raw/house-style/preview/src/index.css +46 -0
  176. package/raw/house-style/tokens/tailwind.preset.ts +49 -0
  177. package/raw/house-style/tokens/tokens.json +62 -0
  178. package/raw/llm-wiki-2.md +162 -0
  179. package/raw/llm-wiki.md +75 -0
  180. package/raw/research/dark-mode-theme/index.md +85 -0
  181. package/raw/research/dark-mode-theme/sources.md +49 -0
  182. package/raw/research/serena-mcp-disconnect/index.md +81 -0
  183. package/raw/research/serena-mcp-disconnect/sources.md +87 -0
  184. package/raw/research/wiki-tooling-improvements/index.md +126 -0
  185. package/raw/research/wiki-tooling-improvements/sources.md +73 -0
  186. 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.