Agentic Factory Template

This repository is a template for an autonomous software development workflow.

It is built on a "General Contractor" architecture. A single, intelligent "Product Manager" agent (00_product_manager.md) creates a plan and orchestrates a team of specialist "worker" agents to build, test, fix, and refactor code.

This system does not use taskmaster.ai or a hard-coded Python script. The master agent manages the entire workflow and state autonomously using AGENT_TODOS.md.

The Workflow: A 2-Phase Process

Phase 1: Planning (Human-in-the-Loop)

You must first create a formal Product Requirement Document (PRD).

1. Start with a customer brief (e.g., "I need a login page").
2. Call the Analyst Agent to refine this brief into a PRD.

   # This is a conceptual command. Replace with your AI-calling script.
   call_ai_agent(".workflow/agents/01_analyst.md", "My customer wants a login page.")

3. The Analyst will ask you clarifying questions. Answer them.
4. The Analyst will output a final my-feature-prd.md file. Save this in your project.

Phase 2: Execution (Autonomous)

Once you have the PRD, you hand it to the "Product Manager" (the boss agent) to build.

1. Call the Product Manager Agent and point it to your new PRD. Include any flags to control its "thinking" process.

   # This single command runs the *entire* factory.
   call_ai_agent(".workflow/agents/00_product_manager.md", "/workflow @my-feature-prd.md --c7 --ultrathink")

2. Done. The 00_product_manager agent will now:
   • Create the AGENT_TODOS.md file.
   • Autonomously call its specialist "worker" agents (Developer, Reviewer, Tester, Troubleshooter) in sequence or parallel.
   • Manage the entire build, test, fix, and refactor loop.
   • Update AGENT_TODOS.md as it works.

Your job is to simply monitor AGENT_TODOS.md until all tasks are marked ✅ Complete.

Initial Setup

1. Create Repo: Click "Use this template" on GitHub to create a new project.
2. Install Dependencies:

   pip install -r requirements.txt

3. Set API Keys:

   export ANTHROPIC_API_KEY="your_api_key_here"
   export OPENAI_API_KEY="your_api_key_here"

The Agent Team

• The Boss:
  • 00_product_manager.md: The orchestrator. It creates the plan (AGENT_TODOS.md) and delegates all work.
• The Specialists (Workers):
  • 01_analyst.md: Creates the PRD.
  • 02_architect.md: (Called by the boss) Designs technical specs.
  • 03_developer.md: (Called by the boss) Writes feature code.
  • 04_test_writer.md: (Called by the boss) Writes new tests.
  • 05_qa_runner.md: (Called by the boss) Runs the test suite.
  • 06_code_reviewer.md: (Called by the boss) Performs static code analysis.
  • 07_documentation.md: (Called by the boss) Updates documentation.
  • 08_troubleshooter.md: (Called by the boss) Fixes code that fails review or testing.
  • 09_archivist.md: (Called by the boss) Cleans the sandbox after a task.
  • 10_refactor_agent.md: (Called by the boss) Polishes working code.