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:

1. 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

2. Create Directory Structure (if not exists)

   rfcs/
   ├── draft/
   ├── review/
   ├── approved/
   │   └── in-progress/
   ├── completed/
   └── archive/

3. 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

4. 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

5. 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