Changelog · Executable Contract per ADR-002Every user-facing change
lands here first.
The changelog is not an afterthought. Commits that touch user-facing behavior must land a ledger entry before the release tag or the pre-commit hook fails.
v1.2.0.2
2026-05-19— Cross-platform Desktop MCP setup helper — Mac · Linux · Windows one-command setup- NEW bootstrap/mxm-desktop-config.sh (Mac/Linux/WSL/Git Bash) + mxm-desktop-config.ps1 (Windows PowerShell + PowerShell 7+ cross-platform). One-command Claude Desktop MCP setup — auto-detects OS, locates claude_desktop_config.json, backs up existing config, merges 8 Maxim MCP entries (preserving existing entries), validates JSON.
- Customer-facing docs refreshed: documents/INSTALL.md gains Section 2 'Enable Maxim in Claude Desktop' with auto-config command + manual config snippet showing OS-specific paths + Web Projects setup + surface fidelity matrix.
- documents/cross-surface/maxim-surface-guide.md updated to v1.2.0.2 with current fidelity matrix (Desktop ~95%, Web ~85%).
- README.md gets 'Multi-surface (v1.2.0+)' line. Mac tester quick-start (5 lines) added to CHANGELOG.md.
- DX-only release. No capability count changes from v1.2.0.1.
v1.2.0.1
2026-05-19— Cross-surface command parity — Maxim's 48 commands work on every Claude surface- NEW 8th MCP server `mxm-commands` (2 tools) — exposes all 48 /mxm-* slash commands as MCP tools. Closes the command-parity gap on Claude Desktop where native slash commands don't exist. After this, asking Desktop 'use mxm-commands.mxm_command for build hello-world' routes identically to typing '/mxm-build hello-world' in Claude Code.
- documents/cross-surface/maxim-project-instructions.md refreshed v1.0.0 → v1.2.0 with NEW 'Slash Command Aliases' section. All 48 commands grouped by tier (TIER 1 verb-first / TIER 2 office / TIER 3 persona / domain) — `/mxm-*` text invocations now work in Desktop and Claude.ai Web Projects via Claude's instruction-following.
- Cowork plugin packaging refreshed v1.0.0 → v1.2.0: skills 20 → 35, commands 14 → 48, mcp_connectors 7 → 8, frameworks 64 → 74, drift_classes 13, agents 91. TIER 1 + TIER 3 command arrays declared explicitly.
- Surface fidelity matrix at v1.2.0.1: Claude Code 100% · Claude Desktop ~95% (8 MCPs + project instructions) · Claude.ai Web ~85% (project instructions w/ aliases, no MCP) · Cowork ~85% (full plugin).
- Capability delta v1.2.0 → v1.2.0.1: total_mcp_servers 7 → 8 (+1 mxm-commands), total_mcp_tools 47 → 49 (+2 mxm_command + list_commands). All other counts unchanged.
v1.2.0
2026-05-19— Adoption story — TIER 1 + TIER 3 commands · voice agents · 10 behavioral frameworks · full roster reorganization- WS1 voice writing agents (ADR-016) — nk-writer routes every writing task through myVoiceDNA/VOICE_SELECTION.md (22 content types, 15K token cap, 5-choice ambiguity prompt). voice-routing skill + per-startup brand-writer template + executive-router Voice Routing Rule.
- WS2 TIER 1 verb-first commands — /mxm-build, /mxm-fix, /mxm-ship, /mxm-explain (4 NEW) + /mxm-plan and /mxm-review upgraded with Fogg B=MAP + conditional auto-loops.
- WS3 TIER 3 persona dispatchers — /mxm-legal, /mxm-arch (native Wardley Mapping), /mxm-secure (triple-OWASP + AIBOM + NIST AI RMF + MITRE ATLAS), /mxm-founder (Prospect-Theory pricing + MOAT_TRACKER-live), /mxm-pm (Tony Ulwick Jobs Atlas). 28 sub-commands handled inline.
- WS4 /mxm-help rebuilt as 9-mode dispatcher with persona auto-detect from project-manifest. Persona cache at .mxm-skills/operator-persona.txt.
- WS5 Full roster reorganization — 19 deprecations + 19 net-new agents = 91 (exact proposal target). CSO +10 specialists. CINO +4. Orchestrators +5 (ethics-orchestrator, behavioral-overlay-orchestrator, confidence-tagger, compliance-orchestrator, handoff-coordinator).
- WS6 — 10 NEW behavioral frameworks at ADR-007 7-section depth: TTM, SDT, Dual Process, Prospect Theory (HIGH) + SCARF, TPB, Social Learning, Operant Conditioning, Diffusion of Innovations, Emotional Design (MED). 64 → 74 frameworks.
- WS7 — Proactive Watch Class 13 third-party-plugin-drift codified per ADR-012 MOE. 11 → 13 drift classes (Class 12 behavioral-moat-drift ratified in pre-sprint cleanup).
- Capability deltas: agents 90→91 · skills 34→35 · commands 39→48 · frameworks 64→74 · drift classes 11→13 · compliance 14 (unchanged) · ADRs 16 (unchanged) · MCP 7 servers / 47 tools (unchanged) · hooks 14 (unchanged).
v1.1.1
2026-04-28— Self-update + public install docs- /mxm-self-update slash command — fast in-place update without /plugin uninstall + /plugin install cycle
- documents/INSTALL.md — public install / upgrade / uninstall guide covering base plugin + 14 packs (L1 individuals vs L2 bundles vs L3 verticals with anti-overlap warning)
- Tester upgrade flow now ~5 sec + 1 restart (was ~2 min + 2 restarts)
- Roadmap renumber: MOE + 7 compliance frameworks moved from v1.1.1 to v1.1.2
v1.1.0 → v1.1.0.4
2026-04-27 to 2026-04-28— License middleware foundation + 4 hotfixes- v1.1.0 — Cloudflare Worker /issue + /validate endpoints LIVE; all 7 MCP servers gated via mcp/_shared/license-gate.mjs (RS256 JWT + machine fingerprint)
- v1.1.0.1 — 90-day Pro Trial auto-activates on first install (Class 11 surface-claims-drift fix); falls back to Starter forever on Day 91+
- v1.1.0.2 — BUG-007 fix: plugin-scoped MCP-deps install + sentinel (was project-scoped, broke every plugin upgrade)
- v1.1.0.3 — Single-restart upgrade via mcp/_shared/spawn-with-deps.mjs wrapper (was 2 restarts)
- v1.1.0.4 — /mxm-help content drift fix (was advertising v1.0.0 era counts)
- Worker live at https://maxim-license-api.isystematic.workers.dev (Version 54be3b40)
- All 7 v1.1.0 ship gates green
v1.0.1
2026-04-27— MCP path bugfix + count alignment- BUG-006 fix — all 7 plugin:maxim:mxm-* MCP servers now connect via ${CLAUDE_PLUGIN_ROOT} substitution (was relative ./mcp/<name>/server.js)
- Total agent count: 88 → 90 (cost-analyst CINO + sre-analyst COO from aria-simplification migration; skill-synthesizer registry drift fix)
- Class 11 surface-claims-drift codified in Proactive Watch + bootstrap/sync-counts.{sh,ps1} companion tool
- Count alignment propagated across 30+ plugin-repo doc surfaces and 9 landing-page TSX/TS surfaces
v1.0.0
2026-04-21— First public release- 88 specialist agents across 7 executive offices
- 34 domain skills, each citing a behavioral framework with author and year
- 38 slash commands, 7 MCP servers (47 tools), 14 hook scripts
- 64 peer-reviewed behavioral frameworks cataloged
- 14 compliance frameworks enforced at the MCP layer
- 11 Architecture Decision Records governing the system
- Four-tier freemium: Starter free, Pro Trial 90 days, Solo $19.99, Pro $39, Professional $99, Team $249 (5 seats)
- Four vertical overlays (Healthcare, Legal, Fintech, GovTech) stackable on any paid tier
- Business Source License 1.1 — converts to Apache 2.0 on 2030-04-21
- Cloudflare Worker license issuance live at maxim-license-api.isystematic.workers.dev
- Stripe-primary payment processor (ADR-011)
- Three-layer .brand-foundation system — Maxim base voice, operator overlay, per-startup overlay
Full commit history lives at
github.com/DrNabeelKhan/maxim/commits/main. The canonical
CHANGELOG.md is at the repo root.