create-rfc

Creates and reviews RFCs comparing alternatives before consequential technical decisions.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-rfc-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-rfc
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/create-rfc
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-rfc-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump straight from a specification to implementation without systematically comparing alternatives, leading to poorly justified architecture choices. This Skill structures the Request for Comments process so consequential technical or content-system decisions are documented, compared, and reviewed before an ADR or implementation begins. ## Core Features & Use Cases - Structured RFC Authoring: Guides creation of an RFC that links the source specification, restates the decision, and documents constraints and decision drivers. - Alternatives Comparison: Requires at least two viable alternatives plus the status quo, compared across architecture, delivery, cost, performance, security, operations, migration, rollback, teardown, and ownership. - Review and Acceptance Workflow: Separates reviewer feedback from author responses and marks the RFC accepted only after the accountable owner chooses a direction, then creates or updates the corresponding ADR. - Use Case: After writing a specification for a new data pipeline, use this Skill to draft an RFC comparing a streaming versus batch approach, collect review feedback, and hand off the accepted direction to an ADR. ## Quick Start Create an RFC for the decision described in my specification document, comparing at least two alternatives plus the status quo.

Frequently Asked Questions about create-rfc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an RFC for a technical decision?

Start by linking the source specification and restating the decision to be made, then document constraints and decision drivers. Present at least two viable alternatives plus the status quo and compare them across architecture, cost, performance, security, operations, migration, and ownership.

What is the difference between an RFC and an ADR?

An RFC compares alternatives and gathers review feedback before a decision is made, while an ADR records the final accepted decision. The RFC is not the final decision record; once the accountable owner chooses a direction, you create or update the corresponding ADR.

When should I create an RFC instead of going straight to an ADR?

Create an RFC when the decision is consequential and multiple viable alternatives exist that need structured comparison and review. It fits after discovery and specification but before implementation, giving reviewers a chance to challenge assumptions.

How many alternatives should an RFC compare?

An RFC should present at least two viable alternatives plus the status quo. Each option is compared across architecture, delivery, cost, performance, security, operations, migration, rollback, teardown, and ownership.

When is an RFC considered accepted?

An RFC is marked accepted only after the user or accountable owner chooses a direction. Review feedback is recorded separately from the author's responses, and acceptance triggers creation or update of the corresponding ADR.