Changelog
All notable changes to mx-workflow are documented here, generated from the project’s CHANGELOG.md. The format follows Keep a Changelog, and the project uses Semantic Versioning. Tagged releases are on GitHub.
Unreleased
Section titled “Unreleased”2.0.0 — 2026-08-26
Section titled “2.0.0 — 2026-08-26”Removed
Section titled “Removed”- Slack bot and Mac mini setup removed from the plugin. Deleted the
slack-bot/daemon (Bolt app, interactive/auto build runners, session store, launchd plist, setup docs), the/mx:setup-mac-minicommand, and thedocs/Slack Bot guide. Scrubbed references from/mx:help, the docs landing page (the “Headless builds via Slack” card) and sidebar, and the ROADMAP. The core plugin (review commands, agents, skills, and the rest of the lifecycle commands) is unaffected. Breaking:/mx:setup-mac-minino longer exists and headless Slack-triggered builds are no longer supported.
1.23.4 — 2026-08-19
Section titled “1.23.4 — 2026-08-19”- The docs site changelog page is now generated from the root
CHANGELOG.mdat build time bydocs/scripts/sync-changelog.mjs, instead of being maintained by hand. The hand-written page had drifted 22 versions behind — its newest entry was 1.1.1 and its “Unreleased” section described work shipped months earlier. Version headings are rewritten (## [1.2.3] - date→## 1.2.3 — date) so bracket characters don’t leak into heading anchors, trailing link-reference definitions are stripped, and the table of contents is capped at version level. The generated file is gitignored and carries a do-not-edit banner, so the root changelog is the single source of truth and the page cannot drift again. - The docs deploy workflow now also triggers on changes to
CHANGELOG.md. It previously watched onlydocs/**, so a release-only commit would have left the generated changelog page stale until some unrelated docs change happened to redeploy the site.
1.23.3 — 2026-08-19
Section titled “1.23.3 — 2026-08-19”Changed
Section titled “Changed”- Docs site: the command and agent pages now reflect the 1.23.x behavior changes, not just the new reference pages.
/mx:builddocuments convention detection (greenfield vs existing) and the deviation gate;/mx:qadocuments the Structure & Style conformance pass under--fulland that it’s skipped on codebases with a pre-existing layout;/mx:create-rulesdocuments the File Layout Convention section and that it describes rather than prescribes;/mx:versiongains a caution box on verifying the tag reached the remote and why--follow-tagsis unsafe;mx-feature-builderin the agent catalog documents its no-precedent fallback rules and deviation reporting.
1.23.2 — 2026-08-19
Section titled “1.23.2 — 2026-08-19”- Docs site: Project Structure and Code Style reference pages, covering the layout invariant (a file lives at the lowest point in the tree that can see all of its consumers), naming and barrel policy, string extraction, the uncapped-nesting rationale, per-framework support (React/Angular/Svelte/Vue/backend/CLI/mobile), the
dependency-cruiserenforcement encoding with its stated coverage limit, and the deviation protocol. Both added to the Reference sidebar.
Changed
Section titled “Changed”- Docs site:
/mx:ratchetpage now lists thestructuredimension in its usage line and description, cross-linked to the new Project Structure page.
1.23.1 — 2026-08-19
Section titled “1.23.1 — 2026-08-19”/mx:releaseand/mx:versionnow require verifying the tag actually reached the remote (git ls-remote --tags origin) after pushing, and both explicitly warn againstgit push --follow-tags.--follow-tagspushes only annotated tags, so a lightweight tag (git tag v1.2.3, no-a) is skipped with no warning — leaving the local repo looking released while the remote has no tag, andgh release createeither failing or pointing at a tag nobody can resolve. Both commands already created annotated tags; the gap was that neither confirmed the push landed.
1.23.0 — 2026-08-18
Section titled “1.23.0 — 2026-08-18”references/project-structure.md— a framework-agnostic file layout spec built on one invariant: a file lives at the lowest point in the tree that can see all of its consumers, so a file may import from its own subtree or an ancestor but never from a sibling’s subtree. Covers hoist-on-second-consumer placement, folder-qualified filenames, constants at scope of use, uncapped nesting (with depth ≥4 as a QA advisory rather than a failure), pre-approved exceptions (framework paths, generated code, e2e, design-system primitives), a per-stack vocabulary table for React/Angular/Svelte/Vue/backend/CLI/mobile, and adependency-cruiserCI encoding of the sibling-import rule. Existing layouts always win; conflicts are reported, never silently migrated.references/code-style.md— the companion spec for what goes inside the files: strict TypeScript (plus the checksstrictomits), banned escape hatches (any,as,!,@ts-ignore), simplicity rules (rule of three, no speculative abstraction, delete rather than comment out), control-flow limits (guard clauses, named conditions,max-depth3,complexity10, no nested ternaries), and naming rules (no single letters or invented abbreviations, name length scales with scope, predicate booleans). Each rule is mapped to CI gate or human review, with the un-lintable ones named as such.- Both references state readability as the explicit tiebreaker and share one deviation protocol: deviations are argued at the build gate before code lands, leave a justified suppression as the artifact, and are then tracked by the existing
/mx:ratchetand/mx:check-ignoresmachinery. - New
structureratchet dimension — counts layout violations (sibling-subtree imports, hand-written barrels) on trunk vs branch via the project’s configured gate, and blocks increases. Skipped when no gate is configured rather than falling back to a hand count, which wouldn’t be comparable across checkouts. Nesting depth is deliberately excluded as an advisory, not a ratchet dimension.
Changed
Section titled “Changed”/mx:buildwired to both references: Phase 0.5 resolves greenfield-vs-existing and records a stackSTRUCTURE_PROFILE, surfacing any conflict with the existing layout in the pipeline overview; Phase 3 gains a Structure & Style section plus a deviation gate that requires approval before non-pre-approved departures land (and under--autoapplies the rule rather than deviating unilaterally); Phase 4.1 adds layout conformance; the final report gains a Structure block. Greenfield builds scaffold the stricttsconfig.jsonbaseline and adependency-cruiserconfig; existing projects get gaps reported instead./mx:qagains a Structure & Style Conformance check under--full, covering what CI can’t reach (deep sibling imports, unqualified filenames, hand-written barrels, inline user-facing strings, speculative hoisting, single-caller abstractions). Skipped on codebases with a pre-existing layout. Justified deviations are reported separately as accepted, not re-litigated as findings./mx:create-rulesnow detects and documents the project’s real layout convention in a new “File Layout Convention” section of the generatedCLAUDE.md, and reports divergences from the reference separately — it describes what the codebase does rather than prescribing what it should do.mx-feature-builderreplaces its vague “follow existing patterns” rule with explicit fallback conventions for code with no precedent, and must now report structure/style deviations in its output.
- Docs: the Getting Started page and the site-wide meta description still led with the old “development workflow plugin / full dev lifecycle” framing — missed in the Phase 1 reposition (only the landing page was updated). Both now lead with the review-grade framing, and Getting Started opens with a “Try it first:
/mx:review” section.
1.22.0 — 2026-06-26
Section titled “1.22.0 — 2026-06-26”- Standalone Skills tier (Phase 5 of the reposition) — four of the sharpest reviewers are now published as self-contained Claude Skills under
skills/, installable individually without the whole plugin:silent-failure-hunter,type-design-analyzer,comment-analyzer(derived from the agents) andhallucination-check(derived from the command). EachSKILL.mdcarries its full instructions and a comment pointing at its canonical plugin source;skills/README.mddocuments install + the sync discipline. Cross-linked from the docs agent catalog. - Distribution & messaging (Phase 4 of the reposition):
keywordsadded toplugin.jsonandmarketplace.json(code-review,ai-code-review,code-quality,static-analysis,hallucination-detection,ci-gate, …) for marketplace discoverability.- Slack bot now answers an empty
@mentionor a greeting/help word with a welcome message that explains the review-grade framing and what it can do (build and review), instead of the bare “I need an instruction” prompt. - New docs guide “Demo: catching a hallucinated API” — a concrete
/mx:reviewwalkthrough where an AI-generated Stripe webhook handler is rejected for an invented SDK method and a swallowed error. Doubles as the script for the demo video. - GitHub repo About line + topics updated to the review framing (applied directly to the repo, not via this PR).
- Review-tier commands (Phase 3 of the reposition) — five deeper, opinionated, refuses-rather-than-generates commands:
/mx:hallucination-check— catches invented APIs, fabricated signatures, non-existent imports, and uninstalled packages by cross-referencing every reference in the diff against actually-installed deps (node_modules, site-packages, module cache) and the repo itself. Evidence-based; unresolvable references are reported as UNVERIFIED, not inflated./mx:second-look— runs the full review team on code generated by other tools (Claude Tag PRs, Cursor/Copilot diffs). Takes a PR number/URL viaghby default, plus--diff <file>and commit ranges offline. Leans harder on hallucination + silent-failure checks for unsupervised output./mx:reject— strict-mode review as a CI gate. Emits a machine-readableMX_VERDICT=PASS|REJECTmarker (plusMX_REJECT_COUNT/MX_BLOCKING) and ships a documented headless recipe (claude -p ... | grep) since slash commands can’t set an exit code./mx:ratchet— “quality only goes up.” Measures coverage, type errors, lint, and suppression count on trunk (in a throwaway git worktree) vs the branch and fails on any regression. Baseline computed live from trunk each run — no stored state. Names new offenders by file:line./mx:audit— whole-repo evolution of/mx:qa. Wraps/mx:qa --fullat repo scope and tracks health trends across dated reports; cron-friendly./mx:qais unchanged.- Documented in
docs/(new “Review-tier” page) and surfaced in/mx:help.
/mx:review— the headline review command (Phase 2 of the reposition). Bundles all 8 review-grade agents into a single verdict (PASS/PASS WITH WARNINGS/REJECT) with per-agent findings and a recommendation. Read-only — it interrogates and reports, never modifies code.- Default scope reviews everything that differs from trunk (
main/master) — committed branch work and uncommitted changes, including untracked new files (where AI-generated code most often hides). Computed via merge-base, so it also works on trunk with only uncommitted edits. Flags:--staged,--commit <sha>,--branch <name>,--scope <path>. - Three configurable verdict modes, default balanced:
--strict(REJECT on CRITICAL or HIGH), balanced (REJECT on CRITICAL),--advisory(never blocks). Always prints a recommendation with reasons. - Models — each agent keeps its existing model assignment (routing optimization deferred to the Phase 2.5 spike).
- Documented in
docs/(new “Review (start here)” page, top of the Commands sidebar) and surfaced as the primary entry point in/mx:helpand the README.
- Default scope reviews everything that differs from trunk (
Changed
Section titled “Changed”- Repositioning — mx-workflow now leads with its identity as “the review-grade quality layer for AI-generated code” rather than “a full dev-lifecycle plugin.” Generation is table stakes; the differentiator is the refusal layer that interrogates AI-generated code for silent failures, hallucinated APIs, suppressed errors, and type rot. The full lifecycle toolkit stays — it’s now framed as the foundation underneath the review agents. (Phase 1 of the reposition; see
ROADMAP.md.) plugin.jsonand marketplace descriptions rewritten to lead with the review framing.README.mdtop section rewritten with the new positioning and a “Why mx-workflow” section naming the gap (peers generate; mx-workflow verifies).- Docs landing page (
docs/) hero, tagline, cards, and a new “Why mx-workflow” section updated to match. - Agent docs (README + docs catalog) now group the 8 review-grade agents first and the 4 build agents at the bottom as “Optional build agents.” Documented the five previously-undocumented agents (
mx-quality-keeper,mx-schema-builder,mx-feature-builder,mx-test-builder,mx-shipkit-builder) — the catalog now covers all 12 agents instead of 7.
1.21.2 — 2026-04-05
Section titled “1.21.2 — 2026-04-05”- Slack bot
@slack/boltupgraded from v3.22 to v4.6.0 for Node.js v25 ESM compatibility — fixesNamed export 'App' not foundcrash andUnhandled event 'server explicit disconnect'socket-mode error - Slack bot data copy sync — installed copy was missing
interactive.js,phases.js,session.jsand had staleindex.js/runner.jsfrom pre-interactive era
1.21.1 — 2026-04-05
Section titled “1.21.1 — 2026-04-05”- New project directories now use readable names derived from the build instruction (e.g.,
task-management-system/) instead of opaque session hashes (session-a3f1b2c4/). Handles name collisions with numeric suffixes.
1.21.0 — 2026-04-05
Section titled “1.21.0 — 2026-04-05”- Auto-project registration — projects register in
.mx-mac-mini.jsonautomatically after each build completes, with meaningful names derived from the PRD file name, branch, or instruction (e.g.,task-manager,settings-page) registerProject()export inslack-bot/runner.jsfor programmatic project registration- Build strategy section in Slack bot docs explaining automatic team vs single agent selection
Changed
Section titled “Changed”/mx:setup-mac-minisimplified — removed Phase 3 (project scanning/registration), reduced to 5 phases. Projects grow organically as you build, no manual discovery needed.- Slack bot docs updated with auto-registration, project referencing patterns, and build strategy info
Removed
Section titled “Removed”- Manual project scanning and alias registration from setup-mac-mini
--projects-onlyflag from setup-mac-mini (no longer applicable)
1.20.0 — 2026-04-05
Section titled “1.20.0 — 2026-04-05”Changed
Section titled “Changed”- Slack bot is now conversational by default — chat naturally, discuss ideas, and build when ready. Claude mediates all replies (no more regex classification), understanding questions vs approval vs feedback from context. Build pipeline only triggers when user explicitly asks to build.
- Conversation history tracked per session and passed to Claude for full context across turns
slack-bot/phases.js— replacedclassifyReply()withconversationSystemPrompt(),buildConversationPrompt(), andparseConversationResponse()for Claude-mediated intent detection via structured markersslack-bot/interactive.js— rewritten from rigid state handlers to unified conversation handler with marker-triggered phase transitionsslack-bot/session.js— addedCONVERSATIONas initial state andhistory[]for conversation trackingslack-bot/index.js— sessions start in conversation mode, first message goes through Claude instead of directly to discovery
1.19.0 — 2026-04-05
Section titled “1.19.0 — 2026-04-05”- Two-way interactive Slack bot conversation — builds now run phase-by-phase by default, posting discovery questions, PRD summaries, and plan summaries to the thread and waiting for user approval or feedback before proceeding. Users can go back and forth at each gate until satisfied.
slack-bot/session.js— session state machine with in-memory lookup and JSON disk persistence, startup recovery for interrupted sessions, 24h expiry cleanupslack-bot/phases.js— prompt generators for each build phase, structured output parsers, reply classifier (approve/cancel/feedback)slack-bot/interactive.js— phase orchestrator driving sessions through discovery → preflight → PRD → plan → build with feedback loops at each gatespawnClaude()export inslack-bot/runner.js— reusable Claude Code spawn primitive used by both auto and interactive runners
Changed
Section titled “Changed”- Slack bot default mode is now interactive (use
--autoflag for original fire-and-forget behavior) slack-bot/index.js— thread reply routing,--autoflag dispatch, user identity verification on session threadsslack-bot/runner.js— refactored to usespawnClaude()internally, exportedextractPrUrl/extractBranchparsers
1.18.1 — 2026-04-04
Section titled “1.18.1 — 2026-04-04”/mx:setup-mac-mininow enforces mandatory phase execution order — Phase 2 (Slack Integration) and Phase 4 (Daemon Setup) explicitly cannot be skipped. Fixes issue where Claude sessions were skipping Slack setup.
1.18.0 — 2026-04-04
Section titled “1.18.0 — 2026-04-04”Changed
Section titled “Changed”/mx:setup-mac-miniredesigned to be proactive and verification-driven — auto-installs required deps, verifies every step via API/CLI before proceeding, gates each phase, validates Slack tokens on paste, checks #builds channel membership, diagnoses daemon failures, and only reports “complete” when everything is verified working. Added Phase 0 pre-flight readiness check and Phase gates at every stage.
1.17.0 — 2026-04-04
Section titled “1.17.0 — 2026-04-04”Changed
Section titled “Changed”/mx:setup-mac-miniexpanded to full day-one setup — 6 phases: system prerequisites (Homebrew, Node.js, Claude Code, Git/SSH, tmux, Tailscale), Slack integration (guided app creation, token collection, auto-detect bot ID, connection test), project registration, daemon setup (launchd with auto-restart), end-to-end verification, and summary. Supports--skip-system,--skip-slack,--projects-onlyflags and re-run menu.- Help card and Slack bot docs page updated to reflect expanded setup
1.16.0 — 2026-04-04
Section titled “1.16.0 — 2026-04-04”/mx:setup-mac-minicommand — one-time interactive setup for the Slack bot. Scans for projects, creates aliases, sets default project, validates CLAUDE.md, writes.mx-mac-mini.jsonconfig.- Project resolution in
slack-bot/runner.js— supports 4 patterns: project prefix (dashboard: add dark mode), first word (api fix bug), default project (bare messages), explicit flag (--repo billing add export) .mx-mac-mini.example.json— example config for reference
Changed
Section titled “Changed”slack-bot/runner.jsrewritten with project resolution, config loading, new/existing project detection/mx:helpupdated with/mx:setup-mac-miniin SESSION START and WHICH PATH sections- Slack bot docs guide updated with project resolution patterns and setup-mac-mini step
1.15.0 — 2026-04-03
Section titled “1.15.0 — 2026-04-03”slack-bot/— Slack bot orchestrator for headless autonomous builds on a Mac mini. Listens to #builds channel and @mentions, triggers/mx:build --auto, streams verbose progress back to Slack in real-time, reports PR links on completion. Includes launchd daemon for auto-start, session isolation, and full logging.
1.14.1 — 2026-04-01
Section titled “1.14.1 — 2026-04-01”Changed
Section titled “Changed”- Documentation site updated — multi-agent command page and choosing-a-workflow guide now reflect funnel discovery, user roles & expectations, test-first build cycle, and per-role spec conformance
1.14.0 — 2026-03-29
Section titled “1.14.0 — 2026-03-29”Changed
Section titled “Changed”/mx:buildPhase 3 now uses test-first cycle: write test → confirm fails → implement → confirm passes. Applies to both single-agent and agent team strategies./mx:build-with-agent-teamspawn prompt template updated with test-first build cycle as a REQUIRED protocol for all implementation agents- QA teammate verification protocol now checks that tests were written alongside features — tasks without tests are failed
- Multi-agent team guide updated with test-first workflow
1.13.0 — 2026-03-29
Section titled “1.13.0 — 2026-03-29”- Test coverage verification in
mx-quality-keeper— verifies that every implemented feature has a corresponding test (e2e for user flows, unit for business logic). Auto-detects test infrastructure (Playwright, Cypress, vitest, jest, pytest, Go/Rust). Reports PASS/FAIL/SKIP per role and expectation ID.
Changed
Section titled “Changed”/mx:qaupdated with Step 6 test coverage verification (runs when--fullor spec found)/mx:buildPhase 4 now includes test coverage check — QA fix cycle writes missing tests- Multi-agent team guide updated with test coverage in QA verification scope
1.12.0 — 2026-03-29
Section titled “1.12.0 — 2026-03-29”Changed
Section titled “Changed”/mx:buildPhase 0 redesigned with funnel discovery — quick direction questions (yes/no, A/B) → inferred context confirmation → targeted details only where uncertain. Replaces the 7 open-ended questions wall./mx:buildPhase 1 and/mx:prdnow include “User Roles & Expectations” section in PRD — each role gets a table of expectations with unique IDs (A1, C2) and priority levelsmx-quality-keeperspec conformance now verifies per role — groups results by role, checks role-gating, reports PASS/FAIL/MISS with expectation IDs/mx:qaspec conformance updated with per-role verification and role-gating checks- Multi-agent team guide updated with role-based spec conformance
1.11.0 — 2026-03-28
Section titled “1.11.0 — 2026-03-28”- Spec conformance check in
mx-quality-keeperagent — verifies every must-have from the PRD was actually built, wired up, and works as specified. Reports PASS/FAIL/MISS per requirement. MISS items (entirely missing features) escalate immediately.
Changed
Section titled “Changed”/mx:qaupdated with Step 5 spec conformance check (runs when--fullor spec found)/mx:buildPhase 4 now includes spec conformance as the critical QA check/mx:build-with-agent-teamQA spawn prompt updated with spec verification protocol- Multi-agent team guide updated with spec conformance in QA verification scope
1.10.0 — 2026-03-28
Section titled “1.10.0 — 2026-03-28”/mx:buildcommand — full pipeline orchestrator: discovery questions → PRD → plan → build (auto-selects agent team or single-agent) → QA → commit. Defaults to interactive discovery;--autofor autonomous mode. Makes incremental commits at each phase for visible progression. Supports--skip-prd,--skip-plan, and--stackflags.
Changed
Section titled “Changed”/mx:helpupdated with/mx:buildin new FULL PIPELINE section and WHICH PATH guidance- Documentation site multi-agent command page renamed to “Full Pipeline & Multi-Agent” with
/mx:buildreference
1.9.0 — 2026-03-28
Section titled “1.9.0 — 2026-03-28”mx-quality-keeperagent — dedicated quality gatekeeper that verifies, tests, and rejects work without writing production code. Operates standalone via/mx:qaor as a mandatory QA teammate in agent team builds/mx:qacommand — comprehensive quality audit (lint, types, tests, suppressions, contract conformance) with structured reporting to.agents/reports/- QA teammate protocol in
/mx:build-with-agent-team— automatic QA spawning, Phase 2.5 continuous verification,TaskCompletedhook enforcement, 3-attempt rejection loop with lead escalation
Changed
Section titled “Changed”/mx:build-with-agent-teamupdated with mandatory QA teammate, continuous verification during implementation, concrete hook configuration examples, and updated definition of done/mx:helpupdated with/mx:qain IMPLEMENTATION, ANYTIME, and WHICH PATH sections- Documentation site multi-agent command page and team guide updated with QA agent protocol
1.8.0 — 2026-03-28
Section titled “1.8.0 — 2026-03-28”Changed
Section titled “Changed”/mx:build-with-agent-teamfully aligned with official Claude Code Agent Teams docs — added display modes (in-process + iTerm2 alongside tmux), keyboard controls, hooks (TeammateIdle/TaskCreated/TaskCompleted), plan approval mode, task management with dependencies and self-claiming, communication patterns (message/broadcast), shutdown and cleanup protocol, troubleshooting guide, and all known limitations/mx:helpdescription updated to reflect in-process mode support- Documentation site command page and multi-agent team guide rewritten with full coverage
1.7.1 — 2026-03-16
Section titled “1.7.1 — 2026-03-16”Changed
Section titled “Changed”- Documentation site updated with
--recursiveflag details on Session & Discovery page
1.7.0 — 2026-03-16
Section titled “1.7.0 — 2026-03-16”Changed
Section titled “Changed”/mx:context-prime--recursivereworked for scalability — deep discovery via module boundary detection (index files + config files across full tree), batched project-wide scoring (2 Greps instead of N), 20-directory cap, deferred overflow, and already-primed detection
1.6.0 — 2026-03-16
Section titled “1.6.0 — 2026-03-16”/mx:context-prime--recursiveflag — walks subdirectories, triages by complexity score, and primes all qualifying directories in one pass
1.5.0 — 2026-03-16
Section titled “1.5.0 — 2026-03-16”/mx:whatsnewcommand — check for plugin updates, show what’s new, and how to update
1.4.0 — 2026-03-14
Section titled “1.4.0 — 2026-03-14”mx-schema-builderagent — database tables, RLS policies, types, and migrations for orchestrated buildsmx-feature-builderagent — single feature implementation (called per feature in pipeline builds)mx-test-builderagent — Playwright e2e test suite generationmx-shipkit-builderagent — production-readiness layer (analytics, SEO, Stripe, feedback, contact)/mx:context-primecommand — analyze a directory and create a.claude/context.local.mdwith non-obvious behavioral notes (hidden coupling, framework quirks, gotchas)/mx:context-primeenforcement audit (Step 3.5) — filters gotchas already caught by lint, TypeScript strict mode, pre-commit hooks, CI, or build checks/mx:context-prime## Verifysection — auto-populates 1–3 concrete test/lint/build commands specific to the target module/mx:context-prime--learnflag — retrospective mode that prompts for session learnings and merges them into existing context files/mx:context-primeCLAUDE.md overlap check — detects redundant content between root CLAUDE.md and local context files, suggests pruning/mx:context-cleancommand — remove local context files for a directory or the entire project/mx:rebasecommand — rebase current branch onto trunk (main/master) or a specified branch with pre-flight checks- Documentation for both context commands on the docs site (Session & Discovery page)
Changed
Section titled “Changed”/mx:helpupdated with/mx:context-prime,/mx:context-clean, and/mx:rebase/mx:shiprenamed to/mx:shipit
1.3.0 — 2026-03-01
Section titled “1.3.0 — 2026-03-01”/mx:releasecommand — one-step release that bumps version, updates changelog, commits, tags, pushes, and creates GitHub release. Skips if nothing to release.
Changed
Section titled “Changed”/mx:helpupdated with/mx:releasecommand in RELEASE section and “Ready to release” path
1.2.0 — 2026-03-01
Section titled “1.2.0 — 2026-03-01”- Documentation site at joshtune.github.io/mx-workflow with command guides, agent references, and getting started tutorials (EIT-57)
- Smart pipeline routing for
/mx:loop— auto-classifies tickets into Bug Fix [A], Feature [B], Simple/Docs [C], or Refactor [D] pipelines with tailored sub-agent workflows (EIT-58) --branch-per-ticketmode for/mx:loop— creates isolated branches with auto-PR creation viagh pr createper ticket (EIT-59)- Per-ticket pipeline override syntax (e.g.,
EIT-42:A) for/mx:loop
Changed
Section titled “Changed”/mx:looppre-flight summary now shows pipeline classification per ticket/mx:loopfinal report includes pipeline breakdown stats, branch names, and PR URLs/mx:helpupdated with new/mx:loopflags and pipeline routing
1.1.1 — 2026-03-01
Section titled “1.1.1 — 2026-03-01”Changed
Section titled “Changed”- Add
/mx:prefix to all commands in/mx:helpreference card for consistency
1.1.0 — 2026-03-01
Section titled “1.1.0 — 2026-03-01”/mx:loopcommand — sequential ticket processor that fetches Linear tickets and processes them one-by-one via sub-agents (EIT-49 prerequisite)/mx:prcommand — create PRs with auto-generated summaries and agent review findings (EIT-28)/mx:branchcommand — ticket-encoded branch creation usingMX_BRANCH_PATTERN(EIT-29)/mx:agentscommand — discover available agents with purposes and command references (EIT-30)/mx:depscommand — dependency security audit, outdated version checks, and unused package detection (EIT-31)/mx:versioncommand — centralized version management across plugin.json, marketplace.json, and CHANGELOG.md (EIT-36)mx-performance-auditoragent — performance analysis covering algorithmic complexity, memory, I/O, frontend, and database patterns (EIT-32)--dry-runflag for/mx:shipit— preview what would be committed and pushed without actually doing it (EIT-33)mx-comment-analyzerintegrated into/mx:implementreview pass for comment quality checks (EIT-41)- Getting Started walkthrough in README — 7-step first-session guide (EIT-37)
- Troubleshooting section in README — 6 common failure modes with solutions (EIT-38)
- Example project configurations in scope-mappings for frontend SPA, backend API, monorepo, and CLI tool (EIT-39)
- PRD vs Plan usage clarification in README (EIT-40)
- Database rollback/cleanup guidance in
/mx:e2e(EIT-42) - CHANGELOG.md following Keep a Changelog format (EIT-49)
- Audited and fixed
allowed-toolsdeclarations across 5 commands — added missing tools, removed unused ones (EIT-35)
Changed
Section titled “Changed”- Version management documented in CLAUDE.md now references
/mx:versioncommand /mx:helpupdated with all new commands across IMPLEMENTATION, DISCOVERY, RELEASE, and ANYTIME sections
1.0.1 — 2026-02-28
Section titled “1.0.1 — 2026-02-28”- Replace non-standard “ultrathink” language with clear instructions in check-ignores command (EIT-26)
- Standardize
.agents/output directory naming to all-lowercase-hyphenated format (EIT-34)
Changed
Section titled “Changed”- Document output directory convention in CLAUDE.md
1.0.0 — 2026-02-27
Section titled “1.0.0 — 2026-02-27”- 15 slash commands for the full dev lifecycle: ticket intake, planning, implementation, quality checks, conventional commits, MR creation, batch AI implementation, and multi-agent team builds
- 6 specialized agents for code review, testing, debugging, and analysis
- Plugin manifest (
plugin.json) and marketplace configuration - CLAUDE.md with project development guidelines
- Scope mappings and agent browser references