TraceForge

AI-First Development Process Engine — automates requirements tracing, quality verification, and session recovery.

Install

npm install -g traceforge

Or run directly with npx:

npx traceforge init .

CLI Commands

| Command | Description | |---------|-------------| | traceforge init [dir] | Initialize project + provision skills | | traceforge analyze [dir] | Analyze design docs → run SSOT pipeline | | traceforge plan [dir] | Topological sort block_map → generate sprint plan | | traceforge implement <blockId> [dir] | Generate code from SSOT block | | traceforge resume [dir] | Project status summary + next action | | traceforge report [dir] | Full project progress report | | traceforge gate [blockId] | Block quality verification (4-layer Gate) | | traceforge trace <subcommand> | Traceability queries (build/query/coverage/impact/missing) | | traceforge mcp-setup [dir] | Register MCP server in Claude Desktop/Code |

Options

traceforge --format json    # JSON output (default)
traceforge --format pretty  # Table output
traceforge --output file    # Save output to file

MCP Server

Provides 13 tools to Claude Desktop/Code: init, report, gate, gate_all, resume, resume_refresh, resume_inject, plan, trace_build, trace_query, trace_coverage, trace_impact, trace_missing

Claude Desktop Setup

# Automatic setup
traceforge mcp-setup --global

# Or manual setup (~/.config/Claude/claude_desktop_config.json)
{
  "mcpServers": {
    "traceforge": {
      "command": "npx",
      "args": ["-y", "traceforge-mcp"]
    }
  }
}

Direct Execution

traceforge-mcp  # Start MCP server via stdio protocol

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ANTHROPIC_API_KEY | For analyze/implement | Claude API key |

init, plan, report, resume, gate, and trace commands work locally without an API key.

Requirements

• Node.js 18+

License

MIT