Claude를 활용해 체계적으로 깔끔한 프로젝트를 구축하는 방법
How to use Claude to build clean projects strategically
핵심 요약
Claude로 대규모 프로젝트를 개발할 때 발생하는 코드 드리프트와 비효율적인 프롬프트 소모를 줄이는 전략적 워크플로우를 논의합니다.
- 프로젝트 구조화 — 로드맵, 저널, 티켓 등을 포함한 표준화된 파일 구조를 활용함
- 컨텍스트 관리 — 세션별로 명확한 목표를 설정하고 /clear 명령어를 통해 토큰 낭비를 방지함
- Git 활용 — Git을 단일 진실 공급원으로 삼아 세션 간 변경 사항을 추적하고 관리함
- 자동화된 피드백 — 린팅, 테스트, 타입 체크 등을 통해 AI가 스스로 코드를 검증하도록 유도함
최근 Claude Pro를 구독하고 웹사이트, 앱, 잠재적인 AI 기반 프로젝트를 포함한 여러 프로젝트를 시작했습니다.
AI 코딩 어시스턴트와 작업하면서 느낀 문제점 중 하나는, 함께 작업하는 시간이 길어질수록 프로젝트가 점점 방향을 잃기 시작한다는 것입니다. Claude에게 한 가지 문제를 해결해달라고 요청하고 다음 기능으로 넘어가면 또 다른 문제가 나타나고, 결국 이전 변경 사항으로 인해 발생한 문제를 해결하는 데 너무 많은 프롬프트를 소비하게 됩니다.
Claude Pro에서는 세션 제한과 주간 사용량 제한이 있기 때문에 이런 상황이 특히 더 답답합니다. 끝없는 디버깅에 사용량을 낭비하기보다는 다른 프로젝트를 만드는 데 사용하고 싶거든요. 현재 Claude Pro의 세션 사용량 제한은 5시간마다 초기화되며 별도의 주간 제한도 있어서, 효율적인 프롬프트 사용이 저에게는 매우 중요합니다.
Claude로 대규모 프로젝트를 구축하면서 프롬프트 수를 최소화하고 오류가 누적될 가능성을 줄일 수 있는 가장 좋은 워크플로우/전략이 무엇인지 궁금합니다.
제가 달성하고자 하는 것은 대략 다음과 같습니다:
프로젝트 계획 → 완전한 명세서 작성 → Claude에게 아키텍처 제공 → 약 5~10개의 주요 프롬프트로 구축 → 요구사항에 맞춰 테스트 → 남은 문제 해결 → 프로덕션 준비
Claude Pro/Claude Code로 비교적 큰 프로젝트를 구축해 본 분들께 여쭤봅니다.
가장 적은 오류와 가장 적은 프롬프트로 작업할 수 있었던 워크플로우는 무엇인가요?
그리고 구체적으로, 사전에 상세한 프로젝트 명세서/PDF를 만드는 것이 실제로 가치가 있는지, 아니면 Claude가 안정적으로 프로젝트를 구축할 수 있도록 구조화하는 더 좋은 방법이 있는지 궁금합니다.
