wdi-method 0.4.5 → 0.5.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 (100) hide show
  1. package/README.md +58 -16
  2. package/bin/wdi-method.js +152 -60
  3. package/kit/.constitution/method/README.md +66 -169
  4. package/kit/.constitution/{constitution.md → method/constitution.md} +10 -56
  5. package/kit/.constitution/{document → method/document}/architecture-guide.md +1 -1
  6. package/kit/.constitution/{document → method/document}/corpus-guide.md +2 -2
  7. package/kit/.constitution/{document → method/document}/delivery-flow-guide.md +338 -338
  8. package/kit/.constitution/{document → method/document}/sdd-guide.md +1 -1
  9. package/kit/.constitution/{document → method/document}/templates/cross-cutting.md +5 -5
  10. package/kit/.constitution/{document → method/document}/templates/design-system.md +67 -67
  11. package/kit/.constitution/{document → method/document}/templates/inventory.md +69 -69
  12. package/kit/.constitution/{document → method/document}/templates/model.md +2 -2
  13. package/kit/.constitution/{document → method/document}/templates/questions.md +10 -9
  14. package/kit/.constitution/{document → method/document}/templates/sdd.md +1 -1
  15. package/kit/.constitution/{document → method/document}/templates/srs.md +2 -2
  16. package/kit/.constitution/{document → method/document}/templates/structure-codebase.md +129 -129
  17. package/kit/.constitution/{document → method/document}/templates/structure-document.md +90 -90
  18. package/kit/.constitution/{language-guide.md → method/language-guide.md} +2 -2
  19. package/kit/.constitution/{repo-guide.md → method/repo-guide.md} +16 -3
  20. package/kit/.constitution/{scripts → method/scripts}/inventory.py +102 -100
  21. package/kit/.constitution/{scripts → method/scripts}/timeline.py +665 -665
  22. package/kit/.constitution/{scripts → method/scripts}/validate.py +1599 -1579
  23. package/kit/.constitution/{structure-guide.md → method/structure-guide.md} +3 -3
  24. package/kit/.constitution/method/why/README.md +169 -0
  25. package/kit/.constitution/method/{artifact-map.md → why/artifact-map.md} +5 -5
  26. package/kit/.constitution/method/{rationale.md → why/rationale.md} +5 -5
  27. package/kit/.constitution/project/constitution.md +63 -0
  28. package/kit/assets/bmad-custom/bmad-advanced-elicitation.toml +9 -9
  29. package/kit/assets/bmad-custom/bmad-architecture.toml +33 -31
  30. package/kit/assets/bmad-custom/bmad-build-auto.toml +5 -5
  31. package/kit/assets/bmad-custom/bmad-build.toml +52 -52
  32. package/kit/assets/bmad-custom/bmad-code-review.toml +13 -12
  33. package/kit/assets/bmad-custom/bmad-correct-course.toml +20 -19
  34. package/kit/assets/bmad-custom/bmad-deep-recon.toml +12 -11
  35. package/kit/assets/bmad-custom/bmad-prd.toml +42 -42
  36. package/kit/assets/bmad-custom/bmad-product-brief.toml +18 -18
  37. package/kit/assets/bmad-custom/bmad-retrospective.toml +4 -4
  38. package/kit/assets/bmad-custom/bmad-spec.toml +16 -15
  39. package/kit/assets/bmad-custom/bmad-ux.toml +19 -19
  40. package/kit/assets/bmad-custom/config.toml +3 -3
  41. package/kit/skills/wdi-blueprint/SKILL.md +3 -3
  42. package/kit/skills/wdi-build/SKILL.md +244 -244
  43. package/kit/skills/wdi-component/SKILL.md +1 -1
  44. package/kit/skills/wdi-help/SKILL.md +98 -98
  45. package/kit/skills/wdi-init/SKILL.md +1 -1
  46. package/kit/skills/wdi-problem/SKILL.md +90 -90
  47. package/kit/skills/wdi-product/SKILL.md +127 -127
  48. package/kit/skills/wdi-reconcile/SKILL.md +2 -2
  49. package/kit/skills/wdi-report/SKILL.md +205 -205
  50. package/kit/skills/wdi-systematic-debugging/SKILL.md +193 -193
  51. package/kit/skills/wdi-ux/SKILL.md +145 -145
  52. package/kit-overlay/AGENTS.md +20 -20
  53. package/kit-overlay/README.md +24 -17
  54. package/kit-overlay/constitution.md +10 -56
  55. package/kit-overlay/portability.md +6 -6
  56. package/kit-overlay/repo-guide.md +112 -97
  57. package/package.json +37 -37
  58. package/scaffold/.control/product-glossary.md +21 -21
  59. package/scaffold/.control/project-non-technical-log.md +23 -23
  60. package/scaffold/.control/questions/answered.md +11 -11
  61. package/scaffold/.control/questions/assumptions.md +15 -15
  62. package/scaffold/.control/questions/blocking.md +21 -21
  63. package/scaffold/.control/questions/external.md +11 -11
  64. package/scaffold/.control/registry/components.yaml +21 -21
  65. package/scaffold/.control/registry/defects.yaml +3 -3
  66. package/scaffold/.control/registry/index.yaml +46 -46
  67. package/scaffold/.control/registry/requirements.yaml +15 -15
  68. package/scaffold/.control/registry/risks.yaml +5 -5
  69. package/scaffold/.control/registry/usecases.yaml +6 -6
  70. package/kit/.constitution/README.md +0 -66
  71. /package/kit/.constitution/{document → method/document}/bmad-guide.md +0 -0
  72. /package/kit/.constitution/{document → method/document}/bmad-skill-register.md +0 -0
  73. /package/kit/.constitution/{document → method/document}/brief-guide.md +0 -0
  74. /package/kit/.constitution/{document → method/document}/decision-guide.md +0 -0
  75. /package/kit/.constitution/{document → method/document}/prd-guide.md +0 -0
  76. /package/kit/.constitution/{document → method/document}/srs-guide.md +0 -0
  77. /package/kit/.constitution/{document → method/document}/templates/addendum.md +0 -0
  78. /package/kit/.constitution/{document → method/document}/templates/architecture-spine.md +0 -0
  79. /package/kit/.constitution/{document → method/document}/templates/brief.md +0 -0
  80. /package/kit/.constitution/{document → method/document}/templates/c4.md +0 -0
  81. /package/kit/.constitution/{document → method/document}/templates/contract.md +0 -0
  82. /package/kit/.constitution/{document → method/document}/templates/decision.md +0 -0
  83. /package/kit/.constitution/{document → method/document}/templates/flow.md +0 -0
  84. /package/kit/.constitution/{document → method/document}/templates/integration.md +0 -0
  85. /package/kit/.constitution/{document → method/document}/templates/lc.md +0 -0
  86. /package/kit/.constitution/{document → method/document}/templates/lifecycle.md +0 -0
  87. /package/kit/.constitution/{document → method/document}/templates/meeting.md +0 -0
  88. /package/kit/.constitution/{document → method/document}/templates/oq.md +0 -0
  89. /package/kit/.constitution/{document → method/document}/templates/prd.md +0 -0
  90. /package/kit/.constitution/{document → method/document}/templates/rtr.md +0 -0
  91. /package/kit/.constitution/{document → method/document}/templates/rules.md +0 -0
  92. /package/kit/.constitution/{document → method/document}/templates/scn.md +0 -0
  93. /package/kit/.constitution/{document → method/document}/templates/uc.md +0 -0
  94. /package/kit/.constitution/{document → method/document}/templates/ux.md +0 -0
  95. /package/kit/.constitution/{document → method/document}/ux-guide.md +0 -0
  96. /package/kit/.constitution/{method-glossary.md → method/method-glossary.md} +0 -0
  97. /package/kit/.constitution/method/{portability.md → why/portability.md} +0 -0
  98. /package/kit/.constitution/{codebase/brownfield-guide.md → project/codebase-brownfield-guide.md} +0 -0
  99. /package/kit/.constitution/{codebase/conventions-guide.md → project/codebase-conventions-guide.md} +0 -0
  100. /package/kit/.constitution/{codebase/stack-guide.md → project/codebase-stack-guide.md} +0 -0
@@ -1,27 +1,28 @@
1
- # Kelas B — tidak ada knob path sama sekali.
1
+ # Class B — no path knob at all.
2
2
  #
3
- # customize.toml bawaan bmad-correct-course hanya membuka activation_steps, persistent_facts, dan
4
- # on_complete. Tidak ada *_output_path, jadi proposalnya tetap mendarat di
5
- # _bmad-output/planning-artifacts/sprint-change-proposal-{date}.md dan MUST didaratkan ulang oleh
6
- # wdi-decision sebagai `DEC-` bertipe course-correction. Kode `SCP-` dan folder
7
- # .control/supplements/ SUDAH DICABUT koreksi arah adalah keputusan, dan tidak ada kode kedua yang
8
- # menamai hal yang sama.
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
9
  #
10
- # Bahaya utamanya bukan path, melainkan kebiasaan skill ini menyunting langsung: default-nya
11
- # "direct updates to epics, stories, or PRD sections". Di repo ini itu MUST NOT terjadi perubahan
12
- # dokumen lewat wdi-decision intent `apply`, isi wave lewat wdi-build. Karena itu larangannya
13
- # dipasang sebagai persistent_facts, yang dipegang sejak aktivasi, bukan sebagai poles di akhir.
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.
14
15
 
15
16
  [workflow]
16
17
 
17
18
  persistent_facts = [
18
- "file:{project-root}/.constitution/document/delivery-flow-guide.md",
19
- "file:{project-root}/.constitution/document/corpus-guide.md",
20
- "Skill ini MUST NOT menulis atau menyunting apa pun di {project-root}/.what/ maupun {project-root}/.how/. Keluarannya adalah proposal; perubahan dokumen dikerjakan wdi-decision intent `apply` setelah `DEC-`-nya accepted, dan isi wave oleh wdi-build.",
21
- "epics.md dan sprint-status.yaml TIDAK dipakai di repo ini kita menjalankan stories route. Keduanya MUST NOT dibaca sebagai sumber, dan MUST NOT dibuat.",
22
- "Pemindaian impak MUST mencakup .what/_prd/, .what/<pc>/, .how/_platform/, .how/<pc>/, SPEC.md, .control/registry/waves.yaml, dan berkas story. .what/<pc>/ tidak dikenal skill ini sama sekali dan tanpa ini akan basi diam-diam.",
23
- "Setiap perubahan rencana yang mahal dibalik MUST menjadi `DEC-` lewat wdi-decision, bukan paragraf di dalam proposal. Koreksi arah sendiri adalah satu `DEC-` bertipe course-correction.",
24
- "Sebuah koreksi yang membatalkan lebih dari 30% story sebuah wave MUST NOT ditangani sebagai tambalan. Katakan begitu, dan biarkan wave-nya dipotong ulang lewat wdi-build.",
19
+ "file:{project-root}/.constitution/method/document/delivery-flow-guide.md",
20
+ "file:{project-root}/.constitution/method/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.",
25
26
  ]
26
27
 
27
- on_complete = "Serahkan pendaratan ke wdi-decision: seluruh proposal jadi satu `DEC-` bertipe course-correction, dan folder run-nya MUST NOT dihapus. MUST NOT menempatkan sendiri, MUST NOT menyunting .what/ atau .how/."
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
- # Skill ini dikirim dengan `persistent_facts = []`, jadi tidak seperti 41 skill lain ia tidak
2
- # memungut konteks proyek sendiri. Berkas ini menutup celah itu; tanpanya riset menjelang G1 berjalan
3
- # tanpa kosakata dan aturan repo, dan hasilnya memakai istilah yang tidak ada di Glossary.
4
-
5
- [workflow]
6
-
7
- persistent_facts = [
8
- "file:{project-root}/.control/product-glossary.md",
9
- "Laporan riset mendarat di _bmad-output/ dan tinggal di sana selamanya. Ia MUST NOT dipromosikan ke .what/ dan MUST NOT dilebur ke brief maupun PRD; `DEC-` dan PRD merujuknya lewat path. Folder run-nya MUST NOT dihapus — intent Update membacanya kembali sebagai original inputs.",
10
- "Istilah domain MUST memakai entri Glossary apa adanya. Istilah baru yang muncul dari riset MUST diusulkan sebagai entri Glossary, bukan dipakai diam-diam.",
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
- # Kelas A — menulis langsung ke korpus.
2
- #
3
- # Satu PRD per **inisiatif / area fungsi**, bukan per rilis. Ia living document:
4
- # perubahan perilaku masuk lewat intent Update ke PRD yang sama, bukan PRD baru.
5
- # Rilis dibawa registry lewat target_release, bukan oleh nama folder.
6
- #
7
- # run_folder_pattern MUST diisi slug inisiatif dan MUST NOT memakai {date}.
8
- # Saat inisiatif baru dibuka, DUA baris MUST diubah bersamaan:
9
- # 1. run_folder_pattern -> slug inisiatif berikutnya
10
- # 2. --path .../prd-<slug>.md -> memlog inisiatif berikutnya
11
- # Mengubah salah satu saja menghasilkan PRD baru yang menempel pada memlog lama.
12
- #
13
- # Nilai bawaan di bawah sengaja tidak bisa dipakai apa adanya ia MUST diganti
14
- # di langkah 4 runbook. PRD yang mendarat di folder bernama ISI-slug-inisiatif
15
- # adalah tanda langkah itu terlewat.
16
-
17
- [workflow]
18
-
19
- prd_template = "{project-root}/.constitution/document/templates/prd.md"
20
- prd_output_path = "{project-root}/.what/_prd"
21
- run_folder_pattern = "ISI-slug-inisiatif"
22
-
23
- doc_standards = ["file:{project-root}/.constitution/document/prd-guide.md"]
24
-
25
- # Fakta di bawah sengaja mengulang sebagian prd-guide.md. Sebabnya waktu: doc_standards baru
26
- # menyala di langkah Polish, sedangkan deteksi intent Create-versus-Update terjadi di aktivasi.
27
- # Yang otoritatif tetap prd-guide.md; kalau keduanya berselisih, guide yang menang dan baris di
28
- # sini MUST diperbaiki.
29
- persistent_facts = [
30
- "file:{project-root}/.control/registry/requirements.yaml",
31
- "file:{project-root}/.constitution/document/prd-guide.md",
32
-
33
- "FR-N, NFR-N, UJ-N, dan CAP-N MUST dialokasikan dari requirements.yaml dan MUST NOT dimulai ulang dari 1. PRD inisiatif berikutnya melanjutkan deret PRD sebelumnyaderetnya global, satu produk satu deret.",
34
-
35
- "PRD ini living document. Perubahan perilaku, penambahan fitur yang erat kaitannya, maupun koreksi janji MUST masuk lewat intent Update ke PRD yang sama. PRD baru MUST NOT dibuat hanya karena rilisnya berganti; ia dibuat hanya saat area fungsinya benar-benar berbeda dan tidak enak dibaca kalau digabung.",
36
-
37
- "Tiap run intent Update MUST menambah tepat satu baris di tabel Revision History PRD: tanggal, apa yang berubah dalam bahasa pembaca luar, dan sebabnya. Tabel itu untuk pembaca; memlog untuk audit. Keduanya MUST NOT saling menggantikan.",
38
-
39
- "Rilis MUST NOT dinyatakan lewat nama folder PRD maupun judulnya. Ia dibawa field target_release di requirements.yaml dan waves.yaml. Menyebut nomor rilis di dalam prosa PRD MAY dilakukan sebagai konteks, tetapi yang mengikat tetap registry.",
40
-
41
- "Seluruh panggilan memlog.py — init, append, set, dan pembacaan saat resume atau intent Update — MUST memakai --path {project-root}/.control/memlog/prd-ISI-slug-inisiatif.md. Slug-nya MUST sama dengan run_folder_pattern di atas, dan kedua baris MUST diubah bersamaan saat inisiatif berganti. --workspace MUST NOT dipakai.",
42
- ]
1
+ # Class A — writes straight into the corpus.
2
+ #
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
+ #
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
+ #
13
+ # The default value below is deliberately unusable as-isit 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
+
17
+ [workflow]
18
+
19
+ prd_template = "{project-root}/.constitution/method/document/templates/prd.md"
20
+ prd_output_path = "{project-root}/.what/_prd"
21
+ run_folder_pattern = "FILL-initiative-slug"
22
+
23
+ doc_standards = ["file:{project-root}/.constitution/method/document/prd-guide.md"]
24
+
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
+ persistent_facts = [
30
+ "file:{project-root}/.control/registry/requirements.yaml",
31
+ "file:{project-root}/.constitution/method/document/prd-guide.md",
32
+
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 sequencethe sequence is global, one product, one sequence.",
34
+
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
+
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
+
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
+
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
+ ]
@@ -1,34 +1,34 @@
1
- # Kelas A — menulis langsung ke korpus.
2
- # Singleton: satu produk, satu brief, lintas rilis. Produk kedua MUST dapat repo sendiri.
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
3
  #
4
- # Dipanggil lewat `wdi-problem`, bukan langsung. Override di sini yang menentukan
5
- # ke mana artefaknya mendarat; skill wrapper yang memeriksa isinya.
4
+ # Called through `wdi-problem`, never directly. The override here decides where the artifact
5
+ # lands; the wrapper skill checks its content.
6
6
 
7
7
  [workflow]
8
8
 
9
- brief_template = "{project-root}/.constitution/document/templates/brief.md"
9
+ brief_template = "{project-root}/.constitution/method/document/templates/brief.md"
10
10
 
11
- # run_folder_pattern MUST konstantanpa {project_name} dan tanpa {date}.
12
- # Itu yang memaksa singleton: tiap run jatuh ke folder yang sama, jadi run kedua
13
- # terdeteksi sebagai resume/update, bukan folder sebelah.
14
- # Hasilnya .what/_product-brief/brief.md dan .what/_product-brief/addendum.md;
15
- # kedua nama berkas itu di-hardcode di SKILL.md dan tidak bisa diatur.
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
16
  brief_output_path = "{project-root}/.what"
17
17
  run_folder_pattern = "_product-brief"
18
18
 
19
- # Append-only terhadap default `skill:bmad-review lenses=structure,prose`.
20
- doc_standards = ["file:{project-root}/.constitution/document/brief-guide.md"]
19
+ # Append-only against the default `skill:bmad-review lenses=structure,prose`.
20
+ doc_standards = ["file:{project-root}/.constitution/method/document/brief-guide.md"]
21
21
 
22
22
  persistent_facts = [
23
- "Seluruh panggilan memlog.py — init, append, set, dan pembacaan saat resume atau intent Update — MUST memakai --path {project-root}/.control/memlog/brief.md. --workspace MUST NOT dipakai; ia akan menaruh .memlog.md di dalam .what/, dan tidak ada memlog yang boleh tinggal di korpus.",
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
24
 
25
- "Template brief membuka dengan izin membuang section yang tidak layak. Izin itu MUST NOT diterapkan pada delapan section wajib: The Problem, Who This Serves, Goals, Success Criteria, Scope In, Scope Out, Constraints, Assumptions — beserta Prerequisites. Section template lain MAY dibuang.",
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
26
 
27
- "Goals MUST bernomor BG-1, BG-2, dan seterusnya. MUST NOT bernomor G1, G2 — G1 sampai G5 adalah nama lima gate di metode ini, dan BG adalah mata rantai pertama rantai traceability BG -> CAP -> FR/NFR -> UC -> Story -> Test.",
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
28
 
29
- "Tabel Who This Serves MUST memuat tepat satu baris bertanda primary, dan MUST memuat seluruh stakeholder termasuk yang tidak pernah membuka produknya.",
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
30
 
31
- "Brief MUST NOT memuat daftar Product Component dan MUST NOT mengisi product_components maupun logical_components. Slicing lahir di EKOR G2 lewat wdi-init intent `component`, dibaca dari brief plus seluruh PRD.",
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
32
 
33
- "Keluaran riset, brainstorming, forge, dan PRFAQ MUST tetap di _bmad-output/. Ia MUST NOT dilebur ke dalam brief dan MUST NOT dipromosikan ke .what/; `DEC-` atau PRD merujuknya lewat path. Folder run itu MUST NOT dihapus — intent Update membacanya kembali sebagai original inputs.",
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
34
  ]
@@ -1,9 +1,9 @@
1
- # Berjalan di stories mode: membaca SPEC.md + stories.yaml + stories/<id>-*.md, bukan
2
- # sprint-status.yaml. Keluarannya RETROSPECTIVE.md di dalam folder spec yang fana.
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
3
 
4
4
  [workflow]
5
5
 
6
6
  persistent_facts = [
7
- "Repo ini berjalan di stories mode. RETROSPECTIVE.md MUST diarsipkan jadi RTR-<wave> di .control/reports/ oleh wdi-build sebelum wave ditutup. Ia WAJIB pada wave `L` dan advisory pada `S` dan `M` — V19 diikatkan ke ukuran wave, bukan ke `mode`, dan melewatinya MUST dinyatakan alih-alih didiamkan.",
8
- "Seluruh baris tabel distilasi di .constitution/document/bmad-guide.md MUST tuntas sebelum wave dinyatakan tertutup.",
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/method/document/bmad-guide.md MUST be complete before a wave is declared closed.",
9
9
  ]
@@ -1,15 +1,16 @@
1
- # Kelas C — satu run per (wave x Product Component), habis setelah G5.
2
- #
3
- # Slug menentukan apakah spec fana atau hidup: slug yang sama mendarat di folder yang sama dan
4
- # mempertahankan capability ID. Slug per-PC saja akan membuat SPEC.md jadi dokumen hidup per PC —
5
- # saingan langsung SRS. Slug w<N>-<pc> menjaga spec tetap fana, dan CAP-N tetap terjaga karena
6
- # dialokasikan dari registry, bukan dari mekanisme internal BMad.
7
-
8
- [workflow]
9
-
10
- persistent_facts = [
11
- "Slug spec MUST berbentuk w<N>-<pc>, satu run per pasangan wave x Product Component.",
12
- "SPEC.md MUST NOT memuat apa pun yang tidak berasal dari SRS, SDD, atau PRD. Temuan baru MUST didaratkan ke korpus oleh skill pemilik lapisannya — tabel kepemilikan di .constitution/document/corpus-guide.md — sebelum wave ditutup, bukan dibiarkan tinggal di spec.",
13
- "CAP-N MUST dialokasikan dari {project-root}/.control/registry/requirements.yaml.",
14
- "file:{project-root}/.control/product-glossary.md",
15
- ]
1
+ # Class C — one run per (wave x Product Component), spent once G5 closes.
2
+ #
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.
8
+
9
+ [workflow]
10
+
11
+ persistent_facts = [
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/method/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.",
15
+ "file:{project-root}/.control/product-glossary.md",
16
+ ]
@@ -1,19 +1,19 @@
1
- # Kelas B — path bisa dikonfigurasi, granularitas per-PC tidak.
2
- #
3
- # bmad-ux hanya mengenal {project_name} dan {date}, tidak ada {slug}, jadi ia tidak bisa mendarat
4
- # sendiri ke .how/<pc>/. Landing zone-nya dibuat NETRAL di _bmad-output/ karena keluarannya
5
- # membelah dua lapisan: DESIGN.md milik .how/, EXPERIENCE.md milik .what/. Mendarat lebih dulu di
6
- # salah satunya adalah pelanggaran lapisan yang hidup selama satu run.
7
-
8
- [workflow]
9
-
10
- ux_output_path = "{project-root}/_bmad-output/ux"
11
- run_folder_pattern = "ux"
12
-
13
- doc_standards = ["file:{project-root}/.constitution/document/ux-guide.md"]
14
-
15
- persistent_facts = [
16
- "Seluruh panggilan memlog.py MUST memakai --path {project-root}/.control/memlog/ux.md. --workspace MUST NOT dipakai.",
17
- ]
18
-
19
- on_complete = "Serahkan pendaratan ke wdi-ux: DESIGN.md ke .how/<pc>/01-ux/, token dan komponen dasar ke .how/_platform/design-system.md, EXPERIENCE.md ke .what/<pc>/04-usecases/, tiap layar didaftarkan sebagai LC ui-screen di components.yaml. MUST NOT menempatkan sendiri."
1
+ # Class B — the path is configurable, per-PC granularity is not.
2
+ #
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
+
8
+ [workflow]
9
+
10
+ ux_output_path = "{project-root}/_bmad-output/ux"
11
+ run_folder_pattern = "ux"
12
+
13
+ doc_standards = ["file:{project-root}/.constitution/method/document/ux-guide.md"]
14
+
15
+ persistent_facts = [
16
+ "Every memlog.py call MUST use --path {project-root}/.control/memlog/ux.md. --workspace MUST NOT be used.",
17
+ ]
18
+
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
- # Dipasang di langkah 1 runbook — MUST lebih dulu dari yang lain.
1
+ # Installed at runbook step 1 — MUST come before anything else.
2
2
  #
3
- # bmad-help dan bmad-correct-course membaca {project_knowledge}. Selama ia menunjuk docs/,
4
- # keduanya membaca folder yang sudah dibubarkan.
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"
@@ -32,7 +32,7 @@ of that is `wdi-component` at G4. You MUST NOT write a promise; when the bluepri
32
32
  | `.control/product-glossary.md` | Terms already fixed |
33
33
  | `.control/decisions/` | `accepted` and `applied` decisions an `AD-N` usually sits behind |
34
34
  | `src/` · `web/` | What actually runs, when this is not a new project |
35
- | `.constitution/document/srs-guide.md` · `architecture-guide.md` | The rules the result is checked against |
35
+ | `.constitution/method/document/srs-guide.md` · `architecture-guide.md` | The rules the result is checked against |
36
36
 
37
37
  ## Step 1 — Position
38
38
 
@@ -65,7 +65,7 @@ whose nouns nobody defined.
65
65
  the count passes a third of a component's use cases, derive it again — `delivery-flow-guide.md` owns the rule
66
66
  and it MUST NOT be negotiated.
67
67
 
68
- **A method term MUST NOT be written into `.constitution/method-glossary.md`.** A product term binds one
68
+ **A method term MUST NOT be written into `.constitution/method/method-glossary.md`.** A product term binds one
69
69
  project; a method term binds every project the method is installed in. Raise it as a proposal, state where it
70
70
  appeared and why the existing vocabulary does not cover it, and hand it to the owner.
71
71
 
@@ -152,7 +152,7 @@ copy inside any SDD.
152
152
  | State | How each is born |
153
153
  |---|---|
154
154
  | No code yet | Written as a **plan** — the tables, endpoints, and screens intended. Nothing can be derived, because there is no source |
155
- | Code exists | **Derived first** by `.constitution/scripts/inventory.py` — migrations for tables, route registration for endpoints, pages for screens — then compared with the plan. The difference is a **finding**, not hand work |
155
+ | Code exists | **Derived first** by `.constitution/method/scripts/inventory.py` — migrations for tables, route registration for endpoints, pages for screens — then compared with the plan. The difference is a **finding**, not hand work |
156
156
 
157
157
  An inventory MUST NOT be assembled from a README or from route names that look plausible. Numbers are stable:
158
158
  a new row takes the next number, never a renumber.