| name | codex-logical-decision-layer |
| description | Use when work is ambiguous or has multiple viable paths; compares options, assumptions, evidence, tradeoffs, and the best next action. |
| load_priority | on-demand |
TL;DR
Use when the task has multiple possible solutions, hidden risk, or high cost of being wrong. Produce a concise decision surface: options, evidence, tradeoffs, recommendation, stop conditions.
Activation
- Activate on
$think, $decide, $options, "think from multiple angles", or "find the best direction".
- Activate for architecture, refactor, debugging strategy, product workflow, release, and non-trivial UI/BE decisions.
- Auto-pair with
codex-reasoning-rigor when the user asks for deeper reasoning or non-generic output.
Hard Rules
- Do not reveal private chain-of-thought. Output the decision contract only.
- Generate 2-4 plausible options, not an unbounded brainstorm.
- Compare options by evidence, cost, risk, reversibility, and verification.
- Prefer the smallest change that satisfies the goal and can be verified.
- If evidence is weak, state the assumption and the first command/file needed to validate it.
- Stop adding abstractions when the current project evidence does not justify them.
Output Contract
## Decision Surface
| Option | When it wins | Cost | Risk | Evidence needed |
| --- | --- | --- | --- | --- |
## Recommendation
Choose <option> because <repo evidence / constraint>.
## Verification
- <command or observable signal>
## Stop Conditions
- <condition that would change the decision>
Command
python "<SKILLS_ROOT>/codex-logical-decision-layer/scripts/build_decision_matrix.py" --problem "<problem>" --options "A,B,C" --format markdown
Reference Files
references/decision-contract.md: compact decision matrix rules and anti-token-waste policy.