02-패턴

02. 실전 워크플로우 3종

개발자 가 가장 자주 만나는 작업 세 가지를 Claude 와 협업하는 패턴.

패턴 1. 신규 기능 — Plan → Implement → Test 3단 분리

1. claude 에서 Plan Mode 로 “기능 명세, 영향 파일, 테스트 시나리오” 만 출력시킨다(코드 X). 2) 사람이 plan을 검토 후 승인하면 구현 단계로 넘긴다. 3) 구현 직후 같은 세션에서 pytest 또는 vitest 를 실행시키고 실패 케이스만 자동 수정 루프.

필수 컨텍스트 파일: CLAUDE.md, notepad.md, 작업별 입력 파일.

산출물: 마크다운 또는 코드 파일로 git/Notion 에 버전 관리.

패턴 2. 버그 수정 — 재현 → 가설 → 패치

스택 트레이스를 그대로 붙이고 “먼저 재현 스크립트를 만들고, 가설 3개를 우선순위로 적은 뒤, 1번 가설부터 검증해줘. 코드 수정 전에 멈춰서 보고할 것” 을 시킨다. 인터럽트 가능한 진단(Interruptible Diagnosis) 패턴.

필수 컨텍스트 파일: CLAUDE.md, notepad.md, 작업별 입력 파일.

산출물: 마크다운 또는 코드 파일로 git/Notion 에 버전 관리.

패턴 3. 대량 리팩터링 — Subagent 위임

150+ 파일의 import 경로 변경 같은 작업은 메인 세션에서 직접 하지 말고 subagent 를 띄워 파일 묶음별로 병렬 처리. 메인은 오케스트레이터(Orchestrator) 역할만.

필수 컨텍스트 파일: CLAUDE.md, notepad.md, 작업별 입력 파일.

산출물: 마크다운 또는 코드 파일로 git/Notion 에 버전 관리.

합주법

세 패턴은 독립적으로도 쓰지만 PRD/스펙 → 실행 → 검증 순서로 엮으면 한 사이클이 된다.