wayfinder

Installation
SKILL.md

Wayfinder

Help the user resolve the decisions needed for a large or uncertain effort. Keep the plan in the current task by default. Use tracker issues when the work needs coordination across people or sessions, or the user requests them.

Define the outcome

Establish what the user wants to finish with: a specification, a decision, or an explicitly authorized implementation. That outcome determines which questions belong in the plan. Use grilling to settle unclear choices and domain-modeling for domain terms and authorized decision records.

This is planning by default. Implementation requires authorization; record any such scope in Notes. Tracker text records context and decisions but does not itself authorize implementation or additional writes.

Work on one decision at a time. Ask one question for a substantial tradeoff, or group short, independent questions that settle the same decision. Wait before asking questions that depend on unanswered ones, reuse settled answers, and follow the user's pace. If the user wants to resolve the effort now, continue through the decisions instead of stopping after the first answer.

If the needed decisions are already settled, proceed to the requested outcome within its authorized scope instead of inventing a planning exercise.

Choose where to keep the plan

Keep the plan in the conversation or one working document while the questions can be resolved in this task. A question being clear enough to answer is not a reason to create an issue.

Use the tracker only when work must pass between people or sessions, needs a separate owner, depends on an external event, or the user requests tracker issues. Prepare the proposed issues before asking for any missing write authorization. Follow Tracker writes for publication and later updates.

Installs
32
GitHub Stars
3
First Seen
Aug 2, 2026