Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-framework
Open on GitHub

What 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-brainstorm to clarify requirements for the authentication module
  • Scan design-doc.md with shadow-areas to uncover hidden operational risks
  • Execute aidd-refine:02-challenge to 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-framework

Step 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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set80

The whole set →
00-async-dev 00-async-dev is a Claude Code skill that takes a task through the async-dev pipeline: repo setup, running a ready issue, and clearing review comments on a PR. CX Codex +1 ★ 571repo stars aidd-qa aidd-qa validates browser acceptance criteria against observable behavior and records short review videos. Useful right before submitting a completed task. CX Codex +1 ★ 571repo stars aidd-telemetry aidd-telemetry is a plugin for Claude Code that tracks token use in Claude Code and Codex sessions, grouped by task, model, or other dimensions. Records stay local. CX Codex +1 ★ 571repo stars aidd-ui aidd-ui is a plugin for the UI/UX direction of the AI-Driven Development framework; in alpha, its only smoke-test skill checks that the plugin loads. CX Codex +1 ★ 571repo stars aidd-orchestrator aidd-orchestrator — a plugin for Claude Code, Cursor and other platforms that orchestrates synchronous development pipelines, automates issue-to-PR workflows, and manages product backlogs. CX Codex +1 ★ 571repo stars aidd-pm The aidd-pm plugin for Claude Code turns a rough idea into tickets a planner can consume through ten product skills. CX Codex +1 ★ 571repo stars aidd-vcs The aidd-vcs plugin for Claude Code automates Git repository setup, atomic commits, pull requests, release tagging, and conflict handling. CX Codex +1 ★ 571repo stars aidd-dev aidd-dev is a Claude Code plugin for planning code changes, implementing them, and checking the results. Its skills also cover testing, refactoring, debugging, and parallel tasks. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open