decide

Compares researched approaches and produces an approved decision record before implementation.

4|1|Updated Jul 31, 2025
One-click install
npx skills add https://github.com/alvis/.agents --skill decide-alvis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decide
Source: https://github.com/alvis/.agents/tree/main/plugins/essential/skills/decide
Command: npx skills add https://github.com/alvis/.agents --skill decide-alvis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into implementation without converging on an approach, leading to rework when tradeoffs, rollback paths, or hidden constraints surface later. This Skill forces a bounded convergence pass that compares options, challenges the recommendation, and records an approved decision before any artifact is written. ## Core Features & Use Cases - Structured Option Comparison: Produces two or three materially distinct options with evidence, cost, reversibility, and accepted tradeoffs, always including the smallest viable change. - Approval-Gated Execution: Writes nothing before user approval, presents a recommendation report with falsification signals and rollback paths, and waits for explicit confirmation. - Decision Recording and Handoff: On approval, writes a lowercase decision record with supersede/affects/invalidates causality fields and hands off to the implementing skill with full context. - Use Case: When choosing between two database migration strategies, invoke this Skill to compare them against observed constraints, challenge the recommendation, and record the approved choice with its rollback plan before any code changes. ## Quick Start Ask the agent to decide between the available approaches for your problem, providing the question and any existing evidence or discovery notes.

Frequently Asked Questions about decide

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

FAQPage Schema
How do I make an architecture decision with an AI agent before coding?

Provide the problem or question plus any evidence artifacts, and the Skill frames the decision, compares two or three distinct options, challenges its own recommendation, and waits for your approval before writing anything. The approved choice is recorded as a decision file with rollback and falsification signals.

What should a good technical decision record include?

A decision record should include the chosen approach, supporting evidence, accepted tradeoffs, edge cases, a falsification signal, and a rollback path. This Skill writes it as a lowercase decisions/<slug>.md file with status accepted and causal fields like supersedes, affects, and invalidates.

When should I use discovery instead of deciding directly?

Use discovery when a material option, constraint, or acceptance criterion is still unknown, since forcing a recommendation from sparse evidence produces unreliable decisions. The Skill detects this gap during its readiness check and routes to essential:discover, stopping the decision pass until results return.

Does the decision skill modify files before approval?

No, it never creates, executes, or modifies files before explicit user approval. It presents a recommendation report and stops, only writing the decision record and handing off to an implementing skill after you approve.

What happens when an old decision is replaced by a new one?

The old accepted decision is never edited; the new decision supersedes it and names the replaced record by id and exact revision. The handoff includes a blast-radius sweep over the affects and invalidates fields so dependent work is flagged as stale.