[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72YEBCAB8N0B3VM80QGC9HS":3,"skill-same:01M72YEBCAB8N0B3VM80QGC9HS":95},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":42,"ownerHtmlUrl":43,"ownerBlogUrl":44,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M72YEBCAB8N0B3VM80QGC9HS","write-prd",null,"Use to turn a raw feature idea into a reviewed PRD.md — a lightweight Socratic interview front (capture the idea, deep-dive the problem) merged with a full product spec (context, goals, user stories, acceptance criteria, NFRs, KPIs). Triggers on \"\u002Fsdlc:write-prd {slug}\", \"write PRD for {slug}\", \"draft PRD for {slug}\", \"PRD для {slug}\", \"write spec for {slug}\", \"product requirements for {slug}\", \"напиши PRD {slug}\", \"опиши вимоги\", \"зафіксуй ідею\". Opens by setting the interview-depth dial (easy\u002Fmedium\u002Fhard), drafts from templates\u002FPRD-template.md, validates each acceptance criterion Socratically, runs a clean-context critic (sdlc:critic), then writes docs\u002Ffeatures\u002F{slug}\u002FPRD.md. Hard refuse if idea-brief.md or CONTEXT.md missing.","genkovich\u002Fagentic-engineering-course-public","genkovich","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F14920737?v=4","01M72Y5BWEEZ8VT4DFW6AGGE8X","Kirill Sulimovsky","01M72Y5BXYRGV5PKCVCHEX81WY",15,"MIT","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: write-prd\nmodel: opus\neffort: high\nagents: [critic]\ndescription: >\n  Use to turn a raw feature idea into a reviewed PRD.md — a lightweight Socratic interview\n  front (capture the idea, deep-dive the problem) merged with a full product spec (context,\n  goals, user stories, acceptance criteria, NFRs, KPIs). Triggers on \"\u002Fsdlc:write-prd {slug}\",\n  \"write PRD for {slug}\", \"draft PRD for {slug}\", \"PRD для {slug}\", \"write spec for {slug}\",\n  \"product requirements for {slug}\", \"напиши PRD {slug}\", \"опиши вимоги\", \"зафіксуй ідею\".\n  Opens by setting the interview-depth dial (easy\u002Fmedium\u002Fhard), drafts from templates\u002FPRD-template.md,\n  validates each acceptance criterion Socratically, runs a clean-context critic (sdlc:critic),\n  then writes docs\u002Ffeatures\u002F{slug}\u002FPRD.md. Hard refuse if idea-brief.md or CONTEXT.md missing.\ntriggers:\n  - \u002Fsdlc:write-prd\n  - \"write PRD for\"\n  - \"draft PRD for\"\n  - \"PRD для\"\n  - \"write spec for\"\n  - \"product requirements for\"\nstage: \"03\"\n---\n\n# Skill: write-prd (SDLC stage 03 — PRD drafter)\n\nTurns a one-line idea into a reviewed `PRD.md`: a lightweight interview captures and stress-tests the idea, then the skill drafts a product spec (context → goals → user stories → acceptance criteria → NFRs → KPIs), validates it Socratically, and runs a clean-context critic before writing. Less typing, more reviewing. This file is the spine; detail lives in `references\u002F`.\n\nThe Socratic machine, the critic, and the ask-style are **shared** — this skill keeps only its deltas:\n→ [`..\u002F_shared\u002Fsocratic-loop.md`](..\u002F_shared\u002Fsocratic-loop.md) · [`..\u002F_shared\u002Fcritic.md`](..\u002F_shared\u002Fcritic.md) · [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md)\n\nDepth governs question volume + autonomy → [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md).\n\n## Owner\n\nPM + Tech Lead (co-authors). PM drives goals \u002F non-goals \u002F KPIs; Tech Lead drives context patterns and the acceptance-criteria coverage.\n\n## Inputs\n\n**Hard required** (skill stops without them):\n\n- `\u003Cslug>` — kebab-case feature slug.\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002Fidea-brief.md` — problem, RICE, Recommendation (§13), Out of scope (§6). Missing → «run `\u002Fsdlc:interview \u003Cslug>` first».\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002FCONTEXT.md` — canonical glossary (role names, domain terms). Missing → «run `\u002Fsdlc:fix-term \u003Cslug>` first». No silent fallback.\n\n**Optional**:\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` — depth hint (MVP vs Full per the size matrix). Read if present; **established here if absent** (step 1 classifies + writes it), so downstream stages never silently default to M.\n- `--reference \u003Cpath-to-module>` — passed at invocation; pre-selects the «Reference module code» channel in step 3.\n\n## Protocol\n\n1. **Prereq check + read context + set interview depth.** `test -f` both required inputs and stop with the appropriate error if either is missing. Then: if `CONTEXT.md` exists, load its `## Glossary` as session state (canonical roles + terms). If `.size` exists, read it to size the PRD's depth; **if absent, establish it now** — classify the feature via the 4 signals in [`..\u002F_shared\u002Fsize-matrix.md`](..\u002F_shared\u002Fsize-matrix.md) (PR count \u002F time-to-merge \u002F new module·API·migration \u002F breaking changes), confirm in one bundled `AskUserQuestion` (at `easy` depth, take the matrix default and record it in the assumptions ledger), and write `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` — so every later stage reads a real size instead of silently defaulting to M. `classify-size` stays the utility to re-classify when scope changes. If `docs\u002Farchitecture-map.md` exists (from `map-architecture`), read it so the PRD is **architecture-aware** — it informs §1 Context, §2 Constraints, and §3 Non-goals (what the existing system already does \u002F can't do). Absent → suggest running `\u002Fsdlc:map-architecture` first, but proceed (the PRD is product-level and can be captured without it). **Do not leak the map's tech into §5 AC** — AC stay business-observable; the map shapes constraints, not acceptance criteria. **Then set the interview depth (the opening question):** **if `.claude\u002Fsdlc.local.md` is absent, auto-create it** with the documented default frontmatter (every key + its allowed values explained inline) and patch `.gitignore`; then read `interview_depth` from it (else default medium), and — unless a `--depth=easy|medium|hard` arg was passed (which skips the question) — ask ONE depth-selection `AskUserQuestion` phrased per [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md), with the saved\u002Fmedium value as the «(Recommended)» first option, overridable per run. The chosen level governs the step-2 deep-dive volume and the step-7 Socratic volume → [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md). (Completeness — §5's 5-type AC floor **and** §4→§5 use-case floor — is unaffected by depth.)\n\n2. **Capture the idea (interview front).** One `AskUserQuestion` for the raw idea in 1–3 sentences (persist verbatim as the baseline). Then a Socratic deep-dive across problem clarity \u002F success criteria \u002F constraints \u002F strategic fit, delivered in batches of 2–3 — its volume scales with the depth dial (easy: only the few un-inferable ones, then a stated-assumptions ledger; medium: 3–5; hard: walk every angle, foreground each trade-off). Phrase every question per [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md).\n\n3. **Reconcile the glossary in-flow (a hard rule, at every depth).** On every new or unknown domain term that surfaces in the interview or the draft, invoke `\u002Fsdlc:fix-term \u003Cslug>` for it **immediately** — compare it against `CONTEXT.md` and add\u002Fupdate the definition before continuing. By the time the PRD is written, every §4 role and §5 domain term is already glossary-canonical; the glossary is never a deferred batch.\n\n4. **Ask which extra channels to read** (multi-select `AskUserQuestion`): reference module code \u002F project docs \u002F MCP-Atlassian (Confluence) \u002F MCP-Atlassian (Jira) \u002F knowledge-base \u002F none. For each picked channel ask the **specific** path\u002Fquery — no silent broad scans. If `--reference` was passed, pre-select `Reference module code`.\n\n5. **Read selected channels.** Reference module → extract entity types, error sentinels, status constants, authz checks. MCP-Atlassian → `mcp__atlassian__search` for specified pages\u002Ftickets. Docs \u002F RAG → only the paths\u002Ftopics the user named.\n\n6. **Read the template + draft §1–§8.** Read [`.\u002Ftemplates\u002FPRD-template.md`](.\u002Ftemplates\u002FPRD-template.md) (its `\u003C!-- Skill instruction: ... -->` comments are the per-section contract). Draft per [`.\u002Freferences\u002Fdraft-generation.md`](.\u002Freferences\u002Fdraft-generation.md): per-section sources, the **5 AC coverage types** (happy \u002F error \u002F authorization \u002F domain invariant \u002F cross-context), and the **stack-agnostic forbidden-token** rule for acceptance criteria. Ensure **every §4 user story has ≥1 AC in §5 at draft time** (the use-case floor applies before the Socratic walk begins).\n\n7. **Socratic validation.** Walk §4 US → §5 AC → §6 NFR → §7 KPI with the shared 4-state machine (per-decision question volume scales with the depth dial — at easy, the un-asked decisions land in the assumptions ledger for a batch veto). write-prd delta → [`.\u002Freferences\u002Fsocratic-loop.md`](.\u002Freferences\u002Fsocratic-loop.md): AC has a 5th option «Add another AC»; the §5 coverage gate enforces **two floors** after drops\u002FOQ-migrations — (a) ≥1 AC of each of the 5 coverage types, and (b) **≥1 AC per retained §4 user story** (regenerate\u002Fadd a replacement if a type *or* a user story is left empty). **Both are floors, not dials — enforced at every depth;** only the question volume scales. The (b) floor closes the §4→§5 link so the downstream `complete-sequence-diagrams` use-case coverage + `review-feature` trace can't be undermined by a user story that lost its only AC. Maintain the edits-log.\n\n8. **Critic + write + commit.** Dispatch the [`critic`](..\u002F..\u002Fagents\u002Fcritic.md) agent — `subagent_type: \"sdlc:critic\"` (carries `model: opus` + `effort: high`, clean-isolated context per [`..\u002F_shared\u002Fagent-roster.md`](..\u002F_shared\u002Fagent-roster.md)) — with the write-prd delta in [`.\u002Freferences\u002Fcritic.md`](.\u002Freferences\u002Fcritic.md) (over [`..\u002F_shared\u002Fcritic.md`](..\u002F_shared\u002Fcritic.md)) — inline the draft + edits-log, it Reads `CONTEXT.md` + `idea-brief.md`. Resolve findings via `AskUserQuestion` (Accept revert \u002F Accept amendment \u002F Override-with-rationale → §1 ¶4 bullet). Run the forbidden-token regex scan as the F6 backstop. On pass, write `docs\u002Ffeatures\u002F\u003Cslug>\u002FPRD.md` (glossary already reconciled in-flow per step 3) and propose commit `03: PRD for \u003Cslug>`. **Register on the roadmap:** add\u002Fpromote this feature to **Now** in `docs\u002Froadmap.md` (via `\u002Fsdlc:roadmap`) — an outcome one-liner + a link to this feature folder + status; if it existed as a Next candidate, move it up. (If there's no roadmap yet, skip — it's optional.) Then **emit the stage-handoff block** per [`..\u002F_shared\u002Fhandoff.md`](..\u002F_shared\u002Fhandoff.md) — *What I did* + *Review* (`PRD.md`, `.size`) + *Run next* (`\u002Fclear`, then `\u002Fsdlc:clarify-prd \u003Cslug>`). (If `sdlc:critic` is unavailable, fall back to a `general-purpose` Agent with the same delta.)\n\n## Definition of Done\n\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002FPRD.md` written; all sections filled (or `\u003C!-- N\u002FA: reason -->`).\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` exists after this stage (read if it was present, else classified + written here).\n- §5 holds ≥1 AC of each of the 5 coverage types after drops\u002FOQ-migrations, **every §4 user story has ≥1 AC** (the use-case floor — no retained US left with zero ACs), and **0 forbidden tokens** (HTTP verbs \u002F URL paths \u002F status-code numerics \u002F `module.error_name` strings \u002F JSON fragments \u002F SQL constructs).\n- §4 roles match the `CONTEXT.md` glossary exactly (no invented `user`\u002F`admin`).\n- §8 Open Questions each carry owner + due (no lone «TBD»).\n- Edits-log maintained; critic (`sdlc:critic`) ran on the post-Socratic draft; every finding resolved or overridden.\n\n## Anti-patterns\n\n- **Skipping the interview front** and reconstructing the idea from the model's guess. Capture + deep-dive must actually fire `AskUserQuestion`.\n- **Naming concrete technologies in §1–§3** (a specific datastore, broker, framework, or library). The PRD is WHAT + WHY; technology choices belong to `architecture-design`.\n- **Implementation leak in AC** — HTTP\u002Fstatus\u002Ferror-code\u002FSQL detail. That mapping lives in `api-forge` and `decide-adr`.\n- **Dispatching `general-purpose` instead of `sdlc:critic`** without first checking availability. The namespaced critic carries the correct model\u002Feffort and clean context; fall back only on confirmed unavailability.\n- **Treating brainstorm or initiatives artifacts as PRD inputs.** PRD draws only from CONTEXT + idea-brief (required) plus user-selected additional channels.\n- **Inventing role names or domain terms** not in CONTEXT glossary. The glossary is canonical; the PRD never introduces new role names.\n\n## References & template\n\n- [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md) — the easy\u002Fmedium\u002Fhard dial set in step 1 (question volume, autonomy).\n- [`.\u002Freferences\u002Fdraft-generation.md`](.\u002Freferences\u002Fdraft-generation.md) — per-section sources, 5 AC coverage types, stack-agnostic forbidden tokens.\n- [`.\u002Freferences\u002Fsocratic-loop.md`](.\u002Freferences\u002Fsocratic-loop.md) — write-prd's delta over the shared Socratic loop (sections walked, use-case floor, decision-types).\n- [`.\u002Freferences\u002Fcritic.md`](.\u002Freferences\u002Fcritic.md) — write-prd's delta over the shared critic (F5 structural floor + F6 forbidden-token specialization).\n- [`.\u002Freferences\u002Fask-examples.md`](.\u002Freferences\u002Fask-examples.md) — explanatory `AskUserQuestion` shape for US \u002F AC \u002F NFR \u002F KPI + critic-finding examples (junior-friendly Ukrainian).\n- [`.\u002Freferences\u002Fchecklist.md`](.\u002Freferences\u002Fchecklist.md) — Definition of Done + full anti-patterns.\n- [`.\u002Ftemplates\u002FPRD-template.md`](.\u002Ftemplates\u002FPRD-template.md) — output scaffold; inline `\u003C!-- Skill instruction: ... -->` comments are the per-section generation contract.\n","# Skill: write-prd (SDLC stage 03 — PRD drafter)\n\nTurns a one-line idea into a reviewed `PRD.md`: a lightweight interview captures and stress-tests the idea, then the skill drafts a product spec (context → goals → user stories → acceptance criteria → NFRs → KPIs), validates it Socratically, and runs a clean-context critic before writing. Less typing, more reviewing. This file is the spine; detail lives in `references\u002F`.\n\nThe Socratic machine, the critic, and the ask-style are **shared** — this skill keeps only its deltas:\n→ [`..\u002F_shared\u002Fsocratic-loop.md`](..\u002F_shared\u002Fsocratic-loop.md) · [`..\u002F_shared\u002Fcritic.md`](..\u002F_shared\u002Fcritic.md) · [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md)\n\nDepth governs question volume + autonomy → [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md).\n\n## Owner\n\nPM + Tech Lead (co-authors). PM drives goals \u002F non-goals \u002F KPIs; Tech Lead drives context patterns and the acceptance-criteria coverage.\n\n## Inputs\n\n**Hard required** (skill stops without them):\n\n- `\u003Cslug>` — kebab-case feature slug.\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002Fidea-brief.md` — problem, RICE, Recommendation (§13), Out of scope (§6). Missing → «run `\u002Fsdlc:interview \u003Cslug>` first».\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002FCONTEXT.md` — canonical glossary (role names, domain terms). Missing → «run `\u002Fsdlc:fix-term \u003Cslug>` first». No silent fallback.\n\n**Optional**:\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` — depth hint (MVP vs Full per the size matrix). Read if present; **established here if absent** (step 1 classifies + writes it), so downstream stages never silently default to M.\n- `--reference \u003Cpath-to-module>` — passed at invocation; pre-selects the «Reference module code» channel in step 3.\n\n## Protocol\n\n1. **Prereq check + read context + set interview depth.** `test -f` both required inputs and stop with the appropriate error if either is missing. Then: if `CONTEXT.md` exists, load its `## Glossary` as session state (canonical roles + terms). If `.size` exists, read it to size the PRD's depth; **if absent, establish it now** — classify the feature via the 4 signals in [`..\u002F_shared\u002Fsize-matrix.md`](..\u002F_shared\u002Fsize-matrix.md) (PR count \u002F time-to-merge \u002F new module·API·migration \u002F breaking changes), confirm in one bundled `AskUserQuestion` (at `easy` depth, take the matrix default and record it in the assumptions ledger), and write `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` — so every later stage reads a real size instead of silently defaulting to M. `classify-size` stays the utility to re-classify when scope changes. If `docs\u002Farchitecture-map.md` exists (from `map-architecture`), read it so the PRD is **architecture-aware** — it informs §1 Context, §2 Constraints, and §3 Non-goals (what the existing system already does \u002F can't do). Absent → suggest running `\u002Fsdlc:map-architecture` first, but proceed (the PRD is product-level and can be captured without it). **Do not leak the map's tech into §5 AC** — AC stay business-observable; the map shapes constraints, not acceptance criteria. **Then set the interview depth (the opening question):** **if `.claude\u002Fsdlc.local.md` is absent, auto-create it** with the documented default frontmatter (every key + its allowed values explained inline) and patch `.gitignore`; then read `interview_depth` from it (else default medium), and — unless a `--depth=easy|medium|hard` arg was passed (which skips the question) — ask ONE depth-selection `AskUserQuestion` phrased per [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md), with the saved\u002Fmedium value as the «(Recommended)» first option, overridable per run. The chosen level governs the step-2 deep-dive volume and the step-7 Socratic volume → [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md). (Completeness — §5's 5-type AC floor **and** §4→§5 use-case floor — is unaffected by depth.)\n\n2. **Capture the idea (interview front).** One `AskUserQuestion` for the raw idea in 1–3 sentences (persist verbatim as the baseline). Then a Socratic deep-dive across problem clarity \u002F success criteria \u002F constraints \u002F strategic fit, delivered in batches of 2–3 — its volume scales with the depth dial (easy: only the few un-inferable ones, then a stated-assumptions ledger; medium: 3–5; hard: walk every angle, foreground each trade-off). Phrase every question per [`..\u002F_shared\u002Fask-style.md`](..\u002F_shared\u002Fask-style.md).\n\n3. **Reconcile the glossary in-flow (a hard rule, at every depth).** On every new or unknown domain term that surfaces in the interview or the draft, invoke `\u002Fsdlc:fix-term \u003Cslug>` for it **immediately** — compare it against `CONTEXT.md` and add\u002Fupdate the definition before continuing. By the time the PRD is written, every §4 role and §5 domain term is already glossary-canonical; the glossary is never a deferred batch.\n\n4. **Ask which extra channels to read** (multi-select `AskUserQuestion`): reference module code \u002F project docs \u002F MCP-Atlassian (Confluence) \u002F MCP-Atlassian (Jira) \u002F knowledge-base \u002F none. For each picked channel ask the **specific** path\u002Fquery — no silent broad scans. If `--reference` was passed, pre-select `Reference module code`.\n\n5. **Read selected channels.** Reference module → extract entity types, error sentinels, status constants, authz checks. MCP-Atlassian → `mcp__atlassian__search` for specified pages\u002Ftickets. Docs \u002F RAG → only the paths\u002Ftopics the user named.\n\n6. **Read the template + draft §1–§8.** Read [`.\u002Ftemplates\u002FPRD-template.md`](.\u002Ftemplates\u002FPRD-template.md) (its `\u003C!-- Skill instruction: ... -->` comments are the per-section contract). Draft per [`.\u002Freferences\u002Fdraft-generation.md`](.\u002Freferences\u002Fdraft-generation.md): per-section sources, the **5 AC coverage types** (happy \u002F error \u002F authorization \u002F domain invariant \u002F cross-context), and the **stack-agnostic forbidden-token** rule for acceptance criteria. Ensure **every §4 user story has ≥1 AC in §5 at draft time** (the use-case floor applies before the Socratic walk begins).\n\n7. **Socratic validation.** Walk §4 US → §5 AC → §6 NFR → §7 KPI with the shared 4-state machine (per-decision question volume scales with the depth dial — at easy, the un-asked decisions land in the assumptions ledger for a batch veto). write-prd delta → [`.\u002Freferences\u002Fsocratic-loop.md`](.\u002Freferences\u002Fsocratic-loop.md): AC has a 5th option «Add another AC»; the §5 coverage gate enforces **two floors** after drops\u002FOQ-migrations — (a) ≥1 AC of each of the 5 coverage types, and (b) **≥1 AC per retained §4 user story** (regenerate\u002Fadd a replacement if a type *or* a user story is left empty). **Both are floors, not dials — enforced at every depth;** only the question volume scales. The (b) floor closes the §4→§5 link so the downstream `complete-sequence-diagrams` use-case coverage + `review-feature` trace can't be undermined by a user story that lost its only AC. Maintain the edits-log.\n\n8. **Critic + write + commit.** Dispatch the [`critic`](..\u002F..\u002Fagents\u002Fcritic.md) agent — `subagent_type: \"sdlc:critic\"` (carries `model: opus` + `effort: high`, clean-isolated context per [`..\u002F_shared\u002Fagent-roster.md`](..\u002F_shared\u002Fagent-roster.md)) — with the write-prd delta in [`.\u002Freferences\u002Fcritic.md`](.\u002Freferences\u002Fcritic.md) (over [`..\u002F_shared\u002Fcritic.md`](..\u002F_shared\u002Fcritic.md)) — inline the draft + edits-log, it Reads `CONTEXT.md` + `idea-brief.md`. Resolve findings via `AskUserQuestion` (Accept revert \u002F Accept amendment \u002F Override-with-rationale → §1 ¶4 bullet). Run the forbidden-token regex scan as the F6 backstop. On pass, write `docs\u002Ffeatures\u002F\u003Cslug>\u002FPRD.md` (glossary already reconciled in-flow per step 3) and propose commit `03: PRD for \u003Cslug>`. **Register on the roadmap:** add\u002Fpromote this feature to **Now** in `docs\u002Froadmap.md` (via `\u002Fsdlc:roadmap`) — an outcome one-liner + a link to this feature folder + status; if it existed as a Next candidate, move it up. (If there's no roadmap yet, skip — it's optional.) Then **emit the stage-handoff block** per [`..\u002F_shared\u002Fhandoff.md`](..\u002F_shared\u002Fhandoff.md) — *What I did* + *Review* (`PRD.md`, `.size`) + *Run next* (`\u002Fclear`, then `\u002Fsdlc:clarify-prd \u003Cslug>`). (If `sdlc:critic` is unavailable, fall back to a `general-purpose` Agent with the same delta.)\n\n## Definition of Done\n\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002FPRD.md` written; all sections filled (or `\u003C!-- N\u002FA: reason -->`).\n- `docs\u002Ffeatures\u002F\u003Cslug>\u002F.size` exists after this stage (read if it was present, else classified + written here).\n- §5 holds ≥1 AC of each of the 5 coverage types after drops\u002FOQ-migrations, **every §4 user story has ≥1 AC** (the use-case floor — no retained US left with zero ACs), and **0 forbidden tokens** (HTTP verbs \u002F URL paths \u002F status-code numerics \u002F `module.error_name` strings \u002F JSON fragments \u002F SQL constructs).\n- §4 roles match the `CONTEXT.md` glossary exactly (no invented `user`\u002F`admin`).\n- §8 Open Questions each carry owner + due (no lone «TBD»).\n- Edits-log maintained; critic (`sdlc:critic`) ran on the post-Socratic draft; every finding resolved or overridden.\n\n## Anti-patterns\n\n- **Skipping the interview front** and reconstructing the idea from the model's guess. Capture + deep-dive must actually fire `AskUserQuestion`.\n- **Naming concrete technologies in §1–§3** (a specific datastore, broker, framework, or library). The PRD is WHAT + WHY; technology choices belong to `architecture-design`.\n- **Implementation leak in AC** — HTTP\u002Fstatus\u002Ferror-code\u002FSQL detail. That mapping lives in `api-forge` and `decide-adr`.\n- **Dispatching `general-purpose` instead of `sdlc:critic`** without first checking availability. The namespaced critic carries the correct model\u002Feffort and clean context; fall back only on confirmed unavailability.\n- **Treating brainstorm or initiatives artifacts as PRD inputs.** PRD draws only from CONTEXT + idea-brief (required) plus user-selected additional channels.\n- **Inventing role names or domain terms** not in CONTEXT glossary. The glossary is canonical; the PRD never introduces new role names.\n\n## References & template\n\n- [`..\u002F_shared\u002Finterview-depth.md`](..\u002F_shared\u002Finterview-depth.md) — the easy\u002Fmedium\u002Fhard dial set in step 1 (question volume, autonomy).\n- [`.\u002Freferences\u002Fdraft-generation.md`](.\u002Freferences\u002Fdraft-generation.md) — per-section sources, 5 AC coverage types, stack-agnostic forbidden tokens.\n- [`.\u002Freferences\u002Fsocratic-loop.md`](.\u002Freferences\u002Fsocratic-loop.md) — write-prd's delta over the shared Socratic loop (sections walked, use-case floor, decision-types).\n- [`.\u002Freferences\u002Fcritic.md`](.\u002Freferences\u002Fcritic.md) — write-prd's delta over the shared critic (F5 structural floor + F6 forbidden-token specialization).\n- [`.\u002Freferences\u002Fask-examples.md`](.\u002Freferences\u002Fask-examples.md) — explanatory `AskUserQuestion` shape for US \u002F AC \u002F NFR \u002F KPI + critic-finding examples (junior-friendly Ukrainian).\n- [`.\u002Freferences\u002Fchecklist.md`](.\u002Freferences\u002Fchecklist.md) — Definition of Done + full anti-patterns.\n- [`.\u002Ftemplates\u002FPRD-template.md`](.\u002Ftemplates\u002FPRD-template.md) — output scaffold; inline `\u003C!-- Skill instruction: ... -->` comments are the per-section generation contract.\n",{"name":5,"model":24,"stage":25,"agents":26,"effort":28,"triggers":29,"description":36},"opus","03",[27],"critic","high",[30,31,32,33,34,35],"\u002Fsdlc:write-prd","write PRD for","draft PRD for","PRD для","write spec for","product requirements for","Use to turn a raw feature idea into a reviewed PRD.md — a lightweight Socratic interview front (capture the idea, deep-dive the problem) merged with a full product spec (context, goals, user stories, acceptance criteria, NFRs, KPIs). Triggers on \"\u002Fsdlc:write-prd {slug}\", \"write PRD for {slug}\", \"draft PRD for {slug}\", \"PRD для {slug}\", \"write spec for {slug}\", \"product requirements for {slug}\", \"напиши PRD {slug}\", \"опиши вимоги\", \"зафіксуй ідею\". Opens by setting the interview-depth dial (easy\u002Fmedium\u002Fhard), drafts from templates\u002FPRD-template.md, validates each acceptance criterion Socratically, runs a clean-context critic (sdlc:critic), then writes docs\u002Ffeatures\u002F{slug}\u002FPRD.md. Hard refuse if idea-brief.md or CONTEXT.md missing.\n","main","2dc9bdfa5d508a04d414fb0991617e6722ec635a","modules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd",13,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public","https:\u002F\u002Ft.me\u002Fgenkovich","https:\u002F\u002Fgithub.com\u002Fgenkovich","https:\u002F\u002Ft.me\u002Fbeerphp","Beer::PHP 🍺 telegram-channel author \r\n","2026-11-12 03:03:13",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add genkovich\u002Fagentic-engineering-course-public --skill write-prd",{"tool":53,"command":54},"bunx","bunx skills add genkovich\u002Fagentic-engineering-course-public --skill write-prd",{"tool":56,"command":57},"pnpm","pnpm dlx skills add genkovich\u002Fagentic-engineering-course-public --skill write-prd","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002FSKILL.md",true,[61,67,71,75,79,83,87,91],{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fask-examples.md","REFERENCE","参考文档",14286,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fask-examples.md",{"path":68,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fchecklist.md",5148,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fchecklist.md",{"path":72,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fcritic-phase.md",439,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fcritic-phase.md",{"path":76,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fcritic-prompt.md",7526,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fcritic-prompt.md",{"path":80,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fcritic.md",5728,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fcritic.md",{"path":84,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fdraft-generation.md",6595,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fdraft-generation.md",{"path":88,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fsocratic-loop.md",5240,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Freferences\u002Fsocratic-loop.md",{"path":92,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":93,"sourceHtmlUrl":94},"templates\u002FPRD-template.md",9165,"https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F6-sdlc\u002Fsdlc\u002Fplugin\u002Fskills\u002Fwrite-prd\u002Ftemplates\u002FPRD-template.md",[96,103,110,117,124,131],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M72YGBW5JKECT8WSRHK1YBCJ","release","Run the whole local release pipeline in order, stopping at each human gate. Triggers on \"run the release\", \"prepare a release\", \"\u002Frelease\", \"зроби реліз\", \"підготуй реліз\". Drives the four stages back to back — bump-version → curate-changelog → release-notes → check-docs-drift — pausing after each so the human reviews the diff before the next stage. Prepares everything in the working tree; never tags, commits, or pushes. The tag push (which fires CI) stays the human's action.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Frelease\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M72YG87VQ89PRCYQSMNAP5RW","release-notes","Draft partner-facing release notes from the same commits as the changelog. Triggers on \"draft release notes\", \"release notes for the next version\", \"\u002Frelease-notes\", \"нотатки релізу\", \"release notes партнеру\". Same input as curate-changelog, different audience and tone: a short, benefit-first narrative for a user or partner — \"what's new for you\" — not a categorized engineer's list. Keeps only changes a user actually notices; drops internal refactors and tooling. Prints the notes to the chat to seed a GitHub Release description or a partner announcement. Writes no file.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Frelease-notes\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M72YG4BXJH9R6QQZD3G8E358","curate-changelog","Curate the [Unreleased] section of docs\u002FCHANGELOG.md from git history. Triggers on \"curate the changelog\", \"update the changelog\", \"\u002Fcurate-changelog\", \"онови changelog\", \"курування журналу\". Reads git log since the last tag, FILTERS out what a reader never feels (test\u002Fci\u002Fchore\u002Fmerge), GROUPS commits about one feature into one bullet, and REWRITES technical subjects into plain language under the six Keep a Changelog categories (Added\u002FChanged\u002FDeprecated\u002F Removed\u002FFixed\u002FSecurity). The result must have FEWER lines than the raw log — that is the proof of curation, not a dump. Leaves the edit in the working tree; never commits or pushes.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Fcurate-changelog\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M72YFZDKNXQ7WF9ARC5KQ4F5","codify-rule","Turn a repeated mistake into a durable, path-scoped rule in .claude\u002Frules\u002F. Triggers on \"codify this rule\", \"make a rule so this doesn't happen again\", \"\u002Fcodify-rule\", \"закодифікуй правило\", \"петля помилка-правило\". Use only when the same mistake showed up TWICE (twice = a pattern, once = noise). Names the wrong shape and the right shape with one short example of each, scopes the rule to the paths that matter, and leaves the edit in the working tree so the next agent on this repo inherits the fix. Edits only .claude\u002Frules\u002F; never commits or pushes.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Fcodify-rule\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":19},"01M72YFVKC19NCQDD30R1C282Q","check-docs-drift","Find and fix where docs\u002Fapi.md fell behind the code. Triggers on \"check for doc drift\", \"is the API doc up to date\", \"\u002Fcheck-docs-drift\", \"перевір дрейф документації\", \"docs drift\". Runs the deterministic scripts\u002Fcheck-docs-drift.py (parses the public NoteBook methods with ast, compares to what docs\u002Fapi.md documents — NO LLM finds the gap), reports the drift, and PROPOSES the doc edit that closes it. The gap is found by parsing; the agent writes the missing documentation in the doc's existing style. Edits only docs\u002F; never commits or pushes.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Fcheck-docs-drift\u002FSKILL.md",[],[],{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":137,"publishedAt":19},"01M72YFQSJ21QX4SQADQ1SQDZR","bump-version","Decide and apply the next semver for a release. Triggers on \"bump the version\", \"what version is next\", \"\u002Fbump-version\", \"простав версію\", \"яка наступна версія\". Reads the next number from the deterministic scripts\u002Fnext-version.sh (NEVER guesses it), explains in plain language WHICH part moved and why (e.g. \"MINOR, because a feat landed: filter notes by tag\"), edits the version line in pyproject.toml, and proposes the matching `git tag vX.Y.Z`. The number is decided by a rule; the agent explains and applies — the human confirms the tag. Never pushes a tag itself.","https:\u002F\u002Fgithub.com\u002Fgenkovich\u002Fagentic-engineering-course-public\u002Fblob\u002Fmain\u002Fmodules\u002F9-collaboration\u002F9.7-release-docs\u002F.claude\u002Fskills\u002Fbump-version\u002FSKILL.md",[],[]]