Forge

Quality forged in, not bolted on.

Forge is an autonomous quality engineering swarm skill for Claude Code that combines BDD behavioral verification, 7 quality gates, confidence-tiered learning, and self-healing fix loops. It spawns 8 specialized agents that work in parallel to verify, test, fix, and commit — continuously — until every Gherkin scenario passes and every quality gate clears.

---

Key Features

• 8 specialized agents working in parallel with cost-optimized model routing
• Gherkin behavioral specifications as the single source of truth
• 7 quality gates: Functional, Behavioral, Coverage, Security, Accessibility, Resilience, Contract
• Confidence-tiered fix patterns (Platinum/Gold/Silver/Bronze) that evolve over time
• Defect prediction based on historical failure data and file changes
• Chaos/resilience testing with controlled failure injection
• Cross-context dependency awareness with cascade re-testing
• Shared types and cross-cutting validation across bounded contexts
• Agent-optimized ADRs with MUST/MUST NOT constraints and verification commands
• Visual regression testing with pixel-by-pixel comparison
• Architecture-agnostic — monolith, microservices, monorepo, mobile+backend
• Optional Agentic QE integration for enhanced pattern search, security scanning, and more
• No mocking — all tests run against the real backend

---

Philosophy

Three Pillars

"DONE DONE"

"DONE DONE" means: the code compiles AND the product behaves as specified. Every Gherkin scenario passes. Every quality gate clears. Every dependency graph is satisfied.

---

Quick Start

# Copy SKILL.md to your Claude Code skills directory
cp SKILL.md ~/.claude/skills/forge.md

# Run on your project
/forge --autonomous --context payments

---

Invocation Modes

---

Architecture

Autonomous Loop

Specify → Test → Analyze → Fix → Audit → Gate → Commit → Learn → Repeat

┌────────────────────────────────────────────────────────────────────┐
│                    FORGE AUTONOMOUS LOOP                            │
├────────────────────────────────────────────────────────────────────┤
│                                                                    │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐      │
│  │ Specify  │──▶│   Test   │──▶│ Analyze  │──▶│   Fix    │      │
│  │ (Gherkin)│   │ (Run)    │   │ (Root    │   │ (Tiered) │      │
│  └──────────┘   └──────────┘   │  Cause)  │   └──────────┘      │
│       ▲                        └──────────┘        │              │
│       │                                            ▼              │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐      │
│  │  Learn   │◀──│  Commit  │◀──│  Gate    │◀──│  Audit   │      │
│  │ (Update  │   │ (Auto)   │   │ (7 Gates)│   │ (A11y)   │      │
│  │  Tiers)  │   └──────────┘   └──────────┘   └──────────┘      │
│  └──────────┘                                                     │
│       │                                                           │
│       └──────────────── REPEAT ──────────────────────────────────│
│                                                                    │
│  Loop continues until: ALL 7 GATES PASS or MAX_ITERATIONS (10)   │
└────────────────────────────────────────────────────────────────────┘

Execution Phases

1. Phase 0 — Backend setup (build, run, health check, seed data)
2. Phase 1 — Behavioral specification & architecture records (Gherkin specs, ADRs)
3. Phase 2 — Contract & dependency validation (schemas, shared types, cross-cutting)
4. Phase 3 — Swarm initialization (load patterns, predictions, confidence tiers)
5. Phase 4 — Spawn 8 autonomous agents in parallel
6. Phase 5 — Quality gates evaluation (7 gates after every fix cycle)

---

Quality Gates

---

Agent Roles

---

Configuration

Project Config (optional)

# forge.config.yaml — placed at repo root
architecture: microservices
backend:
  services:
    - name: auth-service
      port: 8081
      healthEndpoint: /health
      buildCommand: npm run build
      runCommand: npm start
frontend:
  technology: react
  testCommand: npx cypress run --spec {target}
  testDir: cypress/e2e/
  specDir: cypress/e2e/specs/

# Model routing overrides
model_routing:
  bug-fixer: opus
  failure-analyzer: sonnet
  test-runner: haiku

# Visual regression
visual_regression:
  enabled: true
  threshold: 0.001

# Agentic QE integration
integrations:
  agentic-qe:
    enabled: true
    domains: [defect-intelligence, security-compliance, visual-accessibility, contract-testing]

Context Config (optional)

# forge.contexts.yaml — bounded context definitions
contexts:
  - name: identity
    testFile: identity.cy.ts
    specFile: identity.feature
    paths: 68
    subdomains: [Auth, Profiles, Verification]
  - name: payments
    testFile: payments.cy.ts
    specFile: payments.feature
    paths: 89
    subdomains: [Wallet, Cards, Transactions]

dependencies:
  identity:
    blocks: [payments, orders]
  payments:
    depends_on: [identity]
    blocks: [orders, subscriptions]

If no configuration files are present, Forge auto-discovers the project structure on first run.

---

Agentic QE Integration

Forge optionally integrates with Agentic QE via MCP for enhanced capabilities:

All AQE features are additive. Forge works identically without AQE installed.

---

References

• Continuous Behavioral Verification: Ongoing Path to Done — Ikenna Okpala
• Build with Quality Skill: How I Build Software 10x Faster — Mondweep Chakravorty
• claude-code-v3-qe-skill — V3 QE Skill
• agentic-qe — Agentic QE Framework

---

License

MIT