feat(aidd-pm): add Product Brief discovery skill

.claude-plugin/marketplace.json

@@ -31,7 +31,7 @@
     {
       "name": "aidd-pm",
       "source": "./plugins/aidd-pm",
-      "description": "Product management: ticket-info, user-stories, prd, spec",
+      "description": "Product management: ticket-info, user-stories, product-brief, prd, spec, spike",
       "strict": true,
       "recommended": true
     },

README.md

@@ -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>41 skills</kbd> · <kbd>2 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
+  <!--counts:start--><kbd>7 plugins</kbd> · <kbd>42 skills</kbd> · <kbd>2 agents</kbd><!--counts:end--> · <kbd>MIT</kbd>
 </p>
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
@@ -243,9 +243,9 @@ Repo init, commits, pull / merge requests, release tags, issues.
 
 ### 📋 [aidd-pm](plugins/aidd-pm/README.md)
 
-`5 skills` · stable
+`6 skills` · stable
 
-Ticket info, user stories, PRD, spec drafting, spike investigations.
+Ticket info, user stories, Product Briefs, PRD, spec drafting, spike investigations.
 
 </td>
 <td width="33%" valign="top">

aidd_docs/CONTRIBUTING.md

@@ -24,6 +24,7 @@ All templates live alongside the skill that owns them, under `plugins/<plugin>/s
 | `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:06-product-brief/assets/`                 | Product Brief template                                   |
 | `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   |

aidd_docs/README.md

@@ -39,7 +39,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-memory`, `03-context-generate`, `09-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`, `03-prd`, `04-spec` |
+| aidd-pm           | Product management: ticket info, user stories, Product Briefs, PRD, spec, spikes     | `01-ticket-info`, `02-user-stories`, `03-prd`, `04-spec`, `05-spike`, `06-product-brief` |
 | 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) |
@@ -104,7 +104,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, 03-prd, 04-spec                                                                    |
+| aidd-pm      | 01-ticket-info, 02-user-stories, 03-prd, 04-spec, 05-spike, 06-product-brief                                      |
 
 Each plugin is independently installable; install incrementally. Smaller surface, fewer triggers competing.
 
@@ -114,7 +114,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-memory` 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` 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:06-product-brief` to align the product, then `aidd-pm:02-user-stories`, `aidd-pm:03-prd`, or `aidd-pm:04-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.

docs/CATALOG.md

@@ -52,7 +52,7 @@ The development SDLC: plan, implement, assert, audit, review, test, refactor, de
 
 ## 📋 aidd-pm
 
-Product management: ticket retrieval, user stories, PRD, spec, spikes.
+Product management: ticket retrieval, user stories, Product Briefs, PRD, spec, spikes.
 
 | Skill                     | Role                                                       | Actions                          |
 | ------------------------- | ---------------------------------------------------------- | -------------------------------- |
@@ -61,6 +61,7 @@ Product management: ticket retrieval, user stories, PRD, spec, spikes.
 | `03-prd`                  | Generate a structured Product Requirements Document        | `01-prd`                         |
 | `04-spec`                 | Generate or refine a normalized project spec               | `01-build`, `02-refine`          |
 | `05-spike`                | Record or investigate a decision-blocking uncertainty      | `01-create`, `02-investigate`, `03-conclude` |
+| `06-product-brief`        | Produce a Product Brief before requirements                | `01-frame` to `05-finalize`      |
 
 ## 🪞 aidd-refine
 

plugins/aidd-context/skills/12-cook/assets/recipes/start-a-project.md

@@ -20,13 +20,15 @@ Brainstorming sharpens the raw idea into a precise request.
 /aidd-refine:01-brainstorm
 ```
 
-#### 2) 📄 Draft the PRD
+#### 2) 📄 Discover the product and draft the PRD
 
 The PRD turns the idea into structured product requirements.
 
-1. Run `/aidd-pm:03-prd`.
+1. Run `/aidd-pm:06-product-brief`.
+2. Pass its brief to `/aidd-pm:03-prd`.
 
 ```text
+/aidd-pm:06-product-brief
 /aidd-pm:03-prd
 ```
 

plugins/aidd-pm/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "aidd-pm",
   "version": "2.2.1",
-  "description": "Product management: ticket-info, user-stories, prd, spec, spike",
+  "description": "Product management: ticket-info, user-stories, product-brief, prd, spec, spike",
   "author": {
     "name": "AI-Driven Dev",
     "url": "https://github.com/ai-driven-dev"
@@ -12,10 +12,12 @@
     "./skills/02-user-stories",
     "./skills/03-prd",
     "./skills/04-spec",
-    "./skills/05-spike"
+    "./skills/05-spike",
+    "./skills/06-product-brief"
   ],
   "keywords": [
     "product-management",
+    "product-brief",
     "user-stories",
     "prd",
     "specification",

plugins/aidd-pm/CATALOG.md

@@ -13,6 +13,7 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
   - [`skills/03-prd`](#skills03-prd)
   - [`skills/04-spec`](#skills04-spec)
   - [`skills/05-spike`](#skills05-spike)
+  - [`skills/06-product-brief`](#skills06-product-brief)
 
 ---
 
@@ -78,3 +79,20 @@ Auto-generated index of skills, agents, references and assets shipped by the `ai
 | `references` | [qualification.md](skills/05-spike/references/qualification.md) | - |
 | `-` | [SKILL.md](skills/05-spike/SKILL.md) | `Produces an evidence-bounded spike for an uncertainty blocking estimation, feasibility, or design. Use when the user wants to frame, investigate, resume, or conclude one. Not for general research or implementation.` |
 
+#### `skills/06-product-brief`
+
+| Group | File | Description |
+|-------|------|---|
+| `actions` | [01-frame.md](skills/06-product-brief/actions/01-frame.md) | - |
+| `actions` | [02-discover.md](skills/06-product-brief/actions/02-discover.md) | - |
+| `actions` | [03-visualize.md](skills/06-product-brief/actions/03-visualize.md) | - |
+| `actions` | [04-shape.md](skills/06-product-brief/actions/04-shape.md) | - |
+| `actions` | [05-finalize.md](skills/06-product-brief/actions/05-finalize.md) | - |
+| `assets` | [product-brief.md](skills/06-product-brief/assets/product-brief.md) | - |
+| `references` | [brief-quality.md](skills/06-product-brief/references/brief-quality.md) | - |
+| `references` | [evidence.md](skills/06-product-brief/references/evidence.md) | - |
+| `references` | [persistence.md](skills/06-product-brief/references/persistence.md) | - |
+| `references` | [techniques.md](skills/06-product-brief/references/techniques.md) | - |
+| `references` | [visuals.md](skills/06-product-brief/references/visuals.md) | - |
+| `-` | [SKILL.md](skills/06-product-brief/SKILL.md) | `Produces a concise Product Brief before requirements. Use when the user wants to frame or revisit a product opportunity and how it will be validated. Not for requirements, technical design, or planning.` |
+

plugins/aidd-pm/README.md

@@ -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 retrieval, user stories, product requirements, specs, and bounded spike investigations.
+Covers ticket retrieval, user stories, product discovery, requirements, specs, and bounded spike investigations.
 
 ## Skills
 
@@ -19,3 +19,4 @@ Covers ticket retrieval, user stories, product requirements, specs, and bounded
 | [4.3] | [prd](skills/03-prd/SKILL.md) | Generate a structured Product Requirements Document. |
 | [4.4] | [spec](skills/04-spec/SKILL.md) | Generate and refine a project spec from a free-form human request. The spec is the immutable target a planner consumes. |
 | [4.5] | [spike](skills/05-spike/SKILL.md) | Record or investigate an uncertainty that blocks estimation, feasibility, or design. |
+| [4.6] | [product-brief](skills/06-product-brief/SKILL.md) | Produce one evidence-aware Product Brief. |

plugins/aidd-pm/skills/06-product-brief/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: 06-product-brief
+description: Produces a concise Product Brief before requirements. Use when the user wants to frame or revisit a product opportunity and how it will be validated. Not for requirements, technical design, or planning.
+argument-hint: idea | product
+---
+
+# Product Brief
+
+```mermaid
+flowchart LR
+  start([idea or product]) --> frame
+  frame --> discover
+  discover -->|"open decision"| discover
+  discover -->|"ready or assumptions accepted"| shape
+  discover -->|"visual helps"| visualize
+  visualize -->|"revise"| visualize
+  visualize -->|"accepted or skipped"| shape
+  shape -->|"evidence gap"| discover
+  shape --> finalize
+  finalize -->|"learn more"| discover
+  finalize -->|"change visual"| visualize
+  finalize -->|"revise brief"| shape
+  finalize -->|"approved"| done([Product Brief])
+```
+
+## Actions
+
+Run the flow above. Read only the next action's file before running it.
+
+| Action    | Does                                 |
+| --------- | ------------------------------------ |
+| frame     | establish scope and evidence path    |
+| discover  | research, question, and challenge    |
+| visualize | clarify with an optional product view |
+| shape     | compose one Product Brief            |
+| finalize  | refine, approve, and persist          |
+
+## Transversal rules
+
+- Separate evidence, decisions, and assumptions.
+- Keep product decisions with the user.
+- Keep actions and technique names out of user-facing text.

plugins/aidd-pm/skills/06-product-brief/actions/01-frame.md

@@ -0,0 +1,28 @@
+# 01 - Frame
+
+Establish what product is being framed and where useful evidence can come from.
+
+## Input
+
+An idea, an existing product, or the current context.
+
+## Output
+
+The product scope and evidence path.
+
+## Process
+
+1. **Resolve.** Infer the product from current context; otherwise ask for the idea in plain language and wait.
+2. **Ground.** Apply [evidence](../references/evidence.md) to available sources.
+3. **Scope.** State the opportunity.
+4. **Confirm.** Ask about any ambiguity that could change it and wait.
+5. **Focus.** Name only project inspection or external research that could resolve a live claim.
+
+## Test
+
+| Case | Pass |
+| --- | --- |
+| Product not identifiable | workspace unchanged; exactly one open question for the idea; no field list |
+| Existing product | relevant project evidence inspected before asking what it answers |
+| Several current matches | workspace unchanged; one authority-selection question; no date-based choice |
+| Research proposed | each path names the claim it may change |

plugins/aidd-pm/skills/06-product-brief/actions/02-discover.md

@@ -0,0 +1,30 @@
+# 02 - Discover
+
+Build an evidence-aware understanding of the product opportunity.
+
+## Input
+
+The framed product, evidence path, and user feedback.
+
+## Output
+
+The current opportunity, audience, product bet, evidence, assumptions, and success direction.
+
+## Process
+
+1. **Inspect.** Read the selected available sources.
+2. **Research.** Run only the selected external research.
+3. **Choose.** Apply [techniques](../references/techniques.md) only to unresolved claims.
+4. **Challenge.** Surface contradictions that could change the product.
+5. **Probe.** Ask one question about the highest-impact gap and wait.
+6. **Integrate.** Fold the answer into affected claims.
+7. **Repeat.** Return to `Probe` while an unaccepted consequential gap remains.
+
+## Test
+
+| Case | Pass |
+| --- | --- |
+| Unsupported product claim | labeled assumption, never evidence or decision |
+| Lens selected | matches the stated uncertainty in `techniques`; creates no artifact |
+| Next question | exactly one unanswered, product-changing question; no answered question repeated |
+| Consequential gap | no draft unless the user accepts it as an assumption |

plugins/aidd-pm/skills/06-product-brief/actions/03-visualize.md

@@ -0,0 +1,25 @@
+# 03 - Visualize
+
+Clarify a product relationship, journey, comparison, or screen structure when prose is weaker.
+
+## Input
+
+The current product understanding.
+
+## Output
+
+One optional table, Mermaid diagram, or low-fidelity wireframe.
+
+## Process
+
+1. **Create.** Apply [visuals](../references/visuals.md) to the current understanding.
+2. **Show.** Present the visual and wait.
+3. **Revise.** Fold user corrections into the visual.
+
+## Test
+
+| Case | Pass |
+| --- | --- |
+| No matching view | no `Product View` produced |
+| Mermaid | syntax parses |
+| Produced view | exactly one format; its format and `Any view` contracts pass |

plugins/aidd-pm/skills/06-product-brief/actions/04-shape.md

@@ -0,0 +1,28 @@
+# 04 - Shape
+
+Turn the current understanding into one coherent Product Brief.
+
+## Input
+
+The discovered product understanding and any approved visual.
+
+## Output
+
+A review-ready Product Brief kept in context.
+
+## Process
+
+1. **Compose.** Fill [the template](../assets/product-brief.md).
+2. **Check.** Apply [brief quality](../references/brief-quality.md).
+3. **Show.** Present the complete draft without persisting it.
+
+## Test
+
+| Case | Pass |
+| --- | --- |
+| Frontmatter | non-empty `objective`; `status: current`; relation fields absent unless backed by a replacement |
+| Structure | template order unchanged; only empty optional sections omitted |
+| Cleanup | no comment, placeholder, or `TODO` remains |
+| Claims | every consequential claim has a status and basis or next check |
+| Quality | every `brief-quality` row passes |
+| Handoff | complete draft shown; workspace unchanged; finalization follows |

plugins/aidd-pm/skills/06-product-brief/actions/05-finalize.md

@@ -0,0 +1,31 @@
+# 05 - Finalize
+
+Let the user refine, extend, keep, or persist the Product Brief.
+
+## Input
+
+The draft and its sources.
+
+## Output
+
+An approved Product Brief in session or at its resolved path.
+
+## Process
+
+1. **Ask.** Invite revision, further discovery, session approval, or persistence in one open question.
+2. **Clarify.** After content-only approval, ask session or persist and wait.
+3. **Place.** Apply [persistence](../references/persistence.md) to resolve approved files.
+4. **Confirm.** For a replacement, show both changes and wait.
+5. **Write.** Persist approved files; preserve user edits.
+6. **Verify.** Read back every changed brief.
+
+## Test
+
+| Case | Pass |
+| --- | --- |
+| Unapproved draft | workspace unchanged; response ends with one open feedback question |
+| Content approval only | workspace unchanged; session or persistence requested |
+| Initial persistence | one `current` brief created; relation fields absent |
+| Existing persistence | one `current` brief changed; unapproved edits preserved |
+| Replacement | two briefs changed; statuses and project-relative relation paths are reciprocal |
+| Report | written path exists, matches the standard path, and is usable by PRD |