1 문서 우선 (Documentation First)

2 작은 단위로 분할

❌ 잘못된 방식: "전체 기능 구현해줘"
✅ 올바른 방식: "이 문서를 먼저 읽고, 첫 번째 단계만 구현해줘"

3 검증 루프

4 전체 흐름

5 문서 구조 예시

docs/
├── 00-requirement/     # ① 요구사항
│   └── 시장분석_제품컨셉.md
├── 01-development/     # ② 설계 문서
│   ├── 시스템_아키텍처.md
│   ├── 데이터베이스_스키마.md
│   ├── API_명세서.md
│   └── 페이지_구조_설계.md
├── 02-scenario/        # 코드베이스 분석
│   └── 코드베이스_구현_분석.md
└── 03-refactoring/     # ③~⑥ 반복 작업 문서
    ├── 00-서비스기획서.md
    ├── 05-마이페이지-기능명세서.md
    ├── 21-쇼케이스-데이터-도메인-분석서.md
    ├── 24-개선-개발-계획서.md
    └── ...

목표: 무엇을 만들지 명확히 정의

산출물:

• 시장 분석 문서
• 제품 컨셉 정의
• 핵심 기능 목록

프롬프트 예시:

다음 요구사항을 분석해서 기능 목록과 우선순위를 정리해줘:
[요구사항 내용]

출력 형식:
- P0 (필수): ...
- P1 (중요): ...
- P2 (개선): ...

목표: AI가 이해할 수 있는 명확한 설계서 작성

핵심 문서:

프롬프트 예시:

@docs/01-development/04_데이터베이스_스키마_설계.md 를 읽고
users 테이블과 관련된 모든 관계를 파악해서 설명해줘.

목표: 설계대로 동작하는지 빠르게 확인 및 UX 검증

방법:

설계서를 읽고 → 핵심 기능만 구현 → 디자인/동작 확인 → 피드백

프롬프트 예시:

@docs/03-refactoring/10-쇼케이스-등록-페이지-설계서.md 를 읽고
폼 UI만 먼저 구현해줘. API 연동은 나중에 할거야.
목업이니까 하드코딩된 데이터 사용해도 됨.

목표: 목업 피드백을 반영해 설계 수정

체크리스트:

• 누락된 필드 있는지
• 타입이 맞는지
• UX 흐름이 자연스러운지

프롬프트 예시:

방금 만든 목업을 보니 카테고리 선택 UI가 빠졌어.
설계서에 카테고리 관련 내용을 추가하고,
목업도 업데이트해줘.

목표: 설계서 기반으로 실제 코드 작성

핵심: AI에게 문서를 먼저 읽게 하기

프롬프트 예시:

다음 문서들을 순서대로 읽어줘:
1. @docs/03-refactoring/30-CRUD-데이터-도메인-전수조사-분석서.md
2. @docs/03-refactoring/11-레시피-등록-페이지-설계서.md

이 문서들에 정의된 대로 레시피 등록 폼을 구현해줘.
기존 쇼케이스 등록 폼의 패턴을 따라서 작성해.

대규모 작업 시:

이 작업은 크니까 Task 에이전트로 병렬 처리해줘:
1. 백엔드 API 엔드포인트 구현 (Explore로 기존 패턴 파악 후 구현)
2. 프론트엔드 폼 컴포넌트 구현
3. 타입 정의 동기화

목표: 구현 결과를 분석하고 문서화

중요: 이 단계에서 만든 분석서가 다음 작업의 입력이 됨

분석서 유형:

프롬프트 예시:

방금 구현한 레시피 등록 기능을 분석해서 문서로 정리해줘.

포함할 내용:
- 데이터 흐름 (프론트 → API → DB)
- 구현된 필드 목록
- 설계서와 다른 점
- 발견된 이슈

@docs/03-refactoring/ 폴더에 분석서로 저장해줘.

1 하지 말아야 할 것

2 효과적인 방법

✅ 문서를 먼저 읽게 하고 이해했는지 확인
✅ 기존 코드 패턴을 참고하라고 명시
✅ 작업 완료 후 분석서 작성 요청
✅ 병렬 처리 가능한 작업은 Task 에이전트 활용
✅ Explore 에이전트로 코드베이스 검색

3 문서 작성 팁

좋은 분석서의 특징:

• mermaid 다이어그램으로 흐름 시각화
• 테이블로 필드/타입 정리, 필드명 및 테이블 명 등 혼돈을 방지하기 위한 일관된 정의
• 파일 경로 명시
• 설계 vs 구현 차이점 명시

예시 구조:

markdown
# [기능명] 분석서

## 1. 개요
- 분석 목적
- 분석 범위

## 2. 데이터 흐름
[다이어그램]

## 3. 구현 현황
| 계층 | 파일 | 상태 |
|------|------|------|

## 4. 발견된 이슈
- P0: ...
- P1: ...

## 5. 권고사항

4 Claude Code 고급 기능 활용

1 문서 우선 (Documentation First)

2 작은 단위로 분할

❌ 잘못된 방식: "전체 기능 구현해줘"
✅ 올바른 방식: "이 문서를 먼저 읽고, 첫 번째 단계만 구현해줘"

3 검증 루프

4 전체 흐름

5 문서 구조 예시

docs/
├── 00-requirement/     # ① 요구사항
│   └── 시장분석_제품컨셉.md
├── 01-development/     # ② 설계 문서
│   ├── 시스템_아키텍처.md
│   ├── 데이터베이스_스키마.md
│   ├── API_명세서.md
│   └── 페이지_구조_설계.md
├── 02-scenario/        # 코드베이스 분석
│   └── 코드베이스_구현_분석.md
└── 03-refactoring/     # ③~⑥ 반복 작업 문서
    ├── 00-서비스기획서.md
    ├── 05-마이페이지-기능명세서.md
    ├── 21-쇼케이스-데이터-도메인-분석서.md
    ├── 24-개선-개발-계획서.md
    └── ...

목표: 무엇을 만들지 명확히 정의

산출물:

• 시장 분석 문서
• 제품 컨셉 정의
• 핵심 기능 목록

프롬프트 예시:

다음 요구사항을 분석해서 기능 목록과 우선순위를 정리해줘:
[요구사항 내용]

출력 형식:
- P0 (필수): ...
- P1 (중요): ...
- P2 (개선): ...

목표: AI가 이해할 수 있는 명확한 설계서 작성

핵심 문서:

프롬프트 예시:

@docs/01-development/04_데이터베이스_스키마_설계.md 를 읽고
users 테이블과 관련된 모든 관계를 파악해서 설명해줘.

목표: 설계대로 동작하는지 빠르게 확인 및 UX 검증

방법:

설계서를 읽고 → 핵심 기능만 구현 → 디자인/동작 확인 → 피드백

프롬프트 예시:

@docs/03-refactoring/10-쇼케이스-등록-페이지-설계서.md 를 읽고
폼 UI만 먼저 구현해줘. API 연동은 나중에 할거야.
목업이니까 하드코딩된 데이터 사용해도 됨.

목표: 목업 피드백을 반영해 설계 수정

체크리스트:

• 누락된 필드 있는지
• 타입이 맞는지
• UX 흐름이 자연스러운지

프롬프트 예시:

방금 만든 목업을 보니 카테고리 선택 UI가 빠졌어.
설계서에 카테고리 관련 내용을 추가하고,
목업도 업데이트해줘.

목표: 설계서 기반으로 실제 코드 작성

핵심: AI에게 문서를 먼저 읽게 하기

프롬프트 예시:

다음 문서들을 순서대로 읽어줘:
1. @docs/03-refactoring/30-CRUD-데이터-도메인-전수조사-분석서.md
2. @docs/03-refactoring/11-레시피-등록-페이지-설계서.md

이 문서들에 정의된 대로 레시피 등록 폼을 구현해줘.
기존 쇼케이스 등록 폼의 패턴을 따라서 작성해.

대규모 작업 시:

이 작업은 크니까 Task 에이전트로 병렬 처리해줘:
1. 백엔드 API 엔드포인트 구현 (Explore로 기존 패턴 파악 후 구현)
2. 프론트엔드 폼 컴포넌트 구현
3. 타입 정의 동기화

목표: 구현 결과를 분석하고 문서화

중요: 이 단계에서 만든 분석서가 다음 작업의 입력이 됨

분석서 유형:

프롬프트 예시:

방금 구현한 레시피 등록 기능을 분석해서 문서로 정리해줘.

포함할 내용:
- 데이터 흐름 (프론트 → API → DB)
- 구현된 필드 목록
- 설계서와 다른 점
- 발견된 이슈

@docs/03-refactoring/ 폴더에 분석서로 저장해줘.

1 하지 말아야 할 것

2 효과적인 방법

✅ 문서를 먼저 읽게 하고 이해했는지 확인
✅ 기존 코드 패턴을 참고하라고 명시
✅ 작업 완료 후 분석서 작성 요청
✅ 병렬 처리 가능한 작업은 Task 에이전트 활용
✅ Explore 에이전트로 코드베이스 검색

3 문서 작성 팁

좋은 분석서의 특징:

• mermaid 다이어그램으로 흐름 시각화
• 테이블로 필드/타입 정리, 필드명 및 테이블 명 등 혼돈을 방지하기 위한 일관된 정의
• 파일 경로 명시
• 설계 vs 구현 차이점 명시

예시 구조:

markdown
# [기능명] 분석서

## 1. 개요
- 분석 목적
- 분석 범위

## 2. 데이터 흐름
[다이어그램]

## 3. 구현 현황
| 계층 | 파일 | 상태 |
|------|------|------|

## 4. 발견된 이슈
- P0: ...
- P1: ...

## 5. 권고사항

4 Claude Code 고급 기능 활용