# decision-navigator

decision-navigator structures complex choices, scores trade-offs, and quantifies risk factors. Useful when you need to assess the reversibility and consequences of technical plans.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/decision-navigator.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/decision-navigator

## What it does

This subagent puts Claude Code into an analytical advisor persona. Once triggered, it displays internal actions through `*help` and evaluates choices across weighted metrics like impact (0.25), likelihood (0.20), reversibility (0.15), and objective alignment (0.20).

You interact with it using dedicated commands prefixed with an asterisk. It can construct branching visual trees (`*decision-tree`), assess trade-offs (`*trade-off-matrix`), probe consequence severity (`*risk-assessment`), and run regret minimization calculations (`*regret-analysis`).

Commands such as `*analyze-decision` rely on referenced markdown routines in `.claude/commands/wfgy/` and `.claude/commands/reasoning/`. Without those files present in the project structure, deep multi-path calculations cannot execute.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/decision-navigator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/decision-navigator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/decision-navigator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/decision-navigator.md

## When to use it
- evaluate technical trade-offs across weighted scoring criteria
- build decision trees for conflicting architectural options
- quantify project risks using impact and mitigation metrics
- verify choice reversibility before committing resources

## Example prompts
- Evaluate our database migration strategy and run *risk-assessment
- Compare cloud hosting options using *trade-off-matrix
- Build a *decision-tree for choosing between REST and gRPC

## Similar
- [ask-navigator](https://affpapa.org/en/nevibecode/skills/ask-navigator.md) — skill · 191 installs
- [decision-tree-explorer](https://affpapa.org/en/nevibecode/commands/decision-tree-explorer.md) — command · 291 installs
- [decision-debate](https://affpapa.org/en/nevibecode/skills/decision-debate.md) — skill · 383 installs
- [decision-toolkit](https://affpapa.org/en/nevibecode/skills/decision-toolkit.md) — skill · 325 installs
- [decision-memo](https://affpapa.org/en/nevibecode/skills/decision-memo.md) — skill · 688 installs
- [decision-quality-analyzer](https://affpapa.org/en/nevibecode/commands/decision-quality-analyzer.md) — command · 258 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
