프로젝트 부트스트랩 (Project Bootstrap)

가벼운 오케스트레이터입니다. 이 스킬은 다른 스킬을 포함하지 않습니다. 올바른 스킬을 올바른 단계에서 로드하고, 파일 생성을 위한 결정론적 스크립트를 실행하며, 사용자 답변으로 템플릿을 채웁니다. 아래 단계가 복사된 스킬과 충돌하는 경우 이 스킬이 우선합니다.

우선순위 규칙 — 설정 세션 전용

이 순서는 설정 세션 중에만, 이 스킬이 활성화된 동안에만 적용됩니다. 설정 중 지침이 충돌할 경우 다음 순서대로 적용합니다:

이 스킬 (project-bootstrap) — 설정 범위, 안전 규칙, 중지 규칙.
프로젝트 자체 CLAUDE.md — 생성 중인 그대로.
스택 스킬 — 예: 이 프로젝트 유형에 대한 SwiftUI 또는 디자인 스킬.
워크플로우 체크리스트 — references/workflow.md, 기본 프로세스.

설정이 종료되면 이 스킬은 더 이상 활성화되지 않으며 순서는 만료됩니다. 향후 세션에서 유일한 지침 세트는 프로젝트의 CLAUDE.md(및 해당 문서)입니다.

두 개의 경쟁 워크플로우 프레임워크를 설치하지 마십시오 (예: 무거운 사양 기반 프레임워크와 이 스킬의 워크플로우 체크리스트를 모두 설치하지 마십시오). 사용자가 워크플로우 프레임워크를 명시적으로 지정하는 경우, 기본 체크리스트 대신 해당 프레임워크를 사용하고 선택 사항을 docs/SETUP.md에 기록하십시오.

안전 규칙 (절대 재정의 불가)

생성된 파일에 비밀, API 키 또는 토큰을 절대 작성하지 말고, 클라이언트 앱 내에 서버 측 비밀(예: 은행 API 비밀)을 절대 넣지 마십시오.
사용자의 사전 승인 없이 기존 파일을 절대 덮어쓰지 마십시오 (scripts/bootstrap.py는 기본적으로 거부합니다. --force는 옵트인 전용이며, --force의 경우 스크립트는 각 파일을 <filename>.pre-bootstrap.bak에 먼저 백업합니다).
설정 전용: 이 세션에서 제품 기능 구축을 시작하지 마십시오.

워크플로우

다음 단계를 순서대로 실행하십시오. 건너뛰지 마십시오.

1. 인터뷰

references/interview.md를 로드하십시오. 질문을 한 번에 하나씩 묻고, 각 답변이 도착하면 즉시 관련 문서에 기록하십시오. 모든 것을 대화 메모리에 보관하지 마십시오. 사용자가 한 번에 여러 질문에 답하는 경우, 제공된 모든 답변을 기록하고, 해당 질문을 답변됨으로 표시한 후, 첫 번째 답변되지 않은 질문부터 계속 진행하십시오. 답변된 질문을 다시 묻지 마십시오. 모든 질문에 답변이 있거나 사용자가 명시적으로 연기할 때까지(연기된 항목은 docs/STATE.md에 기록) 인터뷰를 중단하지 마십시오.

2. 스크립트 실행

이 스킬의 디렉토리에서:

python3 scripts/bootstrap.py \
  --project-name "<인터뷰에서 얻은 이름>" \
  --type <ios|web|python|generic> \
  --purpose "<인터뷰에서 얻은 한 줄 목적>" \
  --target <새 프로젝트 저장소 경로> \
  --allow-placeholders

--allow-placeholders는 여기서 필수입니다. 이 단계에서는 템플릿에 여전히 {{...}} 채우기 토큰이 의도적으로 포함되어 있으므로(3단계에서 채움), 스크립트는 실패하는 대신 파일별 토큰 경고와 함께 검증을 통과합니다. 대상 디렉토리는 이미 존재해야 합니다(새 프로젝트 저장소). 스크립트는 오타난 경로를 생성하는 대신 대상이 없으면 오류를 발생시킵니다. 사용자가 명시적으로 해당 디렉토리를 생성하도록 요청하는 경우에만 --create-target을 전달하십시오.

이 명령은 디렉토리를 생성하고 템플릿을 결정론적으로 렌더링합니다. 정확히 무엇을 생성했는지, 건너뛰었는지, 덮어썼는지 보고하십시오. 스크립트가 보고하지 않은 파일이 존재한다고 주장하지 마십시오.

3. 인터뷰 답변으로 템플릿 채우기

생성된 파일의 나머지 채우기 프롬프트를 실제 답변으로 바꾸십시오: CLAUDE.md / AGENTS.md의 스택 및 빌드/테스트 명령, docs/PRD.md의 범위, docs/ROADMAP.md의 단계, docs/CONTEXT.md의 용어집 항목. CLAUDE.md는 짧게 유지하십시오. 약 80줄을 넘으면 세부 사항을 docs/로 옮기고 포인터를 남기십시오.

4. 스택 스킬 설치 — 고정, 설치 전 읽기

프로젝트 유형에 대한 참조 파일을 로드하고 여기에 나열된 스킬만 설치하십시오:

iOS → references/ios.md
Web → references/web.md
Python / generic → 기본적으로 스택 스킬 없음. SETUP에 해당 선택 사항을 기록하십시오.

나열된 모든 스킬은 참조 파일의 고정 스킬 테이블에서 정확한 커밋 SHA에 고정됩니다. 설치는 다음을 의미합니다: 저장소를 프로젝트의 .claude/skills/에 복제한 다음 git checkout으로 고정된 SHA를 체크아웃하십시오. 절대 움직이는 브랜치에서 설치하지 말고, 새 SHA를 기록하지 않고 핀을 올리지 마십시오.

설치 전 읽기는 필수입니다. 복제 후, 설치가 완료된 것으로 간주되기 전에 각 스킬에 대해:

해당 SKILL.md를 전체 읽으십시오(기본적으로 로드하는 다른 항목도 기록하십시오).
2-3줄 요약을 작성하십시오: 이 스킬이 향후 세션에 로드할 지침.
네트워크 액세스, 자격 증명 사용 또는 파괴적인 명령을 요청하는 항목을 플래그 지정하십시오. 플래그를 사용자에게 표시하십시오. 사용자의 사전 승인 없이 이러한 항목을 요청하는 스킬을 조용히 설치하지 마십시오.

docs/SETUP.md에 스킬별로 기록하십시오: 이름, 정확한 소스 URL, 고정 SHA, 설치 날짜, 읽기 요약. 스킬의 내용을 CLAUDE.md에 복사하지 마십시오. 스킬은 별도의 로드 가능한 단위로 유지됩니다.

5. 워크플로우 규칙 설정

references/workflow.md의 기본 루프를 CLAUDE.md에 아직 없으면 작성하십시오: 사양 → 계획 → 구축 → 별도 검토, 각 단계는 새로운 세션에서 진행하며, docs/STATE.md는 각 세션 종료 시 업데이트됩니다.

6. 검증 — 2단계 출력이 아닌 새로운 검사

지금, 새롭게 --verify 모드로 검증을 실행하십시오(대상을 현재 상태 그대로 읽고 아무것도 수정하지 않음):

python3 scripts/bootstrap.py --verify --target <프로젝트 저장소 경로>

2단계 실행의 출력을 재사용하지 마십시오. 해당 실행은 3단계의 채우기 및 4단계의 설치 이전의 것입니다. 검증 명령에 --allow-placeholders를 추가하지 마십시오. 스크립트는 해당 조합을 완전히 거부합니다. 검증은 채워진 파일에 대해 실행되어야 하기 때문입니다. --verify는 생성된 파일에 남아 있는 채우기 토큰이 있으면 실패합니다. 토큰 때문에 실패하면 3단계가 완료되지 않은 것입니다. 돌아가서 나머지 토큰을 채우고 --verify를 통과할 때까지 다시 실행하십시오. --verify는 토큰뿐만 아니라 내용도 확인합니다: PRD의 범위 외 목록은 비어 있지 않아야 하며, docs/SETUP.md는 설치된 각 스킬에 대한 고정 SHA를 기록하거나(또는 스택 스킬이 설치되지 않았음을 명시) 해야 합니다. 또한:

.gitignore가 이 스택의 비밀을 다루는지 확인하십시오.
프로젝트의 빈/템플릿 앱이 CLAUDE.md에 기록된 빌드 명령으로 여전히 빌드되는지 확인하십시오(빌드 명령이 아직 존재하는 경우).
docs/SETUP.md를 다시 읽으십시오: 설치된 모든 스킬이 소스 URL, 고정 SHA, 설치 날짜 및 읽기 요약과 함께 나열되어야 합니다.

7. 커밋

하나의 커밋, 그 이상은 없습니다:

chore: initial project setup

설정 파일만 포함하십시오. git 사용자 ID 또는 원격이 구성되지 않은 경우, 그렇게 말하고 커밋을 사용자에게 맡기십시오. 둘 중 하나를 임의로 생성하지 마십시오.

8. 중지

사용자에게 생성된 파일 트리와 docs/ROADMAP.md의 Phase 1을 보여주십시오. 그런 다음 중지하십시오. Phase 1을 시작하지 말고, 기능을 구축하지 말고, "뼈대만이라도 시작해 드릴까요?"라고 제안하지 마십시오. 다음 단계는 새로운 세션에 속합니다 (references/workflow.md 참조).

탈출구: 사용자가 명시적으로 계속 진행하도록 지시하지 않는 한 중지하십시오. 사용자가 계속 진행을 요청하면, Phase 1은 여전히 새로운 세션에서 수행하는 것이 좋다고 한 번 권장한 후, 사용자의 지시에 따라 계속 진행하십시오.

참조 파일 — 요청 시 로드

파일	로드 시점
`references/interview.md`	항상 — 1단계.
`references/ios.md`	프로젝트 유형이 `ios`인 경우.
`references/web.md`	프로젝트 유형이 `web`인 경우.
`references/workflow.md`	5단계 및 부트스트랩된 저장소에서 작업하는 모든 후속 세션.

프로젝트 부트스트랩