convez.ai
PluginProdutividadeIntermediário
seungjaeyuu

Claude Project Bootstrap

seungjaeyuu/claude-project-bootstrap

Bootstrap inteligente com negative-first rules + E2E baseline

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin que inicializa novos projetos com regras negative-first, harness E2E baseline e otimização de contexto. Converte aprendizados de projetos anteriores em padrões reutilizáveis, com suporte para Bash, Firebase, SEO/GEO e checklist de release automatizado.

Instalação

$npx convez-ai seungjaeyuu/claude-project-bootstrap

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 5 meses
Versão
v0.4.1
Issues abertas
2
Contribuidores
1

Casos de uso

  • Inicializar novos projetos com configuração otimizada
  • Padronizar checklist de qualidade e release entre projetos
  • Integrar testes E2E, Firebase e controle de permissões Bash
  • Auditar contexto, baseline e qualidade de projetos existentes

Veredito

Plugin robusto e bem documentado para quem trabalha com múltiplos projetos Python/web. Filosofia de negative-first rules e reutilização de patterns é sólida; exige familiaridade com CLI e fluxos de projeto estruturados.

README

A tradução para o português deste README ainda está na fila.

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-permissionBash 권한 단계 도입·변경 (YOLO/Standard/Strict/None)
/claude-project-bootstrap:firebase-isolationFirebase 격리 도입 (.firebaserc + predeploy hook)
/claude-project-bootstrap:slim-claude-mdCLAUDE.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로 선택했을 때의 프로젝트 구조입니다. 실제로는 선택한 옵션에 따라 필요한 파일만 생성됩니다.

your-project/
├── CLAUDE.md                        ← 횡단 가드레일 + 발견 트리거 (~99줄)
├── INDEX.md                         ← 프로젝트 지도
├── .gitignore                       ← 보안·생성물 보호
├── .claudeignore                    ← 컨텍스트 최적화
├── .secret/                         ← 비밀 파일 (git 제외)
│
├── .claude/
│   ├── settings.json                ← Bash 권한 + Hook 설정
│   └── commands/
│       ├── build.md                 ← /build 커맨드
│       ├── check.md                 ← /check 커맨드
│       └── status.md                ← /status 커맨드
│
├── docs/
│   ├── rules/                       ← 영역별 RULES (on-demand 로딩)
│   │   ├── RULES_E2E.md
│   │   ├── RULES_DATA_INTEGRITY.md
│   │   ├── RULES_ACCESSIBILITY.md
│   │   ├── RULES_VERSIONING.md
│   │   ├── RULES_SEO.md
│   │   ├── RULES_GEO.md
│   │   └── ...
│   └── test/
│       └── baseline/                ← E2E 베이스라인 문서
│
├── scripts/
│   ├── pre-commit-framework.sh      ← pre-commit hook 본체
│   ├── post-merge.sh                ← post-merge hook
│   ├── check_seo.py                 ← SEO 14항목 검증
│   ├── check_doc_size.py            ← 문서 크기 검증
│   ├── check_accessibility_identifiers.py
│   └── ...
│
├── SEO_GUIDELINE.md                 ← SEO + GEO 가이드라인 (웹 프로젝트)
├── TESTING_FRAMEWORK.md             ← E2E 테스트 규약
├── TASK.md                          ← 개발 백로그 인덱스
└── tasks/                           ← 백로그 상세 (DEV-XXX.md)

영역별 RULES (on-demand 로딩)

CLAUDE.md 본체(~99줄)는 횡단 가드레일 + 발견 트리거 표만 유지. 작업 시점에 해당 RULES만 read:

RULES 파일트리거
RULES_E2E.mdE2E 테스트 / Codex orchestrator 작업
RULES_DATA_INTEGRITY.mdFirestore / 백엔드 데이터 호출
RULES_ACCESSIBILITY.mdUI 컴포넌트 편집
RULES_TERMINOLOGY.md도메인 용어 등장
RULES_DICT_DUPLICATES.mddict literal 편집
RULES_REFACTORING.md100줄+ 파일 변경 / 대규모 리팩토링
RULES_VERSIONING.md버전 변경 / 릴리스 / main 커밋
RULES_PROJECT_LIFECYCLE.md출시 준비 / 프로젝트 단계 점검
RULES_SEO.md랜딩 페이지 HTML / 메타 태그 / SEO·GEO 관련 수정
RULES_GEO.mdllms.txt / llms-full.txt / LLM 크롤러 / GEO 관련 수정
RULES_MACOS_RELEASE.md서명·공증·배포(codesign/notarytool/dmg) 작업

빌드번호 자동 관리

플랫폼정본 파일Hook 동작
iOS (XcodeGen)project.yml → CURRENT_PROJECT_VERSIONpre-commit: +1 자동 증가 + xcodegen generate + .xcodeproj staging
macOS (SwiftUI/AppKit)project.yml → CURRENT_PROJECT_VERSIONpre-commit: +1 자동 증가 + xcodegen generate + .xcodeproj staging
Androidbuild.gradle(.kts) → versionCodepre-commit: +1 자동 증가
Web / Nodepackage.json → buildNumberpre-commit: +1 자동 증가

post-merge hook: merge 후 project.yml 변경 감지 시 .xcodeproj 자동 재생성 (빌드번호 불변).


설계 철학

네거티브 우선 — 규칙은 "하지 말라"만 적고 그 외는 모두 허용. LLM이 자력 판단 가능한 일반 모범 사례는 제외.

4층 규칙 범례 — 각 규칙에 강제력 수준을 명시합니다:

flowchart LR
    G["🚫 Guardrail<br>위반 시 차단"]
    S["📐 Schema<br>형식 강제"]
    R["📎 참조<br>참고 자료"]
    H["💡 권장<br>선택 사항"]
    G --- S --- R --- H
층위의미예시
🚫 Guardrail위반 시 커밋 차단 또는 즉시 수정git reset --hard 사용 금지
📐 Schema정해진 형식을 따라야 함빌드번호는 정본 파일에서만 관리
📎 참조필요 시 참고하는 자료테스트 작성 가이드라인
💡 권장따르면 좋지만 강제는 아님Notion에 개발계획 기록

컨텍스트 윈도우는 유한 자원 — ~200K 토큰 중 플러그인/MCP가 ~19% 소비. .claudeignore, enabledPlugins, on-demand RULES로 최적화.

단일 SSOT + 발견 경로 최적화 — 같은 규칙을 여러 곳에 복붙하지 않음. 작업 종류 → RULES 매핑 트리거 표로 필요한 시점에만 read.

상세 근거: docs/design-principles.md


문서


Contributing

See CONTRIBUTING.md. Issues and PRs welcome.

License

MIT © 2026 Yu Seungjae

Ver o original no GitHub

Bom para

Relacionados