git:20260331.dc8aba1 to git:20260401.c32a75d

12 added, 9 removed. Audit A to A.

# Forge

- Forge is a lightweight workflow layer for Claude Code that adds structured planning, validation, retry intelligence, and cross-session memory.

+ Forge is a lightweight workflow layer for Claude Code that adds structured planning, deep validation, retry intelligence, session resumability, and cross-session memory.

## Quick Start

```

/forge <objective>

```

- This triggers the full workflow: understand → plan → execute → validate → retry → learn.

+ This triggers the full workflow: understand → plan → validate plan → execute → validate → retry → learn.

## Skills

- `/forge <objective>` — Full workflow: plan, execute, validate, learn

- `/forge-validate <module-id>` — Validate a specific module

- `/forge-status` — Show current plan status and memory

## Agents

- - `planner` — Decomposes objectives into module DAGs

+ - `planner` — Decomposes objectives into module DAGs, validates plan structure

- `worker` — Executes a single module in a worktree

- - `reviewer` — Reviews completed modules for correctness

- - `debugger` — Root-cause analysis and fix for failed modules

+ - `reviewer` — Reviews completed modules for correctness, uses contract checks

+ - `debugger` — Root-cause analysis with structured log inspection

## MCP Tools

- The forge MCP server provides:

- - `validate` — Run verification commands with stagnation detection

+ The forge MCP server provides 7 tools:

+ - `validate` — Run verification commands with syntax checks, API contract verification, stagnation/velocity/oscillation detection

+ - `validate_plan` — Structural plan validation: DAG cycles, file overlaps, command existence, schema checks

- `memory_recall` — Search project/global memory

- `memory_save` — Save learned patterns

- `iteration_state` — Track retry attempts per module

+ - `forge_logs` — Query structured JSONL logs (filter by run, module, phase, severity)

+ - `session_state` — Save/load/list orchestrator state for session resumability

## Plugin Structure

This project is a Claude Code plugin. Install with `claude plugin add github:TT-Wang/forge`.

```

agents/ — Agent definitions (planner, worker, reviewer, debugger)

skills/ — Skill definitions (/forge, /forge-validate, /forge-status)

- forge-mcp-server/ — MCP server (validate, memory, iteration_state)

+ forge-mcp-server/ — MCP server (7 tools: validate, validate_plan, memory, iteration, logs, session)

.claude-plugin/ — Plugin manifest (plugin.json)

- .forge/ — Runtime data (plans, memory, iterations)

+ .forge/ — Runtime data (plans, memory, iterations, logs, state)

```