skills.rest
AnasIsmai1
AnasIsmai1COMMUNITY
Explore all skills by this author →
WebsiteGitHub

wayfinder

Decomposes vague ideas into tracked investigation tickets on an issue tracker.

Updated Sep 20, 2024
Search Tags:#project planning#issue tracker#agent workflow#multi-session#decision mapping#ticket decomposition#research tickets
One-click install
npx skills add https://github.com/AnasIsmai1/dotfiles --skill wayfinder-anasismai1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/AnasIsmai1/dotfiles/tree/main/agents/.agents/skills/wayfinder
Command: npx skills add https://github.com/AnasIsmai1/dotfiles --skill wayfinder-anasismai1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, fuzzy ideas are too big for a single agent session and lack a visible path from concept to plan. This Skill turns a loose idea into a shared map of investigation tickets on the repo's issue tracker, then resolves them one at a time until the route to the goal is clear. ## Core Features & Use Cases - Map creation: Runs a grilling and domain-modeling session to surface open decisions, then creates a map issue (labelled wayfinder:map) with Notes, Decisions-so-far, and a Fog section for not-yet-specifiable questions. - Typed tickets: Splits work into research, prototype, grilling, and task tickets as child issues, wired with blocking relationships and claimed via labels so concurrent sessions never collide. - Incremental resolution: Each session claims one frontier ticket, resolves it, records the answer as a resolution comment, updates the map index, and graduates newly specifiable fog into fresh tickets. - Use Case: You have a vague goal like "redesign the onboarding flow." Invoke the Skill to chart a map of research and decision tickets, then run parallel sessions that each resolve one ticket until the implementation path is fully defined. ## Quick Start Invoke the wayfinder skill with a loose idea to chart a map, or with an existing map URL to resolve the next unblocked ticket.

Frequently Asked Questions about wayfinder

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

FAQPage Schema
How do I break a vague idea into actionable tickets with an AI agent?▼

Invoke the Skill with your loose idea. It runs a grilling and domain-modeling session to surface open decisions, creates a map issue labelled wayfinder:map, and files the specifiable questions as child tickets wired with blocking relationships.

How do I run multiple agent sessions on the same project plan?▼

Each session claims one ticket by setting the wayfinder:claimed label before starting work, so concurrent sessions skip it. The handoff block provides copy-paste commands to open one session per unblocked ticket in parallel.

What issue trackers does the wayfinding workflow support?▼

The map, child tickets, blocking, and frontier queries are tracker-specific and defined in the repo's docs/agents/issue-tracker.md file. If that document is absent, the Skill defaults to a local-markdown tracker.

When should a question become a ticket versus stay in the fog?▼

A question becomes a ticket when you can state it precisely, even if it is blocked and not yet actionable. It stays in the map's Fog section when you cannot yet phrase it sharply, since fog is coarser than a ticket and may graduate into several tickets later.

Can one agent session resolve multiple tickets at once?▼

No. Each session resolves exactly one ticket, records the answer as a resolution comment, closes the issue, updates the map's Decisions-so-far index, and ends with a handoff block for the next sessions.

Related Skills

Explore More Product & Management Skills→
Adelie-SquadAdelie-Squad
17

Idea Refiner Agent

Refine raw startup ideas into structured concepts with feasibility checks and action plans.

Official
Advanced
redblacktreeredblacktree
1

source-command-oneshot-plan

Executes ralph plan and implementation slash commands for a given ticket.

Community
Basic
williamwwilliamw

prototyping-workflow

Create single-file HTML prototypes of UI components and marketing pages.

Community
Intermediate
subroh0508subroh0508
18

plan-author

Generate a PR-scoped plan document and update the plan index.

Community
Intermediate