Skip to content

openmove/engineering-design-playbook / .agents/skills/design-docs-template/new-rfc

docs-template-new-rfc

Verified

Scaffolds the next numbered RFC from the repo's RFC template, updates the RFC index, and leaves a Draft ready to write. Use when a change has real trade-offs and needs a proposal before code. Invoked via design-docs-template.

FileKindSize
SKILL.mdskill md2.1 KB
---
name: docs-template-new-rfc
description: >-
  Scaffolds the next numbered RFC from the repo's RFC template, updates the RFC
  index, and leaves a Draft ready to write. Use when a change has real
  trade-offs and needs a proposal before code. Invoked via design-docs-template.
---

# new-rfc — scaffold a proposal

**What:** Next `docs/rfc/NNNN-slug.md` from the project template + index row.  
**When:** Non-obvious design, alternatives matter, you want review before build.  
**Not:** Recording a settled decision (that is **new-adr**) or cleaning an existing draft (**rfc-hygiene**).

## Process

### 1. Locate templates

In the current docs repo (not the upstream template unless this *is* that repo):

- Prefer `docs/rfc/0000-template.md` (or the README’s named template)
- Read `docs/rfc/README.md` for numbering and index conventions

If no RFC folder exists, stop and suggest **bootstrap** (or confirm creating `docs/rfc/` from the upstream template).

### 2. Collect inputs

Ask what is missing:

- **Title** (human) and **slug** (kebab-case filename fragment)
- **Full vs mini** — mini = Summary, Motivation, Proposed design, Unresolved questions only (per README)
- **Related ADR/RFC ids** if known (optional)

### 3. Pick NNNN

List existing `docs/rfc/[0-9]*.md`, ignore `0000-*` templates. Next id = max+1, zero-padded to 4 digits, starting at `0001` if none.

### 4. Write the file

- Copy the template to `docs/rfc/NNNN-<slug>.md`
- Set title, id, status `Draft` (or the repo’s equivalent)
- For mini: delete sections the README says to drop
- Do **not** invent the design body; leave template headings for the author

### 5. Index

Add a row to the RFC index in `docs/rfc/README.md` (and any root docs index that lists RFCs).

### 6. Hand off

Report path, id, status, and that the body is still empty on purpose. Offer **rfc-hygiene** only after they have iterated.

## Hard rules

- Never overwrite an existing `NNNN-*` without explicit confirm.
- Do not fill Motivation/Design with guessed product content.
- One RFC = one change proposal; split if they describe two unrelated changes.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall