Part 2: Hands-On Guide

2.8 Best Practice

Claude Code 활용 순서

1
Planning (plan mode + Opus with thinking)
구현 작업 전까지는 plan 모드(/plan으로 활성화)로 설계를 먼저 합니다.
2
Reviewing (/spec-review)
인터뷰 기반 스펙 리뷰로 모호한 부분을 사전에 제거합니다.
3
Iterating (Ralph-loop)
자기 수정 루프를 반복합니다.
- Hook 활용 (예: 작업 종료, 즉 Stop Event 발생 시 /code-review, /security-review, 스타일 체크 등 스킬 실행)
4
UI update, bug fix, code review (Sonnet)
단순 작업은 빠른 모델로 처리합니다.

Best Practice

개념	내용
Perspective	말을 잘 따르는 도구가 아니라 검증 루프를 빨리 돌리는 도구로 인식 "AI에게 뭘 시킬 것인가"보다 "AI가 뭘 기억하게 할 것인가"가 더 중요하다.
Markdown	입력은 마크다운으로 문서 사이트에 "마크다운 모드"가 있는지 확인 - `raw`, `markdown`, `print`, `?plain=1` 같은 옵션이 있는지 확인 필요한 섹션만 가져오기 ("가볍게"가 핵심)
Spec First	명확한 사양(Specifications) → 대부분의 작업을 1-shot에 성공 전체 시간의 80~90% 투자 명령(절차)보다는 선언(상태) 구현 작업 전까지는 plan 모드(`/plan`으로 활성화) 초안 작성 후 인터뷰 프롬프트로 심화: "@spec.md 파일을 읽고 AskUserQuestionTool을 사용하여 기술적 구현, UI & UX, 우려 사항, 트레이드오프 등 모든 측면에 대해 저를 상세히 인터뷰해. 질문은 뻔하거나 상투적이지 않아야 하며, 매우 심층적으로 접근하여 내용이 완성될 때까지 인터뷰를 계속 이어가야 해. 인터뷰가 끝나면 spec.md를 업데이트 해"
Use various models	작업의 시작이나 중요한 작업(핵심 기능 구현, 리팩토링)은 Opus 질문없이 한번에 수행하고 싶으면 Codex CLI UI 수정, 버그 픽스, 코드 리뷰는 Sonnet
Skills & Plugins	반복 업무는 표준화 (생산성은 어떤 날의 영감이 아니라 반복 가능한 루틴으로부터) 프롬프트 엔지니어링보다, 반복되는 동작을 패키징하는 것에 투자 일단은 직접 손을 더럽혀가며 끝까지 시도 (MASTER Framework) Claude Code Agent Skills
Build-Measure-Learn Loop	자기 수정 루프를 최대한 반복하는 것이 품질의 핵심 - 출력을 검증할 수 있다면 반복 개선 가능 Ralph Loop

Perspective

내용: 말을 잘 따르는 도구가 아니라 검증 루프를 빨리 돌리는 도구로 인식

"AI에게 뭘 시킬 것인가"보다 "AI가 뭘 기억하게 할 것인가"가 더 중요하다.

Markdown

내용: 입력은 마크다운으로

문서 사이트에 "마크다운 모드"가 있는지 확인
- raw, markdown, print, ?plain=1 같은 옵션이 있는지 확인

필요한 섹션만 가져오기 ("가볍게"가 핵심)

Spec First

내용: 명확한 사양(Specifications) → 대부분의 작업을 1-shot에 성공

전체 시간의 80~90% 투자

명령(절차)보다는 선언(상태)

구현 작업 전까지는 plan 모드(/plan으로 활성화)

초안 작성 후 인터뷰 프롬프트로 심화:
"@spec.md 파일을 읽고 AskUserQuestionTool을 사용하여 기술적 구현, UI & UX, 우려 사항, 트레이드오프 등 모든 측면에 대해 저를 상세히 인터뷰해. 질문은 뻔하거나 상투적이지 않아야 하며, 매우 심층적으로 접근하여 내용이 완성될 때까지 인터뷰를 계속 이어가야 해. 인터뷰가 끝나면 spec.md를 업데이트 해"

Use various models

내용: 작업의 시작이나 중요한 작업(핵심 기능 구현, 리팩토링)은 Opus

질문없이 한번에 수행하고 싶으면 Codex CLI

UI 수정, 버그 픽스, 코드 리뷰는 Sonnet

Skills & Plugins

내용: 반복 업무는 표준화 (생산성은 어떤 날의 영감이 아니라 반복 가능한 루틴으로부터)

프롬프트 엔지니어링보다, 반복되는 동작을 패키징하는 것에 투자

일단은 직접 손을 더럽혀가며 끝까지 시도 (MASTER Framework)

Claude Code Agent Skills

Build-Measure-Learn Loop

내용: 자기 수정 루프를 최대한 반복하는 것이 품질의 핵심
- 출력을 검증할 수 있다면 반복 개선 가능

Ralph Loop

TO-DOs

1
정구봉님 AI Native Camp 1기 따라하기
https://github.com/ai-native-camp/camp-1/tree/main
2
Claude Code 완전 가이드: 해커톤 우승자의 70가지 파워 팁
Google Drive에서 보기
3
Agent Team + Claude Code 병렬 실행 (feat. Git worktree)
Threads 게시글 보기