Multi-Agent-Software-Development

This project is a multi-agent software development platform built on Claude, where each agent plays a distinct, specialized role in the coding workflow. Rather than relying on a single AI to handle everything, the system distributes responsibility across five purpose-built agents that communicate through a structured handoff protocol. The Planner agent acts as the orchestrator — it receives a raw feature request or bug report, breaks it down into actionable subtasks, and routes work to the appropriate downstream agents. The Engineer agent picks up those tasks and writes, refactors, or debugs the actual code, with access to file I/O and code execution tools. Once code is produced, the Reviewer agent critically evaluates it for correctness, style, edge cases, and potential regressions — and crucially, it can reject the output and send it back for revision rather than blindly passing it forward. The Tester agent then generates and runs a test suite, verifying that the implementation actually works and flagging failures back into the loop. Finally, the Documenter agent synthesizes the entire session into a clean PR description, changelog entry, and inline code comments — producing output that's genuinely merge-ready. What makes this system stand out is its feedback architecture. Agents aren't arranged in a rigid linear pipeline; they can request clarification, push work back upstream, or escalate blockers to the Planner. This creates a self-correcting loop that mimics how real engineering teams operate. The system also supports cross-model review — where one model writes and a different model critiques — reducing the blind spots that come from single-model self-evaluation. The end result is a fully automated dev workflow that takes a natural language request as input and outputs tested, reviewed, and documented code ready for human sign-off.