ai-design-context 0.4.0

package/evidence/todo/2026-09-28-codex-paired-todo/common/review-context.json

@@ -0,0 +1,550 @@
+{
+  "query": {
+    "mode": "review",
+    "value": "REF-00001",
+    "platform": null,
+    "intent": "qa"
+  },
+  "anchors": [
+    {
+      "id": "REF-00001",
+      "alias": "REF-TODO-BENCHMARK",
+      "title": "Todo App Benchmark Reference Project",
+      "type": "reference_project",
+      "status": "draft",
+      "maturity": "reviewed",
+      "path": "examples/todo-app-benchmark.md",
+      "reason": {
+        "kind": "match",
+        "field": "id",
+        "terms": [
+          "ref",
+          "00001"
+        ]
+      }
+    }
+  ],
+  "objects": [
+    {
+      "id": "RESEARCH-00001",
+      "alias": "TELEGRAM",
+      "title": "Telegram",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/products/telegram.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00001",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00002",
+      "alias": "THINGS-3",
+      "title": "Things 3",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/products/things-3.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00001",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00003",
+      "alias": "APPLE-REMINDERS",
+      "title": "Apple Reminders",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/products/apple-reminders.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00001",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00004",
+      "alias": "LINEAR",
+      "title": "Linear",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/products/linear.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00008",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00005",
+      "alias": "ARC",
+      "title": "Arc",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/products/arc.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00004",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00006",
+      "alias": "TEXTUAL-ERROR-RECOVERY",
+      "title": "Textual Error Recovery",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/accessibility/textual-error-recovery.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00010",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00007",
+      "alias": "RESERVED-LOADING-SPACE",
+      "title": "Reserved Loading Space",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/performance/reserved-loading-space.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00011",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00008",
+      "alias": "KEYBOARD-FOCUS-AND-MOTION",
+      "title": "Keyboard Focus And Interaction Motion",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/accessibility/keyboard-focus-and-interaction-motion.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00012",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00009",
+      "alias": "EXPRESSIVE-SYSTEM-UI-2026",
+      "title": "Expressive System UI In 2026",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/visual/expressive-system-ui-2026.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00014",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RESEARCH-00010",
+      "alias": "MOTION-AS-STATE-CONTINUITY",
+      "title": "Motion As State Continuity",
+      "type": "research",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "research/ux/motion-as-state-continuity.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "RULE-00015",
+        "relationship": "derived_from"
+      }
+    },
+    {
+      "id": "RULE-00001",
+      "alias": "PRD-001",
+      "title": "Daily Actions First",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/product/PRD-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00002",
+      "alias": "PRD-002",
+      "title": "Low-Friction Capture Before Organization",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/product/PRD-002.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00002",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00003",
+      "alias": "IA-001",
+      "title": "One Stable Home Surface",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ia/IA-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00004",
+      "alias": "IA-002",
+      "title": "Define The Object Model Before Screens",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ia/IA-002.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00005",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00005",
+      "alias": "UX-001",
+      "title": "Thumb-Zone Primary Actions",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ux/UX-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00002",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00006",
+      "alias": "UX-002",
+      "title": "Progressively Disclose Power",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ux/UX-002.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00007",
+      "alias": "UX-003",
+      "title": "Preserve Context During Inspection",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ux/UX-003.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00005",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00008",
+      "alias": "VIS-001",
+      "title": "Semantic Tokens Only",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/visual/VIS-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00009",
+      "alias": "A11Y-001",
+      "title": "44x44 Touch Targets",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/accessibility/A11Y-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00010",
+      "alias": "A11Y-002",
+      "title": "Textual Input Error Recovery",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/accessibility/A11Y-002.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00002",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00011",
+      "alias": "PERF-001",
+      "title": "Reserve Layout Space For Asynchronous Content",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/performance/PERF-001.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00002",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00012",
+      "alias": "A11Y-003",
+      "title": "Visible Keyboard Focus",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/accessibility/A11Y-003.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00002",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00013",
+      "alias": "A11Y-004",
+      "title": "Reduce Non-Essential Interaction Motion",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/accessibility/A11Y-004.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00005",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00014",
+      "alias": "VIS-002",
+      "title": "Keep Expression Subordinate To Content",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/visual/VIS-002.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "RULE-00015",
+      "alias": "UX-004",
+      "title": "Use Motion To Explain State Continuity",
+      "type": "rule",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "rules/ux/UX-004.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "PAT-00005",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "PAT-00001",
+      "alias": "PAT-001",
+      "title": "Daily Home Surface",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/daily-home-surface.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PAT-00002",
+      "alias": "PAT-002",
+      "title": "Quick Capture",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/quick-capture.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PAT-00003",
+      "alias": "PAT-003",
+      "title": "Mobile Primary Action",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/mobile-primary-action.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PAT-00004",
+      "alias": "PAT-004",
+      "title": "Progressive Detail",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/progressive-detail.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PAT-00005",
+      "alias": "PAT-005",
+      "title": "Context-Preserving Preview",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/context-preserving-preview.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PAT-00006",
+      "alias": "PAT-006",
+      "title": "Object Status List",
+      "type": "pattern",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "patterns/object-status-list.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PROMPT-00003",
+      "alias": "PROMPT-TODO-BENCHMARK",
+      "title": "Todo App Benchmark Prompt",
+      "type": "prompt",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "prompts/TODO_APP_BENCHMARK.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REF-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "PROMPT-00005",
+      "alias": "PROMPT-DESIGN-EVIDENCE-REVIEW",
+      "title": "Design Evidence Review Prompt",
+      "type": "prompt",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "prompts/DESIGN_EVIDENCE_REVIEW.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REVIEW-00001",
+        "relationship": "implements"
+      }
+    },
+    {
+      "id": "CHECK-00001",
+      "alias": "CHECK-DESIGN-QA",
+      "title": "Design QA Checklist",
+      "type": "checklist",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "checklists/DESIGN_QA.md",
+      "reason": {
+        "kind": "dependency",
+        "source": "REVIEW-00001",
+        "relationship": "requires"
+      }
+    },
+    {
+      "id": "REF-00001",
+      "alias": "REF-TODO-BENCHMARK",
+      "title": "Todo App Benchmark Reference Project",
+      "type": "reference_project",
+      "status": "draft",
+      "maturity": "reviewed",
+      "path": "examples/todo-app-benchmark.md",
+      "reason": {
+        "kind": "match",
+        "field": "id",
+        "terms": [
+          "ref",
+          "00001"
+        ]
+      }
+    },
+    {
+      "id": "REVIEW-00001",
+      "alias": "REVIEW-TODO-BENCHMARK",
+      "title": "Todo App Benchmark Reference Review",
+      "type": "review",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "reviews/todo-app-benchmark-reference-review.md",
+      "reason": {
+        "kind": "review",
+        "source": "REF-00001",
+        "relationship": "validates"
+      }
+    },
+    {
+      "id": "REVIEW-00002",
+      "alias": "REVIEW-TODO-RUNNABLE-FIXTURE",
+      "title": "Todo Runnable Fixture Review",
+      "type": "review",
+      "status": "draft",
+      "maturity": "seed",
+      "path": "reviews/todo-reference-fixture-review.md",
+      "reason": {
+        "kind": "review",
+        "source": "REF-00001",
+        "relationship": "validates"
+      }
+    }
+  ]
+}

package/evidence/todo/2026-09-28-codex-paired-todo/common/seed.json

@@ -0,0 +1,86 @@
+[
+  {
+    "id": "t01",
+    "title": "Book dentist appointment",
+    "notes": "Ask about a morning appointment.",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t02",
+    "title": "Pick up parcel",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t03",
+    "title": "Reply to Maya",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t04",
+    "title": "Pay electricity bill",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t05",
+    "title": "Fix bicycle light",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t06",
+    "title": "Water the plants",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t07",
+    "title": "Read chapter twelve",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t08",
+    "title": "Plan weekend walk",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t09",
+    "title": "Return library book",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t10",
+    "title": "Take out recycling",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t11",
+    "title": "Order coffee beans",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": false
+  },
+  {
+    "id": "t12",
+    "title": "Stretch for ten minutes",
+    "notes": "",
+    "dueDate": "2026-09-28",
+    "completed": true
+  }
+]

package/evidence/todo/2026-09-28-codex-paired-todo/common/setup.json

@@ -0,0 +1,47 @@
+{
+  "status": "completed",
+  "scenario": "Todo App",
+  "scenario_sha256": "368b10d4e3db8850d282010560e96e520b87737bc014a0385c30c45fd5b68f3d",
+  "brief_sha256": "5b35c4e957e106467c870fa10e70132cad6ef03fb7a390ad6edfdcfea7526ff7",
+  "seed_sha256": "09426e774f630cf8d673ade4a30c049d5e2e98ad661160e1ba71db85416728b4",
+  "knowledge_commit": "3d9a6a70c47b7008a47dafd24a4aeef2855b07f2",
+  "knowledge_patch_sha256": "a26da973623d431c7258c64c7092352b03bce590154763be67b20cfabb90a03a",
+  "model": "Inherited Codex session model; exact backend model identifier not exposed",
+  "provider": "OpenAI",
+  "sampling": "Not exposed; inherited identically, no model or reasoning override",
+  "generation_surface": "Codex collaboration.spawn_agent; fork_turns=none; worker role",
+  "time_budget_minutes": 10,
+  "allowed_generation_tools": [
+    "filesystem read/write",
+    "shell syntax checks"
+  ],
+  "disallowed_generation_tools": [
+    "network",
+    "browser",
+    "other agents"
+  ],
+  "implementation_target": "Static HTML/CSS/JavaScript; no build dependencies or external assets",
+  "viewports": [
+    {
+      "name": "mobile",
+      "width": 390,
+      "height": 844
+    },
+    {
+      "name": "desktop",
+      "width": 1440,
+      "height": 900
+    }
+  ],
+  "device_scale_factor": 1,
+  "evaluator": "Codex parent agent; internal, unblinded evaluation",
+  "isolation": "Prompt-enforced separate directories and fresh conversation; shared host, tools, and inherited system instructions. No OS-level read isolation.",
+  "browser_version": "153.0.8010.53",
+  "browser_mode": "Headless Chrome, narrow/desktop viewports, no physical mobile keyboard emulation",
+  "color_scheme": "light",
+  "zoom": "100%",
+  "blinded": false,
+  "browser_locale": "en-GB",
+  "evaluation_type": "internal, unblinded, one pair",
+  "playwright_cli_version": "0.1.21"
+}

package/evidence/todo/2026-09-28-codex-paired-todo/common/technical-envelope.md

@@ -0,0 +1,11 @@
+Implement the brief below in your owned output directory: ${OUTPUT_DIR}
+
+You are not alone in the workspace. Never modify, revert, or inspect the other run's files. Do not spawn agents. Use a fresh implementation. You own only this output directory. Work independently with a maximum of 10 minutes from starting this task; record elapsed time and stop with the current output if the budget expires.
+
+Shared technical envelope:
+- Static index.html, styles.css, app.js; no dependencies, frameworks, build step, external fonts/images/assets, network or browser tools. Filesystem and shell syntax checks only. Parent will render both frozen outputs afterward.
+- Use the exact deterministic task data from ${RUN_ROOT}/common/seed.json; localStorage persistence is allowed. Treat 2026-09-28 as today for the initial seed. Do not edit the common inputs.
+- Expose non-product testing hooks on window.__benchmark: reset('seed'|'empty') resets local data and renders; setSaveDelay(milliseconds) sets delay for later save operations; failNextSave() makes the next save fail exactly once; getState() returns a serializable snapshot including tasks. Default delay is 500 ms. Hooks are evaluator-only, not visible product controls.
+- Document hook usage, exact state reproduction, local serving, checks, known limitations, and actual sources read in GENERATION_NOTES.md. Do not assign scores or claim rendered validation.
+- Include empty, loading, failed-save and successful-save states. The evaluator will use the same viewports (390x844 and 1440x900), data and sequences. Decide the UI and interactions yourself from the brief.
+- Save only your own application and notes. Do not inspect an existing implementation or another run's output. Do not modify repository tooling or knowledge files.