clarify

Runs a four-stage clarification funnel with critic review before surfacing user decisions.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ZaxbyHub/ragappv3 --skill clarify-zaxbyhub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/ZaxbyHub/ragappv3/tree/main/.opencode/skills/clarify
Command: npx skills add https://github.com/ZaxbyHub/ragappv3 --skill clarify-zaxbyhub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ambiguous user requests often lead to either premature planning with wrong assumptions or excessive clarification questions that interrupt the user. This protocol structures how an architect agent inventories, classifies, and resolves uncertainties before asking the user anything. ## Core Features & Use Cases - Four-Stage Clarification Funnel: Inventories all material uncertainties, classifies each as self_resolved, critic_resolved, research_needed, user_decision, or deferred_nonblocking, then filters them through a critic sounding board before surfacing anything. - Critic Verdict Mapping: Maps SoundingBoardVerdict outcomes (UNNECESSARY, RESOLVE, REPHRASE, APPROVED) to concrete funnel actions, with hard constraints preventing the critic from dropping always-surface categories like destructive behavior, security risk, or breaking changes. - Structured Decision Packets: Presents remaining user decisions grouped by category with rationale, recommended defaults, options, and blocking markers, and records every resolved item as an explicit assumption. - Use Case: When a user asks an architect agent to plan a feature with unclear scope or migration impact, the agent runs this funnel to resolve what it can internally and only escalates genuine user decisions. ## Quick Start Ask the architect agent to plan an ambiguous feature request and it will load this protocol to run the clarification funnel before presenting any decision packet.

Frequently Asked Questions about clarify

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

FAQPage Schema
How does the clarification funnel reduce unnecessary user questions?▼

The funnel inventories all material uncertainties first, then classifies each as self-resolvable, critic-resolvable, research-needed, or a genuine user decision. Only items surviving critic review as APPROVED are surfaced to the user, so answerable questions never interrupt them.

What is the critic sounding board in the clarify protocol?▼

The critic sounding board reviews candidate clarification questions before they reach the user. It returns verdicts of UNNECESSARY, RESOLVE, REPHRASE, or APPROVED, which map to dropping, answering, rewording, or escalating each question.

Which uncertainty categories must always be surfaced to the user?▼

Always-surface categories include scope boundaries, destructive behavior, security and privacy risk, backward compatibility, breaking changes, new dependencies, deprecations, cross-platform impact, cost tradeoffs, UX choices, rollout strategy, and QA gate strictness. The critic cannot drop these, only rephrase or approve them.

What happens to uncertainties resolved without asking the user?▼

Every resolved uncertainty must be recorded as an explicit assumption in the spec, plan, or .swarm/context.md file. Silently dropping a resolved item is defined as a protocol violation, so each uncertainty entering the funnel has a recorded outcome.

When should the clarify protocol not be used?▼

When a request is already clear, the protocol routes directly to MODE: DISCOVER instead of running the funnel. It is designed only for ambiguous requests where material uncertainties could affect scope, behavior, or risk.