wayfinder-pipeline

Installation
SKILL.md

The wayfinder pipeline

Two routes end in the same place: an issue, spec and tests in line with the code, and a PR built in a worktree off origin/main. The long route charts the decisions first, settles them into specs, slices the specs into build tickets, then builds. The short route is /quick-change, which skips the map and goes straight from issue to PR, and earns that only when nothing is left to decide.

This skill is reference. It runs no stage. Nearly every stage is human-only, so you name the door and the human opens it.

Which route

Quick when all four hold:

  • Decided. A few direct questions settle whatever is open, and each answer closes its question rather than opening two more.
  • Small. One session builds it; one PR a reviewer reads in a sitting carries it.
  • Inside the spec. The specs it touches take an edit, not a new spec or a new ADR, and it contradicts no ADR.
  • Done is nameable. You can write its acceptance criteria now.

Long when any fails. The usual signals:

Installs
2
First Seen
Oct 2, 2026