diff --git a/aidd_docs/CONTRIBUTING.md b/aidd_docs/CONTRIBUTING.md
index 7145ed993..922e16909 100644
--- a/aidd_docs/CONTRIBUTING.md
+++ b/aidd_docs/CONTRIBUTING.md
@@ -24,6 +24,7 @@ All templates live alongside the skill that owns them, under `plugins//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 |
diff --git a/aidd_docs/README.md b/aidd_docs/README.md
index aac1bf1e0..130b053bb 100644
--- a/aidd_docs/README.md
+++ b/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.
diff --git a/docs/CATALOG.md b/docs/CATALOG.md
index d3689e80d..9ed5e4ccc 100644
--- a/docs/CATALOG.md
+++ b/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
diff --git a/plugins/aidd-context/skills/12-cook/assets/recipes/start-a-project.md b/plugins/aidd-context/skills/12-cook/assets/recipes/start-a-project.md
index 85fe9c4d8..f9f029064 100644
--- a/plugins/aidd-context/skills/12-cook/assets/recipes/start-a-project.md
+++ b/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
```
diff --git a/plugins/aidd-pm/.claude-plugin/plugin.json b/plugins/aidd-pm/.claude-plugin/plugin.json
index fd01d18a1..e72791981 100644
--- a/plugins/aidd-pm/.claude-plugin/plugin.json
+++ b/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",
diff --git a/plugins/aidd-pm/CATALOG.md b/plugins/aidd-pm/CATALOG.md
index deaf21870..e3a29ad63 100644
--- a/plugins/aidd-pm/CATALOG.md
+++ b/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.` |
+
diff --git a/plugins/aidd-pm/README.md b/plugins/aidd-pm/README.md
index 1129969a5..edbe52dbd 100644
--- a/plugins/aidd-pm/README.md
+++ b/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. |
diff --git a/plugins/aidd-pm/skills/06-product-brief/SKILL.md b/plugins/aidd-pm/skills/06-product-brief/SKILL.md
new file mode 100644
index 000000000..b089a90aa
--- /dev/null
+++ b/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.
diff --git a/plugins/aidd-pm/skills/06-product-brief/actions/01-frame.md b/plugins/aidd-pm/skills/06-product-brief/actions/01-frame.md
new file mode 100644
index 000000000..77ceaaeb3
--- /dev/null
+++ b/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 |
diff --git a/plugins/aidd-pm/skills/06-product-brief/actions/02-discover.md b/plugins/aidd-pm/skills/06-product-brief/actions/02-discover.md
new file mode 100644
index 000000000..716393da0
--- /dev/null
+++ b/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 |
diff --git a/plugins/aidd-pm/skills/06-product-brief/actions/03-visualize.md b/plugins/aidd-pm/skills/06-product-brief/actions/03-visualize.md
new file mode 100644
index 000000000..1d5736197
--- /dev/null
+++ b/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 |
diff --git a/plugins/aidd-pm/skills/06-product-brief/actions/04-shape.md b/plugins/aidd-pm/skills/06-product-brief/actions/04-shape.md
new file mode 100644
index 000000000..d7005e687
--- /dev/null
+++ b/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 |
diff --git a/plugins/aidd-pm/skills/06-product-brief/actions/05-finalize.md b/plugins/aidd-pm/skills/06-product-brief/actions/05-finalize.md
new file mode 100644
index 000000000..1da13e912
--- /dev/null
+++ b/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 |
diff --git a/plugins/aidd-pm/skills/06-product-brief/assets/product-brief.md b/plugins/aidd-pm/skills/06-product-brief/assets/product-brief.md
new file mode 100644
index 000000000..c5138ec45
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/assets/product-brief.md
@@ -0,0 +1,53 @@
+---
+objective: ""
+status: current
+---
+
+
+
+# Product Brief:
+
+
+
+## Opportunity
+
+
+
+## Audience and Context
+
+
+
+## Product Bet
+
+
+
+## Evidence and Assumptions
+
+| Claim | Status | Basis or next check |
+| --- | --- | --- |
+| | | |
+
+## Boundaries
+
+- Addresses:
+- Leaves out:
+
+## Success
+
+
+
+## Validation and Feedback
+
+
+
+## Product View
+
+
+
+
+
+## Open Decisions
+
+
+
+-
diff --git a/plugins/aidd-pm/skills/06-product-brief/references/brief-quality.md b/plugins/aidd-pm/skills/06-product-brief/references/brief-quality.md
new file mode 100644
index 000000000..6b4878d07
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/references/brief-quality.md
@@ -0,0 +1,10 @@
+# Brief Quality
+
+| Check | Pass when |
+| --- | --- |
+| Coherence | opportunity, audience, and product bet form one falsifiable claim |
+| Boundary | the brief stays outside requirements |
+| Success | user value can confirm or challenge the bet |
+| Validation | the next check targets the riskiest assumption |
+| Feedback | a post-use signal can change a product decision |
+| Decisions | consequential open choices are explicit and accepted |
diff --git a/plugins/aidd-pm/skills/06-product-brief/references/evidence.md b/plugins/aidd-pm/skills/06-product-brief/references/evidence.md
new file mode 100644
index 000000000..2085ede04
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/references/evidence.md
@@ -0,0 +1,18 @@
+# Evidence
+
+Use each source only for what it can support.
+
+| Source | Can support | Cannot establish |
+| --- | --- | --- |
+| Conversation | intent and decisions | observed user or market behavior |
+| Interviews, support, analytics | behavior, pain, and outcomes | every target user |
+| Product docs and interface | promised and visible behavior | actual use or value |
+| Code and tests | implemented behavior | motivation or value |
+| Existing discovery | claims to re-check | current truth |
+| Competitors, reviews, forums | public claims and reported experience | target-user truth |
+
+| Case | Handling |
+| --- | --- |
+| Untested greenfield claim | assumption |
+| Consequential external claim | cite an authoritative or firsthand source; label inference |
+| Several matching current artifacts | ask which is authoritative; date is not evidence |
diff --git a/plugins/aidd-pm/skills/06-product-brief/references/persistence.md b/plugins/aidd-pm/skills/06-product-brief/references/persistence.md
new file mode 100644
index 000000000..ea01b924a
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/references/persistence.md
@@ -0,0 +1,12 @@
+# Persistence
+
+Write `product-brief.md` under `aidd_docs/tasks//_/`.
+Every changed brief has a non-empty `objective` and one listed status.
+
+| Situation | Files | Frontmatter |
+| --- | --- | --- |
+| No brief matches | create one | `status: current`; omit both relation fields |
+| Revise the current brief | update one | keep `status: current` and any existing `supersedes`; omit `superseded_by` |
+| Replace the current brief | create new, update old | new: `current` + `supersedes`; old: `superseded` + `superseded_by` |
+
+Relation values are project-relative paths.
diff --git a/plugins/aidd-pm/skills/06-product-brief/references/techniques.md b/plugins/aidd-pm/skills/06-product-brief/references/techniques.md
new file mode 100644
index 000000000..f48ad674a
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/references/techniques.md
@@ -0,0 +1,12 @@
+# Discovery Techniques
+
+Choose a lens only when it resolves a live uncertainty.
+
+| Uncertainty | Lens | Useful result |
+| --- | --- | --- |
+| Motivation or progress | Jobs To Be Done | situation, desired progress, outcome, and current alternative |
+| Meaningful user differences | Behavioral personas | evidence-backed groups that can change a product decision |
+| Customer value | Value proposition | jobs, pains, gains, and the product bet that addresses them |
+| Product success | North Star | an earned metric for recurring user value, with guardrails if needed |
+| Opportunity space | Opportunity mapping | desired outcome and evidence-backed opportunities |
+| Existing experience | Journey mapping | observed steps, friction, and feedback points |
diff --git a/plugins/aidd-pm/skills/06-product-brief/references/visuals.md b/plugins/aidd-pm/skills/06-product-brief/references/visuals.md
new file mode 100644
index 000000000..c7f44cda6
--- /dev/null
+++ b/plugins/aidd-pm/skills/06-product-brief/references/visuals.md
@@ -0,0 +1,8 @@
+# Product Views
+
+| View | Use for | Contract |
+| --- | --- | --- |
+| Any view | structure clearer than prose | derived from the brief, under `Product View`, no new claim, replaces redundant prose |
+| Compact table | alternatives, groups, claims, or signals | comparison only |
+| Mermaid | sequences, relationships, boundaries, or opportunities | small, directional, and valid |
+| ASCII wireframe | a concrete product screen | structure only; no styling or final copy |
diff --git a/scripts/sync-skill-argument-hints.mjs b/scripts/sync-skill-argument-hints.mjs
index ae89a24c5..be3cdc145 100755
--- a/scripts/sync-skill-argument-hints.mjs
+++ b/scripts/sync-skill-argument-hints.mjs
@@ -95,7 +95,7 @@ function syncArgumentHint(content, hint) {
// Skills whose argument-hint is written by hand, because it names the user's
// entrypoint or cases rather than one token per action. The hook leaves these
// untouched. This is the base pattern for a pipeline or case-based router.
-const MANUAL_ARGUMENT_HINT = new Set(["01-brainstorm", "02-project-memory", "04-skill-generate", "05-spike"]);
+const MANUAL_ARGUMENT_HINT = new Set(["01-brainstorm", "02-project-memory", "04-skill-generate", "05-spike", "06-product-brief"]);
const stale = [];
for (const dir of await skillDirs()) {