# Create Rfc

> Create a new RFC (Request for Comments) technical specification

- Skill: `majiayu000/create-rfc` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/create-rfc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/create-rfc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/create-rfc

---


# create-rfc

**Category**: Technical Architecture

## Usage

```bash
/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

```bash
/create-rfc API Gateway Selection
```

Creates: `rfcs/draft/RFC-0001-api-gateway-selection.md`

```bash
/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