Imported from blockmatic/basilic-skills (
skills/w-wayfinder/SKILL.md). Install upstream withnpx skills add blockmatic/basilic-skills --skill w-wayfinder. Copyright stays with the author.
Use when the way to a destination is bigger than one session. Tickets are decisions, not build slices. Clarify is sparse gaps; grill is a design-tree interview; this playbook is fog. When the way is already clear, stop and offer plan or build. Do not implement on the map. Do not create GitHub issues.
Two modes. Never resolve more than one ticket per work-through session.
Chart
User invokes with a loose idea.
- Name the destination with grill. The destination fixes scope.
- Grill again breadth-first for open decisions and first takeable steps. Explore facts via council. If there is no fog, do not write a map; ask how to proceed.
- Write the map per map output. Decisions so far empty; fog in Not yet specified; ticket only what is already sharp.
- List blocking edges on tickets that wait. Research-shaped tickets: council. Look-and-feel: v0 or ui as a cheap artifact, not a product UI. Default tickets: grill.
- Stop. Charting hands off; it does not resolve tickets.
Work through
User invokes with a map (path or open plan). A ticket is optional.
- Load the map at low resolution. Orient to Destination.
- Take the named ticket, else the first frontier ticket. Mark it claimed on the map before any work.
- Resolve it. Grill for HITL decisions. Council for in-repo or docs facts. Call skills named in Notes.
- Record the answer on the ticket, gist it under Decisions so far, and close the ticket. Graduate fog that is now sharp. Move mis-scoped tickets to Out of scope.
- When no tickets and no fog remain, the way is clear. Hand off to plan, then build if they asked to implement.