Skip to content

Releases: jghiringhelli/forgecraft-mcp

v0.4.0 — Tool Consolidation (16 → 2)

02 Mar 15:19
@jghiringhelli jghiringhelli
v0.4.0
08fd7fe

Choose a tag to compare

View all tags
v0.4.0 — Tool Consolidation (16 → 2) Latest
Latest

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.

Assets 2
Loading

v0.3.0 — Skills, Smart Merging, and Python Support

02 Mar 14:24
@jghiringhelli jghiringhelli
v0.3.0
f9d1fa2

Choose a tag to compare

View all tags
v0.3.0 — Skills, Smart Merging, and Python Support

The biggest release since launch. ForgeCraft now generates the full Claude Code project structure triad: standards (CLAUDE.md) + enforcement (hooks) + workflows (skills).

Skills Generation (New)

ForgeCraft now generates Claude Code custom commands — reusable workflow prompts installed to .claude/commands/ and invoked via /project:<name>. 13 skills across 7 tags:

Tag Skills
UNIVERSAL /project:code-review, /project:run-tests, /project:debug-error, /project:refactor-file
API /project:api-test-endpoint, /project:api-add-endpoint
WEB-REACT /project:react-add-component, /project:react-optimize-performance
HEALTHCARE /project:healthcare-phi-audit
HIPAA /project:hipaa-compliance-check
FINTECH /project:fintech-money-audit
DATA-PIPELINE /project:pipeline-validate-schema, /project:pipeline-trace-lineage

New list_skills tool for discovery. Skills are tier-filtered and support variable substitution.

Safe Instruction File Updates (Fix)

generate_instructions and refresh_project now merge by default instead of overwriting. Custom sections you add to CLAUDE.md (or any instruction file) are preserved across regeneration. No more lost preferences.

Python Support

  • Auto-detects project language from file extensions (no more hardcoded TypeScript)
  • Language-conditional template blocks: {{#if language_is_python}} / {{#if language_is_typescript}}

MCP Server Token Budget

  • Tier annotations (core/recommended/optional) on all 24 MCP server configs
  • New max_servers parameter to cap MCP server recommendations

Other Features

  • get_design_reference tool — on-demand DDD, CQRS, and GoF pattern guides
  • Auto-detect repo URL, framework, and domain from project files
  • Scaffold skips existing files by default with git safety warnings
  • New hooks: function-length checker, import-cycle detector, post-edit commit reminder
  • TDD methodology block in core tier
  • 6 new domain tags with MCP server discovery

Stats

  • 194 tests (39 new)
  • 16 MCP tools
  • 24 tag templates
  • 112+ curated content blocks

Install / Update

npx [email protected]

Or in your MCP config:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}
Loading