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