# Building Product Specifications

> Creates and amends product specification markdown — PRD, FRD, TRD, user story, and UI specs (flow, screen structure, view states) — with consistent layout and frontmatter. Use when the user asks to draft or amend prd.md, frd.md, trd.md, user-story.md, or ui-specs.md at product or feature level — no code implementation.

- Skill: `cedmandocdoc/building-product-specifications` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add cedmandocdoc/building-product-specifications`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cedmandocdoc/building-product-specifications/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: cedmandocdoc (https://skillmd.com/u/cedmandocdoc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cedmandocdoc/building-product-specifications

---


# Building Product Specifications

## Overview

Writes pre-implementation product specs on disk: product vision (PRD), feature behavior (FRD), technical design (TRD), user journeys, and UI specs (navigation flow, screen structure, view states). Recipes own doc-type rules; [spec-contract.md](references/spec-contract.md) is shared plumbing. Works wherever the agent can read and write repository files.

## Agent workflow

Follow this skill when creating or amending product specification markdown. Stop without application code unless the user explicitly asks in the same message.

**Docs root:** Locate via `<docs-root>/index.md` with the static **Author signature** UUID. If none exists, ask the user for an empty folder path, then initialize. See [spec-contract.md](references/spec-contract.md) → **Resolve docs root**.

Match one **Recipes** row; open exactly that reference. Each create recipe also covers amend when the target file already exists.

### Recipes

| Intent | Example phrasing | Read |
| --- | --- | --- |
| PRD | "Draft a PRD", "Update the product requirements" | [creating-prd.md](references/creating-prd.md) |
| FRD | "Write an FRD for checkout", "Amend the checkout FRD" | [creating-frd.md](references/creating-frd.md) |
| User story | "User stories for checkout", "Product user journeys" | [creating-user-story.md](references/creating-user-story.md) |
| TRD | "Technical design for checkout", "System architecture TRD" | [creating-trd.md](references/creating-trd.md) |
| UI specs | "UI specs for checkout", "Screen flow and structure", "View states for checkout" | [creating-ui-specs.md](references/creating-ui-specs.md) |

## Reference index

### Contract

[spec-contract.md](references/spec-contract.md) — resolve root, layout, frontmatter, tiers, hub sync, create-or-amend.

| Doc | When to use |
| --- | --- |
| [spec-contract.md](references/spec-contract.md) | Docs root marker, paths, frontmatter, tiers, hub sync, create-or-amend |
| [creating-prd.md](references/creating-prd.md) | New or amend `prd.md` |
| [creating-frd.md](references/creating-frd.md) | New or amend `features/<slug>/frd.md` |
| [creating-user-story.md](references/creating-user-story.md) | New or amend product or feature `user-story.md` |
| [creating-trd.md](references/creating-trd.md) | New or amend product or feature `trd.md` |
| [creating-ui-specs.md](references/creating-ui-specs.md) | New or amend product or feature `ui-specs.md` (flow, structure, view states) |

## Templates

- [`assets/index.md`](assets/index.md)
- [`assets/prd.md`](assets/prd.md)
- [`assets/frd.md`](assets/frd.md)
- [`assets/trd.md`](assets/trd.md)
- [`assets/user-story.md`](assets/user-story.md)
- [`assets/ui-specs.md`](assets/ui-specs.md)