Anthropic, Claude Code 기반 6단계 AI 네이티브 SDLC 플레이북 공개

AI가 코드 생성을 가속화하는 반면, 인간 중심의 검토 및 승인 프로세스는 변하지 않아 기존 소프트웨어 개발 수명주기(SDLC)에 병목 현상이 발생한다. 이를 해결하기 위해 Anthropic은 AI 에이전트가 모든 단계에 내장되어 선형 흐름을 자동화된 루프로 전환하고, 인간의 감독을 판단과 거버넌스에 집중시키는 AI 네이티브 SDLC를 제안하는 플레이북을 공개했다.

6단계 AI 네이티브 워크플로우

제안된 모델은 SDLC를 6단계로 재구성하며, 각 단계는 감사 추적 역할을 하는 버전 관리 산출물을 생성한다.

• Plan: 이해관계자가 Claude를 사용해 아이디어를 intent.md 파일로 변환하며, 기존 백로그 세분화 회의를 생략한다.
• Design: Claude가 intent.md를 기반으로 spec.md를 생성하며, 사후 검토 대신 skills를 통해 보안, 브랜드, UX 등 조직 정책을 적용한다.
• Build: 엔지니어는 Claude Code의 plan mode를 사용해 코드를 작성하기 전에 plan.md를 생성한다. 이를 통해 구현 전략이 코드와 함께 버전 관리되며 검토된다.
• Test: 에이전트가 로컬 테스트, 빌드, 스크린샷 차이를 활용해 지속적 피드백 루프를 실행한다. 인간 검토 전에 에이전트가 이러한 검사를 통과해야 하므로 후반 단계 실패가 줄어든다.
• Deploy: AI가 버그와 보안 문제를 표시하여 PR 검토를 지원하지만, 프로덕션 배포에는 인간 승인이 필수다. Hooks가 결정적 가드레일을 강제하여 무단 작업을 차단하거나 특정 승인을 요구한다.
• Maintain: 모니터링 도구가 문제를 진단하고 새로운 intent.md 파일을 생성하도록 에이전트를 트리거하여, 사고를 계획 단계로 되돌려 루프를 닫는다.

주요 메커니즘 및 산출물

워크플로우는 감사 추적 역할을 하는 버전 관리 산출물에 의존한다.

• intent.md: 문제, 영향, 목표를 캡처하여 기존 백로그 항목을 대체한다.
• spec.md: 요구 사항과 설계를 결합하며, intent.md와 조직 skills를 기반으로 Claude가 생성한다.
• plan.md: 구현 단계, 파일 변경 사항, 위험을 개요하며, 코드를 작성하기 전에 Claude Code plan mode에서 생성된다.
• CLAUDE.md: 에이전트에게 기관 지식, 관례, 명령을 제공하는 버전 관리 파일이다.
• Skills: 보안 검토 등 특정 작업에 대한 모듈식 버전 관리 지침으로, 정책의 일관된 적용을 보장한다.

거버넌스 및 보안 통제

AI 생성 코드의 속도 증가를 관리하기 위해 플레이북은 결정적 가드레일을 강조한다.

• Hooks: 보호된 파일 편집이나 승인 없는 프로덕션 배포 등 안전하지 않은 작업을 차단하거나 인간 개입을 요구하는 스크립트다. 자문형 skills와 달리 하드 제약 조건으로 작동한다.
• Managed Settings: 엔터프라이즈 환경에서 권한 제한, 샌드박스 강제, 우회 모드 비활성화 등 중앙 통제를 통해 컴플라이언스를 보장한다.
• Continuous Evals: 에이전트 구성(프롬프트, skills, CLAUDE.md)이 변경될 때 실행되는 자동 테스트로, 업데이트가 성능을 저하시키지 않는지 확인한다.
• Parallel Sessions: 엔지니어가 별도 git worktree에서 여러 Claude Code 인스턴스를 실행하여, 검토 품질을 유지하면서 처리량을 높일 수 있다.

배포 및 유지보수

최종 단계는 배포와 지속적 유지보수에 AI를 통합한다.

• AI in PR Review: Claude가 버그, 보안, 컴플라이언스에 대한 초기 코드 검토를 수행하여 인간 리뷰어가 의도와 위험에 집중할 수 있게 한다. 병합에는 인간 승인이 여전히 필수다.
• CI/CD Integration: Claude가 샌드박스 환경에서 빌드 실패를 분류하고, 문서를 업데이트하며, 배포를 준비할 수 있다. 프로덕션 배포는 hooks를 통한 명시적 인간 승인이 필요하다.
• Autonomous Maintenance: 모니터링 도구가 이상(예: 5xx 오류 급증)을 감지하면 Claude를 트리거하여 문제를 진단하고, 수정을 위한 intent.md 파일을 생성하거나 롤백을 시작한다. 이는 사고가 자동으로 계획 단계로 되돌아가는 폐쇄 루프를 만든다.