ros/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git synced 2026-01-30 04:32:02 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
91f6c41be1509025f0c520adab856788ae7a4d0a
BMAD-METHOD/docs/_basement/how-to/brownfield/add-feature-to-existing.md
Alex Verkhovsky 91f6c41be1 docs: radical reduction of documentation scope for v6 beta (#1406) 
* docs: radical reduction of documentation scope for v6 beta

Archive and basement unreviewed content to ship a focused, minimal doc set.

Changes:
- Archive stale how-to workflow guides (will rewrite for v6)
- Archive outdated explanation and reference content
- Move unreviewed content to basement for later review
- Reorganize TEA docs into dedicated /tea/ section
- Add workflow-map visual reference page
- Simplify getting-started tutorial and sidebar navigation
- Add explanation pages: brainstorming, adversarial-review, party-mode,
  quick-flow, advanced-elicitation
- Fix base URL handling for subdirectory deployments (GitHub Pages forks)

The goal is a minimal, accurate doc set for beta rather than
comprehensive but potentially misleading content.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* refactor: restructure BMM and agents documentation by consolidating and flattening index files.

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 14:00:26 -06:00

2.1 KiB
Raw Blame History

title, description
title description
How to Add a Feature to an Existing Project How to add new features to an existing brownfield project

Use the workflow-init workflow to add new functionality to your brownfield codebase while respecting existing patterns and architecture.

When to Use This

  • Adding a new feature to an existing codebase
  • Major enhancements that need proper planning
  • Features that touch multiple parts of the system

:::note[Prerequisites]

  • BMad Method installed
  • Existing project documentation (run document-project first if needed)
  • Clear understanding of what you want to build :::

Steps

1. Run workflow-init

Run workflow-init

The workflow should recognize you're in an existing project. If not, explicitly clarify that this is brownfield development.

2. Choose Your Approach

Feature Scope Recommended Approach
Small (1-5 stories) Quick Flow with tech-spec
Medium (5-15 stories) BMad Method with PRD
Large (15+ stories) Full BMad Method with architecture

3. Create Planning Documents

For Quick Flow:

  • Load PM agent
  • Run tech-spec workflow
  • The agent will analyze your existing codebase and create a context-aware spec

For BMad Method:

  • Load PM agent
  • Run PRD workflow
  • Ensure the agent reads your existing documentation
  • Review that integration points are clearly identified

4. Consider Architecture Impact

If your feature affects system architecture:

  • Load Architect agent
  • Run architecture workflow
  • Ensure alignment with existing patterns
  • Document any new ADRs (Architecture Decision Records)

5. Implement

Follow the standard Phase 4 implementation workflows:

  1. sprint-planning - Organize your work
  2. create-story - Prepare each story
  3. dev-story - Implement with tests
  4. code-review - Quality assurance

Tips

  • Always ensure agents read your existing documentation
  • Pay attention to integration points with existing code
  • Follow existing conventions unless deliberately changing them
  • Document why you're adding new patterns (if any)