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.

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: 319kUpdated 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: 196kUpdated 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: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall