Agent Roles

AI Agent Flow uses a multi-agent pipeline to ensure high-quality, reliable output. Each agent has a specific role in the process — no single model handles everything.

🏛️ The Architect

The Architect is the first agent to act. Its job is to:

• Analyze the user request and relevant codebase context
• Draft a step-by-step implementation plan
• Identify potential edge cases and dependencies
• Produce a detailed spec that the Coder follows

💻 The Coder

The Coder follows the Architect's plan precisely. It:

• Writes the actual code changes across one or more files
• Ensures syntax correctness for the target language and framework
• Implements the logic specified in the plan — no improvisation

🔍 The Reviewer

The Reviewer acts as a second pair of eyes after code is generated. It looks for:

• Logic bugs and off-by-one errors
• Security vulnerabilities (injection, auth issues, unsafe defaults)
• Style guide violations and anti-patterns
• Missing edge case handling

If the Reviewer rejects the code, the Fixer agent is invoked automatically.

🧪 The Tester

The Tester writes unit and integration tests for the generated code. It:

• Generates test files covering happy paths and edge cases
• Runs the project's configured test command (npm test, vitest run, etc.)
• Reports pass/fail results back to the workflow engine

🐛 The Fixer

The Fixer resolves issues surfaced by the Reviewer or Tester. It:

• Reads the specific review feedback or test failure output
• Makes targeted fixes without rewriting unrelated code
• Re-triggers the Reviewer after each fix (up to maxIterations)

⚖️ The Judge

The Judge performs final QA validation. It:

• Cross-references the output with the original user request
• Checks that all Reviewer feedback has been addressed
• Decides whether to PASS the task or send it back for another iteration
• Only approves when the output fully satisfies the original requirements