rfc

Draft and manage structured RFCs with lifecycle states and ADR cross-linking.

1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/HeyItsGilbert/marketplace --skill rfc-heyitsgilbert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rfc
Source: https://github.com/HeyItsGilbert/marketplace/tree/main/plugins/architecture-decisions/skills/rfc
Command: npx skills add https://github.com/HeyItsGilbert/marketplace --skill rfc-heyitsgilbert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft and manage structured RFCs to capture proposals and open discussions before committing to significant technical decisions.

Core Features & Use Cases

  • RFC templates and lifecycle (draft, open, closed, withdrawn) to organize proposals.
  • Storage alongside ADRs in docs/decisions and cross-linking to ADRs for traceability.
  • Guidance on when to propose changes (significant decisions, migrations, architecture) and how to solicit team input.

Quick Start

Draft an RFC that outlines a proposed architectural change, including problem, proposed solution, alternatives, and open questions.

Frequently Asked Questions about rfc

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

FAQPage Schema
How do I draft an RFC for an architectural change proposal?

Draft an RFC for an architectural change by outlining the problem, proposed solution, alternatives, and open questions. This formal template captures proposals to solicit team input before committing to significant technical decisions.

What is the RFC lifecycle for managing technical proposals?

The RFC lifecycle for managing technical proposals includes draft, open, closed, and withdrawn states. These states organize proposals and track discussions from initial submission through final decision-making.

When do I need an RFC document for decision-making?

You need an RFC document when teams face multiple viable approaches, migrations, or architectural changes. It enforces formal proposal structures to secure stakeholder buy-in and open discussions before committing to significant technical decisions.

How do RFCs cross-link to ADRs for architecture documentation?

RFCs cross-link to ADRs by storing both under docs/decisions with RFC-{NNN} naming. This architecture documentation approach ensures traceability between open proposal discussions and finalized decision records.

What's the best way to structure a technical proposal for stakeholder review?

The best way to structure a technical proposal for stakeholder review is using a formal RFC template. It enforces sections for problem statements, proposed solutions, alternatives, and open questions to guide team decisions effectively.

Can I withdraw an RFC proposal after team discussion has started?

You can withdraw an RFC proposal after team discussion has started by moving it to the withdrawn lifecycle state. This formal action removes the proposal from active consideration within the decision-making process.