Table of Contents
Your team adopted Claude Code. Engineers doubled their output. Then what?
According to Anthropic's Claude Academy course, three things typically follow — none of them good.
The Bottleneck Shift: Three Chain Reactions
First, review and deployment become the rate limiter. An engineer opens 3 PRs a day, but reviewers read at the same speed as before. The PR queue piles up. Time from merge to deploy actually gets longer than pre-AI.
Second, existing control mechanisms become impractical. When daily PR volume goes from 5 to 20, line-by-line code review stops scaling. But dropping review lets quality slip — the team is stuck between "fast" and "safe."
Third, governance overhead rises. To handle exceptions ("this PR is too big for one reviewer," "this change needs cross-team sign-off"), the organization layers on committees, approval flows, and exception processes. Bureaucratic overhead eats the time AI saved.
These three problems share a single root cause: the organization accelerated code generation alone without redesigning the rest of the development lifecycle.
AI-Native Doesn't Mean "More AI"
The course defines AI-native SDLC precisely: not slapping an AI tool onto each step of the traditional process, but transforming the linear stages into continuous loops with AI embedded at every handoff point.
Traditional SDLC is a waterfall of six stages:
Plan → Design → Implement → Test → Deploy → Operate
Each stage belongs to a different team, connected by documents and formal sign-offs. The AI-native version turns it into a loop:
intent.md → spec.md → plan.md → Code → Test → Review → Deploy → Monitor → intent.md
The key difference: each stage produces not a "document" but a version-controlled artifact (intent.md, spec.md, plan.md, CLAUDE.md) that an AI agent can read and act on directly. Handoffs between stages no longer need human translation because each stage's output is the next stage's input.
Six Stages, Six Artifacts
The course maps 14 lessons into six stages, each with a key output:
| Stage | Key Output | Owner |
|---|---|---|
| Plan | intent.md (problem + expected outcome) | Originator + Claude |
| Design | spec.md (unified requirements & design spec) | Product owner + Claude |
| Build | Code + CLAUDE.md (version-controlled team knowledge) | Engineer + Claude |
| Test | PR with verification evidence | Claude self-check + CI |
| Deploy | Merged changes through governance gates | Human review + automated gates |
| Maintain | Incident records feeding back as new intent.md | Monitoring agent + human triage |
Note that the last stage's output (intent.md) is the first stage's input — that's the "loop." Post-launch issues don't just go into Jira to age; they automatically become the starting point for the next development cycle.
Governance Philosophy: Humans Judge, Machines Execute
One sentence runs through the entire course:
"Humans remain accountable for every decision that requires judgment."
This isn't a slogan. The course implements it through four layers:
- CLAUDE.md (advisory): tells Claude what to do, but doesn't enforce
- Skills (advisory): encodes organizational policies as triggerable procedures
- Hooks (deterministic): runs shell scripts before/after actions, blocking on failure
- Branch protection (deterministic): agents can only open PRs, never push directly to main
Control increases from top to bottom. CLAUDE.md and Skills make violations "unlikely," Hooks make them "nearly impossible," and branch protection makes them "impossible." As the course puts it: "The skill makes violations rare and the hook makes them close to impossible."
Practical Observations
We experienced the exact same bottleneck shift in a mid-sized project. After adopting Claude Code, a single engineer could produce in one day what previously took two or three — but PR review speed didn't keep up. The PR queue peaked at 12, reviewers started skimming, and quality actually declined.
Our fix followed a path remarkably similar to the course: first, establish a CLAUDE.md to unify output style (reducing trivial issues that slow reviews); then add PreToolUse hooks for automated checks (lint, formatting, block direct push); finally, introduce clean-context AI review (let the agent do a first pass so humans only review flagged items). The principle is the same — reduce review burden first, then use gates to guarantee quality.
Where to Start
If your team already uses Claude Code but hasn't systematically redesigned the development process, this lesson is worth watching first. It doesn't teach Claude Code usage (that's a prerequisite); it explains why tools alone aren't enough.
The course's minimum viable entry point:
- Create a
CLAUDE.mdat the repo root with build commands, test commands, naming conventions, and common mistakes - Add one basic hook: block
git pushto main - Observe for a week to see whether AI-generated code quality starts converging
These three steps cost half a day at most, but the results will make you want to continue through the remaining 13 lessons.
References
Loading...