Plugin sync from amirlehmam/wmux 0.6.2. Fixes the critical MSYS path bug on Windows and adds two major features for multi-agent coordination.

What's new

Phase 4.5 — Contract Detection & Generation (cross-agent drift prevention)

The orchestrate skill now detects coupling between parallel agents (HTML+CSS, schema+consumer, API client+server, shared modules) and generates a shared contract file at {orch-dir}/wave-{N}-contract.md before spawning. Every coupled agent's prompt gets a "READ BEFORE WRITING ANY CODE" block pointing to that file.

Fixes the naming-drift class of bugs: on a previous run, two parallel agents independently invented different class names (.hero__grid vs .hero__inner) for the same elements, and 510 lines of alias CSS had to be written to reconcile. With contract files, both agents read from the same source of truth and use names verbatim.

The decomposition-guide.md reference now includes a Coupling Detection section with strong/weak/no-coupling categories and a resolution flowchart: merge into one agent, sequence across waves, or generate a contract file.

Intelligent pane layout (requires wmux 0.6.2+)

spawn-agents.sh now calls wmux layout grid --count N once instead of cascading wmux split --right / split --down. For 4 agents (orchestrator + 3) you get a clean 2×2 grid. For 9 agents, a 3×3. Etc. One atomic split-tree mutation, deterministic row-major ordering, no more T-shape cascade.

Fallback ANSI dashboard for non-wmux mode

New scripts/dashboard-text.js prints a truecolor ANSI-art dashboard into Claude Code's conversation at wave transitions when running in degraded mode (no wmux available). Shows task, elapsed time, per-wave progress bars, per-agent state with braille spinners and box-drawing chars.

When running under wmux 0.6.2+, the wmux sidebar shows an equivalent (richer) live cockpit automatically — no action needed by the orchestrator.

Critical fix: MSYS path conversion

spawn-agents.sh now uses a winpath() helper that calls cygpath -m on Windows to convert MSYS paths (/c/Users/...) to mixed Windows form (C:/Users/...) before passing them to wmux agent spawn --cmd. Fixes the Cannot find module 'C:\c\Users\...' spawn failures that broke orchestration on Windows.

Install

As a Claude Code plugin, this plugin is published via the Claude Code plugin system. Users of wmux 0.6.2+ get it automatically — wmux ships this plugin bundled and auto-installs it into ~/.claude/plugins/cache/ on first run.

To install standalone via Claude Code plugin manager, point it at this repo's .claude-plugin/marketplace.json.

Changes

• 8 files changed, 599 insertions(+), 59 deletions(-)
• New files: scripts/dashboard-text.js, scripts/launch-agent.js
• Updated: plugin.json (0.1.0 → 0.1.1), spawn-agents.sh, on-agent-stop.sh, SKILL.md (orchestrate + wmux-detect), decomposition-guide.md