brownfield_plugin

Production-grade brownfield development workflow for Claude Code. Research, plan, execute, verify, and learn — applied to feature work on existing codebases. Multi-repo branch coordination, per-repo commit tracking, and merge-order recommendations. Adversarial review by Codex CLI (with Claude fallback). Persistent learning across workstreams.

Status: v1.1.0 — multi-repo execute v2 release. Adds automatic branch creation across affected repos, per-repo commit tracking in state.json, PR creation commands per repo, and a recommended merge order in verify. Backwards-compatible with v1.0.0 workstreams via state.json fallback. Pair with the greenfield plugin for new-project planning + scaffolding.

Table of Contents

• What is Brownfield?
• When to use Brownfield (vs Greenfield)
• Core philosophy
• Installation
• Quick start
• The 10 commands — full reference
• The 6 agents — full reference
• State directory layout
• The workflow loop in detail
• Adversarial review (Codex / Claude)
• Multi-repo support
• The learning system
• Workstreams & state
• Configuration
• Comparison with other tools
• Troubleshooting
• FAQ
• Roadmap
• License

What is Brownfield?

Brownfield is a Claude Code plugin for doing feature work on existing codebases. You use it once per feature (or bug, or refactor, or investigation), and it walks you through a research-backed loop: