BMAD-METHOD/docs/how-to
Caleb cf03b6f50d merge: sync with upstream v6.8.0
Brings 558 upstream commits (v6.0.0-Beta.8 → v6.8.0) into our fork while
preserving our automation surface.

Key upstream changes absorbed:
- src/bmm/ workflow layout retired in favor of src/bmm-skills/ (skill-based
  architecture with SKILL.md + customize.toml per skill)
- src/core/ replaced by src/core-skills/
- New src/scripts/resolve_customization.py for TOML override merging
- Installer expansion (42 platforms, channel-based versioning, remote registry)
- New bmm-skills: bmad-investigate, bmad-spec, bmad-prd (rewritten),
  bmad-prfaq, bmad-checkpoint-preview, bmad-customize, bmad-ux
- 15 new releases of doc translations, web bundles, validators

Our automation preserved:
- scripts/{epic-execute,epic-chain,uat-validate}.sh + epic-execute-lib/
  (untouched by upstream — no path collision)
- src/bmm/workflows/4-implementation/{epic-execute,epic-chain}/
- src/bmm/workflows/5-validation/uat-validate/

Script path rewiring:
- epic-execute.sh: DEV_WORKFLOW_DIR/REVIEW_WORKFLOW_DIR now point at
  src/bmm-skills/4-implementation/bmad-{dev-story,code-review}/, with
  *_WORKFLOW_SKILL pointing at SKILL.md (replaces old workflow.yaml +
  instructions.xml pair). Removed CORE_TASKS_DIR/WORKFLOW_EXECUTOR refs
  (src/core/tasks/workflow.xml no longer exists upstream).
- epic-execute-lib/INIT.md: updated directory tree doc and inspection
  commands to reference new skill paths.

Conflict resolutions:
- README.md, docs/reference/workflow-map.md, docs/tutorials/getting-started.md,
  src/bmm-skills/4-implementation/bmad-create-story/checklist.md → took
  upstream verbatim (stay aligned with their docs direction).
- package.json → took upstream (dropped test:schemas/validate:schemas since
  agent YAML schema retired with src/bmm/agents/; added test:urls,
  test:channels, validate:skills; rebundle path moved cli/ → installer/).
- src/bmm/agents/sm.agent.yaml, src/bmm/workflows/3-solutioning/create-architecture/workflow.md,
  src/bmm/workflows/document-project/instructions.md → accepted upstream's
  deletion (modify/delete conflict; these files are part of the retired
  src/bmm/ layout).

Validated:
- All 4 shell scripts pass `bash -n` syntax check.
- No stale path references remain in scripts/ (grep clean).

Not yet validated:
- `npm install` + `npm test` (run as follow-up).
- Functional smoke test of epic-execute.sh against a real story (manual,
  follow-up).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 06:00:02 -05:00
..
customize-bmad.md feat(core-skills): add bmad-customize — guided authoring for _bmad/custom overrides (#2289) 2026-04-20 22:14:54 -05:00
established-projects.md merge: sync with upstream v6.8.0 2026-05-26 06:00:02 -05:00
expand-bmad-for-your-org.md feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
get-answers-about-bmad.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
install-bmad.md feat(prompts): add directory prompt with updated Clack runtime (#2387) 2026-05-16 18:30:25 -05:00
install-custom-modules.md feat(prompts): add directory prompt with updated Clack runtime (#2387) 2026-05-16 18:30:25 -05:00
non-interactive-installation.md feat(installer): channel-based version resolution + interactive channel management (#2305) 2026-04-24 08:20:30 -05:00
project-context.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
quick-fixes.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
shard-large-documents.md feat(installer): universal source support for custom module installs (#2233) 2026-04-09 18:44:40 -05:00
upgrade-to-v6.md feat(prompts): add directory prompt with updated Clack runtime (#2387) 2026-05-16 18:30:25 -05:00
use-web-bundles.md docs: route all web-bundles install traffic to bmadcode.com/web-bundles (#2425) 2026-05-25 12:17:27 -05:00