Breaking Change: Tool Consolidation (16 → 2)
Consolidated 16 MCP tools into 2 to reduce per-request token overhead by ~70%.
Why
Every MCP tool schema is sent with every AI request. With 16 tools, this wasted ~5,000 tokens per conversation turn — significant for a tool that only runs at setup time.
New Tool Interface
| Tool | Purpose |
|---|---|
setup_project |
Unchanged. Recommended first step — auto-detects tags, creates config, generates instruction files. |
forgecraft |
New. Unified router for all other operations via action parameter. |
Available Actions for forgecraft
refresh, scaffold, generate, audit, review, list, classify, add_hook, add_module, configure_mcp, get_reference, convert
Migration
| Before (v0.3.0) | After (v0.4.0) |
|---|---|
refresh_project { project_dir, apply } |
forgecraft { action: "refresh", project_dir, apply } |
audit_project { tags, project_dir } |
forgecraft { action: "audit", tags, project_dir } |
list_tags {} |
forgecraft { action: "list", resource: "tags" } |
get_nfr_template { tags } |
forgecraft { action: "get_reference", resource: "nfr", tags } |
add_hook { hook, project_dir } |
forgecraft { action: "add_hook", name: "hook-name", project_dir } |
All existing handler logic is preserved — the router is a thin dispatch layer. 214 tests pass.