# claude-scaffold

한국어 | [English](README.en.md) | [简体中文](README.zh.md) | [日本語](README.ja.md)

[](https://github.com/leeyudok/claude-scaffold/actions/workflows/test.yml) [](LICENSE)

**프레임워크가 아니라 fork-and-fill 미니멀 부트스트랩** — Claude Code 용 `.claude/` 초기 구성에 **강제되는** 규칙 티어 P0(즉시 중단)/P1(PR 차단)/P2(리뷰 지적)를 얹고, 스택 프리셋을 pre-commit 게이트 하나로 합성한다.


_30초 데모: 명령 한 번 → `.claude/` 완성 → 시크릿 커밋은 게이트가 차단. 재현은 `vhs docs/assets/demo.tape`._

## 퀵스타트

```bash # clone 없이 원커맨드 curl -fsSL https://raw.githubusercontent.com/leeyudok/claude-scaffold/main/bin/claude-scaffold.sh | bash -s -- --stack nextjs --yes

# 또는 로컬 clone 에서 (옵션 생략 시 대화형 프롬프트) git clone https://github.com/leeyudok/claude-scaffold.git claude-scaffold/bin/claude-scaffold.sh /path/to/new-repo --forge github --stack nextjs,bun --name my-app ```

결과물은 채워진 `.claude/` 디렉터리(agents·skills·hooks·paths 스코프 rules·memory), `AGENTS.md` 프로젝트 브레인, 합성된 pre-commit 게이트 하나 — 전부 직접 소유하는 평범한 파일이다. 전체 옵션은 [사용법](#사용법-1--스크립트) 참조.

## 무엇을 얻나 — 입문자 기준

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/overview-dark.svg"> <img alt="한 명령 → 직접 소유하는 .claude/ (agents·skills·commands·rules·hooks·memory·AGENTS.md) → 강제 게이트(.env·빌드 깨짐·린트 실패 커밋 차단)" src="docs/assets/overview-light.svg"> </picture>

설치 1분 뒤부터 Claude 가 "규칙을 아는 팀원"처럼 움직인다. 프롬프트를 잘 몰라도:

- **워크플로가 기본값**: "로그인 기능 만들어줘" 한 마디에 이슈 등록 → 브랜치 → 구현 → 테스트 동반 → PR/MR 까지 스스로 따른다 (`/fix-issue`, `/sdlc-cycle` 은 역할 분리 에이전트 3개가 무인 사이클). - **실수는 기계가 차단**: `.env`/시크릿 커밋, 타입에러·빌드 깨진 커밋, 신규 JSP 스크립틀릿은 pre-commit 훅이 막고, 복잡도 15 초과 함수는 경고한다 — Claude 가 깜빡해도 걸리는 강제 게이트. - **명령 한 방 시리즈**: `/review`(코드리뷰+보안감사 이중), `/status`, `/knowledge-graph`(문서 링크 검사), `/sonar`. - **요구사항 다지기는 둘 중 골라서**: 스펙을 다회전으로 압박 검증하는 **`grill-me`**(동봉), 아이디어를 함께 발산·수