doc-rfc

Generate structured RFC documents from predefined templates with versioning.

7|3|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/eriklieben/agentic-dev-workflow --skill doc-rfc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-rfc
Source: https://github.com/eriklieben/agentic-dev-workflow/tree/main/.claude/skills/doc-rfc
Command: npx skills add https://github.com/eriklieben/agentic-dev-workflow --skill doc-rfc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the lack of consistency and structure in technical decision-making by providing a standardized template and workflow for drafting Request for Comments (RFC) documents.

Core Features & Use Cases

  • Template-Driven Generation: Automatically populates RFCs with required sections like Motivation, Detailed Design, and Alternatives.
  • Path Resolution: Intelligently detects project structure to ensure documentation is saved in the correct repository or folder.
  • Use Case: When a developer needs to propose a new architectural change or a significant feature, this skill ensures the proposal is well-reasoned, critical of its own drawbacks, and ready for team review.

Quick Start

Ask the agent to write an RFC for the new authentication service proposal to initiate the document generation process.

Frequently Asked Questions about doc-rfc

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

FAQPage Schema
How do I write a technical RFC for a new architecture proposal?

An RFC standardizes technical decision-making by providing a structured template requiring Motivation, Detailed Design, and Alternatives sections. This ensures architecture proposals are well-reasoned and critically evaluated before team review.

What should be included in a Request for Comments document for software design?

A Request for Comments document should include Motivation, Detailed Design, Alternatives, and drawback analysis. Including these sections ensures comprehensive technical decision-making and critical evaluation of proposed software changes.

How do I organize technical proposal documents in a project repository?

Organize technical proposals using path resolution to detect project structure and save RFCs in the correct documentation repository. The system auto-increments document versions to maintain historical tracking.

Can I automate versioning for RFC documents in a documentation repository?

Yes, RFC versioning is automated by resolving paths within project-specific documentation repositories and auto-incrementing document versions. This maintains a consistent version history for all technical proposals.

When do I need to draft an RFC instead of a standard feature specification?

Draft an RFC when proposing architectural changes or significant features requiring structured technical decision-making. Unlike standard specs, RFCs enforce drawback analysis and alternatives evaluation to justify design choices.