rfclisted
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