This folder is read-only. Every file under docs/bmad/ is written by the BMAD sync script (see ../../meta/bmad-sync/README.md) from the codebase repo’s docs/ directory.
Do not hand-edit files here. The next sync will overwrite your changes and flag them in the auto-PR diff.
What will appear here
Once the codebase repo is running BMAD (Phase 2), this folder will fill with:
prd/— product requirements, per-epic shardsarchitecture/— architecture docs, per-component shardsstories/{epic}.{story}.story.md— individual story specstech-spec/— per-epic technical specificationsworkflow-status.yaml— current BMAD sprint state (read bydocs/progress.md)
Until then, this folder is empty except for this README.
Companion content
If you have thoughts, deltas, or decisions about a BMAD doc, put them in research/ or decisions/ (wikilink inward to the BMAD file). See 0003-bmad-sync-contract.