design-playbook 0.9.2 → 0.11.0

package/LICENSE

@@ -1,28 +1,28 @@
-MIT License
-
-Copyright (c) 2026 Bandersnatch0x and contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-This LICENSE covers only the authored materials in this package (skills,
-commands, plugin metadata, and self-written examples). It does not grant
-rights to any third-party playbook manuscript, figures, or trademarks that may
-exist elsewhere in a parent monorepo for learning purposes.
+MIT License
+
+Copyright (c) 2026 Bandersnatch0x and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This LICENSE covers only the authored materials in this package (skills,
+commands, plugin metadata, and self-written examples). It does not grant
+rights to any third-party playbook manuscript, figures, or trademarks that may
+exist elsewhere in a parent monorepo for learning purposes.

package/NOTICE

@@ -1,37 +1,37 @@
-# NOTICE
-
-design-playbook is an original agent plugin (skills, commands, plugin metadata,
-workflow docs, and self-authored examples), licensed under MIT (see `LICENSE`).
-
-It is **not** a port, overlay, or redistribution of any third-party design
-playbook's manuscript, figures, brand marks, or demo site. No rights to such
-materials are claimed or granted here.
-
-The `native-craft` skill is a derivative of yetone/native-feel-skill (MIT). We
-authored our own Design I/O leaf and condensed its decision gate and native
-conventions audit in our own voice; the full depth (WebView survival, IPC
-contract, memory truths, Raycast evidence) remains in the original skill, which
-users may install separately. The MIT License of the original is reproduced
-below in full, as required for derivative works:
-
-  The MIT License (MIT)
-
-  Copyright (c) 2026 yetone
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to deal
-  in the Software without restriction, including without limitation the rights
-  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-  copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in all
-  copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-  SOFTWARE.
+# NOTICE
+
+design-playbook is an original agent plugin (skills, commands, plugin metadata,
+workflow docs, and self-authored examples), licensed under MIT (see `LICENSE`).
+
+It is **not** a port, overlay, or redistribution of any third-party design
+playbook's manuscript, figures, brand marks, or demo site. No rights to such
+materials are claimed or granted here.
+
+The `native-craft` skill is a derivative of yetone/native-feel-skill (MIT). We
+authored our own Design I/O leaf and condensed its decision gate and native
+conventions audit in our own voice; the full depth (WebView survival, IPC
+contract, memory truths, Raycast evidence) remains in the original skill, which
+users may install separately. The MIT License of the original is reproduced
+below in full, as required for derivative works:
+
+  The MIT License (MIT)
+
+  Copyright (c) 2026 yetone
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.

package/README.md

@@ -9,7 +9,7 @@ Declarations + contracts — not a style CSV pack. Compose with [ui-ux-pro-max](
 Path of record (published) - the marketplace catalog lives at the **repo root**, not in this package:
 
 ```text
-/plugin marketplace add <owner>/<repo>
+/plugin marketplace add https://github.com/Bandersnatch0x/design-playbook.git
 /plugin install design-playbook@design-playbook
 ```
 
@@ -55,6 +55,7 @@ After install, skills and commands are **namespaced** by the plugin name:
 | `/design-playbook:design-io` | Full pipeline command |
 | `/design-playbook:ux-spec` | Spec-only command |
 | `/design-playbook:ui-review` | Review command |
+| `/design-playbook:run-review` | Cross-run review command |
 
 Bare `/design-io` is **not** the installed name — always use the `design-playbook:` prefix.
 
@@ -72,7 +73,7 @@ pi has no plugin namespace — skills are `/skill:<name>`, commands are bare `/<
 | --- | --- |
 | `/skill:design-playbook` | Orchestrator skill (model-invoked) |
 | `/skill:ux-spec` … `/skill:ui-evaluator` | Same eight skills as above |
-| `/design-io` · `/ux-spec` · `/ui-review` | Pipeline / spec-only / review commands |
+| `/design-io` · `/ux-spec` · `/ui-review` · `/run-review` | Pipeline / spec-only / review / cross-run commands |
 
 pi ships no built-in MCP, so `preview*` and `observe*` skip by default (ADR-0009 absent→skip; the pipeline still runs spec → picker → fill → craft → accept). To enable both gates, install an MCP adapter and register the bundled servers in your project `.mcp.json`:
 
@@ -116,7 +117,7 @@ pi install npm:pi-mcp-adapter
 .mcp.json              ← bundled MCP servers, launched via ${CLAUDE_PLUGIN_ROOT} (ADR-0009)
 mcp/{preview,evidence}/← MCP adapter runtimes (preview_prototype / execute_capture_plan)
 skills/<name>/SKILL.md ← model-invoked skills
-commands/<name>.md     ← slash commands (design-io, ux-spec, ui-review only)
+commands/<name>.md     ← slash commands (design-io, ux-spec, ui-review, run-review)
 codex/AGENTS.md        ← Codex bridge notes
 examples/              ← self-authored onboarding samples
 LICENSE · NOTICE       ← authored-only scope

package/commands/run-review.md

@@ -0,0 +1,30 @@
+---
+description: Cross-run review of Design I/O runs — gate table + repeat blockers
+---
+
+Cross-run **run review** over `.scratch/<run>/` dirs in the user project. Not a step of a single Design I/O run. Markdown only; report header **`run-review/v1`**.
+
+## Discover
+
+Scan user-side `.scratch/<run>/` (not monorepo `dogfood/*` globs). **Include** only dirs that have `point-back.md` (one table row each). List dirs without `point-back.md` as skipped + reason — they contribute **0** rows. If runs-with-point-back **< 2**, refuse and report that N.
+
+## Report (tables, in order)
+
+1. **Inclusion manifest** first: `path | status` (`included` / `skipped` + reason). Note: hash match ≠ honest transcription of `observed`.
+2. **Per-run table** — mandatory **run-path** column; other columns as needed; **gate** from real `validate_run.py` exit when the script is present (plugin install: `packages/design-playbook/scripts/validate_run.py` per run); else literal `not checked`. **Never** infer ok from "artifacts look complete".
+3. **Repeat blockers** — pure frequency table `count | runs | observed text` (verbatim first-seen text). A **repeat blocker** is the same normalized `observed` text recurring across runs (**counting, not judging**). Rows only where ledger `result != pass`. Grouping key = `observed` **casefold + whitespace-collapsed**, then **char-for-char** equality only; `count ≥ 2`. Literal differences stay separate; optional `similar:` pointer line, never merge counts. **`_none_` is normal** when nothing qualifies (do not loosen normalization to manufacture repeats).
+4. **Point-back** cites: path + verbatim `observed:` quote; no line numbers.
+5. Rollup numbers derived **row-by-row** from the tables above — no "overall it seems".
+
+Ledger row shape: **ui-evaluator** step 2 (do not restate).
+
+```
+禁止:
+- no new run ledger
+- no prose lessons / narrative "learning"
+- no auto-writeback to baseline
+- no semantic clustering of observed — verbatim grouping only
+```
+
+Scope:
+$ARGUMENTS

package/commands/ui-review.md

@@ -1,8 +1,8 @@
----
-description: Declaration-backed UI review with point-back findings
----
-
-Run skill **ui-evaluator** (pull craft-guard checks when AI slop/motion/loading is in scope). Output issue/source/fix/severity; blocking first.
-
-Scope:
-$ARGUMENTS
+---
+description: Declaration-backed UI review with point-back findings
+---
+
+Run skill **ui-evaluator** (pull craft-guard checks when AI slop/motion/loading is in scope). Output issue/source/fix/severity; blocking first.
+
+Scope:
+$ARGUMENTS

package/commands/ux-spec.md

@@ -1,8 +1,8 @@
----
-description: Six-layer spec.md only (stop before UI shell/code)
----
-
-Run skill **ux-spec** only. Emit complete `spec.md`. Do not pick templates or write UI.
-
-Request:
-$ARGUMENTS
+---
+description: Six-layer spec.md only (stop before UI shell/code)
+---
+
+Run skill **ux-spec** only. Emit complete `spec.md`. Do not pick templates or write UI.
+
+Request:
+$ARGUMENTS