trw_prd_create
Generate an AARE-F compliant PRD with 12 standard sections, confidence scores, and traceability links from a feature description. Automatically updates catalogue and roadmap.
Instructions
Generate an AARE-F compliant PRD from a feature description.
Use when:
You have a feature request or requirements and need a structured PRD.
Before writing code for a P0/P1/P2 feature or risky behavioral change.
You want auto-incremented PRD ID, YAML frontmatter, and catalogue sync.
Produces 12 standard sections, confidence scores, and traceability links.
Updates INDEX.md/ROADMAP.md when index_auto_sync_on_status_change is on.
Input:
input_text: feature request or description (becomes Problem Statement + Background).
category: one of CORE, QUAL, INFRA, LOCAL, EXPLR, RESEARCH, FIX (plus any values added to
.trw/config.yaml::extra_prd_categories).priority: P0, P1, P2, or P3 — drives base confidence scores.
title: auto-generated from input_text when empty.
sequence: auto-increments from existing catalogue when default (1).
risk_level: optional critical|high|medium|low — scales validation strictness.
Output: PrdCreateResultDict with fields {prd_id: str, title: str, category: str, priority: str, output_path: str, content: str, sections_generated: int, index_synced: bool}.
Example: trw_prd_create(input_text="Add rate limiting to public API", category="CORE", priority="P1") → {"prd_id": "PRD-CORE-001", "output_path": "docs/requirements-aare-f/prds/PRD-CORE-001.md", "sections_generated": 12, "index_synced": true, ...}
See Also: trw_prd_validate
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| category | No | CORE | |
| priority | No | P1 | |
| sequence | No | ||
| input_text | Yes | ||
| risk_level | No |