# /pilot, Yours to Fork

Brain dump in, deployed project out. Scaffold, build, screenshot-test, harden, ship, all in one conversation.

## Why fork it before you run it

The skill ships as a template. The leverage shows up after you fork it. Run the customize prompt below with your own answers and Claude Code rewrites the skill so it builds for you, not for me. Five minutes of setup buys hundreds of hours of compounded use later.

If you don't customize, the skill will still run, but it will reach for design exemplars from my shipped work, voice rules from my projects, deploy targets I use, and a tech stack I default to. That's a worse fit than spending five minutes telling it about your work.

## What's in this folder

- `pilot.md` - the skill itself, with `{{PLACEHOLDER}}` and `> FILL IN:` markers where my preferences used to live
- `customize-prompt.md` - paste this into Claude Code along with `pilot.md`. It asks you 7 questions and writes a customized version to `~/.claude/skills/pilot/SKILL.md`

## What was stripped

The original `/pilot` references about a dozen supporting files (taste constitution, taste library, design seeds, copy DNA, image manifest, polish baseline, mobile patterns, funnel scaffolding). Those were calibrated to my work over 30+ wins and 40+ corrections. Bundling all of them would force my taste onto you.

Two of those files are referenced by name in `pilot.md` as **optional companions** you can fork separately if you want. The rest live as inline rules in the skill body, generic enough to apply anywhere, with placeholders for the parts that are personal.

What's still in:
- The full step-by-step build flow (parse, scaffold, build, screenshot-test, validate, harden, ship)
- The mechanical QA gates (banned punctuation, layout overflow, touch targets, contrast)
- The architecture defaults (multi-page, mobile-first, accessibility baked in)

What's now placeholder:
- Brand voice rules (you tell it your bans)
- Design exemplars (you tell it 3 sites you respect, 2 you don't)
- Tech stack (you pick the default)
- Deploy target (you pick the default)
- Color palette / mood (you pick the default seed)

## How to install

1. Open `customize-prompt.md`. Copy it.
2. Open Claude Code. Paste the customize prompt. Then paste the contents of `pilot.md` below it. Send.
3. Answer the 7 questions in plain language. No need to be precise, Claude Code handles ambiguity.
4. Claude Code writes the result to `~/.claude/skills/pilot/SKILL.md` and shows you a diff.
5. In any future Claude Code session, type `/pilot {your brain dump}` and it runs against your stack, your taste, your defaults.

## Credit

This skill is a fork of Jack's BLAST framework. The original BLAST is the spine. The screenshot-driven QA loop, the convergence gate, the per-section taste enforcement, those are my additions, refined across maybe a hundred builds and a hundred corrections. If you fork this and improve it further, send the patch back. Everyone benefits.