Your First Build

A step-by-step walkthrough of a complete build from prompt to running code.

The prompt

We'll build a task management API — a real, non-trivial project that exercises the full agent pipeline.

Build a task management REST API with FastAPI and PostgreSQL.

Features:
- Users can create projects and tasks
- Tasks have status (todo, in_progress, done), priority, due dates, and assignees
- JWT authentication
- Full CRUD for projects and tasks
- pytest test suite with at least 80% coverage
- OpenAPI docs auto-generated

Step 1 — Choose your goal

Goal	Best for	Time
Prototype	Exploring an idea quickly	3–5 min
MVP	Something you'll actually use	8–12 min
Production	Shipping to real users	15–25 min

For this walkthrough, select MVP.

Step 2 — Watch the pipeline

Once you hit Build, the SSE stream shows each agent activating in sequence:

✓ IdeationAgent          Defined 12 features, data model confirmed
✓ ArchitectureAgent      FastAPI + PostgreSQL + Alembic selected
✓ DatabaseAgent          Schema: users, projects, tasks, task_assignments
✓ APIDevelopmentAgent    18 endpoints defined
✓ BackendDevelopmentAgent  Generated 2,400 lines across 14 files
✓ UnittestAgent          42 tests written, coverage 87%
✓ SecurityQAAgent        JWT implementation reviewed, no issues
✓ DocumentationAgent     README + docstrings complete
⏸ HITL Checkpoint        Review before deployment config

Human-in-the-Loop

If you enabled HITL, Builder pauses here and shows you everything it's about to generate. You can approve, reject, or add feedback before it continues.

Step 3 — Review the output

Your project is in generated_projects/task-api/:

task-api/
├── app/
│   ├── main.py
│   ├── routers/
│   │   ├── auth.py
│   │   ├── projects.py
│   │   └── tasks.py
│   ├── models/
│   │   ├── user.py
│   │   ├── project.py
│   │   └── task.py
│   ├── schemas/
│   │   └── *.py
│   └── core/
│       ├── config.py
│       ├── database.py
│       └── security.py
├── tests/
│   ├── test_auth.py
│   ├── test_projects.py
│   └── test_tasks.py
├── migrations/
│   └── versions/001_initial.py
├── docker-compose.yml
├── requirements.txt
└── README.md

Step 4 — Run it

cd generated_projects/task-api
docker compose up -d
# API live at http://localhost:8000
# Swagger UI at http://localhost:8000/docs

Step 5 — CTQ Score

After the build, check the quality scorecard:

curl http://localhost:8081/quality/project/task-api

{
  "overall_score": 86,
  "dimensions": {
    "correctness": 92,
    "security": 88,
    "performance": 81,
    "maintainability": 87,
    "test_coverage": 87,
    "documentation": 79
  }
}

Scores below 70 in any dimension trigger an automatic re-run of the relevant agent.

Next steps

• IDE & Copilot — edit the generated code with AI assistance
• Git Integration — commit and push from inside Builder
• Environment Promotion — promote to staging