bmad-plus 0.12.2 → 0.14.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 (127) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +96 -461
  3. package/package.json +12 -5
  4. package/readme-international/README.de.md +42 -9
  5. package/readme-international/README.es.md +43 -10
  6. package/readme-international/README.fr.md +42 -9
  7. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +5 -3
  8. package/src/bmad-plus/module.yaml +270 -220
  9. package/src/bmad-plus/packs/pack-dev-studio/README.md +133 -141
  10. package/src/bmad-plus/packs/pack-dev-studio/SKILL.md +49 -0
  11. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +35 -60
  12. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +59 -59
  13. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +55 -93
  14. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +58 -93
  15. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +55 -132
  16. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +63 -78
  17. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +54 -69
  18. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +54 -93
  19. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +32 -60
  20. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +67 -71
  21. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +61 -90
  22. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +56 -78
  23. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +55 -88
  24. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +20 -153
  25. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +20 -173
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +14 -220
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +20 -329
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +15 -314
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +15 -355
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +15 -375
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +14 -357
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +13 -78
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +52 -65
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +14 -81
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +14 -31
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +14 -45
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +13 -128
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +61 -87
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +55 -298
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +52 -426
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +48 -69
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +22 -80
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +60 -482
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +50 -184
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +57 -173
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +56 -108
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +54 -1509
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +54 -296
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +41 -283
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +58 -18
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +103 -72
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +55 -27
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +34 -60
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +46 -87
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/steps/step-01-init.md +10 -0
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +30 -60
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +57 -27
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +47 -138
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +48 -34
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +51 -68
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +46 -3
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +68 -109
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +53 -174
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +39 -53
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +45 -83
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +45 -176
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +45 -63
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +53 -124
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +44 -100
  70. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +56 -116
  71. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +49 -12
  72. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +51 -328
  73. package/src/bmad-plus/packs/pack-dev-studio/shared/catalog.json +489 -0
  74. package/src/bmad-plus/packs/pack-dev-studio/shared/execution.md +69 -0
  75. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +39 -32
  76. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +85 -14
  77. package/src/bmad-plus/packs/pack-memory/README.md +6 -0
  78. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +12 -5
  79. package/src/bmad-plus/packs/pack-seo/SKILL.md +27 -1
  80. package/src/bmad-plus/packs/pack-seo/scripts/seo_apis.py +8 -8
  81. package/src/bmad-plus/packs/pack-seo/scripts/seo_fetch.py +1 -2
  82. package/src/bmad-plus/packs/pack-seo/scripts/seo_report.py +0 -1
  83. package/src/bmad-plus/packs/pack-seo/seo-chief.md +16 -1
  84. package/src/bmad-plus/packs/pack-seo/seo-judge.md +12 -0
  85. package/src/bmad-plus/packs/pack-seo/seo-scout.md +12 -0
  86. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +4 -4
  87. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +5 -3
  88. package/src/bmad-plus/skills/dev-studio/SKILL.md +19 -0
  89. package/tools/bmad-plus-npx.js +4 -2
  90. package/tools/build/adapters.config.js +60 -51
  91. package/tools/build/check-counts.js +52 -54
  92. package/tools/build/check-install-contract.js +450 -0
  93. package/tools/build/generate-adapters.js +252 -56
  94. package/tools/build/generate.js +364 -14
  95. package/tools/build/generated-adapters/.codex/AGENTS.md +20 -7
  96. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +20 -7
  97. package/tools/build/generated-adapters/.opencode/AGENTS.md +20 -7
  98. package/tools/build/generated-adapters/AGENTS.md +20 -7
  99. package/tools/build/generated-adapters/CLAUDE.md +20 -7
  100. package/tools/build/generated-adapters/CONVENTIONS.md +20 -7
  101. package/tools/build/generated-adapters/GEMINI.md +20 -7
  102. package/tools/build/module.template.yaml +82 -0
  103. package/tools/build/pack-delivery.js +78 -0
  104. package/tools/cli/bmad-plus-cli.js +16 -1
  105. package/tools/cli/commands/doctor.js +49 -217
  106. package/tools/cli/commands/install.js +109 -164
  107. package/tools/cli/commands/studio.js +68 -0
  108. package/tools/cli/commands/uninstall.js +173 -65
  109. package/tools/cli/commands/update-check.js +31 -0
  110. package/tools/cli/commands/update-policy.js +39 -0
  111. package/tools/cli/commands/update.js +102 -113
  112. package/tools/cli/i18n.js +60 -0
  113. package/tools/cli/lib/ide-config.js +4 -261
  114. package/tools/cli/lib/install-manifest.js +17 -0
  115. package/tools/cli/lib/installation-health.js +360 -0
  116. package/tools/cli/lib/installed-adapters.js +89 -0
  117. package/tools/cli/lib/npm-runner.js +177 -0
  118. package/tools/cli/lib/pack-copy.js +62 -66
  119. package/tools/cli/lib/packs.js +546 -3
  120. package/tools/cli/lib/python-health.js +233 -0
  121. package/tools/cli/lib/python-provision.js +2 -2
  122. package/tools/cli/lib/studio.js +310 -0
  123. package/tools/cli/lib/update-check.js +153 -0
  124. package/tools/cli/lib/update-dispatch.js +182 -0
  125. package/tools/cli/lib/update-policy.js +90 -0
  126. package/tools/cli/lib/update-transaction.js +334 -0
  127. package/tools/release/publication-content.js +901 -0
@@ -28,16 +28,21 @@ To activate an agent, say its name or persona:
28
28
  - **Forge** (Architect-Dev) — Architecture + Development + Documentation
29
29
  - **Sentinel** (Quality) — QA + UX review
30
30
  - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
31
- - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
32
- - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
33
- - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
31
+ - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
32
+ - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
33
+ - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
34
+ - **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
35
+ - **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
36
+ - **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
37
+ - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
34
38
  - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
35
39
  - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
36
40
  - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
37
41
  - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
38
42
  - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
39
43
  - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
40
- - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
44
+ - **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
45
+ - **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
41
46
 
42
47
  ## Skills
43
48
 
@@ -98,19 +103,27 @@ Agents MUST follow these behavioral principles:
98
103
  - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
99
104
  - `.agents/memory/context.md` — Update at session end with project state
100
105
 
106
+ ## Framework updates
107
+
108
+ Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
109
+ If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
110
+ When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
111
+ When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
112
+ After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
113
+
101
114
  ## Registry facts (computed from registry.yaml — never hand-typed)
102
115
 
103
- - Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
116
+ - Product: BMAD+ v0.14.0 (derived from BMAD-METHOD v6.6.0)
104
117
  - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
105
118
  - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
106
119
  - Installer agents (14 across all packs):
107
120
  - Core (required): 4 installer agents — Core agents & skills
108
121
  - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
109
122
  - Maker: 1 installer agent — Agent creation toolkit
110
- - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
123
+ - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
111
124
  - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
112
125
  - Memory: 1 installer agent — Persistent cross-session memory
113
- - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
126
+ - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
114
127
  - Backup: 1 installer agent — Backup & restore
115
128
  - Animated: 1 installer agent — Animated website agents
116
129
 
@@ -26,16 +26,21 @@ To activate an agent, say its name or persona:
26
26
  - **Forge** (Architect-Dev) — Architecture + Development + Documentation
27
27
  - **Sentinel** (Quality) — QA + UX review
28
28
  - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
29
- - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
30
- - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
31
- - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
29
+ - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
30
+ - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
31
+ - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
32
+ - **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
33
+ - **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
34
+ - **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
35
+ - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
32
36
  - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
33
37
  - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
34
38
  - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
35
39
  - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
36
40
  - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
37
41
  - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
38
- - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
42
+ - **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
43
+ - **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
39
44
 
40
45
  ## Skills
41
46
 
@@ -96,19 +101,27 @@ Agents MUST follow these behavioral principles:
96
101
  - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
97
102
  - `.agents/memory/context.md` — Update at session end with project state
98
103
 
104
+ ## Framework updates
105
+
106
+ Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
107
+ If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
108
+ When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
109
+ When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
110
+ After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
111
+
99
112
  ## Registry facts (computed from registry.yaml — never hand-typed)
100
113
 
101
- - Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
114
+ - Product: BMAD+ v0.14.0 (derived from BMAD-METHOD v6.6.0)
102
115
  - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
103
116
  - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
104
117
  - Installer agents (14 across all packs):
105
118
  - Core (required): 4 installer agents — Core agents & skills
106
119
  - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
107
120
  - Maker: 1 installer agent — Agent creation toolkit
108
- - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
121
+ - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
109
122
  - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
110
123
  - Memory: 1 installer agent — Persistent cross-session memory
111
- - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
124
+ - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
112
125
  - Backup: 1 installer agent — Backup & restore
113
126
  - Animated: 1 installer agent — Animated website agents
114
127
 
@@ -29,16 +29,21 @@ To activate an agent, say its name or persona:
29
29
  - **Forge** (Architect-Dev) — Architecture + Development + Documentation
30
30
  - **Sentinel** (Quality) — QA + UX review
31
31
  - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
32
- - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
33
- - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
34
- - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
32
+ - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
33
+ - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
34
+ - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
35
+ - **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
36
+ - **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
37
+ - **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
38
+ - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
35
39
  - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
36
40
  - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
37
41
  - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
38
42
  - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
39
43
  - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
40
44
  - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
41
- - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
45
+ - **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
46
+ - **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
42
47
 
43
48
  ## Skills
44
49
 
@@ -99,19 +104,27 @@ Agents MUST follow these behavioral principles:
99
104
  - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
100
105
  - `.agents/memory/context.md` — Update at session end with project state
101
106
 
107
+ ## Framework updates
108
+
109
+ Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
110
+ If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
111
+ When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
112
+ When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
113
+ After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
114
+
102
115
  ## Registry facts (computed from registry.yaml — never hand-typed)
103
116
 
104
- - Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
117
+ - Product: BMAD+ v0.14.0 (derived from BMAD-METHOD v6.6.0)
105
118
  - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
106
119
  - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
107
120
  - Installer agents (14 across all packs):
108
121
  - Core (required): 4 installer agents — Core agents & skills
109
122
  - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
110
123
  - Maker: 1 installer agent — Agent creation toolkit
111
- - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
124
+ - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
112
125
  - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
113
126
  - Memory: 1 installer agent — Persistent cross-session memory
114
- - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
127
+ - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
115
128
  - Backup: 1 installer agent — Backup & restore
116
129
  - Animated: 1 installer agent — Animated website agents
117
130
 
@@ -28,16 +28,21 @@ To activate an agent, say its name or persona:
28
28
  - **Forge** (Architect-Dev) — Architecture + Development + Documentation
29
29
  - **Sentinel** (Quality) — QA + UX review
30
30
  - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
31
- - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
32
- - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
33
- - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
31
+ - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
32
+ - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
33
+ - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
34
+ - **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
35
+ - **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
36
+ - **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
37
+ - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
34
38
  - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
35
39
  - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
36
40
  - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
37
41
  - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
38
42
  - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
39
43
  - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
40
- - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
44
+ - **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
45
+ - **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
41
46
 
42
47
  ## Skills
43
48
 
@@ -98,19 +103,27 @@ Agents MUST follow these behavioral principles:
98
103
  - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
99
104
  - `.agents/memory/context.md` — Update at session end with project state
100
105
 
106
+ ## Framework updates
107
+
108
+ Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
109
+ If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
110
+ When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
111
+ When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
112
+ After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
113
+
101
114
  ## Registry facts (computed from registry.yaml — never hand-typed)
102
115
 
103
- - Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
116
+ - Product: BMAD+ v0.14.0 (derived from BMAD-METHOD v6.6.0)
104
117
  - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
105
118
  - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
106
119
  - Installer agents (14 across all packs):
107
120
  - Core (required): 4 installer agents — Core agents & skills
108
121
  - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
109
122
  - Maker: 1 installer agent — Agent creation toolkit
110
- - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
123
+ - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
111
124
  - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
112
125
  - Memory: 1 installer agent — Persistent cross-session memory
113
- - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
126
+ - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
114
127
  - Backup: 1 installer agent — Backup & restore
115
128
  - Animated: 1 installer agent — Animated website agents
116
129
 
@@ -33,16 +33,21 @@ To activate an agent, say its name or persona:
33
33
  - **Forge** (Architect-Dev) — Architecture + Development + Documentation
34
34
  - **Sentinel** (Quality) — QA + UX review
35
35
  - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
36
- - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
37
- - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
38
- - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
36
+ - **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
37
+ - **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
38
+ - **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
39
+ - **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
40
+ - **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
41
+ - **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
42
+ - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
39
43
  - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
40
44
  - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
41
45
  - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
42
46
  - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
43
47
  - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
44
48
  - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
45
- - **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
49
+ - **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
50
+ - **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
46
51
 
47
52
  ## Skills
48
53
 
@@ -103,19 +108,27 @@ Agents MUST follow these behavioral principles:
103
108
  - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
104
109
  - `.agents/memory/context.md` — Update at session end with project state
105
110
 
111
+ ## Framework updates
112
+
113
+ Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
114
+ If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
115
+ When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
116
+ When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
117
+ After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
118
+
106
119
  ## Registry facts (computed from registry.yaml — never hand-typed)
107
120
 
108
- - Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
121
+ - Product: BMAD+ v0.14.0 (derived from BMAD-METHOD v6.6.0)
109
122
  - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
110
123
  - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
111
124
  - Installer agents (14 across all packs):
112
125
  - Core (required): 4 installer agents — Core agents & skills
113
126
  - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
114
127
  - Maker: 1 installer agent — Agent creation toolkit
115
- - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
128
+ - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
116
129
  - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
117
130
  - Memory: 1 installer agent — Persistent cross-session memory
118
- - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
131
+ - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
119
132
  - Backup: 1 installer agent — Backup & restore
120
133
  - Animated: 1 installer agent — Animated website agents
121
134
 
@@ -0,0 +1,82 @@
1
+ # Hand-authored project questions and compatibility. Pack facts are generated from registry.yaml.
2
+ code: bmad-plus
3
+ name: BMAD+ Streamlined AI-Driven Development
4
+ description: Augmented BMAD framework with multi-role agents, autopilot mode, and parallel execution
5
+ default_selected: true
6
+ extends: bmm
7
+ compatibility:
8
+ min_core_version: 6.0.0
9
+ max_core_version: 7.0.0
10
+ replaces_modules:
11
+ - bmm
12
+ keeps_core_skills: true
13
+ install_packs:
14
+ prompt:
15
+ - Quels packs additionnels souhaites-tu installer ?
16
+ - Core est toujours inclus.
17
+ default: none
18
+ result: '{value}'
19
+ project_name:
20
+ prompt: What is your project called?
21
+ default: '{directory_name}'
22
+ result: '{value}'
23
+ user_skill_level:
24
+ prompt:
25
+ - What is your development experience level?
26
+ - This affects how agents explain concepts in chat.
27
+ default: expert
28
+ result: '{value}'
29
+ single-select:
30
+ - value: beginner
31
+ label: Beginner - Explain things clearly
32
+ - value: intermediate
33
+ label: Intermediate - Balance detail with speed
34
+ - value: expert
35
+ label: Expert - Be direct and technical
36
+ execution_mode:
37
+ prompt:
38
+ - How do you want to work with BMAD+ agents?
39
+ - 'Manual: you call agents when needed. Autopilot: orchestrator manages everything.'
40
+ default: manual
41
+ result: '{value}'
42
+ single-select:
43
+ - value: manual
44
+ label: Manual - Call agents yourself
45
+ - value: autopilot
46
+ label: Autopilot - Orchestrator manages the pipeline
47
+ - value: hybrid
48
+ label: Hybrid - Autopilot with frequent checkpoints
49
+ auto_role_activation:
50
+ prompt: Enable intelligent auto-activation of agent roles based on context?
51
+ default: 'true'
52
+ result: '{value}'
53
+ single-select:
54
+ - value: 'true'
55
+ label: Yes - Agents auto-switch roles when context demands it
56
+ - value: 'false'
57
+ label: No - Only switch roles when I explicitly ask
58
+ parallel_execution:
59
+ prompt: Enable parallel multi-agent execution for independent tasks?
60
+ default: 'true'
61
+ result: '{value}'
62
+ single-select:
63
+ - value: 'true'
64
+ label: Yes - Run independent tasks in parallel
65
+ - value: 'false'
66
+ label: No - Sequential execution only
67
+ planning_artifacts:
68
+ prompt: Where should planning artifacts be stored? (Discovery phase output)
69
+ default: '{output_folder}/discovery'
70
+ result: '{project-root}/{value}'
71
+ implementation_artifacts:
72
+ prompt: Where should implementation artifacts be stored? (Build & Ship phase output)
73
+ default: '{output_folder}/build'
74
+ result: '{project-root}/{value}'
75
+ project_knowledge:
76
+ prompt: Where should long-term project knowledge be stored?
77
+ default: docs
78
+ result: '{project-root}/{value}'
79
+ directories:
80
+ - '{planning_artifacts}'
81
+ - '{implementation_artifacts}'
82
+ - '{project_knowledge}'
@@ -0,0 +1,78 @@
1
+ /** Build-time Python delivery checks; the npm contract repeats them on the archive. */
2
+ 'use strict';
3
+
4
+ const fs = require('node:fs');
5
+ const path = require('node:path');
6
+
7
+ function portable(file) {
8
+ return (
9
+ typeof file === 'string' &&
10
+ Boolean(file) &&
11
+ !/[\\:\0*?![\]{}]/.test(file) &&
12
+ file.split('/').every((part) => part && part !== '.' && part !== '..')
13
+ );
14
+ }
15
+
16
+ function checkPythonDelivery(registry, { packageRoot, packageJson }) {
17
+ const errors = [];
18
+ const roots = (packageJson.files || []).map((root) => root.replace(/\/$/, ''));
19
+ for (const [id, pack] of Object.entries(registry.packs)) {
20
+ if (!pack.runtime.includes('python')) continue;
21
+ if (!portable(pack.python_package)) {
22
+ errors.push(`${id}: python_package must name a portable package directory`);
23
+ continue;
24
+ }
25
+ const resources = [`${pack.python_package}/requirements.txt`];
26
+ if (pack.python_entry !== undefined) {
27
+ if (!portable(pack.python_entry)) {
28
+ errors.push(`${id}: python_entry must remain inside python_package`);
29
+ continue;
30
+ }
31
+ resources.push(`${pack.python_package}/${pack.python_entry}`);
32
+ }
33
+ for (const file of resources) {
34
+ if (!roots.some((root) => portable(root) && (file === root || file.startsWith(`${root}/`)))) {
35
+ errors.push(`${id}: ${file} is outside package.json files roots`);
36
+ }
37
+ try {
38
+ const target = path.join(packageRoot, file);
39
+ if (!fs.lstatSync(target).isFile()) throw new Error('not a regular file');
40
+ const relative = path.relative(fs.realpathSync(packageRoot), fs.realpathSync(target));
41
+ if (relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
42
+ throw new Error('outside package');
43
+ } catch {
44
+ errors.push(`${id}: ${file} is missing or is not a regular file inside the package`);
45
+ }
46
+ }
47
+ }
48
+ return errors;
49
+ }
50
+
51
+ function checkSeoMirror(packageRoot) {
52
+ const shipped = path.join(packageRoot, 'src/bmad-plus/packs/pack-seo');
53
+ const tested = path.join(packageRoot, 'oveanet-pack/seo-audit-360');
54
+ const files = (root) =>
55
+ fs
56
+ .readdirSync(path.join(root, 'scripts'))
57
+ .filter((file) => file.endsWith('.py'))
58
+ .sort();
59
+ const shippedFiles = files(shipped);
60
+ const testedFiles = files(tested);
61
+ const errors = [];
62
+ if (JSON.stringify(shippedFiles) !== JSON.stringify(testedFiles))
63
+ errors.push('SEO script inventory differs between shipped and tested sources');
64
+ for (const file of ['requirements.txt', ...shippedFiles.map((file) => `scripts/${file}`)]) {
65
+ try {
66
+ if (
67
+ !fs.readFileSync(path.join(shipped, file)).equals(fs.readFileSync(path.join(tested, file)))
68
+ ) {
69
+ errors.push(`SEO shipped/tested sources differ: ${file}`);
70
+ }
71
+ } catch {
72
+ errors.push(`SEO shipped/tested source is missing: ${file}`);
73
+ }
74
+ }
75
+ return errors;
76
+ }
77
+
78
+ module.exports = { checkPythonDelivery, checkSeoMirror };
@@ -48,6 +48,9 @@ installCmd.action(install.action);
48
48
  const uninstallCmd = program
49
49
  .command('uninstall')
50
50
  .description('Remove BMAD+ from your project');
51
+ for (const option of uninstall.options || []) {
52
+ uninstallCmd.option(...option);
53
+ }
51
54
  uninstallCmd.action(uninstall.action);
52
55
 
53
56
  // Update command
@@ -112,7 +115,19 @@ for (const option of autoconfig.options || []) {
112
115
  }
113
116
  autoconfigCmd.action(autoconfig.action);
114
117
 
115
- program.parse(process.argv);
118
+ // Version discovery and explicit per-project update policy.
119
+ for (const modulePath of ['./commands/update-check', './commands/update-policy', './commands/studio']) {
120
+ const command = require(modulePath);
121
+ const configured = program.command(command.command).description(command.description);
122
+ for (const option of command.options || []) configured.option(...option);
123
+ configured.action(command.action);
124
+ }
125
+
126
+ // Await asynchronous registry checks and updates before completing the CLI.
127
+ program.parseAsync(process.argv).catch(error => {
128
+ console.error(`BMAD+: ${error.message}`);
129
+ process.exitCode = 1;
130
+ });
116
131
 
117
132
  if (process.argv.slice(2).length === 0) {
118
133
  program.outputHelp();