Spec to draft code
Reads an approved spec and opens a first-pass branch that follows how your repos work.
Overview
Close the gap between design doc and first commit. The agent reads the spec, locates the services and existing patterns it affects, and opens a draft branch with scaffolding, tests and a description reviewers can follow.
Capabilities
- Traces each requirement to the services and files it will change
- Copies the structure and naming your repositories already use
- Ships a draft branch with tests and notes written for reviewers
Example output
Draft branch — invoice PDF download (sample)
Summary
Adds GET /v2/invoices/:id/pdf returning a signed download link
Changes
New route in billing-service modeled on the receipts handler
Tests for missing invoice and expired link cases
Open questions
Should voided invoices still be downloadable? (spec doesn't say)
Agent workflow
Step 1: Start the agent
User points the agent at an approved spec or ticket.
Step 2: Collect the context
The agent reads the spec and finds the code, patterns and tests it touches.
Step 3: Deliver the result
The agent opens a draft branch with notes and any open questions.