Key points
This post is a full annotated translation of an Anthropic Applied AI team playbook (author: Louis Claxton) on rebuilding the software development lifecycle (SDLC) for agentic AI with Claude and Claude Code.
- Core thesis: Organizations now write code at previously unimaginable speeds, but approval gates, reviews, handoffs, and policies still run at human pace. When Build collapses to hours, the bottleneck moves to the stages on either side—Plan, review/Test, and Deploy—and line-by-line human code review no longer scales when diffs are mostly agent-produced.
- AI-native SDLC structure: The traditional six stages (Plan, Design, Build, Test, Deploy, Maintain) become a loop with AI embedded at every step, automated handoffs, and automatic triggering of the next Play.
- The artifact chain as audit trail: Every stage ends by committing a deliverable to version control, and the next stage begins by reading it:
- 01 Plan: Proposers brainstorm directly with Claude to produce an
intent.mdin their own words (problem, outcome, affected users, constraints, open questions), stored in a shared versioned location (e.g., anintent/directory in the product repo). A product owner reviews before acceptance. Metric: weeks of elicitation compress to hours; survival rate of intents tracks quality. - 02 Design: Requirements and design collapse into one session. Claude, guided by organization skills encoding brand, security, compliance, and UX policy, turns
intent.mdinto aspec.mdwith concerns flagged. Policy is applied at authoring time, not discovered weeks later at review. A beta flow uses Claude Design for frontend mockups exported to Claude Code. - 03 Build: Engineers start every change in Claude Code plan mode; nothing is implemented without an accepted plan committed as
plan.md. Institutional knowledge lives in a versioned, one-pageCLAUDE.md(rule: if Claude makes the same mistake twice, fix it inCLAUDE.md). Skills (.claude/skills/<name>/SKILL.md) encode knowledge that must be applied consistently—though skills are persuasive controls only, so non-negotiable policies are backed by deterministic hooks that block protected paths, run formatters, and keep credentials out of diffs. Engineers run parallel sessions in separate git worktrees and delegate recurring work to sub-agents (.claude/agents/). A sidebar covers coexistence with legacy systems (Jira, ServiceNow, Figma) via a designated single source of truth or bidirectional links with commit SHAs. - 04 Test: QA gates at stage boundaries are replaced by continuous evals woven into implementation; feedback loops let sessions self-verify.
- 05 Deploy: Layered agentic review with human review reserved for regulated and critical code. Governance executes when AI acts—hooks serve as approval gates—and CI/CD pipelines are triggered by merged PRs. The final diff is checked against the accepted
plan.md. - 06 Maintain: Agents monitor production deployments; any broken control boundary is diagnosed and written back as a new
intent.md, closing the loop. - Plays are modular and list their prerequisites; start from any Play with no incoming arrows (no prerequisites)—typically Plan or the CLAUDE.md/Skills Plays in Build.
- Adoption begins with manually prompting each step; the end state is a loop where each accepted deliverable fires the next gate, with human attention focused on reviewing flagged items.
- Each Play defines leading metrics (e.g., wall-clock time between artifact commits) and lagging metrics (e.g., rework rounds per change, rate of first-pass merges), read mostly from git history and PR metadata.
intent.md → spec.md → plan.md → diff + tests → PR + review verdict → incident record
Humans remain accountable for judgment decisions; their attention moves to the gates the review agents flag.