Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@
{
"name": "aidd-refine",
"source": "./plugins/aidd-refine",
"description": "Meta-cognition: refine input through brainstorming, refine output through challenge and condensed communication mode.",
"description": "Meta-cognition: refine input through brainstorming, refine output through challenge, blind-spot scanning, and fact-checking.",
"strict": true,
"recommended": true
},
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ _(Already tested on `Legacy` codebases)_
[![Made in France](https://img.shields.io/badge/made%20in-France-0055A4?labelColor=EF4135)](https://www.ai-driven-dev.fr/)

<p>
<!--counts:start--><kbd>7 plugins</kbd> · <kbd>48 skills</kbd> · <kbd>2 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
<!--counts:start--><kbd>7 plugins</kbd> · <kbd>47 skills</kbd> · <kbd>2 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
</p>

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
Expand All @@ -36,7 +36,7 @@ Why not just write your own commands? → [FAQ](docs/FAQ.md#-why-aidd-instead-of
## ✅ Prerequisites

- **An AI coding tool** — Claude Code (native), or Cursor / Copilot / Codex / OpenCode (see [Compatibility](#-compatibility)).
- **[Node](https://nodejs.org)** on your `PATH` — for the plugins that ship hooks ([what they do](docs/ARCHITECTURE.md#-bundled-hooks)).
- **[Node](https://nodejs.org)** on your `PATH` — for the plugin that ships hooks ([what they do](docs/ARCHITECTURE.md#-bundled-hooks)).

## 🔌 Compatibility

Expand Down Expand Up @@ -257,9 +257,9 @@ Three Amigos refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Def

### 🪞 [aidd-refine](plugins/aidd-refine/README.md)

`5 skills` · stable
`4 skills` · stable

Brainstorm, challenge, condense, shadow-areas, fact-check.
Brainstorm, challenge, shadow-areas, fact-check.

</td>
<td width="33%" valign="top">
Expand Down
4 changes: 2 additions & 2 deletions aidd_docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Skills are grouped into plugins by domain. Install only the plugins you need.
| Plugin | Purpose | Example skills |
| ----------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| aidd-context | Bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks, plugins, marketplaces), mermaid diagrams, learn, discovery | `02-project-memory`, `03-context-generate`, `09-mermaid` |
| aidd-refine | Meta-cognition: brainstorm, challenge prior work, condensed communication mode | `01-brainstorm`, `02-challenge`, `03-condense` |
| aidd-refine | Meta-cognition: brainstorm, challenge prior work, blind-spot scan, fact-check | `01-brainstorm`, `02-challenge`, `03-shadow-areas` |
| aidd-pm | Product management: backlog artifacts, refinement, Product Briefs, PRD, spec | `02-user-stories`, `05-spike`, `07-epic`, `09-defect`, `10-task` |
| aidd-dev | Code transformation: plan, implement, assert, audit, review, test, refactor, debug, for-sure | `01-plan`, `02-implement`, `05-review`, `06-test` |
| aidd-vcs | VCS workflows: commit, pull/merge request, release tag, issue creation | `01-commit`, `02-pull-request`, `04-issue-create` |
Expand Down Expand Up @@ -103,7 +103,7 @@ AIDD is delivered as a plugin marketplace. Pick what you need; do not install ev
| Plugin | Skills |
| ------------ | ------------------------------------------------------------------------------------------------------------------- |
| aidd-context | 00-onboard, 01-bootstrap, 02-project-memory, 03-context-generate, 09-mermaid, 10-learn, 11-explore |
| aidd-refine | 01-brainstorm, 02-challenge, 03-condense, 04-shadow-areas, 05-fact-check |
| aidd-refine | 01-brainstorm, 02-challenge, 03-shadow-areas, 04-fact-check |
| aidd-dev | 01-plan, 02-implement, 03-assert, 04-audit, 05-review, 06-test, 07-refactor, 08-debug, 09-for-sure, 10-todo |
| aidd-orchestrator | 00-async-dev, 01-sdlc |
| aidd-vcs | 01-commit, 02-pull-request, 03-release-tag, 04-issue-create |
Expand Down
1 change: 0 additions & 1 deletion docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ Declared in `plugins/<plugin>/hooks/hooks.json`. They run Node, so users need `n
| Plugin | Event | Runs | Purpose |
| -------------- | ------------------ | ------------------------- | -------------------------------------------------------- |
| `aidd-context` | `SessionStart` | `hooks/update_memory.js` | Refresh the project memory block in the AI context files |
| `aidd-refine` | `UserPromptSubmit` | `hooks/condense-stats.js` | Report token savings while condensed output mode is on |

## 🧠 Plugin concerns and layers

Expand Down
7 changes: 3 additions & 4 deletions docs/CATALOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,15 +69,14 @@ Product backlog artifacts, refinement, Product Briefs, Epics, User Stories, Task

## 🪞 aidd-refine

Meta-cognition: brainstorm, challenge, condense, blind-spot scan, fact-check.
Meta-cognition: brainstorm, challenge, blind-spot scan, fact-check.

| Skill | Role | Actions |
| ------------------ | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `01-brainstorm` | Clarify a vague product or technical intent through natural discovery | `01-capture`, `02-probe`, `03-integrate`, `04-finalize` |
| `02-challenge` | Rethink prior work to verify correctness against a plan | `01-challenge` |
| `03-condense` | Toggle terse output mode and report token savings | `01-condense`, `02-stats` |
| `04-shadow-areas` | Scan a markdown artifact for blind spots | `01-detect`, `02-render-report`, `03-diff` |
| `05-fact-check` | Verify factual claims against sources and cite them | `01-identify-claims`, `02-verify`, `03-report` |
| `03-shadow-areas` | Scan a markdown artifact for blind spots | `01-detect`, `02-render-report`, `03-diff` |
| `04-fact-check` | Verify factual claims against sources and cite them | `01-identify-claims`, `02-verify`, `03-report` |

## 🌿 aidd-vcs

Expand Down
7 changes: 3 additions & 4 deletions plugins/aidd-refine/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,16 @@
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "aidd-refine",
"version": "2.2.4",
"description": "Meta-cognition: refine input through brainstorming, refine output through challenge and condensed communication mode.",
"description": "Meta-cognition: refine input through brainstorming, refine output through challenge, blind-spot scanning, and fact-checking.",
"author": {
"name": "AI-Driven Dev",
"url": "https://github.com/ai-driven-dev"
},
"skills": [
"./skills/01-brainstorm",
"./skills/02-challenge",
"./skills/03-condense",
"./skills/04-shadow-areas",
"./skills/05-fact-check"
"./skills/03-shadow-areas",
"./skills/04-fact-check"
],
"keywords": [
"brainstorm",
Expand Down
62 changes: 22 additions & 40 deletions plugins/aidd-refine/CATALOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,11 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
## Table of Contents

- [`.claude-plugin`](#claude-plugin)
- [`hooks`](#hooks)
- [`skills`](#skills)
- [`skills/01-brainstorm`](#skills01-brainstorm)
- [`skills/02-challenge`](#skills02-challenge)
- [`skills/03-condense`](#skills03-condense)
- [`skills/04-shadow-areas`](#skills04-shadow-areas)
- [`skills/05-fact-check`](#skills05-fact-check)
- [`skills/03-shadow-areas`](#skills03-shadow-areas)
- [`skills/04-fact-check`](#skills04-fact-check)

---

Expand All @@ -23,13 +21,6 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
|------|
| [plugin.json](.claude-plugin/plugin.json) |

### `hooks`

| File |
|------|
| [condense-stats.js](hooks/condense-stats.js) |
| [hooks.json](hooks/hooks.json) |

### `skills`

#### `skills/01-brainstorm`
Expand Down Expand Up @@ -59,39 +50,30 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
| `references` | [confidence-rubric.md](skills/02-challenge/references/confidence-rubric.md) | - |
| `-` | [SKILL.md](skills/02-challenge/SKILL.md) | `Rethink just-completed work against an agreed plan, classifying findings as deal-breaker, suggestion, or correct, with a confidence score. Use to challenge or critically review recent work. Not for line-by-line style review or writing code.` |

#### `skills/03-condense`

| Group | File | Description |
|-------|------|---|
| `actions` | [01-condense.md](skills/03-condense/actions/01-condense.md) | - |
| `actions` | [02-stats.md](skills/03-condense/actions/02-stats.md) | - |
| `references` | [intensity-levels.md](skills/03-condense/references/intensity-levels.md) | - |
| `-` | [SKILL.md](skills/03-condense/SKILL.md) | `Toggle terse output mode (lite, full, ultra) that drops filler while code and errors stay verbatim, and report token savings. Use to condense output, switch intensity, or check savings. Not for editing prose or compressing code.` |

#### `skills/04-shadow-areas`
#### `skills/03-shadow-areas`

| Group | File | Description |
|-------|------|---|
| `actions` | [01-detect.md](skills/04-shadow-areas/actions/01-detect.md) | - |
| `actions` | [02-render-report.md](skills/04-shadow-areas/actions/02-render-report.md) | - |
| `actions` | [03-diff.md](skills/04-shadow-areas/actions/03-diff.md) | - |
| `assets` | [report-template.md](skills/04-shadow-areas/assets/report-template.md) | - |
| `references` | [categories.md](skills/04-shadow-areas/references/categories.md) | - |
| `references` | [locked-sets.json](skills/04-shadow-areas/references/locked-sets.json) | - |
| `references` | [probe-style.md](skills/04-shadow-areas/references/probe-style.md) | - |
| `references` | [severity-rubric.md](skills/04-shadow-areas/references/severity-rubric.md) | - |
| `-` | [SKILL.md](skills/04-shadow-areas/SKILL.md) | `Scan a markdown artifact (idea, stories, PRD, spec) for blind spots into a shadow report grouped by category and severity. Use to find gaps or what is missing in a written artifact. Not for interactive Q&A or code review.` |

#### `skills/05-fact-check`
| `actions` | [01-detect.md](skills/03-shadow-areas/actions/01-detect.md) | - |
| `actions` | [02-render-report.md](skills/03-shadow-areas/actions/02-render-report.md) | - |
| `actions` | [03-diff.md](skills/03-shadow-areas/actions/03-diff.md) | - |
| `assets` | [report-template.md](skills/03-shadow-areas/assets/report-template.md) | - |
| `references` | [categories.md](skills/03-shadow-areas/references/categories.md) | - |
| `references` | [locked-sets.json](skills/03-shadow-areas/references/locked-sets.json) | - |
| `references` | [probe-style.md](skills/03-shadow-areas/references/probe-style.md) | - |
| `references` | [severity-rubric.md](skills/03-shadow-areas/references/severity-rubric.md) | - |
| `-` | [SKILL.md](skills/03-shadow-areas/SKILL.md) | `Scan a markdown artifact (idea, stories, PRD, spec) for blind spots into a shadow report grouped by category and severity. Use to find gaps or what is missing in a written artifact. Not for interactive Q&A or code review.` |

#### `skills/04-fact-check`

| Group | File | Description |
|-------|------|---|
| `actions` | [01-identify-claims.md](skills/05-fact-check/actions/01-identify-claims.md) | - |
| `actions` | [02-verify.md](skills/05-fact-check/actions/02-verify.md) | - |
| `actions` | [03-report.md](skills/05-fact-check/actions/03-report.md) | - |
| `assets` | [report-template.md](skills/05-fact-check/assets/report-template.md) | - |
| `references` | [claim-categories.md](skills/05-fact-check/references/claim-categories.md) | - |
| `references` | [report-output-discipline.md](skills/05-fact-check/references/report-output-discipline.md) | - |
| `references` | [verification-cascade.md](skills/05-fact-check/references/verification-cascade.md) | - |
| `-` | [SKILL.md](skills/05-fact-check/SKILL.md) | `Verify factual claims in a text against authoritative sources and rewrite it with footnote citations, hedging the unconfirmed. Use to fact-check, verify a claim, or cite sources on request. Not for judging code or clarifying requirements.` |
| `actions` | [01-identify-claims.md](skills/04-fact-check/actions/01-identify-claims.md) | - |
| `actions` | [02-verify.md](skills/04-fact-check/actions/02-verify.md) | - |
| `actions` | [03-report.md](skills/04-fact-check/actions/03-report.md) | - |
| `assets` | [report-template.md](skills/04-fact-check/assets/report-template.md) | - |
| `references` | [claim-categories.md](skills/04-fact-check/references/claim-categories.md) | - |
| `references` | [report-output-discipline.md](skills/04-fact-check/references/report-output-discipline.md) | - |
| `references` | [verification-cascade.md](skills/04-fact-check/references/verification-cascade.md) | - |
| `-` | [SKILL.md](skills/04-fact-check/SKILL.md) | `Verify factual claims in a text against authoritative sources and rewrite it with footnote citations, hedging the unconfirmed. Use to fact-check, verify a claim, or cite sources on request. Not for judging code or clarifying requirements.` |

7 changes: 3 additions & 4 deletions plugins/aidd-refine/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,13 @@ Meta-cognition plugin for the AI-Driven Development framework.

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, toggle a condensed output mode, analytically scan artifacts for blind spots, and verify factual claims against authoritative sources.
Four skills that refine inputs and outputs through reflection: clarify vague requests, challenge prior work for correctness, analytically scan artifacts for blind spots, and verify factual claims against authoritative sources.

## 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] | [condense](skills/03-condense/SKILL.md) | Toggle terse output mode with intensity levels so prose drops fluff while code, errors, and warnings stay verbatim. |
| [5.4] | [shadow-areas](skills/04-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.5] | [fact-check](skills/05-fact-check/SKILL.md) | Verify factual claims against authoritative sources and rewrite the text with footnote citations, hedging anything that cannot be confirmed. |
| [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. |
Loading