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.

Force a session catchup or a memory promotion outside the hook lifecycle. Default is catchup (read-only); promote is HITL gated.

Scan the current codebase, cluster de-facto design tokens, write a structurally valid DESIGN.md at project root. Uses the design-archeologist subagent for the scan. Validates with npx @google/design.md lint and iterates until valid.

Manual one-shot inject of relevant DESIGN.md tokens into the current phase's findings.md "## Design Context" section. Useful before starting a UI subtask.

Save or recall via the three-tier memory layer. Routes to scratch (file-tier), WHERE (QMD via code-memory-router), or WHY (MemPalace via code-memory-router). Every WHY-tier write goes through the HITL gate.

Walk the user through installing every MDDesign dependency. Detects what is missing, prints exact install commands for the current platform, and verifies after each step. Safe to run multiple times.

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