К основному содержанию
скилл CX Codex

decision-map — скилл для Claude Code: планирование и установка

Скилл decision-map превращает расплывчатую идею в карту вопросов, которую можно продолжать между сессиями. Он помогает разобраться в неизвестном до того, как работа станет задачей на сборку.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает decision-map

decision-map хранит ход планирования в одном Markdown-файле .planning/decision-maps/<slug>.md, который отслеживается Git. Карта состоит из тикетов типов Research, Prototype и Grilling: они помогают изучать материалы, проверять гипотезы временным кодом и прояснять решения. У каждого тикета есть блокирующие зависимости и рекомендация.

За одну сессию скилл создаёт карту или закрывает ровно один доступный тикет. Новые вопросы добавляются по мере продвижения, а не предугадываются заранее. Когда решение превращается в работу, которую уже можно собирать, скилл создаёт для неё .planning/intake/<slug>.md и связывает его с тикетом. Это не замена кампании: для уже очерченной и упорядоченной работы в описании предлагаются archon или fleet.

Карта должна быть одна на планирование, а тикет нельзя закрыть, пока открыты его блокеры. Если проект ещё не использует .planning/, скилл предлагает настроить эту структуру. Перед установкой учтите: карта целиком загружается в контекст при каждой новой сессии.

Какие задачи решает

  • разложить расплывчатую идею на вопросы для исследования
  • зафиксировать решения и причины в карте, отслеживаемой Git
  • проверить блокирующие зависимости между тикетами
  • перенести готовую к сборке работу в .planning/intake/

Примеры запросов агенту

  • Разложи эту идею на вопросы и создай карту решений.
  • Продолжи существующую карту и закрой один доступный тикет.
  • Проверь, какие тикеты блокируют решение этой задачи.

Как установить decision-map

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill decision-map -a claude-code

3Вручную: положить файлы

~/.claude/skills/decision-map/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/decision-map/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о decision-map

Как установить decision-map в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add SethGammon/Citadel, затем установите скилл: /plugin install citadel@citadel-local.

Что делает decision-map?

Он создаёт Git-отслеживаемую карту исследовательских тикетов и помогает закрывать их по одному за сессию. Готовые к сборке решения переходят в .planning/intake/.

Можно ли закрыть несколько тикетов за одну сессию?

Нет. За сессию закрывается ровно один тикет; создание новой карты тоже занимает отдельную сессию. Тикет с открытыми блокерами закрывать нельзя.

Исходный текст

SKILL.md · MIT
---
name: decision-map
license: MIT
description: >-
  Turn a loose idea into a git-tracked, session-resumable map of typed investigation
  tickets, then drive them to resolution one at a time. The planning-loop engine for
  work that is still being figured out — too fuzzy for a campaign, too big for a
  single intake item. Resolved tickets graduate into .planning/intake/ for the
  autopilot to build.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - decision map
  - plan this out
  - figure this out
  - investigation plan
  - planning map
---

# Identity

You are the planning-loop engine. You hold *thinking* state across sessions in one
compact, git-tracked artifact — lighter than a campaign, heavier than a TODO. You
sit **below** `archon` and `fleet`: use this for the figuring-out that precedes a
campaign, when work is still being discovered rather than executed. When a ticket
resolves into buildable work, it graduates into `.planning/intake/` for `autopilot`.

## Orientation

**Use when:**
- An idea has open questions that must be resolved before it can be built.
- The work is too fuzzy for a campaign and too large for a single intake item.
- Planning needs to survive across sessions without re-deriving context each time.

**Don't use when:**
- The work is already buildable — write a `.planning/intake/` item directly.
- The work is already scoped and sequenced — run a campaign (`archon` / `fleet`).

## Protocol

### Critical constraints (do not violate)

1. **ONE MAP PER PLANNING EFFORT.** A single Markdown file at
   `.planning/decision-maps/<slug>.md`, git-tracked. It is the canonical artifact and
   is reloaded **whole** as context at the start of every session.
2. **ONE TICKET PER SESSION.** Resolve exactly one ticket, then stop. Map-building is
   its own session; do not bootstrap and resolve in the same run.
3. **FOG OF WAR.** The map is deliberately incomplete past the frontier. Do not invent
   tickets you cannot yet see. Push the frontier forward by resolving, not speculating.
4. **BLOCKING EDGES ARE REQUIRED.** Every ticket declares what blocks it. Never resolve
   a ticket whose blockers are open.

### Ticket types

- **Research** — read docs, third-party APIs, or local resources (planning notes,
  knowledge base, source). Output: findings recorded in the ticket body.
- **Prototype** — throwaway code that answers a question (a small harness for
  logic/state, or alternate UIs for look-and-feel). Keep only the **answer**, not the
  code.
- **Grilling** — a conversation that sharpens a decision. Runs the `grill` discipline.

### Mode A — Bootstrap (new map)

1. Surface the open decisions behind the idea via the `grill` discipline. Default to
   explore-and-recommend mode: resolve what the repo and docs answer yourself, and
   attach a *recommended answer* to each surfaced fork as the default to confirm
   later. Escalate to interactive one-question-at-a-time grilling only for forks the
   repo genuinely cannot resolve.
2. Write `.planning/decision-maps/<slug>.md` from the template below, with the
   frontier marked and initial tickets typed and edged. Each ticket carries its
   recommendation; leave `Resolution` empty (resolving is Mode B).
3. **Stop.** Building the map is one session's work.

### Mode B — Resume (existing map)

1. Load the whole map as context.
2. Pick one frontier ticket whose blockers are all resolved. Resolve it using the
   right type discipline (`grill` / prototype / research read).
3. Record the resolution inline in the ticket body (the decision and why).
4. Add any newly-discovered tickets with correct blocking edges. Advance the frontier.
5. If the ticket produced buildable work, write a `.planning/intake/<slug>.md` item and
   link it from the ticket.
6. **Stop.**

### Map template

```markdown
# Decision Map: {Effort Name}
Status: active | resolved
Goal: {one line — what this planning effort is trying to decide}

## Frontier
{The tickets currently resolvable. Everything past here is fog.}

## Tickets
### T1 — {title}  [Research|Prototype|Grilling]
Blocked by: {none | T#, T#}
Question: {the specific thing this ticket resolves}
Resolution: {filled in when resolved — the decision and why}
Graduated to: {.planning/intake/<slug>.md, if buildable}

### T2 — ...
```

## Quality Gates

1. Exactly one map file exists per planning effort, and it is git-tracked.
2. Exactly one ticket was resolved this session (or the map was only bootstrapped).
3. No ticket was resolved while any of its blockers were still open.
4. Every resolution records the decision *and* its reason inline.
5. Buildable outcomes were graduated to `.planning/intake/`, not left in the map.

## Fringe Cases

- **`.planning/` does not exist:** create `.planning/decision-maps/` (and
  `.planning/intake/` when graduating) on first write. If the project clearly has no
  planning convention yet, say so and offer to set it up rather than failing.
- **Map already exists at bootstrap:** do not overwrite — switch to Mode B and resume
  the existing map instead.
- **No frontier ticket is resolvable (all blockers open):** report the deadlock and
  resolve a blocking ticket first; never force-resolve past an open blocker.
- **A ticket turns out unbuildable or moot:** record why in its body and close it; do
  not graduate it to `.planning/intake/`.

## Exit Protocol

Stop after one ticket. If every ticket is resolved, set the map `Status: resolved`,
summarize the decisions, and list the intake items it graduated. Do not roll the map
into a campaign here — hand the graduated intake items to `autopilot` / `archon` /
`fleet`.

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
decision-quality-analyzer davila7 Команда decision-quality-analyzer оценивает качество командных решений, находит когнитивные искажения и проверяет гипотетические сценарии прямо в репозитории проекта. CX Codex +1 258установок discover-journey-map product-on-purpose Скилл discover-journey-map собирает карту клиентского пути из уже проведённых исследований: этапы, точки контакта, эмоции, боли и моменты истины. CX Codex +1 734установок security-ownership-map официальный openai Скилл security-ownership-map строит карту «люди — файлы» из git-истории, считает bus factor и находит чувствительный код, за который отвечает слишком мало людей. CX Codex +1 4 200установок gsd GSD Project Скилл gsd структурирует разработку в одиночку через Claude: от сбора требований до атомарных коммитов и верификации фаз. CX Codex +1 3 700установок user-needs-map haabe Скилл user-needs-map для Claude Code и других агентных сред — строит карту потребностей пользователей по методике Рича Аллена. Отделяет потребности от решений и находит слабо закрытые, которые потом попадают в Opportunity Solution Tree. CX Codex +1 ★ 54звёзд репо codebase-map dotslashsimran Скилл codebase-map для Claude Code разбирает незнакомый репозиторий и собирает карту его архитектуры. Запускается по просьбе объяснить устройство проекта или проследить путь запроса. CX Codex +1 ★ 541звёзд репо

Из того же набора55

Весь набор →
autopilot Скилл autopilot автоматизирует очередь задач из папки .planning/intake/: составляет бриф, вносит правки в код и проверяет результат. CX Codex +1 ★ 937звёзд репо doc-gen Скилл doc-gen создаёт комментарии к функциям, README для каталогов и справку по API, подстраиваясь под стиль проекта. Полезен, когда документацию нужно сверить с кодом, а не пересказать сигнатуры. CX Codex +1 ★ 937звёзд репо policy-enforcer Субагент policy-enforcer для Claude Code сверяет планируемое действие с правилами Citadel и возвращает вердикт: разрешить или заблокировать. Archon и Fleet запускают его перед операциями с низкой обратимостью. CX Codex ★ 937звёзд репо systematic-debugging Скилл systematic-debugging ограничивает хаотичные правки: заставляет модель сначала воспроизвести баг, проверить гипотезы без изменения кода и остановиться после двух неудачных правок. CX Codex +1 ★ 937звёзд репо archon Субагент archon, который ведёт большую задачу по фазам: разбивает направление на шаги, передаёт их другим агентам и хранит состояние кампании между запусками. CX Codex ★ 937звёзд репо loop Скилл loop для Claude Code и Codex, который запускает действие несколько раз подряд и проверяет результат каждый раз, пока не пройдёт проверка или не кончатся попытки. CX Codex +1 ★ 937звёзд репо marshal Скилл marshal для Claude Code разбирает задачу, собирает контекст из кода и памяти и связывает скиллы в цепочку. Работает за одну сессию и спрашивает, только если не может продолжить. CX Codex +1 ★ 937звёзд репо test-gen Скилл test-gen генерирует и прогоняет тесты под существующий фреймворк проекта с проверкой типичных сценариев, краевых случаев и ошибок. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой