Overview
Skill collection for pre-implementation product specs on disk. Works in any environment where the agent can read and write repository files.
Contract: references/spec-contract.md — layout, naming, frontmatter, inheritance, tiers.
Agent workflow
Follow this skill when creating, updating, or reviewing product specification markdown: PRD, FRD, TRD, user story, or UI specs — at product level (<docs-root>/) or feature level (<docs-root>/features/<slug>/). Stop without application code unless the user explicitly asks in the same message.
Docs root: Located only via <docs-root>/index.md with the static Author signature UUID in frontmatter. If none exists, ask the user for an empty folder path, then initialize with index.md before any spec. See spec-contract.md → Resolve docs root.
Match one Recipes cell; open exactly that reference.
Recipes
| Doc | Create | Update | Review |
|---|---|---|---|
| PRD | creating-prd.md | updating-prd.md | reviewing-prd.md |
| FRD | creating-frd.md | updating-frd.md | reviewing-frd.md |
| TRD | creating-trd.md | updating-trd.md | reviewing-trd.md |
| User story | creating-user-story.md | updating-user-story.md | reviewing-user-story.md |
| UI specs | creating-ui-specs.md | updating-ui-specs.md | reviewing-ui-specs.md |
Path resolution: Product companions (<docs-root>/trd-web.md, …) and feature companions (<docs-root>/features/<slug>/trd-api.md, …) use the same recipe; <docs-root> comes from spec-contract.md → Finding docs root.
Reference index
Contract
spec-contract.md — layout, frontmatter, resolve rules.
| Doc | When to use |
|---|---|
| spec-contract.md | Docs root index.md marker, author UUID, paths, naming, frontmatter, inheritance, tiers |
| creating-prd.md | New prd.md |
| updating-prd.md | Amend prd.md; sync feature index |
| reviewing-prd.md | Read-only PRD review |
| creating-frd.md | New features/<slug>/frd.md hub |
| updating-frd.md | Amend FRD; sync related and PRD index |
| reviewing-frd.md | Read-only FRD review |
| creating-trd.md | New product or feature TRD (trd.md, trd-<app>.md) |
| updating-trd.md | Amend TRD; flag downstream drift |
| reviewing-trd.md | Read-only TRD review |
| creating-user-story.md | New product or feature user story |
| updating-user-story.md | Amend user story |
| reviewing-user-story.md | Read-only user story review |
| creating-ui-specs.md | New product or feature UI specs |
| updating-ui-specs.md | Amend UI specs |
| reviewing-ui-specs.md | Read-only UI specs review |