decision-map

Plans multi-session efforts as decision tickets on the repository issue tracker.

Updated Jul 12, 2026
One-click install
npx skills add https://github.com/sumitake/agent-collab --skill decision-map-sumitake
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-map
Source: https://github.com/sumitake/agent-collab/tree/main/plugins/agent-collab/skills/decision-map
Command: npx skills add https://github.com/sumitake/agent-collab --skill decision-map-sumitake

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, fuzzy efforts that span multiple sessions often stall because the open questions outnumber the known steps and a single planning pass would guess or stall. This Skill charts such efforts as a shared map of decision tickets on the repo's issue tracker, then resolves them one per session until the route to the destination is clear. ## Core Features & Use Cases - Map charting: Interviews the user to pin the destination, surfaces open decisions breadth-first, and creates a map issue plus child decision tickets with blocking edges. - Ticket-driven sessions: Each session claims one frontier ticket (research, prototype, interview, or task), resolves it, records the decision, and graduates newly sharpened fog into fresh tickets. - Tracker flexibility: Resolves the tracker from project docs, GitHub Issues via the gh CLI, or local markdown files, with a write gate requiring user confirmation before publishing shared tracker state. - Use Case: A team faces a vague multi-week migration idea. The Skill charts a decision map on GitHub Issues, and each subsequent session works one ticket until every decision blocking implementation is resolved. ## Quick Start Ask the agent to chart this effort as a decision map on the issue tracker before any implementation begins.

Frequently Asked Questions about decision-map

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

FAQPage Schema
How do I break a large vague project into manageable tickets?▼

Chart a decision map: interview to pin the destination, surface open decisions breadth-first, then create a map issue with child decision tickets linked by blocking edges. Each ticket is one question sized to a single session, resolved one at a time until no decisions remain.

How do I plan multi-session work using GitHub Issues?▼

Create one map issue labelled decision-map:map whose children are decision tickets, with blocking edges via gh sub-issue support or a Blocked by body convention. Sessions claim tickets by assignment, resolve them, and append one-line gists to the map's Decisions so far section.

Can I use a decision map without GitHub Issues?▼

Yes. The tracker resolves in order: the project's documented tracker workflow wins, then GitHub Issues via the gh CLI, then local markdown with the map at .scratch/<effort>/map.md and tickets as sibling files. Local markdown mode needs no write confirmation.

When should I not use a decision map for planning?▼

Skip the map when the effort fits one session: if breadth-first interviewing surfaces no fog, say so and stop. Also avoid it when the work is execution rather than decision-making, since the map produces decisions, not deliverables.

Why does the skill ask for confirmation before creating issues?▼

Tracker issues are shared, outward-facing state, so a write gate requires presenting the exact titles, bodies, and edges and getting user confirmation before creating or editing them. The exception is when the user already explicitly asked to publish or update the map.