git:20260628.9366aee to git:20261016.04e815b

5 added, 1 removed. Audit A to A.

---

name: project-bootstrap

- description: Bootstrap a project under ~/Projects with the standard agent scaffolding, stamped from the starter kit at shared/Development/templates/starter-kit - a CLAUDE.md from the house template, the stack-agnostic core (.editorconfig, .gitignore, .claude settings/launch, worktree-port script), an optional stack layer, and a row in the ~/Projects/CLAUDE.md root map. Use when creating a new project or repo, or when an existing repo is missing its CLAUDE.md. Trigger on "bootstrap this project", "new project setup", "stamp a CLAUDE.md", "set up agent scaffolding", "give this repo a CLAUDE.md".

+ description: >

+ Stamps a project under ~/Projects with the standard agent scaffolding from the starter kit: a

+ house-template CLAUDE.md, core config, an optional stack layer, and a row in the root map. Use

+ for a new repo or one missing its CLAUDE.md. Trigger on: "bootstrap this project", "new project

+ setup", "stamp a CLAUDE.md", "set up agent scaffolding".

---

# Project Bootstrap

## Purpose

Every repo should hand an agent the same things up front: what it is, how to run it, how to test it, and what not to break. This skill stamps that scaffolding from one source of truth - the starter kit - so cold sessions (and cheaper models) execute instead of rediscovering. The CLAUDE.md is the deliverable; it gets smoke-tested before it counts.

## The starter kit (single source of truth)

All scaffolding lives at `~/Projects/shared/Development/templates/starter-kit/`. Never re-author these files inline - copy them from the kit and fill the placeholders.

- `core/` - stamped into every project, any stack:

- `CLAUDE.md.template`, `README.md.template` - filled with judgment from recon

- `.editorconfig`, `.gitignore` - copied verbatim

- `.claude/settings.json` - copied verbatim (committed canon: minimal safe permissions)

- `.claude/settings.local.json.template` - copied to `settings.local.json`, adjusted to stack; only if absent

- `.claude/launch.json.template` - filled with dev command + port

- `scripts/worktree-port.cjs` - copied verbatim (stable per-worktree dev port)

- `layers/<stack>/` - opt-in, applied over the core; each has its own README with steps:

- `frontend-vite` - React + Vite + TS + current Storybook + design-token enforcement (ready)

- `js-ts`, `python`, `static-11ty` - planned; skip if the directory isn't there yet

## Inputs

Ask only for what can't be discovered: the project's name and one-line purpose if there's no README. Everything else comes from recon.

## Process

1. **Recon the repo** (skip whatever doesn't exist):

- `package.json` / `pyproject.toml` / `composer.json` - scripts and deps (these also tell you the stack -> which layer, if any)

- Server entry: grep for `PORT|listen`; check `.env.example` for required vars

- Existing docs (README, AGENTS.md, docs/) - the CLAUDE.md points at them, never duplicates

- `git log --oneline -15` - recent themes become "Common tasks" candidates

- `git worktree list` - decides whether the worktrees section applies

2. **Pick a port** (web projects only): read the Active projects table in `~/Projects/CLAUDE.md` and pick one nothing else claims. Already taken: 3000 (narraitor, rcv-simulator-va main), 3101, 4173, 4174, 5173, 6006.

3. **Stamp the core** from `starter-kit/core/`:

- Copy verbatim: `.editorconfig`, `.claude/settings.json`, `scripts/worktree-port.cjs`.

- `.gitignore`: copy if the repo has none; if it already has one, ensure the kit's `.claude` commit-canon block is present.

- **Write CLAUDE.md** by filling `CLAUDE.md.template`: every section gets exact commands and literal ports/paths, written for a weaker model - imperative, do-X-then-verify-Y, minimal cleverness required of the reader. Target 100-250 lines. No emojis. (Never overwrite an existing CLAUDE.md - diff instead.)

- **Write `README.md`** from `README.md.template` only if the repo has none.

- **Write `.claude/launch.json`** from `launch.json.template` with the chosen dev command and port.

- **Write `.claude/settings.local.json`** from `settings.local.json.template`, adjusted to the stack (python3, composer, etc.) - only if it doesn't already exist. Keep it small; `/fewer-permission-prompts` grows it later from real usage.

4. **Apply a stack layer** (only if one matches the project): for a React + Vite frontend, follow `layers/frontend-vite/README.md` - scaffold the baseline with the official tools, then overlay the layer's files. Skip this step if the project's stack has no layer yet.

5. **Register it**: append a row to the Active projects table in `~/Projects/CLAUDE.md` (project path, stack, canonical ports).

6. **Smoke-test the doc**: following ONLY the new CLAUDE.md, start the dev server, hit its verify step, run the test command, then stop anything started. If a step doesn't work as written, fix the doc - not the expectations.

7. **Commit** CLAUDE.md (plus the tracked `.claude/` canon and core files, if the repo tracks them) with a message saying what the manual covers. `settings.local.json` stays uncommitted.

## Rules

- The starter kit is the one source of truth - copy from it, never re-author scaffolding inline. If a template needs improving, fix it in the kit, not here.

- Never overwrite an existing CLAUDE.md unasked - present a diff instead.

- Point at existing docs; never paste their content into CLAUDE.md.

- The smoke test is the acceptance test. A CLAUDE.md that hasn't been executed cold doesn't ship.

- If ports or stack change later, update the root-map row too - one canonical port table.