RFC
Request for Comments
For proposing a change and inviting disagreement before building.
- Format.md
- Length50 lines
- Includesnone
The source
50 lines of Markdown, with nothing to install. Copy it, or open the template inside Gnomon and render it as it is.
# RFC: <Title>
- **Author:** <name>
- **Status:** Draft | In Review | Accepted | Rejected | Withdrawn
- **Created:** YYYY-MM-DD
- **Last updated:** YYYY-MM-DD
- **Reviewers:** <names>
## Problem
What problem are we solving and for whom? Why now? What happens if we do nothing?
## Proposal
The recommended approach in 3–5 sentences. The reader should be able to stop here
and know what we're going to do.
## Options & Trade-offs
### Option 1 — <name> (recommended)
- **Summary:**
- **Pros:**
- **Cons:**
- **Cost / effort:**
### Option 2 — <name>
- **Summary:**
- **Pros:**
- **Cons:**
- **Cost / effort:**
### Option 3 — Do nothing
- **Pros:**
- **Cons:**
## Open Questions
- [ ] …
- [ ] …
## Decision Log
| Date | Decision | By |
|------------|-----------------------------------|------------|
| YYYY-MM-DD | Initial draft circulated | <name> |
| YYYY-MM-DD | Option 1 selected after review | <name> |
## References
- Linked tickets, prior RFCs, external docs.Render this offline
This template ships in Gnomon and renders on your machine, with no account and nothing sent to a server. The browser editor is free and needs no install.
Others in Architecture document templates
- ADR — Architecture Decision RecordContext, decision, consequences. The alternatives section is the valuable one.
- HLD — High-Level DesignHigh-level design: the shape, the constraints, the risks.
- Tech Spec / LLDLow-level design. What an implementer needs that the HLD does not say.
- NFR CatalogueThe requirements that get discovered late and expensively.
- RunbookWhat to do at 3am. Written for someone tired and unfamiliar.
- Discovery / Spike ReportFindings from a time-boxed investigation, including the dead ends.
- Post-Mortem / Incident ReviewBlameless incident review. Timeline first, conclusions second.
- Solution One-PagerA solution summary for people who will not read the HLD.