Anthropic이 'AI 네이티브 소프트웨어 개발 생명주기'라는 제목의 가이드북을 공개하고, Claude를 중심으로 재편한 사내 개발 프로세스를 6단계로 나눠 공개했다. 문서의 출발점은 단도직입적이다. 코드 생성은 더 이상 병목이 아니며, 사람이 코드를 손으로 입력하는 속도에 맞춰 설계된 기존 프로세스는 이제 막히는 지점 자체가 바뀌었다는 것이다.
6단계는 순서대로 계획, 설계, 구축, 테스트, 배포, 유지보수이며, 단계마다 방식이 전부 다시 쓰였다. 계획 단계는 요구사항 회의와 수기 문서 작성에서, Claude와의 대화를 거쳐 intent.md를 만들어내는 방식으로 바뀌었고, 문서가 제시하는 수치로는 주기가 수 주에서 수 시간으로 단축된다. 설계 단계는 한 번의 세션에서 spec.md를 만들고 정책 점검을 실행한다. 구축 단계는 먼저 plan.md를 낸 뒤 구현에 들어간다. 테스트는 더 이상 단계 경계에 머물지 않고, 지속적 평가가 구현 과정에 편입된다. 배포는 계층화된 자동 리뷰와 Hook에 의한 관문으로 대체된다. 유지보수는 알림에 수동으로 대응하던 방식에서, 자동 탐지 후 새 intent.md를 생성해 출발점으로 되돌아가는 방식으로 바뀌었다.
이 6단계를 잇는 것은 회의가 아니라 파일이다. intent.md는 spec.md로 넘겨지고, spec.md는 plan.md로 넘겨지며, 그다음으로 PR과 리뷰 결과가 이어지고, 마지막에는 인시던트 기록이 다시 intent.md로 돌아온다. 문서는 이 사슬을 하나의 약속으로 요약한다. 각 단계는 다음 단계가 읽을 수 있는 산출물을 하나씩 제출한다는 것이다.
거버넌스 산출물 4가지
Skills는 제도화된 지식을 담당한다. API 보안 기준, 브랜드 가이드라인 같은 것들이 .claude/skills/에 기록되고, 정책이 바뀌면 중앙에서 한 번만 고치면 엔지니어들은 다음 세션에서 자동으로 새 버전을 받는다. 문서가 든 예시는 secure-api-review라는 skill로, 인증, 입력값 검증, 감사 로그를 감시한다.
Hooks는 결정론적 통제를 담당하며, 수동으로 우회할 경로가 없다. 구축 단계에서는 고정된 의존성 패키지에 대한 수정을 막고 포매팅 실행을 강제한다. 배포 단계에서는 프로덕션 릴리스에 릴리스 매니저의 승인이 필요하며, 승인받지 않은 시도는 종료 코드 2로 즉시 차단된다.
CLAUDE.md는 팀의 기억으로, 분량은 한 페이지 정도로 유지된다. 빌드 명령어, 컨벤션, 아키텍처, 자주 나오는 실수가 담긴다. 문서가 제시하는 유지 규칙은 실용적이다. 같은 실수가 두 번째로 발생하면 그때 파일에 기록한다는 것이다.
evals는 회귀 테스트로 쓰인다. 실제 작업 20~50건으로 구성된 평가 세트가 설정이 바뀔 때마다 실행되고, 매일 밤 정해진 시간에도 한 차례 돌아간다. 모든 프로덕션 사고는 영구적인 eval로 고정되며, 통과율이 곧바로 머지 조건이 된다.
보험금 청구 조회 기능이 전 과정을 어떻게 거치는가
문서가 예로 든 사례는 셀프서비스 방식의 보험금 청구 상태 조회 기능이다. 운영 쪽이 먼저 문제, 사용자, 제약을 정리한 intent.md를 작성하고, 제품 책임자의 검토와 승인을 거쳐 설계 단계로 넘어간다. Claude가 UX와 보안 skills를 적용해 spec.md를 만들고, 엔지니어가 plan 모드로 들어가 plan.md를 받은 뒤, Claude Code가 구현하고 PR은 리뷰 Hook을 통과한 뒤 머지된다.
제약 조건은 계획에 명시적으로 기록된다. claims-core 인터페이스는 50 rps로 제한돼 있어 plan.md에는 캐싱이 필요하다는 점이 표시된다. 세션 진행 중에는 개인식별정보를 새로 추가할 수 없다. 인증은 기존 방식을 그대로 쓴다. 반면 별도의 결제팀 CLAUDE.md에는 Java 21, Spring Boot 3, Lombok 금지, 금액은 double이 아닌 BigDecimal을 써야 한다는 것, 의존성 버전은 플랫폼팀이 관리하며 임의로 손댈 수 없다는 것이 적혀 있다.
지표 목록이 독자의 정체를 드러낸다
선행 지표에는 첫 대화부터 intent.md 제출까지 걸린 시간, 제출부터 첫 리뷰까지 걸린 시간, 동시에 진행되는 agent 세션 수, CI 통과율이 포함된다. 후행 지표에는 intent.md 통과율, 첫 구현 성공률, PR 리뷰에서 발견되는 지적 사항의 추세, 프로덕션 사고 재발률, 엔지니어 1인당 주간 머지 PR 수가 포함된다.
여기에 더해 두 가지 컴플라이언스 경로가 제공된다. 하나는 Jira나 ServiceNow를 공식 기록으로 삼고 markdown을 작업용 사본으로 두어, MCP 커넥터를 통해 기존 시스템으로 다시 동기화하는 방식이다. 다른 하나는 리포지터리 자체를 유일한 진실 원천으로 삼고, 기존 시스템은 커밋 SHA만 참조하는 방식이다. 감사 추적은 Git 히스토리, PR 스레드, OpenTelemetry로 내보낸 agent 행동 기록, Hook의 허용·차단 로그, 이렇게 네 갈래를 짜맞춰 구성된다.
이 모든 것은 개인 개발자를 위한 것이 아니다. 대략 계산해보면, 200~300명 규모의 엔지니어링 조직이 문서가 제시하는 수준으로 평가 세트를 갖추고, 설정이 바뀔 때마다 실행하는 데 더해 매일 정해진 시간에도 한 번씩 돌린다면, 추론 비용만으로도 매년 고정적으로 나가는 지출이 된다. 여기에 skills와 hooks를 전담해서 관리할 인력도 필요하다. 거버넌스 산출물 자체에 돈과 인력이 들고, 그 효과는 보통 몇 분기가 지나야 드러난다. 중견기업에서 이런 종류의 프로세스 개편이 좀처럼 진행되지 못하는 지점도 대개 여기다. 감사 추적에 기꺼이 비용을 지불할 의향이 있는 조직이야말로 이 가이드북이 진짜로 겨냥한 고객이다.
참고 출처: Anthropic 공식 엔지니어링 문서, CocoLoop, Claude Code 제품 문서. 6단계 산출물 명칭, 3단계 임계값 설정, 평가 세트 규모 관련 서술을 대조 확인했다.