mddesign

One-shot wiring check for MDDesign. Verifies planning-with-files, DESIGN.md, code-memory-router, and Google linter are all reachable. Surfaces any missing piece with a one-line fix-it. Read-only.

Audit DESIGN.md against the actual code. Writes DESIGN.md.critique.md adjacent to DESIGN.md with five audit passes structural / drift / accessibility / completeness / consistency. Each finding has a stable id and a /mddesign:fix suggestion.

Deep diagnostic. Checks every MDDesign dependency, verifies hooks fire, validates the lint toolchain, tests scratch directory write, and prints a fix-it for every failure. Use when something is broken or before publishing to confirm a clean install.

Dispatch a phase to a specialist subagent via PhaseSpec v1. Auto-picks the subagent if not specified. HITL gated before dispatch. Result appended to progress.md under "Phase <id> Result".

Apply a single safe quick win from DESIGN.md.critique.md. HITL gated. Re-lints DESIGN.md after every edit; reverts if lint regresses.

Long-running codebase scan. Extracts de-facto design tokens from existing UI code, clusters them by frequency, names them, returns a draft DESIGN.md body conforming to the Google Labs spec. Dispatched by /mddesign:harvest.

Consumes one PhaseSpec v1 and runs it end to end. Reads referenced files itself. Returns a structured result. Default subagent for /mddesign:team dispatch.

Triggered on Stop. Classifies recent session output into scratch / WHERE / WHY tiers. Returns a list of WHY-promotion candidates with verbatim quotes and proposed MemPalace drawer paths. HITL gates the actual promotion.

Drafts a PhaseSpec v1 from a phase in task_plan.md. Read-only on planning files; returns the spec as text.

HITL surrogate. Audits an executor's structured result against the PhaseSpec done_when criteria. Returns approve, reject, or escalate. Read-only.

Continuously bridges DESIGN.md into the active planning phase. When the user is working on a UI phase, reads the project's DESIGN.md, extracts the relevant token slice, and appends it to findings.md under "## Design Context" so the agent sees design constraints in its attention window. Never edits DESIGN.md, never edits task_plan.md. Idles when DESIGN.md is absent.

Harvests a DESIGN.md from an existing codebase, critiques it against the actual code, and applies safe quick-win fixes. Three modes harvest / critique / fix. Shells out to `npx @google/design.md lint` for structural validation; never reimplements Google's linter. The on-ramp that makes DESIGN.md adoptable for every existing repo, not just greenfield projects.

Three-tier memory layer for the orchestrator. Routes scratch (file-tier), WHERE (QMD), and WHY (MemPalace) through the existing code-memory-router slash command. Never edits planning files directly. Every WHY-tier promotion goes through the HITL gate.

Makes sessions durable across `/clear`, machine reboots, and IDE switches. SessionStart catchup pulls scratch + last MemPalace recall + planning files into context. Stop promotion writes a handoff note and runs memory-keeper. Manual `/mddesign:handoff` re-runs either at any time.

Turns a plan phase into a PhaseSpec v1 and dispatches it to a specialist subagent via the Agent tool. Subagent reads files itself, returns a structured result, the result is logged into progress.md. Markdown is the shared state; no in-memory shared store across agents.

4 hooks across 4 events