decision-mapping
Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.
- License 许可
- MIT
- 最近更新
- 2026-11-11
- Stars
- ★ 7
- Forks
- 2
01 前言 Front Matter
- name
- decision-mapping
- description
- Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.
- disable-model-invocation
- true
03 SKILL.md 正文
This skill is invoked when a loose idea requires more than one agent session to turn into a plan. It creates a stateful decision map in a markdown file, and drives the user through a sequence of tickets to resolve the open questions - which may require either prototyping, research or discussion.
The Decision Map
The decision map is a single compact Markdown file, one per planning effort, git-tracked alongside the project. It is the canonical artifact — the whole map is loaded as context into every session, so it must stay compact.
Assets created during tickets should be linked to from the map, not duplicated within it.
Structure
Numbered entries ("tickets"), each its own section keyed by its number:
## #1: Relational Or Non-Relational Database?
Blocked by: #<ticket-number>, #<ticket-number>
Type: Research | Prototype | Discuss
### Question
<question-here>
### Answer
<answer-here>
Each ticket must be sized to one 100K token agent session.
Ticket Types
There are three types of tickets:
- Research: Reading documentation, third-party API's, or local resources like knowledge bases. Creates a markdown summary as an asset. Use this when knowledge outside the current working directory is required.
- Prototype: Writing UI or logic code to test a hypothesis, or to explore a design space. Uses the /prototype skill. Creates a prototype as an asset. Use this when "how should it look" or "how should it behave" is the key question.
- Discuss: Conversation with the agent. Uses the /grilling and /domain-modelling skills. The default case.
Fog of war
The map is deliberately incomplete beyond the frontier. Your job is to investigate the frontier, and to resolve tickets in order to push the frontier forward. Push back the fog of war, one node at a time.
At some point, the fog of war should have been pushed back far enough that the path to the finish line is clear. At that point, no more tickets will be required and the decision map can be considered 'done'.
Invocation
There are two ways this skill can be invoked: bootstrap and resume.
Bootstrap
User invokes with a loose idea.
- Run a /grilling and /domain-modelling session to surface the open decisions.
- Write a new decision map — mostly fog, frontier identified, trivially-decidable entries resolved inline.
- Stop. Map-building is one session's work; do not also resolve tickets.
Resume
User invokes with a path to an existing map and a ticket number.
- Load the whole map as context.
- Run a session to resolve the ticket, invoking skills as needed. If in doubt, use
/grillingand/domain-modelling. - Record what the session resolved in the ticket's body.
- Add newly-discovered tickets (with correct
blocked_byedges). - Stop.
If the decisions made invalidate other parts of the map, update or delete those nodes.
Parallelism
The user may choose to run tickets in parallel, so expect other agents to make changes to the map.
Skipping The Decision Map
Many times, the initial grilling will result in no fog of war. No unresolved tickets. Nothing to do, except implement.
In those situations, you should offer the user the chance to skip the decision map - since the decision map is only needed if multi-session decisions need to be made.
If they skip it, you should recommend either implementing directly or using /to-prd to schedule a multi-session implementation.
04 同仓库更多 Skills
writing-shape
Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.
writing-great-skills
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
writing-fragments
Grilling session that mines the user for fragments — heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts) — and appends them to a single document as raw material for a future article. Use when the user wants to develop ideas before imposing structure, or mentions "fragments", "ideate", or "raw material" for writing.
writing-beats
Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.
ubiquitous-language
Extract a DDD-style ubiquitous language glossary from the current conversation, flagging ambiguities and proposing canonical terms. Saves to UBIQUITOUS_LANGUAGE.md. Use when user wants to define domain terms, build a glossary, harden terminology, create a ubiquitous language, or mentions "domain model" or "DDD".
triage
Move issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.