new-rfc

Solid

Use this skill when the user asks to propose, draft, or open an RFC, update the rules, amend the charter, change our principles, or change the convention for something; also use it for follow-on RFC artifacts after acceptance. Triggers on "RFC", "propose a change to...", "let's get input on...", "draft a proposal", "create the follow-on specs for RFC-NNNN", "generate ADRs for the accepted RFC", and "implement the follow-on work from an RFC". Do NOT use for a settled architectural decision (use `new-adr`, including a superseding ADR), or for a standalone settled feature spec (use `new-spec`).

AI & Automation 21 stars 5 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 81/100

Stars 20%
45
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Skill: new-rfc Draft an answer-first RFC in `docs/rfc/`: research and resolve the proposal before writing it, then give a reviewer a concise, decidable argument rather than an audit trail. Use the template for section-level drafting guidance. ## Output rendering <!-- agentbundle:output-rendering:start --> Lead with the useful outcome or next action. Use warm, non-blaming language and everyday words. Define an unfamiliar term in a few plain words before naming it; keep proper names and exact technical terms intact. During tool work, do not narrate routine calls. Send an update only for safety, a blocker, a needed decision, a material scope change, a long wait, or an active host requirement. When requesting input, ask only for what is needed now. Ask dependent questions one at a time; otherwise group related questions. Offer no more than three clear choices when choices help. Shape the answer to the facts: one fact needs one sentence; related facts use prose; separate items use bullets; real sequences use numbered steps. For prose artifacts, use descriptive headings, short resumable sections, one fact per sentence, and no repeated summary. Emphasize at most one load-bearing point per section. Group long inventories instead of truncating them. Make the result stand alone. Do needed arithmetic, give real dates or times, and say what a file or link establishes instead of making the reader inspect it. For code and comments, prefer obvious structure and names. Comment on intent...

Details

Author
eugenelim
Repository
eugenelim/agent-ready-repo
Created
4 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category