1---2name: docs-ai-prd-23description: Write PRDs, specs, and project context optimized for coding assistants (Claude Code, Cursor, Copilot, Custom GPTs). Includes CLAUDE.md generation, session planning, and templates for creating documentation that tools can execute effectively.4metadata:5 source: https://skillmd.com/skills/diegosouzapw/docs-ai-prd-26---78# PRDs & Project Context910Create product requirements and project context that humans and coding assistants can execute effectively.1112**Two capabilities:**131. **PRDs & Specs** - Requirements, specs, stories, acceptance criteria142. **Project Context** - Architecture, conventions, tribal knowledge (CLAUDE.md)1516**Modern Best Practices (Jan 2026)**: Context engineering (right info, right format, right time), decision-first docs, testable requirements with acceptance criteria, metrics with formula + timeframe + data source, cross-tool portability.1718## Workflow (Use This Order)19201. Pick the deliverable (PRD, AI PRD, tech spec, story map, CLAUDE.md).212. Gather inputs (problem evidence, users, constraints, dependencies, risks).223. Fill the template (write decisions first; keep requirements testable).234. Validate with checklists (requirements, edge cases, security/compliance as needed).245. Hand off with next actions (implementation plan, owners, open questions).2526## Quick Reference2728### PRDs & Specs2930| Task | Template |31|------|----------|32| PRD creation | [assets/prd/prd-template.md](assets/prd/prd-template.md) |33| Tech spec | [assets/spec/tech-spec-template.md](assets/spec/tech-spec-template.md) |34| Planning checklist | [assets/planning/planning-checklist.md](assets/planning/planning-checklist.md) |35| Story mapping | [assets/stories/story-mapping-template.md](assets/stories/story-mapping-template.md) |36| Gherkin/BDD | [assets/stories/gherkin-example-template.md](assets/stories/gherkin-example-template.md) |37| AI PRD | [assets/prd/ai-prd-template.md](assets/prd/ai-prd-template.md) |3839### Project Context (CLAUDE.md)4041| Context Type | Template | Priority |42|--------------|----------|----------|43| **Architecture** | [assets/architecture-context.md](assets/architecture-context.md) | Critical |44| **Conventions** | [assets/conventions-context.md](assets/conventions-context.md) | High |45| **Key Files** | [assets/key-files-context.md](assets/key-files-context.md) | Critical |46| **Minimal Start** | [assets/minimal-claudemd.md](assets/minimal-claudemd.md) | 5-min |47| **Cross-Tool** | [assets/cross-tool-context.md](assets/cross-tool-context.md) | Multi-tool |4849---5051## Decision Tree5253```text54User needs:55 ├─► AI-Assisted Coding?56 │ ├─ Non-trivial (>3 files)? → Planning checklist + agentic session57 │ └─ Simple (<3 files)? → Direct implementation58 │59 ├─► Project Onboarding?60 │ ├─ New to codebase? → Generate CLAUDE.md61 │ └─ Quick context? → Minimal CLAUDE.md62 │63 └─► Traditional PRD?64 ├─ Product requirements? → PRD template65 ├─ AI feature? → AI PRD template66 └─ Acceptance criteria? → Gherkin/BDD67```6869---7071## Cross-Tool Context Files7273| Tool | Location | Notes |74|------|----------|-------|75| Claude Code | `CLAUDE.md`, `.claude/` | Auto-loaded |76| Cursor | `.cursor/rules/` | Project rules |77| Copilot | `.github/copilot-instructions.md` | Workspace context |78| Generic | `AGENTS.md` | Tool-agnostic |7980---8182## CLAUDE.md / AGENTS.md Guidance8384- Start minimal: [assets/minimal-claudemd.md](assets/minimal-claudemd.md)85- Add only what’s needed: [assets/architecture-context.md](assets/architecture-context.md), [assets/conventions-context.md](assets/conventions-context.md), [assets/key-files-context.md](assets/key-files-context.md), [assets/dependencies-context.md](assets/dependencies-context.md), [assets/tribal-knowledge-context.md](assets/tribal-knowledge-context.md)86- Keep it executable: commands must run; include no secrets; prefer file paths over pasted code8788---8990## Do / Avoid9192### Do9394- Start with executive summary (decision, users, scope, success)95- Define acceptance criteria in testable language96- Keep requirements unambiguous (must/should/may)97- Link to supporting docs instead of pasting9899### Avoid100101- Vague requirements ("fast", "easy") without definitions102- Mixing draft notes and final requirements103- Metrics without measurement plan104- Docs with no owner or review cadence105- Dual-state wording that mixes live behavior, target behavior, and migration behavior in one statement106107---108109## LLM Ambiguity Gate (Required for planning docs)110111- Label every behavior as exactly one of: `Live now`, `Target`, or `Transition` (with owner + end condition).112- Label every metric as either `Reference signal` or `Release blocker`.113- Define one canonical feature-gating contract per feature; all other docs must link to it instead of restating variants.114- Keep assumptions/open questions separate from final decisions.115- If conflicts exist across docs, mark one canonical source and add follow-up tasks to resolve mirrors.116117---118119## Context Extraction120121Use:122- [references/architecture-extraction.md](references/architecture-extraction.md) for components/data flows123- [references/convention-mining.md](references/convention-mining.md) for naming/patterns124- [references/tribal-knowledge-recovery.md](references/tribal-knowledge-recovery.md) for git-history “why”125- [references/docs-audit-commands.md](references/docs-audit-commands.md) for audit commands and tool fallbacks126127---128129## Quality Checklist130131### PRD Quality132- [ ] Clear problem statement133- [ ] Measurable success criteria134- [ ] Unambiguous acceptance criteria135- [ ] Edge cases documented136- [ ] AI can execute without clarification137- [ ] Every behavior is labeled `Live now`, `Target`, or `Transition`138- [ ] Metrics are labeled `Reference signal` or `Release blocker`139- [ ] Each feature-gating rule has one canonical source (no conflicting duplicates)140141### CLAUDE.md Quality142- [ ] Architecture reflects actual structure143- [ ] Key files exist at listed locations144- [ ] Conventions match actual patterns145- [ ] Commands actually work146- [ ] No sensitive information147148---149150## Resources151152| Resource | Purpose |153|----------|---------|154| [references/agentic-coding-best-practices.md](references/agentic-coding-best-practices.md) | AI coding patterns |155| [references/requirements-checklists.md](references/requirements-checklists.md) | PRD validation |156| [references/traditional-prd-writing.md](references/traditional-prd-writing.md) | Classic PRD format |157| [references/architecture-extraction.md](references/architecture-extraction.md) | Mining architecture |158| [references/convention-mining.md](references/convention-mining.md) | Extracting conventions |159| [references/tribal-knowledge-recovery.md](references/tribal-knowledge-recovery.md) | Git history analysis |160| [references/docs-audit-commands.md](references/docs-audit-commands.md) | Audit shell commands |161| [references/stakeholder-alignment.md](references/stakeholder-alignment.md) | Stakeholder buy-in, RACI, conflict resolution |162| [references/acceptance-criteria-patterns.md](references/acceptance-criteria-patterns.md) | Testable ACs, BDD, edge case coverage |163| [references/prd-review-facilitation.md](references/prd-review-facilitation.md) | Running PRD reviews, feedback categorization |164| [data/sources.json](data/sources.json) | Curated external sources |165166## Templates167168| Category | Templates |169|----------|-----------|170| PRDs | prd-template, ai-prd-template, tech-spec-template |171| Planning | planning-checklist, agentic-session-template |172| Stories | story-mapping-template, gherkin-example-template |173| Context | architecture, conventions, key-files, minimal-claudemd |174| Stack-specific | nodejs-context, python-context, react-context, go-context |175176## Related Skills177178| Skill | Purpose |179|-------|---------|180| [docs-codebase](../docs-codebase/SKILL.md) | README, API docs, ADRs |181| [qa-docs-coverage](../qa-docs-coverage/SKILL.md) | Documentation gaps |182| [product-management](../product-management/SKILL.md) | Product strategy |183| [software-architecture-design](../software-architecture-design/SKILL.md) | System design |