Changelog

This page auto-updates with every release.

Changelog

All notable changes to SpecForge are documented here.

Format: Keep a Changelog · Versioning: SemVer

---

[Unreleased]

Added

• Feature grouping for specs: specs now organized under {feature}/{slug}/ directories
• Mermaid diagrams now use real project knowledge (framework, database, architecture layers)
• SpecForge version identifier (Generated by: SpecForge vX.Y.Z) in FICHA-TECNICA.md metadata

Fixed

• Duplicate Architecture row appearing outside the metadata table in FICHA-TECNICA.md
• Structured multi-paragraph descriptions no longer wrapped in "As a user, I want..." in HU.md

[0.6.1] — 2026-02-26

Added

• E2E lifecycle test suite: 68 tests validating all tool handlers with valid enum inputs
• Tests cover 4 streams: core, analysis, platform, governance

[0.6.0] — 2026-02-26

Fixed

• All 27 Zod enums now have .describe() with explicit valid values — prevents LLM hallucination of invalid enum values (e.g., sending "mid" instead of "intermediate")
• ExperienceLevelEnum description now lists valid options

[0.5.0] — 2026-02-25

Added

• Profile-aware UX: userProfile parameter on init_project (developer, product-owner, designer, non-technical)
• Simplified clarification flow — SpecForge asks fewer, smarter questions based on user profile
• ChatGPT Desktop and Cline (VS Code) added to compatible AI tools list
• Website language simplified for non-technical users

Changed

• clarify_requirements now only triggers for extremely vague topics (< 3 words)
• Removed technical interrogation questions (performance, timeline, dependencies) — SpecForge decides these based on project context

[0.2.0] — 2026-02-25

Added

• Semantic-release for automatic versioning and npm publish via GitHub Actions
• workflow_dispatch trigger on publish workflow

Fixed

• Husky hooks disabled in CI semantic-release workflow
• npm auth configuration in setup-node

[0.1.1] — 2026-02-24

Added

• Website published at https://specforge-mcp.vercel.app in 6 languages (EN, ES, PT, FR, ZH, DE)
• Ko-fi donation button (floating popup + donate page)
• Google Search Console verification
• Hero logos panel with OS, AI agents, and language logos
• Ecosystem banner with animated marquee (AI agents + languages)
• Mobile performance improvements (LCP, FCP optimization)
• Preload hints for critical CSS/JS assets

Fixed

• Mobile hero overlap — VitePress .VPHero .image container now hidden on mobile
• Sitemap hreflang — all 85 URLs now have correct 7 hreflang alternates
• Donation popup now appears after 8s delay (was 3s) to avoid LCP interference

[0.1.0] — 2026-02-20

Added

• Initial public release on npm as specforge-mcp
• 59 MCP tools across 8 streams (A–H): init, spec lifecycle, analysis, planning, platform, docs, orchestration, governance
• Support for TypeScript, Python, Go, Rust, Java/Kotlin, Swift, PHP, Ruby, C#, Dart/Flutter
• Works with Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot, VS Code
• Spec Driven Development (SDD) workflow: HU.md + FICHA-TECNICA.md + PROGRESS.md per spec
• Mermaid diagram generation (architecture, sequence, state machine, ER, data flow)
• Multi-language i18n (EN/ES/PT) for generated specs
• Clean Architecture (hexagonal) — engine, tools, storage, types layers
• 10,857 tests with ≥95% coverage