Skip to content
Projects

claude-code · plugin · TDD loop

Forge Master

Claude Code plugin that turns an approved PRD into an autonomous TDD execution loop: tier-tagged phase plans, deterministic escalation rules, and disk-backed state that survives context compaction.

https://github.com/alanvaa06/forge-master

Overview

Forge Master is a Claude Code plugin for agentic loop-engineering: it turns an approved PRD into autonomous, verified, self-correcting execution. A PRD's acceptance criteria are decomposed into phases, each tagged by tier (junior/senior) and process (light/heavy), then executed until every phase is done or cleanly blocked. Verification is always the test runner's exit code, never agent opinion, and state flushes to disk after every phase so a run survives a crash or context compaction.

What it does

  • PRD design (interview) or import from an existing spec/Jira/Notion export, with testable Given/When/Then acceptance criteria.
  • plan-design decomposes the PRD into phases tagged by tier (junior/senior) and process (light/heavy), each mapped to the ACs it covers.
  • forge-run executes phase by phase; "green" is always the test runner's exit code, never agent opinion.
  • Escalation is deterministic — junior→senior, light→heavy — triggered by observed signals (red iterations, stuck subagent, exhausted budget), never a triage agent.
  • State (todo, results, lessons, memory) flushes to disk after every phase, so a run resumes cleanly across crashes or context compaction.
  • Heavy phases enforce TDD's Iron Law (test first, must fail, minimal implementation, green) plus an independent code-review contract.
  • Ends with a Definition-of-Done report: done/blocked/pending phases, token spend, escalations, and lessons learned.

Stack

JavaScript · Claude Code plugin system.

Status

Open source (MIT). Installable via the Claude Code plugin marketplace.

GitHub →