← ClaudeAtlas

rfclisted

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.
AlemTuzlak/skills · ★ 39 · AI & Automation · score 74
Install: claude install-skill AlemTuzlak/skills
# RFC Writer Help the user write an RFC that survives review. An RFC is a **forcing function for clarity**, not documentation written after the fact. Its value is the thinking it forces: honest goals, real alternatives, named risks, and a concrete design. A pretty document with hand-waved alternatives and vague goals is worthless. This skill exists to prevent that. This skill is **interactive by design**. It interviews the user to surface the thinking, grounds every claim in the real codebase, and shows the user working code for the design before writing a word of prose. It never fabricates the hard sections. ## Principles - **The thinking is the product.** The document is a byproduct. If a section can't be filled honestly (no real alternative exists, no risk is known), say so explicitly rather than inventing filler. - **Ground every claim.** In a repo, back statements about the current system with file references. Never assert how the code works without having read it. - **Show, don't tell.** The design is communicated as a worked API / code example the user picked from real options, not as prose. This is non-negotiable (see Phase 3). - **Rejected options are not waste.** The approaches the user didn't pick become the "Alternatives considered" section, complete with their code. That's why alternatives are real here and not strawmen. - **Ask only what's unanswered.** If the user's request, a linked ticket, or the code already answers a dimension, don't re-ask it. Confirm