| name | project-bootstrap |
| description | 새 프로젝트 시작 시 최소 골격과 진입 문서를 빠르게 잠그는 스킬 |
| user_invocable | true |
| tags | ["bootstrap","scaffold","startup","docs"] |
| trigger | 새 프로젝트를 시작하거나 기존 프로젝트를 하네스 구조로 옮길 때 |
| version | 5 |
Project Bootstrap
새 프로젝트의 "코드 이전에 필요한 운영 골격"을 잠그는 스킬이다.
First Files
AGENTS.md
AGENTS.md
ai-context/START-HERE.md
docs/status/PROJECT-STATUS.md
docs/status/DECISION-LOG.md
docs/ref/ARCHITECTURE.md
docs/ref/PRD.md
docs/ref/PROJECT-PLAN.md
docs/ref/STACK-PROFILES.md
Rule
- 구현보다 먼저 목적, 구조, 검증 경로를 잠근다.
Use When
- 새 저장소를 처음 만들 때
- hackathon / MVP / 새 side project 시작 시
- 기존 저장소에 AI 협업 구조를 심고 싶을 때
Inputs
- 프로젝트명
- 새 프로젝트 위치
- 한 줄 설명
- 첫 검증 명령 후보
- 필요 시 stack profile 이름
Fast Path
템플릿 전체 루트에서:
bash scripts/bootstrap-project.sh <project-name> <destination-path>
예:
bash scripts/bootstrap-project.sh dogcoach-v2 /tmp/dogcoach-v2
stack-aware 예:
bash scripts/bootstrap-project.sh dogcoach-v2 /tmp/dogcoach-v2 --stack-profile "Next.js + FastAPI + Supabase"
Steps
Step 1: scaffold 복사
scaffold/project-root/를 새 프로젝트 루트에 복사한다.
복사 후 최소 구조:
project-root/
├── AGENTS.md
├── AGENTS.md
├── ai-context/
├── docs/
├── .Codex/
├── .codex/
├── .obsidian/
└── scripts/
Step 2: 이름과 날짜 치환
bootstrap-project.sh는 아래 placeholder를 치환한다.
__PROJECT_NAME__
__DATE__
--stack-profile이 있으면 STACK-PROFILES.md에서 해당 profile starter를 읽어
PROJECT-PLAN.md
ARCHITECTURE.md
PROJECT-STATUS.md
- 필요 시
PRD.md
초안을 profile-aware하게 채운다.
수동 복사했다면 직접 바꾼다.
Step 3: entry 문서 잠금
반드시 먼저 채우는 파일:
AGENTS.md — 읽기 순서와 규칙
AGENTS.md — 짧은 진입점
ai-context/START-HERE.md — 현재 초점
Step 4: status 문서 잠금
PROJECT-STATUS.md에 아래를 적는다.
- current phase
- active tracks
- 첫 검증 명령
- next actions
DECISION-LOG.md에는 초기 구조 채택 이유를 남긴다.
Step 5: 구조 문서 잠금
ARCHITECTURE.md에는 최소한 아래를 적는다.
- 시스템 overview
- 레이어
- 외부 의존성
- repo boundary
PRD.md에는 goal/scope/non-goal을 적는다.
STACK-PROFILES.md에서 가장 가까운 starter profile을 고른다.
PROJECT-PLAN.md에는 최소한 아래를 적는다.
- phases
- assumptions
- risks
- dependencies
- verification
- exit criteria
- intake verdict
- impact map summary
- sub-agent opportunities
PROJECT-STATUS.md에는 추가로 아래를 적는다.
- current sub-agent work
- handoff capsule
- evidence status
Step 6: 운영 자산 최소 연결
.Codex/settings.json
.codex/hooks.json
.obsidian/templates.json
scripts/check-project.sh
Step 7: 첫 검증 실행
새 프로젝트 루트에서:
bash scripts/check-project.sh
그 다음 스택별 검증 명령을 PROJECT-STATUS.md에 추가한다.
Outputs
- 실행 가능한 프로젝트 골격
- AI 진입 문서
- 최소 상태/구조 문서
- 계획 문서
- stack profile reference
- 첫 검증 경로
Verify
Failure / Fallback
- 프로젝트명이 아직 불확실하면 placeholder 상태로 먼저 부트스트랩한다
- docs를 다 채우기 부담되면
AGENTS, PROJECT-STATUS, ARCHITECTURE 세 개만 먼저 잠근다
- Obsidian을 안 쓰면
.obsidian은 남겨두되 최소 설정만 유지한다