개요
intent.md는 Anthropic의 AI-native SDLC 플레이북(2026-08-21)에서 개발 프로세스의 첫 산출물이다. 아이디어를 낸 사람이 Claude와 대화한 결과를 자기 말로 적어 커밋하는 “proto-spec”이다. 플레이북의 출발점은 “코드는 더 이상 병목이 아니다”라는 진단이다. 빌드가 빨라지면 병목은 계획·리뷰·배포처럼 여전히 사람 속도로 도는 앞뒤 단계로 옮겨 간다.

세 문서의 역할
| 단계 | 문서 | 작성 | 승인 |
|---|---|---|---|
| Stage 1: Plan | intent.md | 아이디어 발단자(originator)가 Claude와 함께 | PO |
| Stage 2: Design | spec.md | Claude | PO(검토만) |
| Stage 3: Build | plan.md | Claude(plan mode) | 개발자 |
- 의도 —
intent.md- 발단자가 Claude와 브레인스토밍하며 자기 언어로 작성한다. 잘못 이해된 부분은 발단자가 고치고, PO는 커밋 전에 검토·수정한 뒤 승인하거나 기각한다.
- 담기는 내용: 문제, 제안하는 결과, 영향받는 사용자와 시스템, 제약 조건, 열린 질문.
- 단일 제품이라면 제품 레포의
intent/폴더가 가장 단순한 보관처다. 운영 중 장애 지표(control band) 이탈도 새intent.md가 되어 루프가 다시 시작된다.
- 스펙 —
spec.md- Claude가 승인된
intent.md를 받아 요구사항과 설계를 하나의 스펙으로 작성한다. 원문 표현으로 PO는 “reviews that spec, but doesn’t write it”, 즉 검토만 하고 쓰지 않는다. - 조직의 스킬(브랜드·보안·컴플라이언스·UX 정책)이 제약으로 적용된다. 정책끼리 충돌해 둘 다 만족할 수 없는 지점은 우려 사항(flagged concerns)으로 명시한다.
- Claude가 승인된
- 설계 —
plan.md- Claude Code plan mode에서 Claude가 작성한다. 개발자는 “무엇이 깨질 수 있나, 가장 위험한 단계는, 택하지 않은 대안은”을 물으며 계획을 심문하고 수정을 요구한다. plan mode에서는 계획이 승인될 때까지 Claude가 파일을 수정할 수 없으므로 이 검토가 강제된다.
- 담기는 내용: 변경될 파일, 작업 순서, 리스크, 증거(테스트). 승인 기준은 “대화를 본 적 없는 엔지니어가 plan만으로 구현할 수 있는 수준”이다.
- 승인된 계획은
plan.md로 커밋되어 감사 추적에 남고, PR 리뷰에서 실제 diff와 대조된다.
핵심
세 문서는 intent → spec → plan → diff로 이어지는 산출물 체인이다. 각 단계는 커밋으로 끝나고, 그 커밋이 다음 단계를 시작시킨다. 초안은 Claude가 쓰고 각 단계의 승인 게이트는 사람(PO 또는 개발자)이 맡는다. 커밋 체인이 곧 “누가 무엇을 요청했고, 에이전트가 무엇을 만들었고, 누가 승인했는가”의 감사 기록이 된다.
함께 볼 자료
관련 노트
- 2026-09-10-threads-intent-md-workflow — 같은 intent-first 흐름을 worktree 병렬 실행까지 확장한 스레드
- 2026-09-26-claude-ai-driven-code-modernization — 같은 플레이북을 참고하는 레거시 현대화 가이드
- moc-claude-code — 상위 MOC
- moc-ai-coding — 에이전트 기반 개발 프로세스의 상위 주제