claude-project-bootstrap
Claude Code plugin: 네거티브 우선 원칙 + 베이스라인 E2E 하네스 + 컨텍스트 최적화로 새 프로젝트를 부트스트랩합니다.
실전 프로젝트에서 반복된 시행착오를 다음 프로젝트의 기본값으로 적용하는 재사용 프레임워크입니다.
English README
빠른 시작
# 1. 마켓플레이스 등록
claude plugin marketplace add seungjaeyuu/claude-project-bootstrap
# 2. 설치
claude plugin install claude-project-bootstrap
# 3. 새 프로젝트 폴더에서 Claude Code 실행 후:
/claude-project-bootstrap:kickoff
커맨드 네임스페이스: 플러그인 커맨드는 /<plugin-name>:<command> 형식 prefix 가 필수입니다. /kickoff 단독 호출은 Unknown command 에러 — 반드시 /claude-project-bootstrap:kickoff.
업데이트 (기존 설치 사용자)
# 1) 마켓플레이스 메타데이터 새로고침
claude plugin marketplace update seungjaeyuu-plugins
# 2) 재설치 = 업데이트
claude plugin uninstall claude-project-bootstrap@seungjaeyuu-plugins
claude plugin install claude-project-bootstrap@seungjaeyuu-plugins
/plugin 대화형 UI의 Marketplaces → Update marketplace listings 또는 auto-update 토글로도 가능합니다.
제공하는 것
어떤 커맨드를 쓸까?
처음 사용한다면 /kickoff 으로 시작하세요. 어떤 커맨드가 필요한지 모르겠다면 /guide 가 안내합니다.
flowchart TD
START{"어떤 작업을 하려나요?"}
START -->|"새 프로젝트 시작"| INIT["/kickoff"]
START -->|"기존 설정 변경"| INIT
START -->|"품질·컨텍스트 점검"| AUDIT["/audit"]
START -->|"출시 준비 점검"| RELEASE["/release"]
START -->|"배포 문서 구축"| DEPLOY["/deploy-setup"]
START -->|"뭘 해야 할지 모르겠다"| GUIDE["/guide"]
RELEASE -.->|"배포 문서 없으면"| DEPLOY
INIT -.->|"SEO + GEO만 추가"| SEO["/seo-setup"]
INIT -.->|"Bash 권한만"| BASH["/bash-permission"]
INIT -.->|"Firebase만"| FIREBASE["/firebase-isolation"]
슬래시 커맨드
메인 커맨드 (v0.3.0+, deploy-setup v0.3.4+)
| 커맨드 | 용도 |
|---|
/claude-project-bootstrap:kickoff | 새 프로젝트 초기화 + 기존 프로젝트 설정 변경 (대화형 질의 최대 11회) |
/claude-project-bootstrap:audit | 품질·컨텍스트·베이스라인 일괄 점검 (--context, --baseline, --quality) |
/claude-project-bootstrap:release | 출시 준비 체크 (배포 문서 체인 + 버전, 보안, 법적, i18n, 테스트, 접근성, SEO + GEO 7대 카테고리) |
/claude-project-bootstrap:deploy-setup | 배포 문서 레이지 참조 체인 구축 (CLAUDE.md → INDEX.md → DEPLOYMENT_INDEX.md → 릴리스 기록) |
/claude-project-bootstrap:guide | 프로젝트 단계 자동 감지 + 적합한 커맨드 안내 |
기능별 커맨드 (v0.2.0+, 하위호환 유지)
| 커맨드 | 용도 |
|---|
/claude-project-bootstrap:baseline-review | → /audit --baseline 으로 통합 (하위호환 유지) |
/claude-project-bootstrap:bash-permission | Bash 권한 단계 도입·변경 (YOLO/Standard/Strict/None) |
/claude-project-bootstrap:firebase-isolation | Firebase 격리 도입 (.firebaserc + predeploy hook) |
/claude-project-bootstrap:slim-claude-md | CLAUDE.md 슬림화 + 영역별 RULES 분리 |
/claude-project-bootstrap:doc-size-hook | 문서 크기 임계치 hook 도입 (CLAUDE.md 120줄 / RULES 250줄) |
/claude-project-bootstrap:seo-setup | 기존 웹 프로젝트에 SEO + GEO 가이드라인·검증 스크립트·hook 도입 |
/kickoff 워크플로우
/kickoff 실행 시 대화형 질의를 통해 프로젝트에 필요한 옵션만 선택합니다. 각 질의에서 Yes를 선택하면 하위 질의가 추가됩니다.
flowchart TD
INIT["/kickoff 실행"] --> Q0["Q0: Bash 권한 단계 선택<br>(YOLO / Standard / Strict / None)"]
Q0 --> Q1{"Q1: E2E 테스트<br>프레임워크?"}
Q1 -->|Yes| Q1S["Q1a: 앱 타입 선택<br>Q1b: Hook 자동 설치?"]
Q1 -->|No| Q2
Q1S --> Q2{"Q2: 백엔드<br>사용?"}
Q2 -->|Yes| Q2S["Q2a: 백엔드 종류 선택<br>Q2b: Project ID 입력"]
Q2 -->|No| Q3
Q2S --> Q3{"Q3: TASK.md<br>백로그?"}
Q3 --> Q4{"Q4: 웹 SEO + GEO?"}
Q4 -->|Yes| Q4S["Q4a: HTML 경로 입력<br>Q4b: 사이트 URL 입력"]
Q4 -->|No| GEN
Q4S --> GEN["파일 생성 + 완료 리포트 출력"]
모든 질의의 기본값은 No 입니다. 아무것도 선택하지 않으면 최소한의 파일만 생성됩니다 (Minimal tier).
단, macOS 프로젝트는 tier와 무관하게 서명·공증·배포 가드레일(docs/rules/RULES_MACOS_RELEASE.md)을 함께 받습니다 — 배포는 tier 선택과 독립적으로 필요하기 때문입니다.
생성되는 파일 (옵션별)
| 옵션 | 생성되는 파일 |
|---|
| 기본 (모두 필수) | CLAUDE.md, INDEX.md, .gitignore, .claudeignore, .secret/.gitkeep |
.claude/commands/ | build.md, check.md, status.md (빌드 명령 분리) |
| E2E 테스트 프레임워크? (Yes) | TESTING_FRAMEWORK.md, {APP}_BASELINE.md, scripts/baseline.yml |
| Firebase/Supabase? (Yes) | default-deny 보안 규칙 안내 + .env.example 초안 |
| Hook 자동 설치? (Yes) | .claude/settings.json, .git/hooks/pre-commit + post-merge symlink, scripts/check_*.py |
| TASK.md 백로그? (Yes) | TASK.md + tasks/DEV-XXX.md 2계층 구조 |
| 웹 SEO + GEO? (Yes) | SEO_GUIDELINE.md, scripts/check_seo.py, docs/rules/RULES_SEO.md, docs/rules/RULES_GEO.md |
생성 파일 구조
모든 옵션을 Yes로 선택했을 때의 프로젝트 구조입니다. 실제로는 선택한 옵션에 따라 필요한 파일만 생성됩니다.
