# Decide

Walk the user through design or implementation decisions one at a time, or review...

- Repository: https://github.com/ParadevAI/Paradev (15823 stars)
- Category: Design
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ParadevAI/Paradev --skill decide -g -a claude-code -y`
Codex: `npx skills add ParadevAI/Paradev --skill decide -g -a codex -y`
Cursor: `npx skills add ParadevAI/Paradev --skill decide -g -a cursor -y`
Gemini CLI: `npx skills add ParadevAI/Paradev --skill decide -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ParadevAI/Paradev`

## Description

Walk the user through design or implementation decisions one at a time, or review completed code one change at a time. Use when the user says "walk me through each decision", "let's decide together", "help me work through these choices", "walk me through what you did", or "QA step by step". Present concise context, mutually exclusive options, log each answer, and finish with a summary.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Decide

## Prepare

Before a design walkthrough, inspect the relevant code and record concrete bugs, inconsistencies, and decision points in `plans/<YYYYMMDD>-<topic>.md` or the appropriate app-scoped `plans/` directory. Preserve existing edits; never discard speculative or user-authored work without explicit approval.

Order decisions by dependency and leverage, not document order.

## Decision walkthrough

For each decision:

1. Show `## Decision N: <title>`.
2. Give two to four sentences of context grounded in real files or functions.
3. State the trade-off in one sentence.
4. Ask exactly one interactive question with two to four mutually exclusive options.
   - Use `ask_user` when available. In Codex Plan mode, use `request_user_input` when that is the exposed interactive question tool.
   - Never substitute a plain-text question when repository instructions require an interactive overlay.
   - Keep labels to five words or fewer.
   - Put the recommendation first and suffix its label with `(Recommended)`.
   - Explain each option and its trade-off in one sentence.
   - Do not add an `Other` option when the client adds one automatically.
5. After the answer, write `Logged: <decision>.` and continue.

If the user acknowledges an issue without choosing, log the recommended choice and say they can correct the assumption.

At the end, provide a `| # | Decision | Choice |` table and offer to turn the audit into an implementation plan. Do not write implementation code during the decision walkthrough.

## QA walkthrough

Use this mode when the user wants to review existing code step by step.

The rest: https://github.com/ParadevAI/Paradev/blob/HEAD/.agents/skills/decide/SKILL.md