Pwp Bootstrap

Project Bootstrap Skill

This skill defines how to start a new project from scratch. Covers repository setup, folder structure, configuration, and the first commit.

Bootstrap Mindset

• Foundation before features. A well-initialized project saves hundreds of hours later.
• Conventions from day one. It's 10x harder to adopt conventions after code exists.
• Ship the skeleton first. Get the project building and deploying before writing features.
• Document decisions early. The first ADR is the cheapest to write.

Bootstrap Checklist

Phase 1: Repository Foundation (5 min)

• Git initialized
• Package manager configured
• .gitignore created
• First commit: chore: initialize repository

Phase 2: Governance Files (5 min)

• README.md — name, description, quick start
• LICENSE
• .env.example with placeholder values

Phase 3: Tooling Configuration (10 min)

• TypeScript (strict mode)
• Linter (ESLint / Biome)
• Formatter (Prettier or equivalent)
• Build tool (Vite, Next.js, etc.)

Phase 4: Project Structure (5 min)

{project}/
├── src/
│   ├── components/
│   ├── lib/
│   ├── types/
│   ├── hooks/
│   ├── api/
│   └── styles/
├── public/
├── docs/plans/
├── tests/
├── .env.example
├── .gitignore
├── README.md
├── tsconfig.json
└── package.json

Phase 5: Hello World (5 min)

• Entry point created
• Builds successfully
• Runs locally
• TypeScript compiles cleanly

Phase 6: CI/CD Setup (optional, 10 min)

• GitHub Actions for build + type check
• Deploy pipeline configured
• Branch protection on main

CLAUDE.md Template

# Project: {name}

## Stack
- {Framework}: {version}
- {Language}: {version}

## Conventions
- Components: PascalCase, co-located with styles/tests
- Utilities: camelCase, in src/lib/
- Tests: co-located as {file}.test.ts

## Commands
- `npm run dev` — development server
- `npm run build` — production build
- `npm test` — run tests
- `npx tsc --noEmit` — type check

Anti-Patterns