โ— Open Source & MIT Licensed

Stop Prompting AI in Circles

Agentic Sprint brings structured, spec-driven development to Claude Code. A self-iterative state machine that reads your specs, orchestrates agents, and loops until the work is done.

View on GitHub โ†’ See How It Works
$ /new-sprint Add user authentication with OAuth โœ“ Sprint 3 created at .claude/sprint/3/ $ /sprint โ†’ Phase 1: Architect analyzing specs... โ†’ Phase 2: Spawning python-dev, nextjs-dev โ†’ Phase 3: Running qa-test-agent, ui-test-agent โœ“ Sprint 3 Complete - All tests passing

How It Works

A spec-driven, self-iterative state machine in four phases

1

Write Specs

Create a simple specification file describing what you want to build. Can be one line or highly detailed.

2

Architect Plans

The Project Architect agent analyzes your specs and creates detailed API contracts and implementation guides.

3

Agents Build

Specialized agents (backend, frontend, CI/CD) implement the feature in parallel, following the specs.

4

Iterate & Converge

QA and UI tests validate. The state machine loops โ€” refining specs, fixing issues โ€” until convergence (max 5 iterations).

Extensible Agent System

Start with built-in agents, extend with your own. The architecture is open by design.

๐Ÿ›๏ธ

Project Architect

Analyzes requirements, creates specifications, and coordinates all other agents. The decision-maker.

Coordination
๐Ÿ

Python Dev

Builds FastAPI backends with async patterns, PostgreSQL, and proper security practices.

Backend
โš›๏ธ

Next.js Dev

Creates modern React applications with Next.js 16, TypeScript, and TailwindCSS.

Frontend
๐Ÿงช

QA Test Agent

Maintains automated test suites with API and unit tests. Validates against the API contract.

Testing
๐ŸŽญ

UI Test Agent

Runs E2E browser tests via Playwright MCP. In manual mode, opens a live browser for you to explore while capturing errors.

E2E Testing
๐Ÿ”ง

CI/CD Agent

Configures pipelines, manages deployments, and sets up quality gates.

DevOps

๐Ÿ”ฎ Allpurpose Agent

No specialized agent for your stack? The allpurpose-agent adapts to any technology โ€” Go, Rust, Flutter, Ruby, whatever. The architect automatically falls back to it when needed.

The architect creates appropriate specs and prompts it correctly. You just write your requirements.

๐Ÿค Write Your Own

These agents are starting points, not final products. Fork, extend, contribute. Add agents for your stack, improve existing ones, share what works.

Learn how to create agents โ†’

Why It Works

A convergent process that eliminates AI's common failure modes

Context Preservation

Each agent receives only what it needs โ€” specs, contracts, relevant code. No wasted tokens on irrelevant history. Context windows stay lean and focused.

Specs Shrink, Not Grow

Completed work is removed from specifications. Each iteration focuses only on what remains. TODOs decrease, clarity increases.

Errors Get Erased

Working code stays untouched while issues get fixed. The signal-to-noise ratio improves with each pass. Mistakes don't compound.

Think of it like a diffusion process: the picture starts noisy, but with each iteration, noise reduces and clarity emerges. Most sprints converge well before 5 iterations. If not, the system pauses and asks what to do โ€” you stay in control.

The Second Brain Effect

Persistent memory that survives across sprints โ€” without bloating your context

๐ŸŽฏ

project-goals.md

The Business Brain (you maintain this)

  • โ€ข Product vision and target audience
  • โ€ข Market analysis and differentiators
  • โ€ข Success metrics and constraints
  • โ€ข What you're building and why

The architect reads this to make decisions aligned with your product goals, not just technical specs.

๐Ÿ—บ๏ธ

project-map.md

The Technical Brain (architect maintains)

  • โ€ข Project structure and architecture
  • โ€ข API surface and database schema
  • โ€ข Routes, components, env variables
  • โ€ข Where everything lives and how it connects

Agents read this instead of scanning the entire codebase. Straight to the relevant files.

You maintain project-goals.md โ€” the more detail you provide, the sharper the architect becomes. The architect maintains project-map.md and keeps it lean. This is how agents "remember" your project without consuming your context window.

Key Features

Everything you need for autonomous, spec-driven development

๐Ÿ“‹

Specification-Driven

API contracts are the source of truth. Frontend and backend implement the same spec.

๐Ÿ”„

Iterative Refinement

Autonomous iterations with a checkpoint at 5. System pauses to ask โ€” continue, adjust, or intervene.

โšก

Parallel Execution

Implementation agents run in parallel. UI testing and diagnostics run together.

๐ŸŽฏ

MCP Integration

Leverages Playwright and Next.js DevTools MCP for browser automation and error monitoring.

๐Ÿ“Š

Structured Reports

Every agent returns machine-parseable reports. Easy to track progress and issues.

๐ŸŒ

i18n Built-In

French and English support throughout. Agents use i18n keys, never hardcoded strings.

Manual Testing Mode

Explore your app with live error monitoring

๐ŸŽญ

Live Browser via Playwright

A real browser opens pointing to your app. Click around, test forms, explore edge cases yourself.

๐Ÿ”

Parallel Error Monitoring

A diagnostics agent watches for runtime errors in real-time. We ship one for Next.js โ€” write your own for any stack with observability tools.

๐Ÿ“‹

Reports on Close

When you close the browser, both agents finalize and return comprehensive reports of everything captured.

โšก

Quick Access

Run /sprint --manual to skip the full workflow and jump straight to manual testing.

Simple Sprint Spec

All you need to start a sprint

.claude/sprint/1/specs.md
# Sprint 1 Specifications

## Goal
Add user authentication with OAuth and email/password

## Scope
- User registration and login
- OAuth with Google and GitHub
- Password reset flow
- Protected dashboard route

## Testing
- QA: required
- UI Testing: required
- UI Testing Mode: automated

Ready to Try Agentic Sprint?

Clone the repo, copy to your project, and run your first autonomous sprint.

Get Started on GitHub โ†’