claude-code-project-bootstrap

Claude Code Project Bootstrap

A skill pack for Claude Code that sets up guardrails, hooks, and git workflow automation for any development project.

Claude Code is Anthropic's CLI tool that lets Claude work directly in your terminal — reading files, running commands, editing code. This skill pack adds safety rails so Claude can work autonomously without accidentally breaking things.

• Blocks destructive commands (force push, rm -rf, git reset --hard)
• Gates commits behind passing builds and tests
• Protects sensitive files (.env, credentials, keys)
• Enforces git conventions (feature branches, conventional commits)
• Scans for hardcoded secrets in every written file
• Auto-formats code after writes (prettier, ruff, rustfmt, etc.)

Works with any stack: Node/TS, Python, Rust, Go, Swift/Xcode, and more.

Quick Start

Install the plugin:

# Add as a marketplace source
claude plugin marketplace add https://github.com/damoli1103/claude-code-project-bootstrap

# Install the plugin
claude plugin install claude-code-project-bootstrap

Then open Claude Code in your project directory and run:

/bootstrap

Claude asks for your project name, stack, and visibility, then creates a GitHub repo with hooks, guardrails, and a CLAUDE.md — ready to go.

Skills Included

Skill	Command	What It Does
claude-code-project-bootstrap	(auto-loaded)	Knowledge base with hook scripts, templates, and patterns. Claude reads this automatically when relevant.
bootstrap	/bootstrap	Interactive setup wizard. Creates GitHub repo, hooks, CLAUDE.md from scratch.
audit-project	/audit-project	Audits an existing project against best practices. Reports PASS/WARN/FAIL and offers to fix gaps.
init-planning	/init-planning	Sets up structured .planning/ directory with project definition, codebase analysis, requirements, and roadmap for multi-phase projects.

What Gets Created

/bootstrap output

your-project/
├── .claude/
│   ├── hooks/
│   │   ├── validate-bash.sh      # blocks destructive commands, gates commits, validates messages + branches
│   │   ├── protect-files.sh      # blocks writes to sensitive files
│   │   ├── build-check.sh        # auto-detects stack, runs build + tests
│   │   ├── scan-secrets.sh       # warns on hardcoded secrets in written files
│   │   ├── session-check.sh      # verifies hooks setup on session start
│   │   └── auto-format.sh        # formats files after write (if formatters installed)
│   ├── statusline.sh             # context window monitor (progressive color)
│   ├── settings.json             # hook wiring + statusline (committed to git)
│   └── settings.local.json       # user allow-list (NOT committed)
├── .gitignore
├── README.md
├── CLAUDE.md                      # project instructions for Claude
└── ...

/init-planning output

.planning/
├── PROJECT.md                 # What we're building, core value, constraints
├── REQUIREMENTS.md            # REQ-IDs with phase traceability
├── ROADMAP.md                 # Phases, plans, success criteria, progress
├── STATE.md                   # Current position, velocity, decisions, blockers
├── .continue-here.md          # Session resume point
├── config.json                # Workflow preferences
├── codebase/                  # Brownfield analysis (7 docs)
│   ├── ARCHITECTURE.md        # Layers, patterns, data flow
│   ├── STRUCTURE.md           # Directory layout, file purposes
│   ├── STACK.md               # Languages, frameworks, deps
│   ├── CONVENTIONS.md         # Naming, code style, patterns
│   ├── TESTING.md             # Test framework, coverage, strategy
│   ├── CONCERNS.md            # Tech debt, risks, fragile areas
│   └── INTEGRATIONS.md        # APIs, data storage, external services
└── phases/
    └── NN-phase-name/
        ├── NN-CONTEXT.md      # Phase decisions + boundary
        ├── NN-PP-PLAN.md      # Executable plan with must_haves
        ├── NN-PP-SUMMARY.md   # Post-execution summary
        └── NN-VERIFICATION.md # Phase quality gate

Commands

/bootstrap — Set Up a New Project

The bootstrap wizard walks you through creating a fully-configured Claude Code project. It:

1. Asks you for project name, stack (Node/TS, Python, Rust, Go, Swift/Xcode), visibility (public/private), and description
2. Creates a GitHub repo (or uses your existing one)
3. Generates .gitignore, README.md, and CLAUDE.md tailored to your stack
4. Installs 6 hooks in .claude/hooks/ (see Hook Reference below)
5. Wires hooks in .claude/settings.json
6. Explains permission tiers and lets you choose a level
7. Commits and pushes the initial setup

If the project already has a git repo, README, or other files, the wizard skips those steps instead of overwriting.

/audit-project — Check Your Setup