rfc

You are the RFC command. Manage cross-team technical decisions via a structured Request for Comments process.

Setup

source .great_cto/env.sh 2>/dev/null || export PATH="/opt/homebrew/bin:$HOME/.local/bin:/usr/local/bin:$PATH"

TEAM_SIZE_RAW=$(grep "^team-size:" .great_cto/PROJECT.md 2>/dev/null | awk '{print $2}')
# Validate: must be a plain positive integer. Anything else → treat as 1 (single dev).
if [[ "$TEAM_SIZE_RAW" =~ ^[0-9]+$ ]]; then
  TEAM_SIZE="$TEAM_SIZE_RAW"
else
  [ -n "$TEAM_SIZE_RAW" ] && echo "WARN: team-size='$TEAM_SIZE_RAW' is not a positive integer — treating as 1."
  TEAM_SIZE=1
fi
if [ "$TEAM_SIZE" -lt 10 ]; then
  echo "RFC process is for teams of 10+. Your team: $TEAM_SIZE."
  echo "For smaller teams, discuss decisions in chat and record them as ADRs directly."
  echo "To use RFC anyway: set 'team-size: 10' in .great_cto/PROJECT.md"
  exit 0
fi

RFC_DIR="docs/rfcs"
INDEX_FILE="$RFC_DIR/RFC-INDEX.md"
ACTION="${1:-list}"
mkdir -p "$RFC_DIR"

---

Action: new "title" — create a new RFC

TITLE="$2"
# Get next RFC number
LAST_NUM=$(ls "$RFC_DIR"/RFC-*.md 2>/dev/null | grep -oE 'RFC-[0-9]+' | grep -oE '[0-9]+' | sort -n | tail -1 || echo "0")
NUM=$(printf "%03d" $((LAST_NUM + 1)))
SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-' | cut -c1-40)
RFC_FILE="$RFC_DIR/RFC-${NUM}-${SLUG}.md"
AUTHOR=$(git config user.name 2>/dev/null || echo "unknown")
DATE=$(date +%Y-%m-%d)
DEADLINE=$(python3 -c "from datetime import date, timedelta; d=date.today(); days=0; count=0
while count<5:
  d+=timedelta(1)
  if d.weekday()<5: count+=1
print(d.isoformat())" 2>/dev/null || date -v+7d +%Y-%m-%d 2>/dev/null || date +%Y-%m-%d)

Write $RFC_FILE:

# RFC-<NUM>: <title>

Status: DRAFT
Author: <author>
Created: <date>
Review deadline: <5 business days from today>
Teams affected: []
Related ADR: —
Supersedes: —   # optional: comma list of ADRs this RFC replaces, e.g. ADR-003, ADR-007

---

## Problem

> What problem are we solving? Who is affected? What happens if we don't solve it?

[Fill in]

## Proposal

> The specific change or decision being proposed.

[Fill in]

## Alternatives considered

> At least 2 alternatives you evaluated and why they were rejected.

1. **Do nothing**: [reason rejected]
2. **[Alternative B]**: [reason rejected]

## Impact

**Breaking changes:** [yes/no — describe if yes]
**Migration path:** [if breaking — how teams migrate]
**Teams affected:** [list teams who need to act or adjust]
**Cost:** [infra cost delta, if any]
**Timeline:** [estimate]

## Open questions

- [ ] Q1: [question that needs resolution before this can be accepted]
- [ ] Q2:

## Comments

> Add comments with: /rfc comment <id> "text"

---

## Decision

> Filled in by: /rfc close <id> accept|reject

Status: DRAFT
Decision: —
Decided by: —
Date: —
Reason: —
ADR created: —