v1.4.1

Changed

• Core documentation now states explicitly that GitHub Spec Kit is the base workflow reference for this framework.
• README, docs index, and structure guides now align the real-project model with the spec/ sidecar architecture.
• Roadmap, launch kit, and versioning docs are now aligned with the current v1.4.x state.

Verified

• npm run build
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .
• ./scripts/check-sdd-gate.sh .

v1.4.0

Added

• Exact sidecar-mode prompts to keep advanced projects clean and avoid copying the full framework repository.
• New bilingual guides:
  • docs/en/49-spec-sidecar-prompts.md
  • docs/es/49-prompts-sidecar-spec.md

Changed

• spec/ sidecar is now the explicit professional default for real projects.
• sdd-core and sdd-mcp now resolve sidecar layouts correctly.
• create-www-project.sh now invokes nested scripts through bash for reliable MCP-driven execution.
• GitMCP docs now use relative links compatible with offline markdown link checks.

Fixed

• MCP integration test aligned with sidecar workspace outputs.
• Local markdown link-check failures caused by absolute filesystem links in GitMCP docs.

Verified

• npm run typecheck
• npm run build
• npm run mcp:smoke
• npm run mcp:http:smoke
• npm run mcp:test
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .
• ./scripts/check-sdd-gate.sh .

v1.3.1

v1.3.1

Added

• Dedicated GitMCP connection guides:
  • docs/en/48-how-to-connect-this-repo-with-gitmcp.md
  • docs/es/48-como-conectar-este-repo-con-gitmcp.md

Changed

• README, docs index, easy MCP guide, and free external MCP guide now point directly to the GitMCP step-by-step guide.
• Package versions aligned to 1.3.1 for this documentation patch release.
• GitMCP is explained more clearly as a free external repo-context MCP, not a replacement for sdd-mcp.

Verified

• npm run build
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .

v1.3.0

Added

• easy MCP guides for non-technical users in English and Spanish
• hosted onboarding MCP model docs in English and Spanish
• client visual examples for easy MCP in English and Spanish
• release prep docs for v1.3.0
• easy MCP resource: sdd-easy-mcp-guide
• easy MCP prompts:
  • easy_start_project
  • easy_create_spec
  • easy_show_structure
  • easy_validate_project
  • easy_show_next_step
  • easy_close_session

Changed

• README, docs index, AI start guide, and MCP references now surface the easy path before the deep technical path
• media kit positioning now includes easy MCP onboarding
• internal package versions aligned to 1.3.0

Verified

• npm run typecheck
• npm run build
• npm run mcp:smoke
• npm run mcp:http:smoke
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .
• ./scripts/check-sdd-gate.sh .

v1.2.0

v1.2.0

This release positions the repository more clearly as an operational SDD framework with AI guidance, GitHub Spec Kit alignment, and MCP support.

Highlights

• Added dedicated MCP CI workflow.
• Added MCP integration test that exercises real tools and resource reads.
• Added public roadmap, client setup recipes, and versioning strategy docs.
• Added social preview asset and media kit for diffusion.
• Added end-to-end adoption example and issue templates for real use cases.
• Aligned internal package versions with the framework release.
• Fixed sdd_create_spec to create the spec directory before contracts.

Verification

• npm run typecheck
• npm run build
• npm run mcp:smoke
• npm run mcp:http:smoke
• npm run mcp:test
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .
• ./scripts/check-sdd-gate.sh .

v1.1.0

v1.1.0

This release turns the framework into a real MCP-capable product layer while keeping the template as the canonical source.

Highlights

• Added packages/sdd-core as typed reusable SDD logic.
• Added packages/sdd-mcp with stdio and Streamable HTTP transports.
• Added 12 MCP tools for workspace, spec, validation, gate, status, roadmap, and logbook flows.
• Added static resources and active-project resource templates.
• Added outputSchema and structuredContent for stronger MCP client compatibility.
• Added copy/paste config examples for Cursor, Claude Code, and Codex.
• Added root .mcp.json for project-scoped MCP adoption.
• Added bilingual MCP setup guides and launch kit docs.

Verification

• npm run typecheck
• npm run build
• npm run mcp:smoke
• npm run mcp:http:smoke
• ./scripts/validate-sdd.sh . --strict
• ./scripts/check-sdd-policy.sh .
• ./scripts/check-sdd-gate.sh .