# Pwp Bootstrap

> New project initialization protocol — from empty directory to production-ready foundation in one session. Use this skill whenever the user wants to start a new project, initialize a repo, scaffold an application, or set up a codebase from scratch. Also use when they say 'new project', 'start fresh', 'initialize a repo', 'scaffold this', 'set up the project', or 'create a new app'. Covers repo set…

- **Type:** Skill
- **Install:** `agentstack add skill-shandar-pwp-plugin-pwp-bootstrap`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shandar](https://agentstack.voostack.com/s/shandar)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shandar](https://github.com/shandar)
- **Source:** https://github.com/shandar/pwp-plugin/tree/main/skills/pwp-bootstrap
- **Website:** https://affordance.design/protocol

## Install

```sh
agentstack add skill-shandar-pwp-plugin-pwp-bootstrap
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```markdown
# 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

| Anti-Pattern | Do This Instead |
|-------------|----------------|
| Starting with features, adding structure later | Structure first, features second |
| No .gitignore from start | Create in first commit |
| Copying config from another project blindly | Configure intentionally |
| Skipping "Hello World" verification | Verify build/run before features |
| No CI from start | Set up CI before first feature |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shandar](https://github.com/shandar)
- **Source:** [shandar/pwp-plugin](https://github.com/shandar/pwp-plugin)
- **License:** MIT
- **Homepage:** https://affordance.design/protocol

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shandar-pwp-plugin-pwp-bootstrap
- Seller: https://agentstack.voostack.com/s/shandar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.