git:20260926.3bf7953 to git:20260926.2aeab42

# design-playbook for Codex

## Install (path of record)

Marketplace catalog lives at the **repo root** (same GitHub repo as Claude Code).

```bash

# published

codex plugin marketplace add Bandersnatch0x/design-playbook

codex plugin add design-playbook@design-playbook

# local monorepo (dev)

codex plugin marketplace add <abs-path-to-repo-root>

codex plugin add design-playbook@design-playbook

```

Verify:

```bash

codex plugin list -m design-playbook --available --json

# expect: design-playbook@design-playbook, enabled=true after add

```

Codex-native manifest: `packages/design-playbook/.codex-plugin/plugin.json`

Codex MCP (relative paths, no `CLAUDE_PLUGIN_ROOT`): `.codex-plugin/mcp.json`

Skills: `packages/design-playbook/skills/*`

## Fallback: skills-only install

If you only want skills under `~/.codex/skills` (no plugin marketplace):

```bash

# from repo root — copies/symlinks skill trees into ~/.codex/skills

python packages/design-playbook/codex/install_skills.py --force

# or @-reference a single skill:

# @packages/design-playbook/skills/design-playbook/SKILL.md

```

Register MCP directly (fallback when `codex plugin add` is unavailable):

`codex plugin add` depends on a healthy codex marketplace subsystem. If `codex doctor`

or `codex plugin marketplace list` fails (e.g. a stale marketplace source path), register

the servers directly in `~/.codex/config.toml` (or your `CODEX_HOME`):

```toml

# ~/.codex/config.toml (or $CODEX_HOME/config.toml)

[mcp_servers.design-playbook-preview]

command = "python"

args = ["<abs>/packages/design-playbook/mcp/preview/server.py"]

[mcp_servers.design-playbook-evidence]

command = "python"

args = ["<abs>/packages/design-playbook/mcp/evidence/server.py"]

# evidence also needs: pip install playwright && playwright install chromium

```

Verify: `codex mcp list` should list both. `preview*` needs a system Edge/Chrome (the

adapter spawns it via `--app=`); `observe*` needs Playwright + Chromium.

> **`preview*` skips when `preview_prototype` is absent; G5 is not triggered.**

> Follow the orchestrator's skip narration to report the reason and enable path.

> This is designed skip behaviour, not a crash. Confirm the tool is registered

> (`codex mcp list`) before treating it as a preview failure. Codex end-to-end preview

> smoke is not yet validated (v0.4.4 deferred the codex E2E smoke; only evidence/G6 was

> server-level smoked).

## Load order

Read `skills/design-playbook/SKILL.md` first. Its **Run profile** and **Steps**

sections are the sole authority for stage order, conditional entry, and completion

criteria. Consume the `run_profile.py route` result as directed there; this bridge

does not define a second route or a host-specific sequence.

For optional adapters, follow the orchestrator's **Steps** preamble and

`skills/design-playbook/references/load-map.md` pointers. Use its one-line skip

narration when a stage does not run, including the reason and enable path.

Audit preferences (ADR-0033) apply identically on Codex. Follow `skills/design-playbook/SKILL.md` § *Audit preferences* as sole authority; this bridge adds no host-specific preference rules.

## Compose

- Style DB → ui-ux-pro-max

- Visual risk → frontend-design

- Pipeline + acceptance → design-playbook