rfc

Cross-runtime: follow runtime compatibility for invocation, delegation, configuration precedence, state paths, and permissions.

You are helping create a new RFC (Request for Comments) document. Your task is to generate a properly numbered RFC file from the template with pre-filled metadata.

Step 1: Parse Arguments

Extract the RFC title from $ARGUMENTS.

• If $ARGUMENTS is empty or not provided, use the active host user-input mechanism to prompt: "What is the title for this RFC? (e.g., 'add deploy command', 'config schema v2')"
• Validate the title contains only alphanumeric characters, spaces, and hyphens
• If invalid characters are found, strip them and confirm with the user

Step 2: Auto-Determine RFC Number

Scan for existing RFC files to determine the next number:

# Find existing RFCs and determine next number
latest=$(ls docs/rfcs/rfc-*.md 2>/dev/null | sort -V | tail -1)
if [ -n "$latest" ]; then
  current=$(basename "$latest" | sed 's/rfc-\([0-9]*\)-.*/\1/')
  next=$((10#$current + 1))
else
  next=1
fi
printf -v rfc_num "%03d" $next

Logic:

• If no existing RFCs found, start at 001
• If existing RFCs found, extract the highest NNN from rfc-NNN-*.md and increment by 1
• Zero-pad to 3 digits (001, 002, ..., 999)

Step 3: Generate Filename

Convert the title to a kebab-case filename:

• Convert to lowercase
• Replace spaces with hyphens
• Remove special characters (keep alphanumeric and hyphens)
• Collapse multiple hyphens into one
• Trim leading/trailing hyphens

kebab_title=$(echo "$title" \
  | tr '[:upper:]' '[:lower:]' \
  | sed 's/[^a-z0-9 -]//g' \
  | tr ' ' '-' \
  | sed 's/-\{2,\}/-/g; s/^-//; s/-$//')

Result: rfc-${rfc_num}-${kebab_title}.md

Examples:

• "Add Deploy Command" -> rfc-001-add-deploy-command.md
• "Config Schema v2" -> rfc-002-config-schema-v2.md

Step 4: Create Directory

Immediately before creating anything, show the RFC number, title, author, and final file path. Ask for explicit confirmation to create the directory and RFC file. Do not treat automatic skill invocation or title confirmation as approval for the write.