wdi-method 0.4.6 → 0.5.0

package/kit/skills/wdi-product/SKILL.md

@@ -1,127 +1,127 @@
----
-name: wdi-product
-description: Use at G2 Product — when a PRD is created or an existing promise changes. Two intents, prd and update. Checks position, dispatches bmad-prd, verifies the result against prd-guide.md, and lands the memlog. Never writes the PRD itself.
----
-
-# WDI Product
-
-G2 decides **what is built, and how it feels to use.** `bmad-prd` writes the PRD.
-
-This wrapper exists because `bmad-prd` was the only writer of a primary artifact in this method with no WDI
-wrapper at all — so nothing checked its position, nothing verified its result against the guide, and nothing
-landed its memlog where the next run would read it. Those three gaps were paid for at G2 every time.
-
-You MUST NOT write or edit `prd.md` yourself. If a check fails, name what is missing and re-dispatch.
-
-| Intent | When |
-|---|---|
-| `prd` | A functional area a reader would not think to look for in an existing PRD |
-| `update` | Anything else — the default, and by a wide margin |
-
-## Inputs
-
-| Source | What it answers |
-|---|---|
-| `.what/_product-brief/brief.md` | The problem, the primary user, the boundary the PRD MUST respect |
-| `.what/_prd/*/prd.md` | Which initiatives already have a PRD, and what each already promises |
-| `.control/registry/requirements.yaml` | The next `CAP`/`FR`/`NFR`/`UJ` ids, allocated globally |
-| `.control/decisions/` | `applied` decisions the PRD MUST already reflect |
-| `.constitution/document/prd-guide.md` | The rules the result is checked against |
-| `.control/product-glossary.md` | Terms already fixed |
-
-## Step 1 — Position, and `update` is the default
-
-The decision this skill exists for. The test is the **reader**, not the calendar:
-
-> Would someone looking for this promise open an existing document?
-
-Yes → `update`, however large the change. No → `prd`. A PRD MUST NOT be split because it grew long, and a
-release is never a reason on its own. `prd-guide.md` owns the full table.
-
-Three asks that are not this skill:
-
-| Ask | Route |
-|---|---|
-| The problem itself has changed | `wdi-problem` — a re-cut plan under a wrong problem is wasted work |
-| Only the **wording** of an `FR` is wrong, while the promise is the same | The skill already at work fixes it directly. See below |
-| A planning assumption turned out to be void | `wdi-decision`, which wraps `bmad-correct-course` |
-
-## Step 2 — Wording is not a promise
-
-The split that ended three corrections in "reported but not fixed". `prd-guide.md` owns it; what this skill
-owns is refusing to run for the wrong half.
-
-| What changed | Who does it |
-|---|---|
-| A wrong cross-reference, a retired term, a word inconsistent with an `applied` decision — **the promise is the same** | Whichever skill is already at work. Memlog records it; **one** Revision History row per pass, never one per correction |
-| Scope, the proof of done, an `FR` retired or born | This skill, intent `update` |
-
-You MUST NOT accept a wording correction as an `update` run. Doing so puts a trivial fix behind a gate, and
-that is exactly how the three earlier ones were dropped.
-
-## Step 3 — Dispatch
-
-Invoke `bmad-prd` with the detected intent, scoped to **one initiative**. Do not restate the rules to it —
-they arrive through `persistent_facts` and `doc_standards` in `_bmad/custom/bmad-prd.toml`.
-
-Name the brief and, for `update`, the existing PRD and every `applied` decision that reaches it. The skill
-globs its own default locations, which this project redirects.
-
-## Step 4 — Verify
-
-| # | Check | Fails when |
-|---|---|---|
-| 1 | Home | Anything outside `.what/_prd/<initiative>/`, or a folder still named `ISI-slug-inisiatif` |
-| 2 | Ids allocated from the registry | `FR-1` restarted, or an id invented in prose |
-| 3 | Every `FR` names its `capability`; every `NFR` names its `goal` | V15 has nothing to check |
-| 4 | Every `FR` has **exactly one** proof of done, in business language | Zero, or a second technical restatement beside it |
-| 5 | Every `NFR` names `enforced_by` | An `NFR` nothing enforces is decoration (V5) |
-| 6 | Cross-Cutting NFRs and Constraints both present | An absent section reads as "not checked" |
-| 7 | No solution shape | A framework, a table, or a transport named in `prd.md` rather than in `addendum.md` |
-| 8 | One Revision History row for this run, written for someone not in the room | Zero rows, several rows, or a row that says "Updated §4.2" |
-| 9 | Memlog at `.control/memlog/prd-<slug>.md`, slug matching the folder | A `.memlog.md` appeared inside `.what/` — `--workspace` was used |
-| 10 | `bmad-review` ran through `doc_standards` on `prd.md` and `addendum.md` | It did not fire |
-
-Check 9 MUST be fixed immediately rather than reported. V16 rejects a memlog inside the corpus.
-
-## Step 5 — `owns:`, and the collision it prevents
-
-A new or changed `FR` that claims write authority over a domain entity MUST be checked against `owns:` in
-`components.yaml`. An entity has exactly one owning Product Component; an `FR` from another PRD that needs to
-change it MUST point at the owner's `FR` rather than promising to write it itself. V21 checks this, and the
-collision has already happened once for real.
-
-Report a collision. You MUST NOT resolve it by widening one PRD's claim.
-
-## Step 6 — Impact
-
-A changed promise changes what other documents can still claim. Check, and **report** — never edit.
-
-| Found | Where it goes |
-|---|---|
-| A `UC` realising an `FR` whose promise moved | `wdi-component` intent `behaviour`, or `wdi-blueprint` when the catalogue line itself changes |
-| A blueprint inventory row with nothing promising it any more | `wdi-blueprint` |
-| A contradiction with an `applied` decision | `wdi-decision` — a new `DEC-`, never an edit to one already applied |
-| A component born by this initiative | `wdi-init` intent `component` |
-
-Then run the change-control matrix in `delivery-flow-guide.md` and **report** which gates reopen. You MUST
-NOT reopen one yourself.
-
-## Rules
-
-- You MUST NOT write a second PRD for an area that already has one. The reader test decides, and its answer
-  is `update` far more often than it feels.
-- You MUST NOT open G2 on a PRD that has not been through check 10. Gate time is for deciding, not
-  proofreading.
-- The gate reads `prd.md` and `EXPERIENCE.md` together. A PRD that passes while the experience side is
-  missing has answered half of what G2 decides.
-- Every unresolved `[ASSUMPTION]` MUST be filed through `wdi-question` before the gate opens.
-- You MUST NOT raise `status:`. Status is a stage; the `reviewed:` block is an event, and `wdi-review` writes
-  it.
-- When the PRD cannot promise what was asked, say so and stop. Route to `wdi-problem`; do not quietly narrow
-  the ask.
-
-## Output
-
-Intent dispatched · what the promise now is in one line · the result of all ten checks naming the failures ·
-the `owns:` check · impact found and where it was routed · the gates the matrix names · open questions filed.
+---
+name: wdi-product
+description: Use at G2 Product — when a PRD is created or an existing promise changes. Two intents, prd and update. Checks position, dispatches bmad-prd, verifies the result against prd-guide.md, and lands the memlog. Never writes the PRD itself.
+---
+
+# WDI Product
+
+G2 decides **what is built, and how it feels to use.** `bmad-prd` writes the PRD.
+
+This wrapper exists because `bmad-prd` was the only writer of a primary artifact in this method with no WDI
+wrapper at all — so nothing checked its position, nothing verified its result against the guide, and nothing
+landed its memlog where the next run would read it. Those three gaps were paid for at G2 every time.
+
+You MUST NOT write or edit `prd.md` yourself. If a check fails, name what is missing and re-dispatch.
+
+| Intent | When |
+|---|---|
+| `prd` | A functional area a reader would not think to look for in an existing PRD |
+| `update` | Anything else — the default, and by a wide margin |
+
+## Inputs
+
+| Source | What it answers |
+|---|---|
+| `.what/_product-brief/brief.md` | The problem, the primary user, the boundary the PRD MUST respect |
+| `.what/_prd/*/prd.md` | Which initiatives already have a PRD, and what each already promises |
+| `.control/registry/requirements.yaml` | The next `CAP`/`FR`/`NFR`/`UJ` ids, allocated globally |
+| `.control/decisions/` | `applied` decisions the PRD MUST already reflect |
+| `.constitution/method/document/prd-guide.md` | The rules the result is checked against |
+| `.control/product-glossary.md` | Terms already fixed |
+
+## Step 1 — Position, and `update` is the default
+
+The decision this skill exists for. The test is the **reader**, not the calendar:
+
+> Would someone looking for this promise open an existing document?
+
+Yes → `update`, however large the change. No → `prd`. A PRD MUST NOT be split because it grew long, and a
+release is never a reason on its own. `prd-guide.md` owns the full table.
+
+Three asks that are not this skill:
+
+| Ask | Route |
+|---|---|
+| The problem itself has changed | `wdi-problem` — a re-cut plan under a wrong problem is wasted work |
+| Only the **wording** of an `FR` is wrong, while the promise is the same | The skill already at work fixes it directly. See below |
+| A planning assumption turned out to be void | `wdi-decision`, which wraps `bmad-correct-course` |
+
+## Step 2 — Wording is not a promise
+
+The split that ended three corrections in "reported but not fixed". `prd-guide.md` owns it; what this skill
+owns is refusing to run for the wrong half.
+
+| What changed | Who does it |
+|---|---|
+| A wrong cross-reference, a retired term, a word inconsistent with an `applied` decision — **the promise is the same** | Whichever skill is already at work. Memlog records it; **one** Revision History row per pass, never one per correction |
+| Scope, the proof of done, an `FR` retired or born | This skill, intent `update` |
+
+You MUST NOT accept a wording correction as an `update` run. Doing so puts a trivial fix behind a gate, and
+that is exactly how the three earlier ones were dropped.
+
+## Step 3 — Dispatch
+
+Invoke `bmad-prd` with the detected intent, scoped to **one initiative**. Do not restate the rules to it —
+they arrive through `persistent_facts` and `doc_standards` in `_bmad/custom/bmad-prd.toml`.
+
+Name the brief and, for `update`, the existing PRD and every `applied` decision that reaches it. The skill
+globs its own default locations, which this project redirects.
+
+## Step 4 — Verify
+
+| # | Check | Fails when |
+|---|---|---|
+| 1 | Home | Anything outside `.what/_prd/<initiative>/`, or a folder still named `ISI-slug-inisiatif` |
+| 2 | Ids allocated from the registry | `FR-1` restarted, or an id invented in prose |
+| 3 | Every `FR` names its `capability`; every `NFR` names its `goal` | V15 has nothing to check |
+| 4 | Every `FR` has **exactly one** proof of done, in business language | Zero, or a second technical restatement beside it |
+| 5 | Every `NFR` names `enforced_by` | An `NFR` nothing enforces is decoration (V5) |
+| 6 | Cross-Cutting NFRs and Constraints both present | An absent section reads as "not checked" |
+| 7 | No solution shape | A framework, a table, or a transport named in `prd.md` rather than in `addendum.md` |
+| 8 | One Revision History row for this run, written for someone not in the room | Zero rows, several rows, or a row that says "Updated §4.2" |
+| 9 | Memlog at `.control/memlog/prd-<slug>.md`, slug matching the folder | A `.memlog.md` appeared inside `.what/` — `--workspace` was used |
+| 10 | `bmad-review` ran through `doc_standards` on `prd.md` and `addendum.md` | It did not fire |
+
+Check 9 MUST be fixed immediately rather than reported. V16 rejects a memlog inside the corpus.
+
+## Step 5 — `owns:`, and the collision it prevents
+
+A new or changed `FR` that claims write authority over a domain entity MUST be checked against `owns:` in
+`components.yaml`. An entity has exactly one owning Product Component; an `FR` from another PRD that needs to
+change it MUST point at the owner's `FR` rather than promising to write it itself. V21 checks this, and the
+collision has already happened once for real.
+
+Report a collision. You MUST NOT resolve it by widening one PRD's claim.
+
+## Step 6 — Impact
+
+A changed promise changes what other documents can still claim. Check, and **report** — never edit.
+
+| Found | Where it goes |
+|---|---|
+| A `UC` realising an `FR` whose promise moved | `wdi-component` intent `behaviour`, or `wdi-blueprint` when the catalogue line itself changes |
+| A blueprint inventory row with nothing promising it any more | `wdi-blueprint` |
+| A contradiction with an `applied` decision | `wdi-decision` — a new `DEC-`, never an edit to one already applied |
+| A component born by this initiative | `wdi-init` intent `component` |
+
+Then run the change-control matrix in `delivery-flow-guide.md` and **report** which gates reopen. You MUST
+NOT reopen one yourself.
+
+## Rules
+
+- You MUST NOT write a second PRD for an area that already has one. The reader test decides, and its answer
+  is `update` far more often than it feels.
+- You MUST NOT open G2 on a PRD that has not been through check 10. Gate time is for deciding, not
+  proofreading.
+- The gate reads `prd.md` and `EXPERIENCE.md` together. A PRD that passes while the experience side is
+  missing has answered half of what G2 decides.
+- Every unresolved `[ASSUMPTION]` MUST be filed through `wdi-question` before the gate opens.
+- You MUST NOT raise `status:`. Status is a stage; the `reviewed:` block is an event, and `wdi-review` writes
+  it.
+- When the PRD cannot promise what was asked, say so and stop. Route to `wdi-problem`; do not quietly narrow
+  the ask.
+
+## Output
+
+Intent dispatched · what the promise now is in one line · the result of all ten checks naming the failures ·
+the `owns:` check · impact found and where it was routed · the gates the matrix names · open questions filed.

package/kit/skills/wdi-reconcile/SKILL.md

@@ -40,7 +40,7 @@ in one line before checking, and say what it excluded.
 
 ## Step 2 — Run the validators first
 
-Run `uv run .constitution/scripts/validate.py`, and `uv run .constitution/scripts/inventory.py` when code
+Run `uv run .constitution/method/scripts/validate.py`, and `uv run .constitution/method/scripts/inventory.py` when code
 exists. V1–V24 answer everything that can be **counted**, and you MUST NOT re-derive by reading what they
 already report. Carry their findings as they came, then spend the reading on what no validator can see.
 
@@ -82,7 +82,7 @@ governs it, and the four failures worth looking for are the ones no ID chain rec
 
 You MUST NOT invent a rule to fail an artifact against. Every finding here MUST quote the guide it comes
 from. A file at `status: Draft` MAY be read as guidance but MUST NOT be used to reject anything — that
-holds for all three `codebase/*-guide.md` — and a file at `status: Reference` MUST NOT be cited to reject
+holds for all three `.constitution/project/codebase-*-guide.md` — and a file at `status: Reference` MUST NOT be cited to reject
 anything at all.
 
 ### What the Evidence check is, and what it is not