BMAD-METHOD/docs
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
..
cs feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
explanation docs: route all web-bundles install traffic to bmadcode.com/web-bundles (#2425) 2026-05-25 12:17:27 -05:00
fr feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
how-to merge: sync with upstream v6.8.0 2026-05-26 06:00:02 -05:00
improvements merge: sync with upstream/main (v6.0.0-Beta.8) 2026-02-10 14:09:21 -06:00
reference feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
tutorials refactor(bmad-ux): spine-based UX skill (DESIGN.md + EXPERIENCE.md) (#2413) 2026-05-22 23:16:06 -05:00
vi-vn feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
zh-cn feat(docs): Add sidebar order validator for doc frontmatter (#2409) 2026-05-25 10:15:37 -05:00
404.md fix(docs): comprehensive documentation site review fixes (#1578) 2026-02-08 11:58:22 -06:00
_STYLE_GUIDE.md chore: remove SM agent (Bob) and migrate to Developer agent (#2186) 2026-04-02 12:25:24 -07:00
bmad_improvements_v2.md merge: sync with upstream/main (v6.0.0-Beta.8) 2026-02-10 14:09:21 -06:00
bmad_improvements_v2_fixes.md merge: sync with upstream/main (v6.0.0-Beta.8) 2026-02-10 14:09:21 -06:00
index.md feat(skills): TOML-based agent and workflow customization (#2284) 2026-04-19 19:30:29 -05:00
roadmap.mdx feat(docs): add public roadmap and improve site navigation 2026-02-22 19:41:57 -06:00