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 no diagram uploads. The browser editor is free and needs no install.

Get Gnomon Open the browser editor

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.