Engineering
claude-code-project-bootstrap avatar

claude-code-project-bootstrap

Project bootstrap for Claude Code with safety guardrails, git workflow automation, project auditing, and structured multi-phase planning.

Introduction

This skill pack streamlines the initiation and maintenance of software development projects for Claude Code. It provides an automated setup wizard that handles the heavy lifting of project configuration, from initializing git and GitHub repositories to setting up protective hooks. Designed for developers and automated agents, it ensures that Claude operates within a secure environment by preventing destructive shell commands, enforcing conventional commit standards, and blocking accidental exposure of sensitive credentials through integrated secret scanning. Beyond initialization, the toolkit includes an audit mechanism that inspects existing projects against a comprehensive 45-point best-practice checklist, identifying security gaps, missing configuration files, or suboptimal workflow patterns. It also offers a structured project planning module that generates a hierarchical document architecture for multi-phase development, enabling better tracking of requirements, architectural decisions, and codebase analysis. This system is stack-agnostic, providing compatible hooks for Node/TypeScript, Python, Rust, Go, and Swift environments.

  • Interactive /bootstrap wizard for creating repos, READMEs, CLAUDE.md files, and directory scaffolding.

  • Advanced hook management for PreToolUse, PostToolUse, and SessionStart lifecycle triggers.

  • Security guardrails: prevents recursive forced deletion, hard resets, and accidental pushes to main branches.

  • Built-in secret protection that scans for API keys (e.g., Anthropic, GitHub, AWS), hardcoded credentials, and private key material.

  • Automated maintenance hooks including build-gated commits and context-aware code auto-formatting for multiple languages.

  • Comprehensive /audit-project command to verify setup integrity across git, hooks, settings, and documentation.

  • Structured project roadmap and planning module (/init-planning) using a .planning directory for phase tracking.

  • Ensure you have the gh CLI installed to fully automate GitHub repository creation and remote synchronization.

  • Input for the bootstrap wizard should include project name, stack preference, and repository visibility settings.

  • Hooks are non-blocking where possible, offering 'soft' warnings for non-critical issues and hard blocks for destructive operations.

  • The system utilizes .claude/settings.json for hook wiring and supports .claude/settings.local.json for user-specific configurations that should not be committed to source control.

  • Best suited for teams and individual developers aiming to standardize the interaction model between Claude Code and their specific codebase requirements.

Repository Stats

Stars
1
Forks
0
Open Issues
0
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
May 4, 2026, 01:17 AM
View on GitHub