maxsimcli 4.0.0 → 4.0.1

package/README.md

@@ -23,7 +23,7 @@ MAXSIM solves this by offloading work to fresh-context subagents, each with a si
 npx maxsimcli@latest
 ```
 
-**Works with Claude Code, OpenCode, Gemini CLI, and Codex — on Mac, Windows, and Linux.**
+**Works with Claude Code — on Mac, Windows, and Linux.**
 
 > ⚠️ **Early Alpha** — APIs, commands, and workflows may change between releases. Expect rough edges.
 
@@ -75,7 +75,7 @@ That's the loop. Discuss → Plan → Execute → Verify. Each phase is isolated
 
 ## How It Works
 
-MAXSIM installs 30+ slash commands into your AI runtime. Each command is a structured workflow that spawns specialized subagents with fresh context.
+MAXSIM installs 32 slash commands, 11 skills, and an MCP server into Claude Code. Each command is a structured workflow that spawns specialized subagents with fresh context.
 
 ### The Core Loop
 
@@ -251,27 +251,18 @@ npx maxsimcli@latest
 ```
 
 The installer prompts you to choose:
-1. **Runtime** — Claude Code, OpenCode, Gemini, Codex, or all
-2. **Location** — Global (all projects) or local (current project only)
+1. **Location** — Global (all projects) or local (current project only)
 
-Verify with:
-- Claude Code / Gemini: `/maxsim:help`
-- OpenCode: `/maxsim-help`
-- Codex: `$maxsim-help`
+Verify with: `/maxsim:help`
 
 <details>
 <summary><strong>Non-interactive Install (Docker, CI, Scripts)</strong></summary>
 
 ```bash
-npx maxsimcli --claude --global    # Claude Code → ~/.claude/
-npx maxsimcli --opencode --global  # OpenCode → ~/.config/opencode/
-npx maxsimcli --gemini --global    # Gemini CLI → ~/.gemini/
-npx maxsimcli --codex --global     # Codex → ~/.codex/
-npx maxsimcli --all --global       # All runtimes
+npx maxsimcli --claude --global    # Global install → ~/.claude/
+npx maxsimcli --claude --local     # Project-scoped install → ./.claude/
 ```
 
-Add `--local` instead of `--global` for project-scoped installs.
-
 </details>
 
 ---
@@ -306,7 +297,7 @@ Project settings live in `.planning/config.json`, created during `/maxsim:new-pr
 
 ### Model Profiles
 
-MAXSIM has **4 model profiles** that control which Claude model each of the 11 specialized agents uses:
+MAXSIM has **4 model profiles** that control which Claude model each of the 13 specialized agents uses:
 
 | Profile | Planners & Executors | Researchers | Orchestrators |
 |---------|---------------------|-------------|---------------|
@@ -356,7 +347,7 @@ The context bar shows a 10-segment indicator that turns red and blinks above 95%
 
 ## Agents
 
-11 specialized subagents, each with fresh context and a single responsibility:
+13 specialized subagents, each with fresh context and a single responsibility:
 
 | Agent | Role |
 |-------|------|
@@ -367,6 +358,8 @@ The context bar shows a 10-segment indicator that turns red and blinks above 95%
 | `maxsim-roadmapper` | Creates project roadmaps with phase breakdown |
 | `maxsim-plan-checker` | Verifies plans will achieve the phase goal |
 | `maxsim-executor` | Implements plans with atomic commits |
+| `maxsim-spec-reviewer` | Reviews implementation for spec compliance after execution |
+| `maxsim-code-reviewer` | Reviews implementation for code quality and patterns |
 | `maxsim-verifier` | Goal-backward verification after execution |
 | `maxsim-debugger` | Scientific-method debugging with persistent state |
 | `maxsim-integration-checker` | Verifies cross-phase integration and E2E flows |
@@ -374,6 +367,39 @@ The context bar shows a 10-segment indicator that turns red and blinks above 95%
 
 ---
 
+## Skills
+
+MAXSIM includes 11 built-in skills that enforce workflow constraints and best practices. Skills auto-trigger based on context — they're not optional guidelines, they're active workflow enforcement.
+
+| Skill | Description |
+|-------|-------------|
+| `batch-worktree` | Run parallel tasks in isolated git worktrees |
+| `brainstorming` | Structured ideation and feature exploration |
+| `code-review` | Automated code review with quality checks |
+| `memory-management` | Persistent memory across sessions |
+| `roadmap-writing` | Guided roadmap and requirements authoring |
+| `sdd` | Spec-driven development workflow |
+| `simplify` | Review changed code for reuse, quality, and efficiency |
+| `systematic-debugging` | Root-cause investigation before attempting fixes |
+| `tdd` | Test-driven development — failing test before implementation |
+| `using-maxsim` | Guide for effective MAXSIM usage |
+| `verification-before-completion` | Verify work before claiming completion |
+
+---
+
+## MCP Server
+
+MAXSIM installs an MCP (Model Context Protocol) server that exposes project tools directly to Claude Code. The server is auto-configured during installation via `.mcp.json`.
+
+**Exposed tools:**
+- **Phase operations** — list, add, complete, and remove phases
+- **State management** — read/update STATE.md (decisions, blockers, metrics)
+- **Todo operations** — create, list, and complete todos
+
+The MCP server runs as a stdio process managed by Claude Code — no manual startup needed.
+
+---
+
 ## Contributing
 
 MAXSIM is open source and contributions are welcome.

package/dist/assets/CHANGELOG.md

@@ -1,3 +1,56 @@
+# [4.0.0](https://github.com/maystudios/maxsimcli/compare/v3.12.0...v4.0.0) (2026-03-02)
+
+
+* feat!: remove non-Claude adapters and simplify install to Claude-only ([e640107](https://github.com/maystudios/maxsimcli/commit/e640107bc7d66fd6b6a22778fc3f5aa2f720f1ae))
+
+
+### Bug Fixes
+
+* **core:** add actionable context to catch blocks across core modules ([3bda2eb](https://github.com/maystudios/maxsimcli/commit/3bda2eb3767500a2500cd4ce394af90a79ef1c8a))
+* **core:** replace Unix find with cross-platform fs walk ([#22](https://github.com/maystudios/maxsimcli/issues/22)) ([8dddae4](https://github.com/maystudios/maxsimcli/commit/8dddae4f2af7fa2c0e398025779c4fcc85389244))
+* **core:** replace Unix find with cross-platform fs walk for Windows compatibility ([b121ae6](https://github.com/maystudios/maxsimcli/commit/b121ae68d5d38733960e9ff72c2f7a982f54d739))
+* **dashboard:** increase health check timeout to 10s and verify multi-project isolation ([bee185c](https://github.com/maystudios/maxsimcli/commit/bee185c91e730896040afef63eaac5d782cefc28))
+* **install:** add .mcp.json backup and install recovery safety ([77eb4fe](https://github.com/maystudios/maxsimcli/commit/77eb4feeafd141eca94349f19615fcee97bb6718))
+* **install:** move skills install path from agents/skills/ to skills/ ([436712a](https://github.com/maystudios/maxsimcli/commit/436712a4adee7c86ae9480a6aa93e52ff017338a))
+* **install:** remove dead isCodex reference and reject deprecated runtime flags ([#21](https://github.com/maystudios/maxsimcli/issues/21)) ([9a4af80](https://github.com/maystudios/maxsimcli/commit/9a4af80c5543fcd69970fbac4f9c71c9f5821388))
+* resolve duplicate CmdResult and update tests for CmdResult pattern ([1e02d4b](https://github.com/maystudios/maxsimcli/commit/1e02d4b7df95d3833fd92f3413870a18ff1be3d4))
+* **state:** harden STATE.md parsing for format drift resilience ([9881d1c](https://github.com/maystudios/maxsimcli/commit/9881d1c9f6b1810aa5838f651aa16f9bd87cdf5d))
+
+
+### Features
+
+* add artefakte system, context loader, and start command (Units 1, 9, 10) ([dbbc2b4](https://github.com/maystudios/maxsimcli/commit/dbbc2b4d35412f9b51e100a9aa2bd027dcd4e398))
+* add brainstorming and roadmap-writing skills (Units 7, 8) ([1b8c64c](https://github.com/maystudios/maxsimcli/commit/1b8c64c2c5dec6f2873df1cc79a5002b176f7e96))
+* async I/O for hot-path commands and phase-list pagination (Phase 10) ([19e7741](https://github.com/maystudios/maxsimcli/commit/19e7741c8df1567a08f59282235b217855d4cd85))
+* **execution:** wire Execute-Review-Simplify-Review cycle into execution pipeline ([7a6a998](https://github.com/maystudios/maxsimcli/commit/7a6a998aeb707288930d99e36c06ba0cac23dfae))
+* **mcp:** complete E2E Q&A routing between Claude Code and dashboard ([ac3115a](https://github.com/maystudios/maxsimcli/commit/ac3115a7e120ae9b1e597ae6f9afe664449640a2))
+* rewrite workflows with thinking-partner behavior and artefakte integration (Units 2-6) ([f44b4f4](https://github.com/maystudios/maxsimcli/commit/f44b4f4589df9f94fc3b927a88e5683c2b5bbf2d))
+* **skills:** add batch-worktree and sdd skill templates ([84997be](https://github.com/maystudios/maxsimcli/commit/84997be21443de3213636f862c480ca32caed254))
+* **skills:** add skill-list, skill-install, skill-update CLI commands ([d848acd](https://github.com/maystudios/maxsimcli/commit/d848acd678e19a4eb1bf947e15a972786a801ef0))
+* **skills:** register using-maxsim skill for auto-trigger at conversation start ([d5f0a50](https://github.com/maystudios/maxsimcli/commit/d5f0a50ab625655cf1d3e53eebbb86661b011bf3))
+* unified dashboard mode with enhanced MCP Q&A and multi-project support (Units 11-14) ([b26205e](https://github.com/maystudios/maxsimcli/commit/b26205ebffb1770daa6f2bbb82ced801af8800eb))
+
+
+### BREAKING CHANGES
+
+* Remove OpenCode, Gemini, and Codex runtime support.
+MAXSIM v2.0 is Claude Code-only.
+
+- Delete adapter files: opencode.ts, gemini.ts, codex.ts
+- Delete transforms/: tool-maps.ts, frontmatter.ts, content.ts
+- Simplify adapter registry to export only claudeAdapter
+- Narrow RuntimeName type to 'claude' literal
+- Narrow AdapterConfig.commandStructure to 'nested' only
+- Remove --opencode, --gemini, --codex, --both, --all CLI flags
+- Remove promptRuntime() multi-runtime selector
+- Remove copyFlattenedCommands() and copyCommandsAsCodexSkills()
+- Remove configureOpencodePermissions() and parseJsonc()
+- Remove non-Claude branches from install, uninstall, hooks, manifest
+- Simplify shared.ts to use claudeAdapter directly (no adapter map)
+- Update help text and banner for Claude-only messaging
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
 # [3.12.0](https://github.com/maystudios/maxsimcli/compare/v3.11.0...v3.12.0) (2026-03-01)