decision-mapping

Structure loose ideas into ordered investigation tickets in a git-tracked markdown decision map.

Updated May 28, 2026
One-click install
npx skills add https://github.com/haryelramalho/skills --skill decision-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-mapping
Source: https://github.com/haryelramalho/skills/tree/main/skills/community/decision-mapping
Command: npx skills add https://github.com/haryelramalho/skills --skill decision-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps turn an unclear idea into a structured sequence of investigation tickets so a complex decision can be resolved without losing track of open questions.

Core Features & Use Cases

  • Map Building: Creates a compact, git-tracked decision map that serves as the canonical planning artifact.
  • Progressive Resolution: Drives one ticket at a time so research, prototyping, or discussion can advance in a controlled order.
  • Multi-Session Planning: Supports long-running work where unresolved decisions must survive across separate sessions and contributors.

Quick Start

Ask the AI to bootstrap a decision map for your loose idea and capture the first set of unresolved questions in a compact markdown file.

Frequently Asked Questions about decision-mapping

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

FAQPage Schema
How do I structure a vague idea into actionable investigation tickets?

Structuring a vague idea into actionable tickets requires mapping open questions into a sequenced, blocked order. This Skill bootstraps a compact markdown artifact that tracks unresolved decisions and drives resolution one ticket at a time to prevent losing track of open questions.

What is the best way to track open research questions across multiple sessions?

Tracking open research questions across multiple sessions requires a git-tracked markdown decision map that preserves unresolved decisions. This Skill supports multi-session planning by maintaining ordered tickets with blocking relationships and concise answer logging in a compact artifact.

How do I bootstrap a decision map for a complex prototyping workflow?

Bootstrapping a decision map for a complex prototyping workflow starts by asking the AI to capture the first set of unresolved questions in a compact markdown file. The Skill uses bootstrap mode to structure loose ideas into a sequenced map of investigation tickets with blocking relationships.

Can I resume a multi-session planning workflow without losing tracked decisions?

You can resume a multi-session planning workflow without losing tracked decisions using the Skill's resume mode. It picks up progression from the existing git-tracked markdown artifact, ensuring unresolved questions and blocking relationships remain intact across separate sessions.

Does decision mapping work with git-tracked markdown files?

Decision mapping works directly with git-tracked markdown files by using them as the canonical planning artifact. The Skill generates a compact markdown structure that supports ordered tickets, blocking relationships, and concise answer logging for version-controlled planning.