Skip to content
Open
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
### A community-maintained marketplace of skills, agents, and rules for Claude Code.

<p>
<!--counts:start--><kbd>6 plugins</kbd> · <kbd>31 skills</kbd> · <kbd>3 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
<!--counts:start--><kbd>6 plugins</kbd> · <kbd>32 skills</kbd> · <kbd>3 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
</p>

<p>
Expand Down Expand Up @@ -166,9 +166,9 @@ Commits, pull / merge requests, release tags, issue creation.

### 📋 [aidd-pm](plugins/aidd-pm/README.md)

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

Ticket info, user stories, PRD, spec drafting.
Ticket info, user stories, PRD, wireframe, spec drafting.

</td>
<td width="33%" valign="top">
Expand Down
3 changes: 2 additions & 1 deletion UPGRADE.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,8 @@ Invocation in v4 is `plugin:NN-action`. Where a column says "sub-flow", the old
| `aidd-dev:09-for-sure` | Loops and retries a task until an explicit success condition is met. | 4.0 |
| `aidd-orchestrator:00-async-dev` | Async, label/comment-driven runs from GitHub issues (setup / run / review). | 4.0 |
| `aidd-pm:03-prd` | Builds a PRD from a feature description or user stories. | 4.0 |
| `aidd-pm:04-spec` | Writes a normalised tech spec (the contract planning consumes). | 4.0 |
| `aidd-pm:04-wireframe` | Produces low-fidelity wireframes (screens, layouts, navigation flow) from a PRD or feature description. | 4.5 |
| `aidd-pm:05-spec` | Writes a normalised tech spec (the contract planning consumes). | 4.0 |
| `aidd-refine:03-condense` | Terse output mode with token-savings reporting. | 4.0 |
| `aidd-refine:04-shadow-areas` | Scans a spec for blind spots (missing actor, edge case, dependency, ...). | 4.0 |
| `aidd-refine:05-fact-check` | Verifies factual claims against sources and rewrites with citations. | 4.1 |
Expand Down
3 changes: 2 additions & 1 deletion aidd_docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ All templates live alongside the skill that owns them, under `plugins/<plugin>/s
| `aidd-context:03-context-generate/assets/agents/` | Agent file template |
| `aidd-context:03-context-generate/assets/rules/` | Rule file template |
| `aidd-pm:03-prd/assets/` | PRD body template |
| `aidd-pm:04-spec/assets/` | Spec template and validator |
| `aidd-pm:04-wireframe/assets/` | Wireframe body template |
| `aidd-pm:05-spec/assets/` | Spec template and validator |
| `aidd-dev:01-plan/assets/` | Plan and master-plan templates |
| `aidd-vcs:01-commit/assets/` | Conventional commit message template |
| `aidd-vcs:02-pull-request/assets/` | Pull/merge request body template, contributing example |
Expand Down
6 changes: 3 additions & 3 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.
| ----------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| aidd-context | Bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks, plugins, marketplaces), mermaid diagrams, learn, discovery | `02-project-init`, `03-context-generate`, `04-mermaid` |
| aidd-refine | Meta-cognition: brainstorm, challenge prior work, condensed communication mode | `01-brainstorm`, `02-challenge`, `03-condense` |
| aidd-pm | Product management: ticket info, user stories, PRD, spec | `01-ticket-info`, `02-user-stories-create`, `03-prd`, `04-spec` |
| aidd-pm | Product management: ticket info, user stories, PRD, wireframe, spec | `01-ticket-info`, `02-user-stories-create`, `03-prd`, `04-wireframe`, `05-spec` |
| aidd-dev | Code transformation: Dev SDLC orchestrator, plan, implement, assert, audit, review, test, refactor, debug, for-sure | `00-sdlc`, `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` |
| aidd-orchestrator | Async orchestration of the SDLC on labeled issues (optional, extra) | `00-async-dev` (router with setup / run / review sub-flows) |
Expand Down Expand Up @@ -102,7 +102,7 @@ AIDD is delivered as a plugin marketplace. Pick what you need; do not install ev
| aidd-refine | 01-brainstorm, 02-challenge, 03-condense, 04-shadow-areas, 05-fact-check |
| aidd-dev | 00-sdlc, 01-plan, 02-implement, 03-assert, 04-audit, 05-review, 06-test, 07-refactor, 08-debug, 09-for-sure |
| aidd-vcs | 01-commit, 02-pull-request, 03-release-tag, 04-issue-create |
| aidd-pm | 01-ticket-info, 02-user-stories-create, 03-prd, 04-spec |
| aidd-pm | 01-ticket-info, 02-user-stories-create, 03-prd, 04-wireframe, 05-spec |

Each plugin is independently installable; install incrementally. Smaller surface, fewer triggers competing.

Expand All @@ -112,7 +112,7 @@ A typical change cycles through skills from several plugins. The order below is

1. **Bootstrap** (only for a brand-new project): `aidd-context:01-bootstrap` imagines the stack and architecture, comparing candidate stacks and writing an `INSTALL.md`. Skip this step on an existing project.
2. **Project init** (once per project, re-runnable to refresh): `aidd-context:02-project-init` scaffolds `aidd_docs/`, the memory bank, and the AI context files for the tools you use. Re-running later refreshes the scaffold without overwriting your customizations.
3. **Frame the request**: `aidd-refine:01-brainstorm` to clarify, `aidd-pm:01-ticket-info` to pull tracker data, `aidd-pm:02-user-stories-create` and `aidd-pm:03-prd` or `aidd-pm:04-spec` to formalize scope.
3. **Frame the request**: `aidd-refine:01-brainstorm` to clarify, `aidd-pm:01-ticket-info` to pull tracker data, `aidd-pm:02-user-stories-create` and `aidd-pm:03-prd` or `aidd-pm:05-spec` to formalize scope.
4. **Plan**: `aidd-dev:01-plan` produces the technical plan, component behavior model, or design-image extraction.
5. **Implement and assert**: `aidd-dev:02-implement` writes code against the plan; `aidd-dev:03-assert` verifies the result.
6. **Review**: `aidd-dev:05-review` for code and functional review; `aidd-refine:02-challenge` to stress-test the result.
Expand Down
5 changes: 3 additions & 2 deletions docs/CATALOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,14 +44,15 @@ The development SDLC: plan, implement, assert, audit, review, test, refactor, de

## aidd-pm

Product management: ticket retrieval, user stories, PRD, spec.
Product management: ticket retrieval, user stories, PRD, wireframe, spec.

| Skill | Role | Actions |
| ------------------------- | ---------------------------------------------------------- | -------------------------------- |
| `01-ticket-info` | Retrieve and display ticket information | `01-ticket-info` |
| `02-user-stories-create` | Generate INVEST-compliant user stories | `01-create-user-stories` |
| `03-prd` | Generate a structured Product Requirements Document | `01-prd` |
| `04-spec` | Generate or refine a normalized project spec | `01-build`, `02-refine` |
| `04-wireframe` | Produce low-fidelity wireframes from a PRD or description | `01-wireframe` |
| `05-spec` | Generate or refine a normalized project spec | `01-build`, `02-refine` |

## aidd-refine

Expand Down
10 changes: 7 additions & 3 deletions plugins/aidd-context/hooks/routing/tests/held-out-prompts.json
Original file line number Diff line number Diff line change
Expand Up @@ -38,9 +38,13 @@
{ "prompt": "write product requirements", "expect": "aidd-pm:03-prd", "category": "prd-en" },
{ "prompt": "génère un PRD", "expect": "aidd-pm:03-prd", "category": "prd-fr" },

{ "prompt": "build spec from PRD", "expect": "aidd-pm:04-spec", "category": "spec-en", "also_accept": ["aidd-pm:03-prd"] },
{ "prompt": "refine spec with reviewer notes", "expect": "aidd-pm:04-spec", "category": "spec-en" },
{ "prompt": "rédige la spec", "expect": "aidd-pm:04-spec", "category": "spec-fr" },
{ "prompt": "wireframe the checkout screens", "expect": "aidd-pm:04-wireframe", "category": "wireframe-en" },
{ "prompt": "create wireframes for the onboarding flow", "expect": "aidd-pm:04-wireframe", "category": "wireframe-en" },
{ "prompt": "fais les wireframes de la feature login", "expect": "aidd-pm:04-wireframe", "category": "wireframe-fr" },

{ "prompt": "build spec from PRD", "expect": "aidd-pm:05-spec", "category": "spec-en", "also_accept": ["aidd-pm:03-prd"] },
{ "prompt": "refine spec with reviewer notes", "expect": "aidd-pm:05-spec", "category": "spec-en" },
{ "prompt": "rédige la spec", "expect": "aidd-pm:05-spec", "category": "spec-fr" },

{ "prompt": "create implementation plan for auth", "expect": "aidd-dev:01-plan", "category": "plan-en" },
{ "prompt": "rédige un plan technique", "expect": "aidd-dev:01-plan", "category": "plan-fr" },
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ All templates live alongside the skill that owns them, under `plugins/<plugin>/s
| `aidd-context:03-context-generate/assets/agents/` | Agent file template |
| `aidd-context:03-context-generate/assets/rules/` | Rule file template |
| `aidd-pm:03-prd/assets/` | PRD body template |
| `aidd-pm:04-spec/assets/` | Spec template and validator |
| `aidd-pm:04-wireframe/assets/` | Wireframe body template |
| `aidd-pm:05-spec/assets/` | Spec template and validator |
| `aidd-dev:01-plan/assets/` | Plan and master-plan templates |
| `aidd-vcs:01-commit/assets/` | Conventional commit message template |
| `aidd-vcs:02-pull-request/assets/` | Pull/merge request body template, contributing example |
Expand Down
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.
| ----------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| aidd-context | Bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks, plugins, marketplaces), mermaid diagrams, learn, discovery | `02-project-init`, `03-context-generate`, `04-mermaid` |
| aidd-refine | Meta-cognition: brainstorm, challenge prior work, condensed communication mode | `01-brainstorm`, `02-challenge`, `03-condense` |
| aidd-pm | Product management: ticket info, user stories, PRD, spec | `01-ticket-info`, `02-user-stories-create`, `03-prd`, `04-spec` |
| aidd-pm | Product management: ticket info, user stories, PRD, wireframe, spec | `01-ticket-info`, `02-user-stories-create`, `03-prd`, `04-wireframe`, `05-spec` |
| aidd-dev | Code transformation: Dev SDLC orchestrator, plan, implement, assert, audit, review, test, refactor, debug, for-sure | `00-sdlc`, `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` |
| aidd-orchestrator | Async orchestration of the SDLC on labeled issues (optional, extra) | `00-async-dev` (router with setup / run / review sub-flows) |
Expand Down Expand Up @@ -102,7 +102,7 @@ AIDD is delivered as a plugin marketplace. Pick what you need; do not install ev
| aidd-refine | 01-brainstorm, 02-challenge, 03-condense, 04-shadow-areas, 05-fact-check |
| aidd-dev | 00-sdlc, 01-plan, 02-implement, 03-assert, 04-audit, 05-review, 06-test, 07-refactor, 08-debug, 09-for-sure |
| aidd-vcs | 01-commit, 02-pull-request, 03-release-tag, 04-issue-create |
| aidd-pm | 01-ticket-info, 02-user-stories-create, 03-prd, 04-spec |
| aidd-pm | 01-ticket-info, 02-user-stories-create, 03-prd, 04-wireframe, 05-spec |

Each plugin is independently installable; install incrementally. Smaller surface, fewer triggers competing.

Expand All @@ -112,7 +112,7 @@ A typical change cycles through skills from several plugins. The order below is

1. **Bootstrap** (only for a brand-new project): `aidd-context:01-bootstrap` imagines the stack and architecture, comparing candidate stacks and writing an `INSTALL.md`. Skip this step on an existing project.
2. **Project init** (once per project, re-runnable to refresh): `aidd-context:02-project-init` scaffolds `aidd_docs/`, the memory bank, and the AI context files for the tools you use. Re-running later refreshes the scaffold without overwriting your customizations.
3. **Frame the request**: `aidd-refine:01-brainstorm` to clarify, `aidd-pm:01-ticket-info` to pull tracker data, `aidd-pm:02-user-stories-create` and `aidd-pm:03-prd` or `aidd-pm:04-spec` to formalize scope.
3. **Frame the request**: `aidd-refine:01-brainstorm` to clarify, `aidd-pm:01-ticket-info` to pull tracker data, `aidd-pm:02-user-stories-create` and `aidd-pm:03-prd` or `aidd-pm:05-spec` to formalize scope.
4. **Plan**: `aidd-dev:01-plan` produces the technical plan, component behavior model, or design-image extraction.
5. **Implement and assert**: `aidd-dev:02-implement` writes code against the plan; `aidd-dev:03-assert` verifies the result.
6. **Review**: `aidd-dev:05-review` for code and functional review; `aidd-refine:02-challenge` to stress-test the result.
Expand Down
6 changes: 4 additions & 2 deletions plugins/aidd-pm/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "aidd-pm",
"version": "1.0.2",
"description": "Product management: ticket-info, user-stories-create, prd, spec",
"description": "Product management: ticket-info, user-stories-create, prd, wireframe, spec",
"author": {
"name": "AI-Driven Dev",
"url": "https://github.com/ai-driven-dev"
Expand All @@ -11,12 +11,14 @@
"./skills/01-ticket-info",
"./skills/02-user-stories-create",
"./skills/03-prd",
"./skills/04-spec"
"./skills/04-wireframe",
"./skills/05-spec"
],
"keywords": [
"product-management",
"user-stories",
"prd",
"wireframe",
"specification",
"tickets"
],
Expand Down
27 changes: 19 additions & 8 deletions plugins/aidd-pm/CATALOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
- [`skills/01-ticket-info`](#skills01-ticket-info)
- [`skills/02-user-stories-create`](#skills02-user-stories-create)
- [`skills/03-prd`](#skills03-prd)
- [`skills/04-spec`](#skills04-spec)
- [`skills/04-wireframe`](#skills04-wireframe)
- [`skills/05-spec`](#skills05-spec)

---

Expand Down Expand Up @@ -53,14 +54,24 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
| `-` | [README.md](skills/03-prd/README.md) | - | - |
| `-` | [SKILL.md](skills/03-prd/SKILL.md) | `Generate a structured Product Requirements Document from a feature description or user stories, validated with the user before save. Use when the user says "prd", "draft prd", "write prd", "product requirements for X", "generate a prd", or invokes `/prd`. Do NOT use for writing user stories, drafting a technical implementation plan, or writing source code.` | - |

#### `skills/04-spec`
#### `skills/04-wireframe`

| Group | File | Description | Argument Hint |
|-------|------|---|---|
| `actions` | [01-wireframe.md](skills/04-wireframe/actions/01-wireframe.md) | - | - |
| `assets` | [wireframe-template.md](skills/04-wireframe/assets/wireframe-template.md) | `Low-fidelity wireframe template (screens, layouts, navigation flow)` | - |
| `evals` | [scenarios.json](skills/04-wireframe/evals/scenarios.json) | - | - |
| `-` | [README.md](skills/04-wireframe/README.md) | - | - |
| `-` | [SKILL.md](skills/04-wireframe/SKILL.md) | `Produce low-fidelity wireframes from a feature description, auto-loading a PRD from aidd_docs when one exists, validated with the user before save. Use when the user says "wireframe", "wireframes", "wireframe the feature", "screen layout", "low-fi mockup", "maquette fil de fer", or asks for the screens and navigation flow of a feature. Do NOT use for high-fidelity visual design, generating UI code, drafting a PRD, or writing a spec.` | - |

#### `skills/05-spec`

| Group | File | Description |
|-------|------|---|
| `actions` | [01-build.md](skills/04-spec/actions/01-build.md) | - |
| `actions` | [02-refine.md](skills/04-spec/actions/02-refine.md) | - |
| `assets` | [spec-template.md](skills/04-spec/assets/spec-template.md) | - |
| `evals` | [scenarios.json](skills/04-spec/evals/scenarios.json) | - |
| `-` | [README.md](skills/04-spec/README.md) | - |
| `-` | [SKILL.md](skills/04-spec/SKILL.md) | `Generate or refine a project spec from a free-form human request, an existing PRD, or reviewer findings. Use when the user says "draft spec", "spec for X", "refine the spec", "generate spec from prd", "/spec", or when an orchestrator needs a normalized contract before planning. Do NOT use for writing source code, drafting a full PRD, or modifying a validated and locked spec.` |
| `actions` | [01-build.md](skills/05-spec/actions/01-build.md) | - |
| `actions` | [02-refine.md](skills/05-spec/actions/02-refine.md) | - |
| `assets` | [spec-template.md](skills/05-spec/assets/spec-template.md) | - |
| `evals` | [scenarios.json](skills/05-spec/evals/scenarios.json) | - |
| `-` | [README.md](skills/05-spec/README.md) | - |
| `-` | [SKILL.md](skills/05-spec/SKILL.md) | `Generate or refine a project spec from a free-form human request, an existing PRD, or reviewer findings. Use when the user says "draft spec", "spec for X", "refine the spec", "generate spec from prd", "/spec", or when an orchestrator needs a normalized contract before planning. Do NOT use for writing source code, drafting a full PRD, or modifying a validated and locked spec.` |

5 changes: 3 additions & 2 deletions plugins/aidd-pm/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Product management plugin for the AI-Driven Development framework.

First time? Install with `/plugin install aidd-pm@aidd-framework`, then run `aidd-pm:01-ticket-info`.

Covers ticket information retrieval, user story creation, product requirement documents, and spec generation for downstream agents.
Covers ticket information retrieval, user story creation, product requirement documents, low-fidelity wireframes, and spec generation for downstream agents.

## Skills

Expand All @@ -17,4 +17,5 @@ Covers ticket information retrieval, user story creation, product requirement do
| [4.1] | [ticket-info](skills/01-ticket-info/README.md) | Retrieve and display ticket information from the configured ticketing tool. |
| [4.2] | [user-stories-create](skills/02-user-stories-create/README.md) | Generate INVEST-compliant user stories from a feature description. |
| [4.3] | [prd](skills/03-prd/README.md) | Generate a structured Product Requirements Document. |
| [4.4] | [spec](skills/04-spec/README.md) | Generate and refine a project spec from a free-form human request. The spec is the immutable target a planner consumes. |
| [4.4] | [wireframe](skills/04-wireframe/README.md) | Produce low-fidelity wireframes (screens, layouts, navigation flow) from a PRD or feature description. |
| [4.5] | [spec](skills/05-spec/README.md) | Generate and refine a project spec from a free-form human request. The spec is the immutable target a planner consumes. |
Loading
Loading