02-구조

02. 구조 — hello-cowork 워크플로우 4단계

전체 그림

[1. Intent]
  사람이 한 문단으로 무엇을 원하는지 적는다
        │
        ▼
[2. Plan]
  Claude가 계획을 제안한다 (Plan Mode 또는 일반 모드)
        │
        ▼
[3. Execute]
  Claude Code가 파일을 만들고, Claude Cowork가 보조 자료를 생성한다
        │
        ▼
[4. Verify]
  사람 또는 분리된 모델/동료가 결과를 검증한다
        │
        ▼
   "한 일"

각 단계의 산출물은 다음과 같다.

단계	산출물	저장 위치
Intent	`INTENT.md` 한 문단	프로젝트 루트
Plan	Claude 응답의 계획 섹션	세션 로그 또는 `PLAN.md`
Execute	수정된 파일들 + git diff	git working tree
Verify	검증 결과 노트	`VERIFY.md` 또는 PR 코멘트

1단계 — Intent (의도)

사람이 적는다. 다음 3개 질문에 답한다.

무엇을 만들 것인가? (한 줄)
왜 만드는가? (한 줄)
**완료의 정의(Definition of Done)**는 무엇인가? (체크리스트 3개 이내)

좋은 Intent 예시:

# INTENT
## 무엇
hello-claude 프로젝트의 README.md에 "학습 목표" 섹션과 "오늘의 회고" 섹션을 추가한다.

## 왜
Part 0/03 워크플로우 학습을 위해 첫 "한 일"을 만들기 위함.

## 완료의 정의
- [ ] README.md에 두 섹션이 존재한다
- [ ] git에 커밋되어 있다
- [ ] 두 번째 사람(또는 모델)이 한 번 검토했다

Intent를 적는 데 5분 이상 쓰지 않는다. 완벽한 의도는 없다.

2단계 — Plan (계획)

Claude Code의 Plan Mode를 쓰는 것을 권장한다. 일반 모드에서는 다음과 같이 명시적으로 요청한다.

INTENT.md를 읽고, 실행하지 말고 계획만 먼저 보여줘.
파일별로 어떤 변경이 들어갈지 목록으로 정리해.

Claude의 응답에서 다음을 확인한다.

모든 완료의 정의가 계획에 반영되었는가?
의도하지 않은 파일이 변경 목록에 들어가 있지 않은가?
위험 명령(rm, git push --force, npm publish)이 포함되지 않았는가?

문제가 있으면 계획을 거부하고 다시 요청한다. 실행 전에 잡는 비용이 실행 후 잡는 비용의 1/10이다.

3단계 — Execute (실행)

계획에 동의하면 실행을 시작한다.

이 계획대로 진행해. 각 파일 변경은 diff를 보여주고 내 승인을 기다려.

Claude Code는 파일 단위로 diff를 제시한다. 매번 읽고 승인한다. “Yes to all”은 누르지 않는다.

실행이 끝나면 git status로 변경 범위가 계획과 일치하는지 다시 확인한다.

4단계 — Verify (검증)

자기 검증 금지. 다음 중 하나 이상을 한다.

분리된 모델에게 평가: 같은 결과물을 다른 LLM(예: ChatGPT/Codex/Gemini)에게 보여주고 “이 변경이 INTENT를 만족하는가”를 묻는다.
동료에게 PR 리뷰: 1줄짜리 변경이라도 PR을 만들고 동료의 LGTM을 받는다.
분리된 Claude 세션에게 평가: 새 세션을 띄워서 “이 PR을 비판적으로 검토해줘”라고 요청한다. 같은 세션에서 자기 자신에게 묻지 않는다.

검증 결과를 VERIFY.md 또는 PR 코멘트에 한 문단으로 기록한다.

Cowork의 보조 역할

Claude Code가 코드/파일을 직접 만지는 동안, Claude Cowork는 다음을 보조한다.

회의록·자료 정리(텍스트 요약)
외부 자료 검색·요약
작업 결과를 슬랙/이메일 초안으로 가공

비개발 사용자라면 4단계 전체를 Cowork만으로 진행할 수 있다(파일이 코드가 아니라 문서일 경우). 개발자는 Code 중심 + Cowork 보조 패턴이 자연스럽다.