pilot v0.10.0 claude code · single-plugin marketplace sdlc guide → github →

PILOT

A Claude Code plugin that auto-routes your intent to the right underlying skill, enforces CLAUDE.md quality gates, and stays extensible with a one-line registry edit.

what
Fourteen shell hooks across seven events (including a deterministic UserPromptSubmit route-advisor and an autopilot Stop gate) + a routing skill + ten slash commands + three bundled MCPs (context7, playwright, github), with playwright-cli preferred for UI verification when installed. Wired automatically by the plugin manifest.
trigger
Auto-engages on session start and on prompts containing build / fix / ship / explore / messy / broken / review. Naming a skill or MCP literally (context7, playwright, tdd, frontend-design, improve-codebase-architecture) routes there directly — no keyword scoring.
phases
21 routed phases: Recall · Triage · Bootstrap · Map · Frame · Plan · Build · Debug · Performance · Verify · Review · Security · Documentation · Refactor · Migration · Dependencies · Pre-deploy · Ship · Release · Post-deploy · Capture — plus Autopilot: one requirement in, the whole loop conducted hands-off with exactly two checkpoints (plan approval, ship approval) and a bounded verify→fix loop. Each phase maps to a primary skill with at least one fallback. GSD is the default spine; PAUL is opt-in.
how
UserPromptSubmit injects a deterministic route for literal skill names + project state. SessionStart prints a banner and self-heals settings. PreToolUse gates large edits and bad commits. Stop / SubagentStop block "done" claims without test evidence. PreCompact re-anchors routing rules.
team
Autopilot cycles are branch-scoped (.pilot/cycles/<branch>.json) so parallel devs never collide; checkpoint approvals are machine-witnessed from real user prompts (a UserPromptSubmit hook the model can't fake — self-approved checkpoints get bounced); .pilot.json profiles set per-repo style/strictness; opt-in shared outcome ledger + dev/outcome-report.sh give the team a first-pass-verified rate; dev/bootstrap-team.sh installs the constellation at pinned versions and reports marketplace drift; docs/team-onboarding.md is the 10-minute ramp.
why
So your AI sessions look the same across framing, planning, TDD, debugging, and shipping — without remembering which skill to invoke. And measured, not asserted: routing has a golden-set eval, outcomes have an A/B method (docs/ab-method.md).
running
session — claude code scene 01
awaiting prompt
active phase routing
waiting for prompt
routed skill via registry.md
active hook most recent
no hook fired yet
bypass markers ~/.cache/pilot
(none)
outcome

seven hook events in time order

Each box lights up when the corresponding hook fires in the active scenario above. UserPromptSubmit runs first on every prompt (deterministic route-advisor). SubagentStop shares its script with Stop — both block "done without evidence" claims.

SessionStart
on open · self-heal
sessionstart-banner.sh
UserPromptSubmit
every prompt
route-advisor.sh · approval-capture.sh
PreToolUse
Edit / Write / MultiEdit / NotebookEdit
plan-gate.sh
PreToolUse
Bash · git commit
pre-commit.sh
Stop
turn ends
verify-gate.sh · autopilot-gate.sh
SubagentStop
subagent ends
verify-gate.sh
PreCompact
before compaction
precompact-anchor.sh

guardrails enforced

id rule event script
G1 plan before coding (>20 LOC) PreToolUse plan-gate
G3 conventional commits, no WIP PreToolUse pre-commit
G7 : any needs // any: comment PreToolUse pre-commit
G8 no console.log in committed TS/JS PreToolUse pre-commit
G12 no sleep / setTimeout in tests PreToolUse pre-commit
G14 block "done" claims without test evidence Stop · SubagentStop verify-gate
G15 block destructive commands + secret reads PreToolUse safety-gate
G16 autopilot: no stopping mid-cycle, no crossing checkpoints unapproved Stop autopilot-gate

slash commands

/pilot-offskip next gate fire of any kind
/pilot-bypass --no-planskip next plan-gate only
/pilot-bypass --no-precommitskip next pre-commit only
/pilot-off-railsdisable until /pilot-back-on
/pilot-back-onre-engage all gates
/pilot-statuswired hooks · bypass · last routes
/pilot-tracecurrent session's phase chain in order
/pilot-doctorfull install diagnostic
/pilot-autopilot <req>requirement → shipped, 2 checkpoints
/pilot-approvewitness approval for the waiting checkpoint
/pilot-floorapply blocking CI + pre-commit quality floor
/pilot-rememberappend a durable project note