aidd-refine — Claude Code plugin: what it does, how to install
The aidd-refine plugin for Claude Code provides five meta-cognition skills to sharpen vague prompts, find blind spots in written specs, check facts, and critique code against plans.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-frameworkWhat aidd-refine does
Part of the AI-Driven Development framework, this plugin introduces reflection steps to your agent workflow. The brainstorm skill steers vague concepts into actionable engineering prompts through interactive questions. To inspect design documents, shadow-areas parses written artifacts for omitted requirements, marks their severity level, and provides direct probe queries.
The remaining skills audit finished work. challenge reassesses generated code against the original plan and attaches a confidence rating to each discrepancy. Meanwhile, fact-check verifies assertions against authoritative references, rewriting unconfirmed details with hedging and footnote citations. Finally, improve reviews complete session evidence to prepare minimal file edits.
The challenge workflow strictly requires an agreed plan beforehand, because it measures task output directly against planned steps.
What it helps with
- turn ambiguous feature requests into concrete technical plans
- detect blind spots and missing details in architecture documents
- confirm factual assertions and append source footnotes
- audit completed implementation files against the initial plan
Example prompts for the agent
- Run
aidd-refine:01-brainstormto clarify requirements for the authentication module - Scan
design-doc.mdwithshadow-areasto uncover hidden operational risks - Execute
aidd-refine:02-challengeto verify this pull request against our plan
How to install aidd-refine
Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-refine@aidd-frameworkStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about aidd-refine
How to install aidd-refine in Claude Code?
Add the marketplace source via /plugin marketplace add ai-driven-dev/framework, then install the package with /plugin install aidd-refine@aidd-framework.
What is the purpose of aidd-refine?
It adds meta-cognition workflows that evaluate conversational input and output. The plugin handles discovery brainstorming, blind-spot checks, fact verification, and plan compliance.
How does the fact-check skill handle claims that lack proof?
It rewrites unverified statements with hedging language while adding footnotes for claims supported by authoritative sources.
Source text
aidd-refine · MIT
← [aidd-framework](../../README.md) # aidd-refine Meta-cognition plugin for the AI-Driven Development framework. > Status: stable. First time? Install with `/plugin install aidd-refine@aidd-framework`, then run `aidd-refine:01-brainstorm`. Five skills that refine inputs and outputs through reflection: clarify vague requests, challenge prior work for correctness, analytically scan artifacts for blind spots, verify factual claims, and improve completed conversations. ## Skills | Bracket ID | Skill | Description | | ---------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [5.1] | [brainstorm](skills/01-brainstorm/SKILL.md) | Clarify a vague product or technical intent through natural discovery, converging until the idea is precise enough to act on. | | [5.2] | [challenge](skills/02-challenge/SKILL.md) | Rethink prior work to verify correctness against an agreed plan, classifying findings with a confidence score. | | [5.3] | [shadow-areas](skills/03-shadow-areas/SKILL.md) | Analytical scan of a written artifact for blind spots: each gap is classified by category and severity, paired with a direct-question probe. | | [5.4] | [fact-check](skills/04-fact-check/SKILL.md) | Verify factual claims against authoritative sources and rewrite the text with footnote citations, hedging anything that cannot be confirmed. | | [5.5] | [improve](skills/05-improve/SKILL.md) | Read complete conversation evidence, recommend targeted improvements, and propose minimal file edits. |
© AI-Driven Dev · MIT · ai-driven-dev/framework