본문으로 건너뛰기
RAISE LABRAISE LAB

VIDEO NOTE

Claude Code로 복잡한 개발을 성공시키는 기획·코딩 분리 워크플로우

김플립 - LLM 코딩 · 11분 · 고급 · 26. 11. 18. · 분야별 AX 사례 › 서비스 제작

YouTube 에서 보기 · 김플립 - LLM 코딩 (새 탭에서 열림)

AI 코딩 도구로 복잡한 작업을 다룰 때 결과물이 무너지는 문제를 방지하기 위해 기획과 코딩을 철저히 분리하는 워크플로우를 제시한다. 코드 작성을 바로 시키지 않고 리서치와 상세 계획을 마크다운 문서로 작성한 뒤, 인간이 직접 주석 메모를 달아 수정하는 루프를 거친다. 계획 검증이 끝난 뒤에만 일괄 구현 프롬프트를 내려 AI가 기계적으로 코드를 완성하게 만든다.

핵심

  • 작성된 계획을 사람이 직접 검토하고 승인하기 전까지 Claude Code에 코드를 작성하게 하지 않는 것이 핵심 원칙이다.
  • 리서치 단계에서는 구두 요약이 아니라 research.md 파일에 코드베이스 분석 내용을 깊이 있게 정리하도록 지시한다.
  • 기획 단계에서는 내장 플랜 모드 대신 에디터 편집과 버전 관리가 가능한 plan.md 마크다운 파일을 생성해 관리한다.
  • plan.md 안에 인라인 주석 메모를 달고 '아직 구현하지 마'라는 제약을 걸어 계획의 세부 방향과 제약 조건을 확정한다.
  • 구현 단계에서는 typecheck 실행 및 any/unknown 타입 금지 규칙을 포함한 정제된 프롬프트로 멈춤 없이 일괄 작성하게 한다.
  • 개발 방향이 잘못되었을 때는 그 위에서 덧대어 고치지 말고 git 커밋을 통째로 되돌린 뒤 범위를 좁혀 다시 시도한다.

RAISE LAB 에서 배우는 사람에게

Claude Code를 쓸 때 바로 코딩을 시키지 않고 마크다운 계획서와 주석 루프로 인간의 통제권을 유지하는 실무 워크플로우를 배울 수 있다.

챕터

  1. 0:00바이브코딩의 한계와 핵심 원칙 (새 탭에서 열림)
  2. 1:341단계: 리서치 문서화 (새 탭에서 열림)
  3. 3:162단계: 마크다운 파일 기반 계획 수립 (새 탭에서 열림)
  4. 4:31주석 달기 반복 사이클 (새 탭에서 열림)
  5. 6:373단계: 기계적 구현 및 프롬프트 규칙 (새 탭에서 열림)
  6. 8:08실패 시 깃 롤백 원칙 (새 탭에서 열림)
  7. 8:424단계: 운전대를 잡고 방향 조정하기 (새 탭에서 열림)
  8. 9:325단계: 긴 단일 세션 유지와 요약 (새 탭에서 열림)

이 노트는 RAISE LAB 운영팀이 고른 영상을 AI(Gemini)가 보고 한국어로 정리한 것입니다. 영상의 저작권은 원작자에게 있고, 자막·대본은 싣지 않습니다. 김플립 - LLM 코딩 원작자 채널 (새 탭에서 열림)

서비스 제작