wdi-method 0.4.5 → 0.4.6
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/README.md +252 -222
- package/bin/wdi-method.js +1030 -1029
- package/kit/.constitution/document/delivery-flow-guide.md +1 -1
- package/kit/.constitution/document/templates/cross-cutting.md +4 -4
- package/kit/.constitution/document/templates/model.md +2 -2
- package/kit/.constitution/document/templates/questions.md +10 -9
- package/kit/.constitution/document/templates/srs.md +2 -2
- package/kit/.constitution/scripts/inventory.py +102 -100
- package/kit/.constitution/scripts/timeline.py +665 -665
- package/kit/.constitution/scripts/validate.py +314 -312
- package/kit/assets/bmad-custom/bmad-advanced-elicitation.toml +15 -15
- package/kit/assets/bmad-custom/bmad-architecture.toml +17 -15
- package/kit/assets/bmad-custom/bmad-build-auto.toml +5 -5
- package/kit/assets/bmad-custom/bmad-build.toml +52 -52
- package/kit/assets/bmad-custom/bmad-code-review.toml +6 -5
- package/kit/assets/bmad-custom/bmad-correct-course.toml +28 -27
- package/kit/assets/bmad-custom/bmad-deep-recon.toml +12 -11
- package/kit/assets/bmad-custom/bmad-prd.toml +22 -22
- package/kit/assets/bmad-custom/bmad-product-brief.toml +34 -34
- package/kit/assets/bmad-custom/bmad-retrospective.toml +9 -9
- package/kit/assets/bmad-custom/bmad-spec.toml +9 -8
- package/kit/assets/bmad-custom/bmad-ux.toml +7 -7
- package/kit/assets/bmad-custom/config.toml +3 -3
- package/kit/skills/wdi-report/SKILL.md +5 -5
- package/package.json +1 -1
- package/scaffold/.control/product-glossary.md +21 -21
- package/scaffold/.control/project-non-technical-log.md +23 -23
- package/scaffold/.control/questions/answered.md +11 -11
- package/scaffold/.control/questions/assumptions.md +15 -15
- package/scaffold/.control/questions/blocking.md +21 -21
- package/scaffold/.control/questions/external.md +11 -11
- package/scaffold/.control/registry/components.yaml +21 -21
- package/scaffold/.control/registry/defects.yaml +3 -3
- package/scaffold/.control/registry/index.yaml +46 -46
- package/scaffold/.control/registry/requirements.yaml +15 -15
- package/scaffold/.control/registry/risks.yaml +5 -5
- package/scaffold/.control/registry/usecases.yaml +6 -6
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
#
|
|
2
|
-
#
|
|
3
|
-
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
6
|
-
#
|
|
7
|
-
|
|
8
|
-
[workflow]
|
|
9
|
-
|
|
10
|
-
preferences = [
|
|
11
|
-
"Honor AGENTS.md
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"Pushback MUST
|
|
15
|
-
]
|
|
1
|
+
# This skill has no `persistent_facts` key, so house rules cannot be injected through the usual
|
|
2
|
+
# path. `preferences` is the equivalent lever: literal sentences a reviewer follows every
|
|
3
|
+
# session.
|
|
4
|
+
#
|
|
5
|
+
# Only a house rule that changes HOW a critique lands belongs here — the full method stays in
|
|
6
|
+
# .constitution/document/delivery-flow-guide.md.
|
|
7
|
+
|
|
8
|
+
[workflow]
|
|
9
|
+
|
|
10
|
+
preferences = [
|
|
11
|
+
"Honor AGENTS.md and .constitution/document/ as the rules currently in force in this repo.",
|
|
12
|
+
"Judge a G1-G4 artifact chiefly by its Decision Summary: one page, business language, no jargon that lacks a Glossary entry. A summary that cannot be read in full within its gate's time budget is the finding itself.",
|
|
13
|
+
"There are only five normative words — MUST, MUST NOT, SHOULD, SHOULD NOT, MAY — in English and uppercase; the surrounding prose follows the product's chosen `doc_language`. Flag as a defect: any other imperative marker in any language, a translated method term, or an invented equivalent for a technical term the industry writes in English.",
|
|
14
|
+
"Pushback MUST name the decision actually at stake and its cost if wrong, not merely grade the writing.",
|
|
15
|
+
]
|
|
@@ -1,8 +1,9 @@
|
|
|
1
|
-
#
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Class A — initiative altitude only.
|
|
2
|
+
# The spine holds the invariants that keep separately built units from diverging.
|
|
3
|
+
# Structure (stack, tree, data shapes) is treated as a seed, not a contract.
|
|
4
4
|
#
|
|
5
|
-
#
|
|
5
|
+
# Order binds: the spine comes first, and bmad-spec reads it as a companion — never the other
|
|
6
|
+
# way round.
|
|
6
7
|
|
|
7
8
|
[workflow]
|
|
8
9
|
|
|
@@ -10,22 +11,23 @@ spine_template = "{project-root}/.constitution/document/templates/architectu
|
|
|
10
11
|
spine_output_path = "{project-root}/.how/_platform"
|
|
11
12
|
run_folder_pattern = "architecture"
|
|
12
13
|
|
|
13
|
-
# architecture-guide.md MUST NOT
|
|
14
|
-
#
|
|
15
|
-
# customize.toml
|
|
14
|
+
# architecture-guide.md MUST NOT be installed as doc_standards, even though that is the usual
|
|
15
|
+
# place for a document guide. This skill deliberately excludes the spine from doc_standards —
|
|
16
|
+
# its own default customize.toml says "never to the spine", and SKILL.md step 5 repeats it:
|
|
16
17
|
# "apply {workflow.doc_standards} polish to that prose only, never to the spine".
|
|
17
|
-
#
|
|
18
|
-
#
|
|
19
|
-
#
|
|
18
|
+
# Installed there, the AD-N rule would only polish the deck and C4 — documents that carry no
|
|
19
|
+
# AD-N — while the spine itself gets written with no guide at all. So it is installed as a
|
|
20
|
+
# persistent fact, held from activation, rather than as end-of-run polish.
|
|
20
21
|
#
|
|
21
|
-
# doc_standards
|
|
22
|
-
#
|
|
22
|
+
# doc_standards is deliberately left empty. BMad's own default
|
|
23
|
+
# `skill:bmad-review lenses=structure,prose` still applies to rendering, and this array appends —
|
|
24
|
+
# emptying it does not remove the default.
|
|
23
25
|
#
|
|
24
|
-
#
|
|
25
|
-
#
|
|
26
|
+
# The consequence is that the spine gets no automatic review. `bmad-review` on it MUST be called
|
|
27
|
+
# manually before G4 — see the "Who calls bmad-review" table in 05-gates.md.
|
|
26
28
|
|
|
27
29
|
persistent_facts = [
|
|
28
30
|
"file:{project-root}/.constitution/document/architecture-guide.md",
|
|
29
31
|
"file:{project-root}/.constitution/document/decision-guide.md",
|
|
30
|
-
"
|
|
32
|
+
"Every memlog.py call MUST use --path {project-root}/.control/memlog/spine.md. --workspace MUST NOT be used.",
|
|
31
33
|
]
|
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
#
|
|
1
|
+
# One loop iteration with no human in it. Dispatched through {spec_folder} + {story_id}.
|
|
2
2
|
|
|
3
3
|
[workflow]
|
|
4
4
|
|
|
5
5
|
persistent_facts = [
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
"
|
|
6
|
+
"This repo runs in stories mode. sprint-status.yaml does not exist and MUST NOT be created.",
|
|
7
|
+
"Test-first discipline binds: a test MUST fail first, and MUST fail for the expected reason.",
|
|
8
|
+
"A worker MUST NOT change anything outside the story it was dispatched. A change it judges necessary beyond that MUST be stated in the final report, never made silently.",
|
|
9
|
+
"When a test or build fails and the cause is not yet known, wdi-systematic-debugging MUST run before any fix is proposed. A third failed fix attempt is the signal to stop and report, not to try a fourth.",
|
|
10
10
|
]
|
|
@@ -1,52 +1,52 @@
|
|
|
1
|
-
# G5 —
|
|
2
|
-
#
|
|
3
|
-
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
6
|
-
#
|
|
7
|
-
#
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
#
|
|
13
|
-
#
|
|
14
|
-
|
|
15
|
-
#
|
|
16
|
-
#
|
|
17
|
-
#
|
|
18
|
-
#
|
|
19
|
-
|
|
20
|
-
implementation_handoff = """
|
|
21
|
-
Launch a subagent with no prior conversation context, with this prompt:
|
|
22
|
-
|
|
23
|
-
> Read {spec_file} fully and implement it — the spec is the sole source of truth. Load every file listed in its frontmatter `context:` before you start.
|
|
24
|
-
>
|
|
25
|
-
> Work test-first, one task at a time:
|
|
26
|
-
>
|
|
27
|
-
> 1. Write the smallest test that expresses the next unmet acceptance criterion.
|
|
28
|
-
> 2. Run it. Confirm it fails, and confirm it fails for the reason you expect — a test that errors on a typo or a missing import has proven nothing.
|
|
29
|
-
> 3. Write the minimum code that makes it pass. No extra scope, no "while I'm here" refactoring.
|
|
30
|
-
> 4. Run the test plus the surrounding suite. Both must be green before you start the next task.
|
|
31
|
-
>
|
|
32
|
-
> If a criterion genuinely cannot be expressed as a test — pure configuration, a docs change, a visual-only tweak — say so explicitly in your report and state how you verified it instead. Never invent a test that asserts nothing in order to satisfy the cycle, and never write the implementation first and the test afterwards to make it look followed.
|
|
33
|
-
>
|
|
34
|
-
> When done, report what you changed, how you verified it, and anything left incomplete or risky. Include the actual command output for the final test run — a claim of green without the output does not count as verification.
|
|
35
|
-
"""
|
|
36
|
-
|
|
37
|
-
persistent_facts = [
|
|
38
|
-
"
|
|
39
|
-
"
|
|
40
|
-
"
|
|
41
|
-
]
|
|
42
|
-
|
|
43
|
-
#
|
|
44
|
-
#
|
|
45
|
-
# - review_layers —
|
|
46
|
-
#
|
|
47
|
-
#
|
|
48
|
-
#
|
|
49
|
-
#
|
|
50
|
-
#
|
|
51
|
-
#
|
|
52
|
-
#
|
|
1
|
+
# G5 — the only executor, dispatched by wdi-build. An executor MUST NOT assemble its own chain.
|
|
2
|
+
#
|
|
3
|
+
# Supplies the test-first discipline bmad-build lacks on its own: it audits tests AFTER
|
|
4
|
+
# implementation (Matrix Test Audit in step-03), but never requires a test to fail first.
|
|
5
|
+
#
|
|
6
|
+
# Merge rule: a string replaces, a list appends, a table merges per key.
|
|
7
|
+
# .claude/skills/bmad-build/customize.toml MUST NOT be edited — it is overwritten on every update.
|
|
8
|
+
|
|
9
|
+
[workflow]
|
|
10
|
+
|
|
11
|
+
# Replaces the default step-03 handoff. Everything the default carries stays (a subagent with no
|
|
12
|
+
# conversation context, the spec as the sole source of truth, loading the files listed in
|
|
13
|
+
# `context:`, a closing report); this override adds the test-first cycle on top.
|
|
14
|
+
|
|
15
|
+
#
|
|
16
|
+
# Deliberately carries METHOD only. Restating the goal, the file list, the acceptance criteria,
|
|
17
|
+
# and house style rules does NOT belong in the dispatch — all of it is already in the spec, and
|
|
18
|
+
# step-03 forbids duplicating it here.
|
|
19
|
+
|
|
20
|
+
implementation_handoff = """
|
|
21
|
+
Launch a subagent with no prior conversation context, with this prompt:
|
|
22
|
+
|
|
23
|
+
> Read {spec_file} fully and implement it — the spec is the sole source of truth. Load every file listed in its frontmatter `context:` before you start.
|
|
24
|
+
>
|
|
25
|
+
> Work test-first, one task at a time:
|
|
26
|
+
>
|
|
27
|
+
> 1. Write the smallest test that expresses the next unmet acceptance criterion.
|
|
28
|
+
> 2. Run it. Confirm it fails, and confirm it fails for the reason you expect — a test that errors on a typo or a missing import has proven nothing.
|
|
29
|
+
> 3. Write the minimum code that makes it pass. No extra scope, no "while I'm here" refactoring.
|
|
30
|
+
> 4. Run the test plus the surrounding suite. Both must be green before you start the next task.
|
|
31
|
+
>
|
|
32
|
+
> If a criterion genuinely cannot be expressed as a test — pure configuration, a docs change, a visual-only tweak — say so explicitly in your report and state how you verified it instead. Never invent a test that asserts nothing in order to satisfy the cycle, and never write the implementation first and the test afterwards to make it look followed.
|
|
33
|
+
>
|
|
34
|
+
> When done, report what you changed, how you verified it, and anything left incomplete or risky. Include the actual command output for the final test run — a claim of green without the output does not count as verification.
|
|
35
|
+
"""
|
|
36
|
+
|
|
37
|
+
persistent_facts = [
|
|
38
|
+
"This repo runs in stories mode. sprint-status.yaml does not exist and MUST NOT be created; story status lives in the story file's own frontmatter.",
|
|
39
|
+
"A Logical Component MUST be registered in components.yaml before the story touching it is worked.",
|
|
40
|
+
"When something breaks and the cause is not yet known, wdi-systematic-debugging MUST run before any fix is proposed.",
|
|
41
|
+
]
|
|
42
|
+
|
|
43
|
+
# Not overridden, and deliberately so:
|
|
44
|
+
#
|
|
45
|
+
# - review_layers — the three default layers (blind-hunter, edge-case-hunter,
|
|
46
|
+
# verification-gap) plus the two-CLI-family Review Panel that bmad-code-review runs afterward
|
|
47
|
+
# already cover this repo's review needs. A fourth layer would spend tokens without closing a
|
|
48
|
+
# gap.
|
|
49
|
+
#
|
|
50
|
+
# - on_complete — updating the registry once a story is done belongs to wdi-build and the skill
|
|
51
|
+
# that owns that layer, not to bmad-build. Putting it here would give one file two writers.
|
|
52
|
+
# The story-closing checklist lives in 05-gates.md.
|
|
@@ -1,12 +1,13 @@
|
|
|
1
|
-
# Review Panel:
|
|
2
|
-
#
|
|
1
|
+
# Review Panel: two reviewers from two different CLI families, and neither may come from the
|
|
2
|
+
# family that ran the implementation.
|
|
3
3
|
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
4
|
+
# WARNING: the adversarial and edge-case lenses here are read from the bundled copy of
|
|
5
|
+
# review-prompts/, NOT from the bmad-review skill. An override on bmad-review will not be visible
|
|
6
|
+
# on this path.
|
|
6
7
|
|
|
7
8
|
[workflow]
|
|
8
9
|
|
|
9
10
|
persistent_facts = [
|
|
10
11
|
"file:{project-root}/.constitution/codebase/conventions-guide.md",
|
|
11
|
-
"
|
|
12
|
+
"A finding that repeats across stories MUST be recorded through bmad-project-context intent record, not fixed silently every time it recurs.",
|
|
12
13
|
]
|
|
@@ -1,27 +1,28 @@
|
|
|
1
|
-
#
|
|
2
|
-
#
|
|
3
|
-
#
|
|
4
|
-
# on_complete.
|
|
5
|
-
# _bmad-output/planning-artifacts/sprint-change-proposal-{date}.md
|
|
6
|
-
# wdi-decision
|
|
7
|
-
# .control/supplements/
|
|
8
|
-
#
|
|
9
|
-
#
|
|
10
|
-
#
|
|
11
|
-
# "direct updates to epics, stories, or PRD sections".
|
|
12
|
-
#
|
|
13
|
-
#
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"file:{project-root}/.constitution/document/
|
|
20
|
-
"
|
|
21
|
-
"
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
1
|
+
# Class B — no path knob at all.
|
|
2
|
+
#
|
|
3
|
+
# bmad-correct-course's own default customize.toml only opens activation_steps, persistent_facts,
|
|
4
|
+
# and on_complete. There is no *_output_path, so its proposal still lands at
|
|
5
|
+
# _bmad-output/planning-artifacts/sprint-change-proposal-{date}.md and MUST be landed again by
|
|
6
|
+
# wdi-decision as a `DEC-` of type course-correction. The `SCP-` code and the
|
|
7
|
+
# .control/supplements/ folder have ALREADY BEEN RETIRED — a course correction is a decision, and
|
|
8
|
+
# there is no second code naming the same thing.
|
|
9
|
+
#
|
|
10
|
+
# The main danger is not the path but this skill's habit of editing directly: its default is
|
|
11
|
+
# "direct updates to epics, stories, or PRD sections". In this repo that MUST NOT happen —
|
|
12
|
+
# document changes go through wdi-decision intent `apply`, and wave content through wdi-build.
|
|
13
|
+
# That is why the prohibition is installed as a persistent fact, held from activation, rather than
|
|
14
|
+
# as end-of-run polish.
|
|
15
|
+
|
|
16
|
+
[workflow]
|
|
17
|
+
|
|
18
|
+
persistent_facts = [
|
|
19
|
+
"file:{project-root}/.constitution/document/delivery-flow-guide.md",
|
|
20
|
+
"file:{project-root}/.constitution/document/corpus-guide.md",
|
|
21
|
+
"This skill MUST NOT write or edit anything in {project-root}/.what/ or {project-root}/.how/. Its output is a proposal; document changes are made by wdi-decision intent `apply` once the `DEC-` is accepted, and wave content by wdi-build.",
|
|
22
|
+
"epics.md and sprint-status.yaml are NOT used in this repo — we run the stories route. Neither MUST be read as a source, and neither MUST be created.",
|
|
23
|
+
"The impact scan MUST cover .what/_prd/, .what/<pc>/, .how/_platform/, .how/<pc>/, SPEC.md, .control/registry/waves.yaml, and the story files. .what/<pc>/ is unknown to this skill entirely, and without this it goes stale silently.",
|
|
24
|
+
"Every plan change that is expensive to reverse MUST become a `DEC-` through wdi-decision, not a paragraph inside the proposal. A course correction is itself one `DEC-` of type course-correction.",
|
|
25
|
+
"A correction that voids more than 30% of a wave's stories MUST NOT be handled as a patch. Say so, and let the wave be re-cut through wdi-build.",
|
|
26
|
+
]
|
|
27
|
+
|
|
28
|
+
on_complete = "Hand the landing to wdi-decision: the whole proposal becomes one `DEC-` of type course-correction, and its run folder MUST NOT be deleted. MUST NOT land itself, MUST NOT edit .what/ or .how/."
|
|
@@ -1,11 +1,12 @@
|
|
|
1
|
-
#
|
|
2
|
-
#
|
|
3
|
-
#
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
"
|
|
10
|
-
"
|
|
11
|
-
|
|
1
|
+
# This skill ships with `persistent_facts = []`, so unlike the other 41 skills it picks up no
|
|
2
|
+
# project context of its own. This file closes that gap; without it, research ahead of G1 runs
|
|
3
|
+
# with no vocabulary and no repo rules, and its output uses terms that don't exist in the
|
|
4
|
+
# Glossary.
|
|
5
|
+
|
|
6
|
+
[workflow]
|
|
7
|
+
|
|
8
|
+
persistent_facts = [
|
|
9
|
+
"file:{project-root}/.control/product-glossary.md",
|
|
10
|
+
"A research report lands in _bmad-output/ and stays there permanently. It MUST NOT be promoted into .what/ and MUST NOT be folded into the brief or a PRD; a `DEC-` or PRD references it by path instead. Its run folder MUST NOT be deleted — intent Update reads it back as original inputs.",
|
|
11
|
+
"A domain term MUST use the Glossary entry as written. A new term surfacing from research MUST be proposed as a Glossary entry, not used silently.",
|
|
12
|
+
]
|
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Class A — writes straight into the corpus.
|
|
2
2
|
#
|
|
3
|
-
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
3
|
+
# One PRD per **initiative / functional area**, not per release. It is a living document:
|
|
4
|
+
# a behaviour change goes through intent Update on the same PRD, never a new one.
|
|
5
|
+
# A release is carried by the registry through target_release, not by the folder name.
|
|
6
6
|
#
|
|
7
|
-
# run_folder_pattern MUST
|
|
8
|
-
#
|
|
9
|
-
# 1. run_folder_pattern ->
|
|
10
|
-
# 2. --path .../prd-<slug>.md ->
|
|
11
|
-
#
|
|
7
|
+
# run_folder_pattern MUST be filled with the initiative slug and MUST NOT use {date}.
|
|
8
|
+
# When a new initiative opens, TWO lines MUST change together:
|
|
9
|
+
# 1. run_folder_pattern -> the next initiative's slug
|
|
10
|
+
# 2. --path .../prd-<slug>.md -> the next initiative's memlog
|
|
11
|
+
# Changing only one produces a new PRD stuck to the old memlog.
|
|
12
12
|
#
|
|
13
|
-
#
|
|
14
|
-
#
|
|
15
|
-
#
|
|
13
|
+
# The default value below is deliberately unusable as-is — it MUST be replaced at runbook
|
|
14
|
+
# step 4. A PRD landing in a folder literally named FILL-initiative-slug is the sign that step
|
|
15
|
+
# was skipped.
|
|
16
16
|
|
|
17
17
|
[workflow]
|
|
18
18
|
|
|
19
19
|
prd_template = "{project-root}/.constitution/document/templates/prd.md"
|
|
20
20
|
prd_output_path = "{project-root}/.what/_prd"
|
|
21
|
-
run_folder_pattern = "
|
|
21
|
+
run_folder_pattern = "FILL-initiative-slug"
|
|
22
22
|
|
|
23
23
|
doc_standards = ["file:{project-root}/.constitution/document/prd-guide.md"]
|
|
24
24
|
|
|
25
|
-
#
|
|
26
|
-
#
|
|
27
|
-
#
|
|
28
|
-
#
|
|
25
|
+
# The facts below deliberately repeat part of prd-guide.md. The reason is timing: doc_standards
|
|
26
|
+
# only activates at the Polish step, while Create-versus-Update intent detection happens at
|
|
27
|
+
# activation. prd-guide.md remains authoritative; where the two disagree, the guide wins and the
|
|
28
|
+
# line here MUST be fixed.
|
|
29
29
|
persistent_facts = [
|
|
30
30
|
"file:{project-root}/.control/registry/requirements.yaml",
|
|
31
31
|
"file:{project-root}/.constitution/document/prd-guide.md",
|
|
32
32
|
|
|
33
|
-
"FR-N, NFR-N, UJ-N,
|
|
33
|
+
"FR-N, NFR-N, UJ-N, and CAP-N MUST be allocated from requirements.yaml and MUST NOT restart from 1. The next initiative's PRD continues the previous PRD's sequence — the sequence is global, one product, one sequence.",
|
|
34
34
|
|
|
35
|
-
"PRD
|
|
35
|
+
"This PRD is a living document. A behaviour change, a closely related feature addition, or a promise correction MUST go through intent Update on the same PRD. A new PRD MUST NOT be created just because the release changed; it is created only when the functional area is genuinely different and reads badly if merged.",
|
|
36
36
|
|
|
37
|
-
"
|
|
37
|
+
"Every intent Update run MUST add exactly one row to the PRD's Revision History table: the date, what changed in language an outside reader understands, and why. That table is for the reader; the memlog is for the audit. Neither MUST substitute for the other.",
|
|
38
38
|
|
|
39
|
-
"
|
|
39
|
+
"A release MUST NOT be stated through the PRD's folder name or its title. It is carried by the target_release field in requirements.yaml and waves.yaml. Naming a release number inside the PRD's prose MAY be done as context, but the registry remains what binds.",
|
|
40
40
|
|
|
41
|
-
"
|
|
41
|
+
"Every memlog.py call — init, append, set, and the read on resume or intent Update — MUST use --path {project-root}/.control/memlog/prd-FILL-initiative-slug.md. The slug MUST match run_folder_pattern above, and both lines MUST change together when the initiative changes. --workspace MUST NOT be used.",
|
|
42
42
|
]
|
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
#
|
|
2
|
-
# Singleton:
|
|
3
|
-
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
6
|
-
|
|
7
|
-
[workflow]
|
|
8
|
-
|
|
9
|
-
brief_template = "{project-root}/.constitution/document/templates/brief.md"
|
|
10
|
-
|
|
11
|
-
# run_folder_pattern MUST
|
|
12
|
-
#
|
|
13
|
-
#
|
|
14
|
-
#
|
|
15
|
-
#
|
|
16
|
-
brief_output_path = "{project-root}/.what"
|
|
17
|
-
run_folder_pattern = "_product-brief"
|
|
18
|
-
|
|
19
|
-
# Append-only
|
|
20
|
-
doc_standards = ["file:{project-root}/.constitution/document/brief-guide.md"]
|
|
21
|
-
|
|
22
|
-
persistent_facts = [
|
|
23
|
-
"
|
|
24
|
-
|
|
25
|
-
"
|
|
26
|
-
|
|
27
|
-
"Goals MUST
|
|
28
|
-
|
|
29
|
-
"
|
|
30
|
-
|
|
31
|
-
"
|
|
32
|
-
|
|
33
|
-
"
|
|
34
|
-
]
|
|
1
|
+
# Class A — writes straight into the corpus.
|
|
2
|
+
# Singleton: one product, one brief, across releases. A second product MUST get its own repo.
|
|
3
|
+
#
|
|
4
|
+
# Called through `wdi-problem`, never directly. The override here decides where the artifact
|
|
5
|
+
# lands; the wrapper skill checks its content.
|
|
6
|
+
|
|
7
|
+
[workflow]
|
|
8
|
+
|
|
9
|
+
brief_template = "{project-root}/.constitution/document/templates/brief.md"
|
|
10
|
+
|
|
11
|
+
# run_folder_pattern MUST be constant — no {project_name}, no {date}.
|
|
12
|
+
# That is what forces the singleton: every run lands in the same folder, so a second run is
|
|
13
|
+
# detected as a resume/update, not a sibling folder.
|
|
14
|
+
# The result is .what/_product-brief/brief.md and .what/_product-brief/addendum.md; both
|
|
15
|
+
# filenames are hardcoded in SKILL.md and cannot be configured.
|
|
16
|
+
brief_output_path = "{project-root}/.what"
|
|
17
|
+
run_folder_pattern = "_product-brief"
|
|
18
|
+
|
|
19
|
+
# Append-only against the default `skill:bmad-review lenses=structure,prose`.
|
|
20
|
+
doc_standards = ["file:{project-root}/.constitution/document/brief-guide.md"]
|
|
21
|
+
|
|
22
|
+
persistent_facts = [
|
|
23
|
+
"Every memlog.py call — init, append, set, and the read on resume or intent Update — MUST use --path {project-root}/.control/memlog/brief.md. --workspace MUST NOT be used; it would place a .memlog.md inside .what/, and no memlog is allowed to live in the corpus.",
|
|
24
|
+
|
|
25
|
+
"The brief template opens with permission to drop a section that does not fit. That permission MUST NOT apply to the eight mandatory sections: The Problem, Who This Serves, Goals, Success Criteria, Scope In, Scope Out, Constraints, Assumptions — plus Prerequisites. Other template sections MAY be dropped.",
|
|
26
|
+
|
|
27
|
+
"Goals MUST be numbered BG-1, BG-2, and so on. They MUST NOT be numbered G1, G2 — G1 through G5 are the names of this method's five gates, and BG is the first link in the BG -> CAP -> FR/NFR -> UC -> Story -> Test traceability chain.",
|
|
28
|
+
|
|
29
|
+
"The Who This Serves table MUST carry exactly one row marked primary, and MUST cover every stakeholder including one who never opens the product.",
|
|
30
|
+
|
|
31
|
+
"The brief MUST NOT carry a Product Component list, and MUST NOT fill product_components or logical_components. The slicing is born at the TAIL of G2 through wdi-init intent `component`, read from the brief plus every PRD.",
|
|
32
|
+
|
|
33
|
+
"Output from research, brainstorming, forge, and PRFAQ MUST stay in _bmad-output/. It MUST NOT be folded into the brief and MUST NOT be promoted into .what/; a `DEC-` or PRD references it by path. That run folder MUST NOT be deleted — intent Update reads it back as original inputs.",
|
|
34
|
+
]
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
#
|
|
2
|
-
# sprint-status.yaml.
|
|
3
|
-
|
|
4
|
-
[workflow]
|
|
5
|
-
|
|
6
|
-
persistent_facts = [
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
]
|
|
1
|
+
# Runs in stories mode: reads SPEC.md + stories.yaml + stories/<id>-*.md, not
|
|
2
|
+
# sprint-status.yaml. Its output is RETROSPECTIVE.md inside the spec folder — which is ephemeral.
|
|
3
|
+
|
|
4
|
+
[workflow]
|
|
5
|
+
|
|
6
|
+
persistent_facts = [
|
|
7
|
+
"This repo runs in stories mode. RETROSPECTIVE.md MUST be archived as RTR-<wave> in .control/reports/ by wdi-build before the wave closes. It is REQUIRED on a wave `L` and advisory on `S` and `M` — V19 is tied to wave size, not to `mode`, and skipping it MUST be stated rather than left silent.",
|
|
8
|
+
"Every row of the distillation table in .constitution/document/bmad-guide.md MUST be complete before a wave is declared closed.",
|
|
9
|
+
]
|
|
@@ -1,15 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Class C — one run per (wave x Product Component), spent once G5 closes.
|
|
2
2
|
#
|
|
3
|
-
#
|
|
4
|
-
#
|
|
5
|
-
#
|
|
6
|
-
#
|
|
3
|
+
# The slug decides whether a spec is ephemeral or lives on: the same slug lands in the same
|
|
4
|
+
# folder and keeps its capability ID. A slug per-PC alone would turn SPEC.md into a living
|
|
5
|
+
# document per PC — a direct rival to the SRS. The slug w<N>-<pc> keeps the spec ephemeral, and
|
|
6
|
+
# CAP-N stays sound because it is allocated from the registry, not from BMad's own internal
|
|
7
|
+
# mechanism.
|
|
7
8
|
|
|
8
9
|
[workflow]
|
|
9
10
|
|
|
10
11
|
persistent_facts = [
|
|
11
|
-
"
|
|
12
|
-
"SPEC.md MUST NOT
|
|
13
|
-
"CAP-N MUST
|
|
12
|
+
"A spec slug MUST take the shape w<N>-<pc>, one run per (wave x Product Component) pair.",
|
|
13
|
+
"SPEC.md MUST NOT carry anything that did not come from the SRS, SDD, or PRD. A new finding MUST be landed in the corpus by the skill that owns that layer — the ownership table in .constitution/document/corpus-guide.md — before the wave closes, never left sitting in the spec.",
|
|
14
|
+
"CAP-N MUST be allocated from {project-root}/.control/registry/requirements.yaml.",
|
|
14
15
|
"file:{project-root}/.control/product-glossary.md",
|
|
15
16
|
]
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Class B — the path is configurable, per-PC granularity is not.
|
|
2
2
|
#
|
|
3
|
-
# bmad-ux
|
|
4
|
-
#
|
|
5
|
-
#
|
|
6
|
-
#
|
|
3
|
+
# bmad-ux only knows {project_name} and {date}, no {slug}, so it cannot land directly into
|
|
4
|
+
# .how/<pc>/. Its landing zone is made NEUTRAL in _bmad-output/ because its output splits across
|
|
5
|
+
# two layers: DESIGN.md belongs to .how/, EXPERIENCE.md belongs to .what/. Landing in either one
|
|
6
|
+
# first would be a layer violation that lives for the length of one run.
|
|
7
7
|
|
|
8
8
|
[workflow]
|
|
9
9
|
|
|
@@ -13,7 +13,7 @@ run_folder_pattern = "ux"
|
|
|
13
13
|
doc_standards = ["file:{project-root}/.constitution/document/ux-guide.md"]
|
|
14
14
|
|
|
15
15
|
persistent_facts = [
|
|
16
|
-
"
|
|
16
|
+
"Every memlog.py call MUST use --path {project-root}/.control/memlog/ux.md. --workspace MUST NOT be used.",
|
|
17
17
|
]
|
|
18
18
|
|
|
19
|
-
on_complete = "
|
|
19
|
+
on_complete = "Hand the landing to wdi-ux: DESIGN.md to .how/<pc>/01-ux/, tokens and base components to .how/_platform/design-system.md, EXPERIENCE.md to .what/<pc>/04-usecases/, every screen registered as an LC ui-screen in components.yaml. MUST NOT land itself."
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Installed at runbook step 1 — MUST come before anything else.
|
|
2
2
|
#
|
|
3
|
-
# bmad-help
|
|
4
|
-
#
|
|
3
|
+
# bmad-help and bmad-correct-course read {project_knowledge}. As long as it points at docs/,
|
|
4
|
+
# both read a folder that has already been dissolved.
|
|
5
5
|
|
|
6
6
|
project_knowledge = "{project-root}/.control"
|