diff --git a/src/bmm-skills/4-implementation/bmad-create-story/workflow.md b/src/bmm-skills/4-implementation/bmad-create-story/workflow.md index 0acd8666b..22f46d83a 100644 --- a/src/bmm-skills/4-implementation/bmad-create-story/workflow.md +++ b/src/bmm-skills/4-implementation/bmad-create-story/workflow.md @@ -266,6 +266,18 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: processes - **Integration Patterns:** External service integrations, data flows Extract any story-specific requirements that the developer MUST follow Identify any architectural decisions that override previous patterns + + + 📂 READ FILES BEING MODIFIED — skipping this is the primary cause of implementation failures and review cycles + From the architecture directory structure, identify every file marked UPDATE (not NEW) that this story will touch + Read each relevant UPDATE file completely. For each one, document in dev notes: + - Current state: what it does today (state machine, API calls, data shapes, existing behaviors) + - What this story changes: the specific sections or behaviors being modified + - What must be preserved: existing interactions and behaviors the story must not break + + A story implementation must leave the system working end-to-end — not just satisfy its stated ACs. + If a behavior is required for the feature to work correctly in the existing system, it is a requirement + whether or not it is explicitly written in the story. The dev agent owns this.