---
name: init-project
description: Bootstrap a new dev project with GitHub Issues tracking, repo setup, security settings, and project configuration. Goes from zero to structured repo in one command.
user-invocable: true
---

# /init-project

Bootstrap a new development project from scratch. Creates a GitHub repo, sets up issue tracking, configures security defaults, and scaffolds the project structure — all in one command.

## Usage

```
/init-project
/init-project [project name]
```

## When to Activate

- User says `/init-project`
- User wants to start a new development project
- User says "let's build..." or "new project" or "scaffold"

## Process

### Phase 1: Project Definition

Gather core details:

- **Project name** — kebab-case, used for repo and directory
- **Description** — one-liner for GitHub and README
- **Stack** — framework, language, database, hosting target
- **Visibility** — public or private repo

### Phase 2: Repository Setup

1. Create GitHub repo with description
2. Clone locally to workspace directory
3. Initialize with chosen framework/template
4. Set up `.gitignore` for the stack

### Phase 3: Project Configuration

1. Create `CLAUDE.md` with:
   - Project overview and architecture decisions
   - Dev commands (build, test, deploy)
   - Coding conventions
   - Environment setup instructions

2. Set up GitHub Issues:
   - Create labels: `bug`, `feature`, `enhancement`, `documentation`, `p0`, `p1`, `p2`
   - Create initial milestone for MVP
   - Add first issues for core features

### Phase 4: Security Defaults

1. Enable Dependabot alerts
2. Add `.env.example` (never commit `.env`)
3. Set up branch protection on `main`
4. Add security-related `.gitignore` entries

### Phase 5: First Commit

Stage everything, create initial commit, push to remote.

## Output

A fully configured repository with issues, labels, milestones, security settings, and project documentation — ready to start building.