Quick Fix Workflow¶

Purpose: Rapid implementation of straightforward changes

When to use: - Simple changes (1-2 files, obvious solution) - Low risk (non-critical systems, reversible) - Well-known patterns (done many times before) - Time-critical (production hotfix)

Token budget: 20-40k tokens (single session)

Workflow Phases¶

Text Only

Phase 1: Orient & Implement (15-30% context)
   ↓
Phase 2: Validate & Commit (5-10% context)

Key principle: Skip research/planning for simple changes

Phase 1: Orient & Implement¶

Commands:

Bash

Read CLAUDE.md-simple                     # Quick orientation
# Describe simple change
# Agent implements directly

What happens: 1. Load constitutional foundation (2k tokens) 2. Understand change request 3. Make change immediately 4. Validate inline

Examples of quick fixes: - Fix typo in documentation - Update dependency version - Add environment variable - Adjust configuration value - Fix linting error

Token budget: 15-30k tokens

Phase 2: Validate & Commit¶

Commands:

Bash

/vibe --quick recent              # Fast inline check
# Commit with message

What happens: 1. Run quick validation (syntax, build, unit tests) 2. If pass: Commit with context 3. If fail: Fix and retry

Token budget: 5-10k tokens

When to Use vs Complete Cycle¶

Use Quick Fix when:¶

✅ Single file or small change ✅ Solution is obvious ✅ Risk is low ✅ Time is limited

Use Complete Cycle when:¶

❌ Multiple files with dependencies ❌ Solution is unclear ❌ Risk is high (critical system, production) ❌ Pattern should be extracted (learning opportunity)

Example: Fix Typo¶

Bash

Read CLAUDE.md-simple
# User: "Fix typo in README.md line 45, 'recieve' → 'receive'"

# Agent:
# ✅ Reads README.md
# ✅ Edits line 45
# ✅ Validates markdown syntax
# ✅ Commits: "docs(readme): Fix typo - recieve → receive"

# Total time: 2 minutes
# Token budget: 5k tokens

Example: Update Dependency¶

Bash

Read CLAUDE.md-simple
# User: "Update golang-jwt/jwt from v4.5.0 to v4.5.1"

# Agent:
# ✅ Edits go.mod:12
# ✅ Runs: go mod tidy
# ✅ Runs: go test ./...
# ✅ Commits: "chore(deps): Update golang-jwt/jwt to v4.5.1"

# Total time: 5 minutes
# Token budget: 10k tokens

Example: Add Environment Variable¶

Bash

Read CLAUDE.md-simple
# User: "Add LOG_LEVEL=info to config/app.yaml"

# Agent:
# ✅ Edits config/app.yaml:8
# ✅ Validates YAML syntax
# ✅ Verifies app reads LOG_LEVEL
# ✅ Commits: "feat(config): Add LOG_LEVEL environment variable"

# Total time: 8 minutes
# Token budget: 12k tokens

Start quick fix with: Read CLAUDE.md-simple → describe simple change