로드 중

무엇이 달라지고 어디서부터 시작할지

강의 13분

조직들은 1년 전만 해도 상상할 수 없었던 속도로 AI를 사용해 코드를 작성하기 시작했지만, 코드를 둘러싼 프로세스는 같은 속도로 변화하지 않았습니다.

소프트웨어 개발 수명 주기(SDLC)는 소프트웨어를 아이디어에서 프로덕션까지 이끄는 프로세스입니다. 대부분의 조직은 계획, 설계, 빌드, 테스트, 배포, 유지 관리라는 동일한 여섯 단계의 어떤 버전을 운영하고 있습니다.

변화

아래 표는 전통적인 SDLC와 Claude가 지원하는 AI 네이티브 SDLC 사이의 스펙트럼 양 끝을 보여줍니다. 대부분의 조직은 두 열 사이 어딘가에 위치합니다.

단계전통적인 SDLCAI 네이티브 SDLC
계획위원회가 요구사항을 수집하고, 워크숍과 승인을 거쳐 정제한 후 수작업으로 작성Claude가 소스에서 직접 문제점을 종합해 사람이 읽을 수 있고 기계가 실행할 수 있는 intent.md에 담아냄
설계분석가가 사양을 작성하고 디자이너가 이를 해석요구사항과 설계가 에이전트와의 단일 작업 세션으로 압축되며, Skills로 부호화된 표준에 따라 안내되고 Git으로 버전 관리됨
빌드테스트와 코드는 직접 작성되며, 문서는 주요 개발이 끝난 후에 작성됨테스트와 코드는 AI가 생성하며, 조직의 지식은 버전 관리되는 기계 판독 가능한 CLAUDE.md 파일과 Skills로 유지됨
테스트단계 경계에서의 QA 게이트구현 전반에 걸쳐 짜여진 지속적인 평가(evals)
배포사람이 모든 코드 줄을 검토하며, 거버넌스는 검토 주기 안에서 이루어지지만 종종 일관성이 없음에이전틱 검토가 여러 겹으로 이루어지고, 사람의 검토는 규제 대상이거나 중요한 코드에만 한정됨. 거버넌스는 AI가 행동하는 동안 강제되며, 승인 게이트로서의 hooks가 사용됨
유지 관리사람이 프로덕션을 지켜보며 버그를 확인에이전트가 실시간 배포를 모니터링함. control band를 벗어난 경우 진단되어 새로운 intent.md로 루프에 다시 기록됨

판단이 필요한 모든 결정에 대해서는 사람이 계속 책임을 집니다.

표에 등장하는 두 가지 용어는 문서 전반에 걸쳐 반복해서 나옵니다. intent.md는 무엇을 원하는지, 왜 원하는지, 어떤 제약 조건 하에서인지를 기술하는 짧은 버전 관리 파일입니다. 제어 대역(control band)은 프로덕션 지표의 정상 수준을 둘러싼 범위입니다.

플레이는 어떻게 작동하는가

플레이는 플레이북의 핵심이며, 여섯 개의 비선형 단계(계획, 설계, 빌드, 테스트, 배포, 유지 관리)로 그룹화되어 전체 수명 주기를 포괄합니다.

각 플레이는 다음을 다룹니다:

  • 무엇이 바뀌는지
  • 시작하는 방법
  • 구현을 위한 구체적인 단계
  • 거버넌스 고려 사항
  • 효과가 있었는지 측정하는 방법

각 플레이는 "Prerequisites"(전제 조건) 항목 아래에 의존성을 명시하며, 이는 의존성 그래프에서 더 자세히 보여줍니다.

다섯 행에 걸친 12개 플레이의 의존성 그래프. 1행, 전제 조건 없음: 의도 포착(Capture intent), CLAUDE.md, Skills, 피드백 루프, Hooks, Plan mode. 2행: Subagents(CLAUDE.md 필요, 피드백 루프는 도움이 됨), Evals(CLAUDE.md와 피드백 루프 필요). 3행: 요구사항 및 설계(의도 포착과 Skills 필요), PR 검토(Evals와 Subagents 필요, Skills는 도움이 됨). 4행: CI/CD(PR 검토와 Hooks 필요). 5행: 루프 닫기(CI/CD와 의도 포착 필요). CLAUDE.md는 Skills에 도움이 되지만 필수는 아님.

플레이 의존성 그래프. 맨 위 행의 플레이는 전제 조건이 없습니다. 실선 화살표는 해당 플레이를 기반으로 하는 플레이를 가리키며, 점선 화살표는 도움이 되지만 필수는 아님을 의미합니다.

첫 번째 플레이 선택하기

플레이는 모듈식으로 구성되어 있으며, 조직은 고유한 필요에 따라 서로 다른 시점에 서로 다른 단계의 전환을 우선시하도록 선택할 수 있습니다.

위 그래프의 맨 위 행에 있는 여섯 개의 플레이는 전제 조건이 없습니다:

  • 계획: intent.md로 포착하기
  • 빌드: 기본 시작점으로서의 Claude Code plan mode
  • 빌드: CLAUDE.md
  • 빌드: 조직 지식으로서의 Skills
  • 테스트: Claude에게 피드백 루프 제공하기
  • 배포: 승인 게이트로서의 Hooks

확신이 서지 않는다면 CLAUDE.md로 시작하세요. 이 플레이는 저장소, Claude Code, 그리고 코드베이스를 아는 엔지니어 한 명을 필요로 하며, subagents와 evals 플레이가 이를 기반으로 합니다.