Matt Pocock Wayfinder Skill for Codex Project Planning
Build a shared planning map for work that spans multiple sessions. Turn open questions into linked decision tickets and record which decisions block the next step.
中文Setup for Codex
Use Codex in a repository. The skill can use local Markdown when no issue tracker is configured. Some decision types call additional research or design skills.
- Copy the pinned skills/engineering/wayfinder directory into .agents/skills/wayfinder. Install the companion skills named for your decision types from the same revision.
- Open the project in Codex and select $wayfinder explicitly. Set the issue tracker for the project or use its local Markdown mode.
Example task
Use $wayfinder to plan an internal report export. One decision is CSV versus JSON, and the other is on-demand versus nightly generation. Use local Markdown, identify the next decision to resolve, and leave application code untouched.Expected result
The map records the destination and two decision tickets, with the next question and any blocking relationship visible.
Upstream documentation
Original SKILL.md on GitHub · MIT license · Source reviewed
Frequently asked question
How does Wayfinder preserve planning decisions between Codex sessions?
It records a map and linked decision tickets in the project's tracker. A new session can reopen the map and select an unblocked question.