새로운 프로젝트 생성하기 프롬프트

0. 프로젝트 폴더 준비

    터미널에서 새로운 폴더 하나를 만들고 그 안으로 이동합니다.
    예: mkdir my-new-app && cd my-new-app

    이 폴더 안에서 claude 명령을 실행해 Claude Code 세션을 시작합니다.
    이 폴더가 바로 “이 프로젝트(저장소)”가 됩니다.

1. 설계·구조 계획 (Plan Mode)

이때는 아직 파일이 거의 없거나 비어 있어도 괜찮습니다.

text

이 프로젝트를 완전히 새 앱으로 시작하려고 합니다. 목표: - [여기에 앱 목적 한 줄 요약] 요청: 1. 프로젝트 구조(폴더, 파일)를 먼저 설계해 주세요. 2. 가장 작은 첫 마일스톤을 정의해 주세요. 3. 그 마일스톤을 달성하기 위한 작업 단계를 나눠 주세요. 4. 기술 스택과 폴더 이름 관례도 제안해 주세요. 5. 나중에 이 설계를 바탕으로 구현을 시작할 수 있게, 필요한 파일 목록을 먼저 정리해 주세요.

이렇게 하면 Claude가 구조를 먼저 잡고, “프로젝트 초기 설계”라는 단계를 따릅니다.
새로운 프로젝트 시작 시 구조 설계 → 초기 파일 생성 → 첫 마일스톤을 권장합니다.

 

2. 초기 파일·구조 생성

설계가 나왔으면:

위 설계에 맞춰 초기 파일과 폴더를 생성해 주세요. 요청: - 앱 실행에 필요한 최소 파일(예: main.js, index.tsx, main.py 등) - 기본 폴더 구조(components/, pages/, utils/ 등) - 설정 파일(예: package.json, requirements.txt, .env 등) - 필요한 경우 .gitignore, README.md 주의: - 기존에 없던 파일만 생성 - 아직 기능 구현은 하지 말고, 구조만 잡기

이 과정에서 Claude Code가 실제로 파일을 생성하며, 새 프로젝트를 “구조가 잡힌 상태”로 만들어 줍니다.

3. CLAUDE.md로 규칙 정하기

이제 프로젝트가 생겼으니, 규칙을 문서화 합니다.

이 프로젝트를 위한 CLAUDE.md 파일을 만들어 주세요. 내용: - 프로젝트 목적: [한 줄] - 사용 기술 스택: [프론트/백, 언어, 프레임워크] - 파일 구조 규칙 - 코드 스타일 규칙 - “이 저장소”에서 절대 해서는 안 되는 일(예: 큰 리팩터링 금지, 특정 파일은 건드리지 말기 등) - 작업 방식: 탐색 → 계획 → 구현 → 테스트 → 커밋 이 파일을 먼저 생성하고, 이후에는 모든 작업에서 이 파일을 참고하게 해 주세요.

Claude Code 공식 문서와 가이드에서도 CLAUDE.md를 프로젝트별 “지침서”로 사용하라고 권장합니다.

4. 첫 마일스톤 구현 (완전 처음부터 시작일 때)

이제 “실제 구현”을 시작합니다.

이 프로젝트는 아직 초기 상태입니다. 요청: 1. 설계에 따라 첫 마일스톤(최소 동작 버전)을 정의 2. 그 마일스톤을 달성하기 위한 작업 단계를 나눠서 설명 3. 첫 단계(예: 기본 화면 표시, 랜딩 페이지, API 연결 없이 더미 데이터 등)만 구현 제약: - 기존 구조를 유지 - 불필요한 리팩터링 금지 - 기능은 작게 나눠서 한 번에 한 단계씩 진행

이렇게 하면 “완전 빈 폴더”에서 시작해도, Claude가 프로젝트를 점진적으로 구축해 줍니다.

5. 이후 기능 추가

아래 기능을 추가해 주세요. 기능: - [여기에 기능 설명] 요구사항: - 관련 파일만 최소한으로 수정 - 기존 동작은 유지 - 에러 처리 포함 - 필요하면 테스트도 추가 진행 방식: - 먼저 구현 계획을 짧게 설명 - 그다음 코드 수정 - 마지막에 변경한 파일과 이유를 요약

6. 버그 수정

다음 오류를 수정해 주세요. 증상: - [오류 설명] 재현 방법: - [재현 단계] 에러 로그: - [에러 메시지] 추가 정보: - 관련 파일: [파일명] - 기대 동작: [기대 결과] 요청: - 원인 추정 - 수정 방안 - 최소 수정으로 해결 - 필요하면 테스트 추가

7. 리팩터링

이 코드를 리팩터링해 주세요. 목표: - 가독성 개선 - 중복 제거 - 함수/컴포넌트 분리 - 기존 동작 유지 제약: - 외부 동작 바꾸지 않기 - 큰 구조 변경은 피하기 - 테스트가 있으면 깨지지 않게 유지 먼저 리팩터링 계획을 제안한 뒤 진행해 주세요.

 

리팩터링은 기능 추가보다 위험할 수 있어서, 먼저 계획을 받는 방식이 안정적입니다. 또한 CLAUDE.md에 규칙을 적어 두면 Claude가 프로젝트 스타일을 더 잘 따릅니다.

8. 테스트

다음 코드에 대한 테스트를 추가해 주세요. 대상: - [파일명 또는 함수명] 요청: - 정상 케이스 - 예외 케이스 - 경계값 테스트 포함 - 기존 테스트 스타일에 맞추기 테스트가 없으면 가장 적절한 테스트 프레임워크 기준으로 작성해 주세요.

작은 단위로 테스트를 붙이면 기능 변경 후 검증이 쉬워집니다. Claude Code 관련 실전 가이드들도 구현 후 테스트와 커밋을 자주 하라고 권장합니다.

9. 커밋 전 점검

변경된 내용을 기준으로 커밋 전에 점검해 주세요. 확인 항목: - 빌드나 실행에 문제 없는지 - 누락된 테스트가 있는지 - 불필요하게 수정된 파일이 있는지 - 개선할 점이 있는지 마지막에 커밋 메시지 초안도 제안해 주세요.