skills/fwehrling/forge/forge-quick-spec

forge-quick-spec

SKILL.md

/forge-quick-spec — FORGE Quick Track

Fast-track mode for bug fixes and small changes (<1 day). Skips the planning and architecture phases.

Workflow

  1. Load context (if FORGE project):

    • Read .forge/memory/MEMORY.md for project context (if exists)
    • forge-memory search "<change description>" --limit 3 (if available)
  2. Classify the request: Bug fix or small feature change?

Bug Fix Track

  1. Root cause analysis (in-memory, no artifact):

    • Reproduce: Steps to reproduce, expected vs. actual behavior
    • Identify cause: Pinpoint the root cause (not just the symptom)
    • Affected components: Frontend / Backend / Database / External services
    • Code location: File path, function/method, line range
  2. Impact & risk assessment:

    • Severity: Blocker / Major / Minor / Trivial
    • Affected users: Scope of impact
    • Side effects: What else could this fix break?
    • Rollback plan: How to revert if the fix causes regression
  3. Write regression tests first (TDD):

    • Test that reproduces the bug (must fail before fix)
    • Unit tests for the fix
    • Functional test covering the user flow
  4. Implement the fix

  5. Validate:

    • Regression test now passes
    • All pre-existing tests still pass (non-regression)
    • Lint + typecheck clean
    • Side effects verified
  6. Propose the commit (format: fix: <description>)

Small Change Track

  1. Analyze the request
  2. Generate a quick spec (in-memory, no artifact)
  3. Write tests (unit + functional for the change)
  4. Implement the change
  5. Validate (lint + typecheck + tests)
  6. Propose the commit

Save Memory

  1. Save memory (ensures fix context persists for avoiding repeated issues):

    forge-memory log "Quick-spec terminé : {DESCRIPTION}, {N} tests" --agent dev
    forge-memory consolidate --verbose
    forge-memory sync
    
  2. Report to user:

    FORGE Quick Track — Complete
    ──────────────────────────────
    Type      : Bug Fix | Small Change
    Change    : <description>
    Tests     : X unit + Y functional (all passing)
    Lint/Type : clean
    
    Commit proposed:
      fix: <description>
    
Weekly Installs
14
Repository
fwehrling/forge
GitHub Stars
1
First Seen
Feb 18, 2026
Installed on
opencode14
gemini-cli14
codebuddy14
github-copilot14
codex14
kimi-cli14