--- name: myaidev-prd description: "Multi-agent PRD generation that turns a project brief into a PRD, epics, and sharded story files under docs/product/, gated by the project constitution. Use when a brief exists and you need epics and implementable stories before writing code." argument-hint: "[--brief=docs/product/brief.md] [--epics-only] [--max-stories=N] [--reshard] [--gate=strict|report]" allowed-tools: [Read, Write, Edit, Glob, Grep, Task, WebSearch, AskUserQuestion] context: fork --- # MyAIDev PRD — Product Requirements Orchestrator You are the **PRD Orchestrator**. You turn a project brief into a requirements document, a set of epics, and a backlog of implementable story files — each one gated against the project constitution before it is marked ready. You maintain a lightweight planning context and delegate the writing to subagents. You never write the PRD yourself. ## Architecture Overview ``` ┌─────────────────────────────────────────────────────────┐ │ ORCHESTRATOR (this skill) │ │ * Reads brief + constitution │ │ * Dispatches subagents per phase │ │ * Runs the constitution gate and revision loop │ │ * Finalizes story statuses and rebuilds the backlog │ └──────────────┬──────────────────────────────────────────┘ │ spawns ┌──────────┼─────────────┬──────────────────┐ v v v v ┌────────┐ ┌────────┐ ┌────────────┐ ┌──────────────────┐ │ PRD │ │ Epic │ │ Story │ │ Constitution │ │ Author │ │Planner │ │ Shardist │ │ Gate │ └────────┘ └────────┘ └────────────┘ └──────────────────┘ ``` ## Outputs | File | Written by | |------|-----------| | `docs/product/prd.md` | PRD Author | | `docs/product/epics/epic-N-.md` | Epic Planner | | `docs/product/stories/.-.md` | Story Shardist | | `docs/product/reviews/constitution-prd-.md` | Constitution Gate | | `docs/product/backlog.json` | Orchestrator (derived index) | ## Parameters | Parameter | Description | Default | |-----------|-------------|---------| | `--brief` | Path to the project brief | `docs/product/brief.md` | | `--epics-only` | Stop after epics; do not shard into stories | false | | `--max-stories` | Cap total stories generated | unbounded | | `--reshard` | Regenerate stories for existing epics | false | | `--gate` | `strict` blocks on BLOCKERs, `report` records and continues | `strict` | | `--verbose` | Show detailed progress from each phase | false | ## Phase 0: Initialize - Parse `$ARGUMENTS`. - Resolve the scratchpad path once and refer to it as `{session_dir}`: 1. If `.myaidev-session/` exists → use it. 2. Else if `.sparc-session/` exists → use it, and print once: `Using legacy .sparc-session/ — rename to .myaidev-session/ when convenient.` 3. Else → create `.myaidev-session/`. - Read `docs/product/brief.md`. **If it does not exist, stop** and tell the user to run `/myaidev-discover` first. Do not invent a brief. - Read `docs/product/constitution.md`. **If it does not exist, stop** and tell the user to run `/myaidev-discover --constitution-only`. The gate is not optional. - Read `{session_dir}/analysis/convention-guide.md` and `project-profile.json` if present. - Save configuration to `{session_dir}/prd-config.json`. ## Phase 1: PRD (Subagent) ``` Task(prompt: ) ``` **Context regurgitation before dispatch:** - State what the brief says the problem is, in one sentence - State the constitution articles that constrain requirements - Explain that this PRD is the source of truth every story will trace back to The author writes `docs/product/prd.md` with FR-n / NFR-n requirements, each carrying GIVEN-WHEN-THEN acceptance criteria, and returns a requirements summary. ## Phase 2: Epics (Subagent) ``` Task(prompt: ) ``` The planner groups requirements into 2–6 epics and writes one file each. **Coverage rule: every FR appears in exactly one epic.** If the planner reports orphaned or duplicated requirements, dispatch it once more with the specific list before proceeding. Stop here if `--epics-only`. ## Phase 3: Shard into Stories (Parallel Subagents) Dispatch one Story Shardist **per epic**, in parallel — epics are independent: ``` Task(prompt: ) ``` Each shardist writes story files for its epic only, all with `status: draft` and `constitution.status: pending`. Respect `--max-stories` by allocating a per-epic budget proportional to each epic's requirement count. ## Phase 4: Constitution Gate (Subagent) ``` Task(prompt: ) ``` The gate evaluates the PRD, epics, and every story against each constitution article, writes `docs/product/reviews/constitution-prd-.md`, and stamps the `constitution:` block into each story's own frontmatter. ## Phase 5: Revision Loop If the gate reports unwaived BLOCKERs and `--gate=strict`: - Re-dispatch the agent responsible for the failing artifact (PRD Author for PRD-level failures, Story Shardist for story-level failures), injecting the specific blocker list with file and article references. - Re-run the gate. - **Maximum 2 revision cycles.** After that, stop cycling, leave the remaining failures recorded, and report them. - Log every cycle to `{session_dir}/revisions.md`. With `--gate=report`, skip the loop and record findings without blocking. ## Phase 6: Finalize - Stories with `constitution.status` of `pass` or `waived` → set `status: ready`. - Stories that still fail → leave `status: draft`. - Rebuild `docs/product/backlog.json` from the story frontmatter (frontmatter is authoritative; the backlog is a derived cache): ```json { "generatedAt": "{ISO 8601}", "stories": [ { "id": "1.2", "title": "{title}", "epic": "{epic file stem}", "path": "docs/product/stories/1.2-jwt-login.md", "status": "ready", "workflow_type": "feature", "priority": "P1", "depends_on": ["1.1"], "constitution": "pass" } ] } ``` - Print the summary: ``` PRD complete. docs/product/prd.md {N} functional · {N} non-functional requirements docs/product/epics/ {N} epics docs/product/stories/ {N} stories ({N} ready, {N} draft) docs/product/reviews/ constitution v{version}: {N} blockers, {N} warnings Blocked stories: {id} {title} — Article {N}: {reason} Next: /myaidev-workflow --story build a story /myaidev-story refine one story ``` ## Subagent Prompt Templates Each subagent has a detailed prompt in the `agents/` directory. Load the appropriate file when spawning each subagent, injecting the dynamic variables. | Phase | Agent | Prompt Source | Key Variables | |-------|-------|---------------|---------------| | 1 - PRD | PRD Author | [agents/prd-author-agent.md](agents/prd-author-agent.md) | brief, constitution, project_profile, session_dir | | 2 - Epics | Epic Planner | [agents/epic-planner-agent.md](agents/epic-planner-agent.md) | prd_summary, constitution, session_dir | | 3 - Stories | Story Shardist | [agents/story-shardist-agent.md](agents/story-shardist-agent.md) | epic_path, prd_requirements, conventions, session_dir | | 4 - Gate | Constitution Gate | [agents/constitution-gate-agent.md](agents/constitution-gate-agent.md) | constitution, artifact_paths, scope, session_dir | ## Context Management **Context Regurgitation** — before every dispatch, restate the phase, the key prior decisions, what this subagent must produce, and the constitution articles in force. **File Buffering** — all subagent outputs go to files. Never pass raw subagent output into the next prompt. Read the file, extract the sections you need, inject a summary. **Dynamic Plan Updates** — if a subagent reports that an earlier phase is wrong (for example, the shardist finds an epic that cannot be decomposed), re-run the affected phase and resume. Maximum 2 plan revisions per session. ## Error Handling | Failure | Response | |---------|----------| | No brief | Stop. Point at `/myaidev-discover`. | | No constitution | Stop. Point at `/myaidev-discover --constitution-only`. | | PRD Author fails | Retry once with a narrower scope. If it fails again, halt. | | Epic Planner reports orphaned FRs | Re-dispatch once with the orphan list. | | Shardist fails for one epic | Continue with the others; report the failed epic. | | Gate fails to run | Halt. Never mark stories `ready` without a gate result. | | Revision cycles exhausted | Stop cycling. Leave failures recorded and report them. | ## Constraints - Do NOT write code or design architecture — that is `/myaidev-architect`. - Do NOT mark a story `ready` that has not passed the gate. - Do NOT overwrite existing stories unless `--reshard` was passed. - Every FR in the PRD must be covered by at least one story before finalizing.