| name | create-rfc |
| description | Create a new RFC (Request for Comments) technical specification |
| argument-hint | <rfc-title> |
create-rfc
Category: Technical Architecture
Usage
/create-rfc <rfc-title>
Arguments
<rfc-title>: Required - Short descriptive title for the RFC (will be kebab-cased for filename)
Execution Instructions
When this command is run, Claude Code should:
-
Determine RFC Number
- Scan
rfcs/ directory (all subdirectories) for existing RFC files
- Find highest RFC number (RFC-XXXX pattern)
- Increment by 1 for new RFC
- If no RFCs exist, start with RFC-0001
-
Create Directory Structure (if not exists)
rfcs/
├── draft/
├── review/
├── approved/
│ └── in-progress/
├── completed/
└── archive/
-
Generate RFC File
- Convert title to kebab-case: "API Gateway Selection" → "api-gateway-selection"
- Create file:
rfcs/draft/RFC-XXXX-<kebab-title>.md
- Use template from skill references
-
Populate Metadata
- Set
rfc_id to new number
- Set
title from argument
- Set
status to DRAFT
- Set
created and last_updated to today's date
- Leave
author for user to fill
-
Confirm Creation
Created RFC-XXXX: <title>
Location: rfcs/draft/RFC-XXXX-<kebab-title>.md
Status: DRAFT
Next steps:
1. Fill in the Overview and Problem Statement sections
2. Define your Evaluation Criteria before analyzing options
3. Analyze at least 2 options objectively
4. When ready for review: /rfc-status RFC-XXXX --set REVIEW
Template Reference
Use the template from:
plugins/devops-data/skills/rfc-specification/references/rfc-template.md
Example Usage
/create-rfc API Gateway Selection
Creates: rfcs/draft/RFC-0001-api-gateway-selection.md
/create-rfc Database Migration Strategy
Creates: rfcs/draft/RFC-0002-database-migration-strategy.md
Validation
- Title must be provided (not empty)
- Title should be 2-6 words for clarity
- Warn if similar RFC already exists (fuzzy match on title)
Error Handling
- If
rfcs/ directory doesn't exist, create it with full structure
- If title is empty, prompt user for title
- If similar RFC exists, ask for confirmation before creating