Skip to content

AI-Native SDLC Playbook L1: When Code Generation Is No Longer the Bottleneck

Sep 12, 20261 min
TL;DRClaude Academy's opening lesson identifies the core paradox: AI accelerates code generation, but review, testing, and deployment don't keep pace. The bottleneck shifts from 'not writing fast enough' to 'not reviewing fast enough.' The AI-native SDLC fix isn't more AI-generated code — it's embedding AI into every stage where bottlenecks now live.
Table of Contents
  1. The Bottleneck Shift: Three Chain Reactions
  2. AI-Native Doesn't Mean "More AI"
  3. Six Stages, Six Artifacts
  4. Governance Philosophy: Humans Judge, Machines Execute
  5. Practical Observations
  6. Where to Start
  7. References

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:

StageKey OutputOwner
Planintent.md (problem + expected outcome)Originator + Claude
Designspec.md (unified requirements & design spec)Product owner + Claude
BuildCode + CLAUDE.md (version-controlled team knowledge)Engineer + Claude
TestPR with verification evidenceClaude self-check + CI
DeployMerged changes through governance gatesHuman review + automated gates
MaintainIncident records feeding back as new intent.mdMonitoring 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:

  1. CLAUDE.md (advisory): tells Claude what to do, but doesn't enforce
  2. Skills (advisory): encodes organizational policies as triggerable procedures
  3. Hooks (deterministic): runs shell scripts before/after actions, blocking on failure
  4. 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:

  1. Create a CLAUDE.md at the repo root with build commands, test commands, naming conventions, and common mistakes
  2. Add one basic hook: block git push to main
  3. 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