Claude Code를 사용할 때는 “바로 코딩”을 금지하고, 먼저 코드베이스를 깊이 있게 읽어 research.md로 정리하게 한 뒤 해당 내용을 검토하고, 이어서 plan.md에 상세한 구현 계획을 작성하도록 합니다. 이후 계획 문서에 직접 주석을 달아 제약, 수정, 거절, 도메인 지식을 추가하고, “아직 구현하지 말라”는 가드를 둔 상태에서 1~6회 수정 루프를 반복하며 계획을 프로젝트 현실에 맞게 다듬습니다. 계획이 확정되면 세부 Todo 체크리스트를 추가하고, 그 다음에야 “계획대로 전부 구현하고, 타입 체크를 지속적으로 수행하며 진행 상황을 plan에 체크하라”는 표준 프롬프트로 실행을 맡깁니다. 핵심은 마크다운 문서를 공유된 기준으로 삼아 검토, 주석, 수정을 통해 인간이 판단을 개입시키고, 구현은 기계적으로 수행하도록 만들어 잘못된 가정으로 인한 대규모 되돌림과 주변 시스템 파손을 예방하는 워크플로우입니다.
