pathfinder

Decomposes large projects into altitude-scoped architecture decisions tracked as GitHub issues.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/vinzenz/workflows --skill pathfinder-vinzenz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pathfinder
Source: https://github.com/vinzenz/workflows/tree/main/.agents/skills/pathfinder
Command: npx skills add https://github.com/vinzenz/workflows --skill pathfinder-vinzenz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large features and systems are too big to design in one session, and design work drifts into implementation detail before the overall shape is agreed. Pathfinder enforces a staged descent — intent, parts, seams, interiors — so architecture decisions happen at the right level of detail and are recorded on the issue tracker. ## Core Features & Use Cases - Altitude-gated planning: Works at exactly one altitude per session (A0 Intent through A4 Ready), parking any lower-level detail instead of answering it prematurely. - Tracker-native state: Represents the plan as a pathfinder:path GitHub issue with child leg issues, labels, assignees, and native blocking dependencies, so any session can resume without local state. - Typed legs with HITL/AFK modes: Each leg is a survey, research, prototype, or task with dispatch metadata, claim comments, and resolution records. - Use Case: You need to design a new dispatch system spanning multiple services. Pathfinder charts a path issue, runs an A0 intent survey with the human, creates A1 parts legs, and hands off a frontier of ready, scoped tickets to implementers — without writing any application code. ## Quick Start Ask the agent to use pathfinder to chart a path for your big feature idea, starting with an A0 intent survey and creating the path issue on the tracker.

Frequently Asked Questions about pathfinder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break a large software project into an architecture plan?▼

Pathfinder charts a path issue on the tracker, then descends one altitude per session: A0 Intent, A1 Parts, A2 Seams, A3 Interior, A4 Ready. Each altitude produces legs — child issues with one question each — resolved via surveys, research, or prototypes.

What is the difference between pathfinder and wayfinder?▼

Pathfinder fits efforts with a structure to find — components and how they fit — where the risk is committing to details early. Wayfinder fits loosely-related unknowns with no natural decomposition, where the map is a checklist of investigations rather than a ladder.

Does pathfinder write application code?▼

No. Pathfinder writes only to the issue tracker, docs/ specs and ADRs, and its own .pathfinder/ scratch directory. It produces decisions and a frontier of ready legs that implementers pick up and build.

Can I use pathfinder without GitHub Issues?▼

Yes, a local markdown fallback stores the path and legs under .pathfinder/ with Status, Altitude, and Blocked by lines. However, GitHub via gh-tool is the reference path because native blocking dependencies render the frontier visually.

How does pathfinder handle a session that dies mid-leg?▼

State lives on the tracker, so a claimed but unresolved leg is recognizable by its assignee and missing resolution comment. The Claim comment's timestamp decides staleness; stale claims are unassigned and re-claimed by a fresh session.