RFC: Example RFC
A minimal, lint-passing RFC that mirrors the example PRD/test pair. It shows how §1.A traceability wires every PRD story + composite AC id to a design element and a test spec. Replace it with real content (or delete it) when you start authoring. The
rfc-starterskill produces RFCs in the full §1–§7 shape; this example keeps only what the linter checks (frontmatter + cross-refs) plus the traceability matrix so the chain is obvious. See.claude/reference/frontmatter-contract.md.
Metadata
| Field | Value | Notes |
|---|---|---|
| Status | IDEA | Working vocabulary IDEA/RFC/AGREED/ABANDON; the YAML status: above uses the linter enum (IDEA→draft). |
| Owner | TBD | Mirrors frontmatter dri. |
| Source PRD | ../prds/example-prd.md | Mirrors frontmatter related. |
| Type | full-stack | Drives which §2/§3 details apply. |
1. Overview
What this RFC builds and why now: the technical design that satisfies the example PRD's
acceptance criteria. Link the driving PRD: ../prds/example-prd.md.
Detail 1.A — PRD Traceability Matrix
Every story the PRD defines maps to a design element here. The AC ids below are the
composite ids minted by the example PRD's horizontal Section-8 story table
(<STORY-ID>/AC-n).
| PRD Story | Composite AC ids | Design element (this RFC) | Test spec ref |
|---|---|---|---|
EXMPL-S01 — Lint-passing example | EXMPL-S01/AC-1, EXMPL-S01/AC-2, EXMPL-S01/ERR-1 | §2.1 — the linted doc layout | ../tests/example-test.md |
EXMPL-S02 — Traceable to a test | EXMPL-S02/AC-1 | §2.2 — the E2E traceability wiring | ../tests/example-test.md |
2. Technical Design
Detail 2.1 — Doc layout
The initiative ships prds/, rfcs/, and tests/. The linter enforces frontmatter +
the PRD body gate; the example PRD passes both (covers EXMPL-S01/AC-1, EXMPL-S01/AC-2,
EXMPL-S01/ERR-1).
Detail 2.2 — Traceability wiring
Each composite AC id is referenced by the example test spec's covers_acceptance_criteria,
so the E2E runner reports zero dangling refs and zero uncovered criteria (covers
EXMPL-S02/AC-1).
7. Ready for Agent Execution
- Every PRD story + composite AC id is traced in §1.A
- Test plan references the example test spec