create-rfd

Create and manage Requests for Discussion documents with structured lifecycle states.

7|1|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/ar4mirez/samuel --skill create-rfd-ar4mirez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-rfd
Source: https://github.com/ar4mirez/samuel/tree/main/template/.claude/skills/create-rfd
Command: npx skills add https://github.com/ar4mirez/samuel --skill create-rfd-ar4mirez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation and management of Requests for Discussion (RFDs), providing a structured process for exploring technical options, building consensus, and documenting design rationale before implementation.

Core Features & Use Cases

  • Structured RFD Creation: Generates RFD documents with predefined sections for problem statements, options, proposals, and considerations.
  • Lifecycle Management: Guides RFDs through states like Ideation, Discussion, Published, and Committed, with clear transition rules.
  • Use Case: When proposing a new architectural approach, use this Skill to create an RFD that outlines the problem, evaluates alternatives (e.g., microservices vs. monolith), documents the chosen path, and captures the rationale for future reference.

Quick Start

Use the create-rfd skill to start a new RFD about choosing a caching strategy.

Frequently Asked Questions about create-rfd

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

FAQPage Schema
How do I document technical decisions and architecture proposals for my team?

Document technical decisions by creating a Request for Discussion (RFD) that structures problem statements, evaluates architectural options, and preserves design rationale. RFDs guide proposals through defined lifecycle states like Ideation, Discussion, Published, and Committed for clear team tracking.

What is the best way to build consensus before implementing a new architectural approach?

Building consensus before implementation is best achieved through an RFD process that structures technical exploration and captures considerations. By managing RFD states from Ideation to Committed, teams collaboratively evaluate alternatives and formalize agreement before development begins.

How do I structure a technical proposal to compare options like microservices versus a monolith?

Structure a technical proposal using predefined RFD sections for problem statements, options, and considerations. This format systematically documents the evaluation of alternatives, such as comparing microservices to a monolith, ensuring the chosen architectural path and rationale are preserved for future reference.

When do I need a formal process for technical decision making and rationale preservation?

You need a formal technical decision making process when proposing new architectural approaches that require structured exploration and team alignment. Using RFDs ensures design rationale and consensus building steps are documented through a managed lifecycle, preventing future context loss.

Can I use an RFD to track the lifecycle of a caching strategy proposal from discussion to commitment?

Yes, you can use an RFD to track a caching strategy proposal through clear lifecycle transition rules. The process manages RFD states from initial Ideation and Discussion to Published and Committed, maintaining an index for ongoing discovery and tracking of the technical decision.

Does managing RFDs require specific dependencies or external tools to maintain the index?

Managing RFDs and their discovery index requires no external dependencies or tools. The process operates independently using scripts and references to handle file locations, lifecycle state transitions, and the structured documentation needed for technical proposals.