Maxim
Changelog · Executable Contract per ADR-002

Every 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-19Cross-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-19Cross-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-19Adoption 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-28Self-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-28License 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-27MCP 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-21First 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.