ai-design-context 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (288) hide show
  1. package/AGENTS.md +156 -0
  2. package/CHANGELOG.md +71 -0
  3. package/CODE_OF_CONDUCT.md +29 -0
  4. package/CONTRIBUTING.md +128 -0
  5. package/LICENSE +21 -0
  6. package/README.md +283 -0
  7. package/RELEASE_NOTES_v0.1.0.md +45 -0
  8. package/RELEASE_NOTES_v0.3.0.md +47 -0
  9. package/RELEASE_NOTES_v0.4.0.md +29 -0
  10. package/RELEASE_READINESS.md +107 -0
  11. package/ROADMAP.md +60 -0
  12. package/SECURITY.md +40 -0
  13. package/assets/logo.svg +9 -0
  14. package/benchmarks/README.md +19 -0
  15. package/benchmarks/chat.md +37 -0
  16. package/benchmarks/mobile-home-screen.md +38 -0
  17. package/benchmarks/notes-app.md +37 -0
  18. package/benchmarks/settings.md +37 -0
  19. package/benchmarks/shopping-list.md +37 -0
  20. package/benchmarks/todo-app.md +144 -0
  21. package/checklists/DESIGN_QA.md +102 -0
  22. package/checklists/GENERATED_INDEX.md +7 -0
  23. package/docs/AGENT_CONTEXT.md +111 -0
  24. package/docs/BENCHMARK.md +170 -0
  25. package/docs/DESIGNLINT_READINESS.md +110 -0
  26. package/docs/DESIGN_SYSTEM.md +23 -0
  27. package/docs/EVALUATION_RUBRIC.md +154 -0
  28. package/docs/GITHUB_SETUP.md +28 -0
  29. package/docs/GLOSSARY.md +45 -0
  30. package/docs/INDEX.md +109 -0
  31. package/docs/KNOWLEDGE_ENGINE.md +594 -0
  32. package/docs/MOBILE_FIRST.md +18 -0
  33. package/docs/NPM_RELEASE.md +43 -0
  34. package/docs/PATTERN_SPEC.md +113 -0
  35. package/docs/PHILOSOPHY.md +25 -0
  36. package/docs/PRODUCT_THINKING.md +26 -0
  37. package/docs/STYLE_GUIDE.md +49 -0
  38. package/docs/TRACEABILITY.md +45 -0
  39. package/evidence/README.md +64 -0
  40. package/evidence/TEMPLATE.md +46 -0
  41. package/evidence/chat/.gitkeep +1 -0
  42. package/evidence/mobile-home/.gitkeep +1 -0
  43. package/evidence/notes/.gitkeep +1 -0
  44. package/evidence/settings/.gitkeep +1 -0
  45. package/evidence/shopping/.gitkeep +1 -0
  46. package/evidence/todo/.gitkeep +1 -0
  47. package/evidence/todo/2026-06-25-codex-gpt-5/EVALUATION.md +66 -0
  48. package/evidence/todo/2026-06-25-codex-gpt-5/README.md +40 -0
  49. package/evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/generated-output.md +163 -0
  50. package/evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/metadata.json +38 -0
  51. package/evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/notes.md +20 -0
  52. package/evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/prompt.md +16 -0
  53. package/evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/scores.md +18 -0
  54. package/evidence/todo/2026-06-25-codex-gpt-5/baseline/generated-output.md +98 -0
  55. package/evidence/todo/2026-06-25-codex-gpt-5/baseline/metadata.json +19 -0
  56. package/evidence/todo/2026-06-25-codex-gpt-5/baseline/notes.md +19 -0
  57. package/evidence/todo/2026-06-25-codex-gpt-5/baseline/prompt.md +9 -0
  58. package/evidence/todo/2026-06-25-codex-gpt-5/baseline/scores.md +18 -0
  59. package/evidence/todo/2026-09-28-codex-paired-todo/EVALUATION.md +70 -0
  60. package/evidence/todo/2026-09-28-codex-paired-todo/README.md +52 -0
  61. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/GENERATION_NOTES.md +133 -0
  62. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/app.js +289 -0
  63. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/context/context-preserving-preview.json +443 -0
  64. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/context/daily-home-surface.json +373 -0
  65. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/context/quick-capture.json +301 -0
  66. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/context/sources-read.txt +36 -0
  67. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/generated-output.md +11 -0
  68. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/index.html +64 -0
  69. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/launch-prompt.md +1 -0
  70. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/metadata.json +55 -0
  71. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/notes.md +15 -0
  72. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/parent-status-message.md +1 -0
  73. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/prompt.md +49 -0
  74. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/runtime-checks.json +776 -0
  75. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/scores.md +20 -0
  76. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-completed.png +0 -0
  77. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-default.png +0 -0
  78. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-detail-reduced-motion.png +0 -0
  79. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-detail.png +0 -0
  80. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-empty.png +0 -0
  81. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-keyboard-focus.png +0 -0
  82. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-save-error.png +0 -0
  83. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-saved.png +0 -0
  84. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-saving.png +0 -0
  85. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/desktop-validation.png +0 -0
  86. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-completed.png +0 -0
  87. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-default.png +0 -0
  88. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-detail-reduced-motion.png +0 -0
  89. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-detail.png +0 -0
  90. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-empty.png +0 -0
  91. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-keyboard-focus.png +0 -0
  92. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-save-error.png +0 -0
  93. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-saved.png +0 -0
  94. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-saving.png +0 -0
  95. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/screenshots/mobile-validation.png +0 -0
  96. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/source-hashes.json +5 -0
  97. package/evidence/todo/2026-09-28-codex-paired-todo/ai-design-rules/styles.css +122 -0
  98. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/GENERATION_NOTES.md +86 -0
  99. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/app.js +303 -0
  100. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/generated-output.md +11 -0
  101. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/index.html +71 -0
  102. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/launch-prompt.md +1 -0
  103. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/metadata.json +55 -0
  104. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/notes.md +15 -0
  105. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/parent-status-message.md +1 -0
  106. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/prompt.md +49 -0
  107. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/runtime-checks.json +772 -0
  108. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/scores.md +20 -0
  109. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-completed.png +0 -0
  110. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-default.png +0 -0
  111. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-detail-reduced-motion.png +0 -0
  112. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-detail.png +0 -0
  113. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-empty.png +0 -0
  114. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-keyboard-focus.png +0 -0
  115. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-save-error.png +0 -0
  116. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-saved.png +0 -0
  117. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-saving.png +0 -0
  118. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/desktop-validation.png +0 -0
  119. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-completed.png +0 -0
  120. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-default.png +0 -0
  121. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-detail-reduced-motion.png +0 -0
  122. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-detail.png +0 -0
  123. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-empty.png +0 -0
  124. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-keyboard-focus.png +0 -0
  125. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-save-error.png +0 -0
  126. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-saved.png +0 -0
  127. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-saving.png +0 -0
  128. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/screenshots/mobile-validation.png +0 -0
  129. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/source-hashes.json +5 -0
  130. package/evidence/todo/2026-09-28-codex-paired-todo/baseline/styles.css +9 -0
  131. package/evidence/todo/2026-09-28-codex-paired-todo/capture-ai-design-rules.js +60 -0
  132. package/evidence/todo/2026-09-28-codex-paired-todo/capture-baseline.js +60 -0
  133. package/evidence/todo/2026-09-28-codex-paired-todo/common/brief.md +35 -0
  134. package/evidence/todo/2026-09-28-codex-paired-todo/common/knowledge-files.json +127 -0
  135. package/evidence/todo/2026-09-28-codex-paired-todo/common/knowledge.patch +890 -0
  136. package/evidence/todo/2026-09-28-codex-paired-todo/common/review-context.json +550 -0
  137. package/evidence/todo/2026-09-28-codex-paired-todo/common/seed.json +86 -0
  138. package/evidence/todo/2026-09-28-codex-paired-todo/common/setup.json +47 -0
  139. package/evidence/todo/2026-09-28-codex-paired-todo/common/technical-envelope.md +11 -0
  140. package/evidence/todo/2026-09-28-codex-paired-todo/layout-metrics.json +133 -0
  141. package/evidence/todo/2026-09-28-codex-paired-todo/layout-probe.js +15 -0
  142. package/examples/GENERATED_INDEX.md +8 -0
  143. package/examples/INDEX.md +16 -0
  144. package/examples/README.md +15 -0
  145. package/examples/consequential-action-confirmation-reference.md +83 -0
  146. package/examples/todo-app-benchmark.md +117 -0
  147. package/examples/todo-reference/README.md +29 -0
  148. package/examples/todo-reference/app.js +154 -0
  149. package/examples/todo-reference/favicon.svg +4 -0
  150. package/examples/todo-reference/index.html +67 -0
  151. package/examples/todo-reference/review-evidence/2026-07-15/desktop-default.png +0 -0
  152. package/examples/todo-reference/review-evidence/2026-07-15/desktop-detail.png +0 -0
  153. package/examples/todo-reference/review-evidence/2026-07-15/mobile-detail.png +0 -0
  154. package/examples/todo-reference/review-evidence/2026-07-15/mobile-error.png +0 -0
  155. package/examples/todo-reference/styles.css +241 -0
  156. package/graph/GENERATED_GRAPH.md +71 -0
  157. package/observations/README.md +23 -0
  158. package/observations/accessibility/reduced-interaction-motion.md +49 -0
  159. package/observations/accessibility/textual-error-recovery.md +50 -0
  160. package/observations/accessibility/visible-keyboard-focus.md +49 -0
  161. package/observations/ai/agent-consequential-action-controls.md +56 -0
  162. package/observations/ai/agent-work-visibility-and-intervention.md +51 -0
  163. package/observations/ai/figma-agent-context-and-skills.md +52 -0
  164. package/observations/finance/high-risk-wallet-recovery-flows.md +55 -0
  165. package/observations/finance/market-interface-adaptive-trading-surfaces.md +55 -0
  166. package/observations/interaction/chrome-scoped-view-transitions.md +52 -0
  167. package/observations/interaction/figma-motion-as-system-capability.md +53 -0
  168. package/observations/mobile/mobile-bottom-sheet-choice-contracts.md +55 -0
  169. package/observations/performance/reserved-loading-space.md +51 -0
  170. package/observations/product-repos/pinned-ai-design-rules-integration.md +49 -0
  171. package/observations/visual/apple-liquid-glass-functional-layer.md +52 -0
  172. package/observations/visual/chrome-content-first-adaptive-ui.md +51 -0
  173. package/observations/visual/material-3-expressive-system.md +52 -0
  174. package/package.json +65 -0
  175. package/patterns/GENERATED_INDEX.md +13 -0
  176. package/patterns/INDEX.md +41 -0
  177. package/patterns/README.md +5 -0
  178. package/patterns/consequential-action-confirmation.md +127 -0
  179. package/patterns/context-preserving-preview.md +145 -0
  180. package/patterns/daily-home-surface.md +134 -0
  181. package/patterns/mobile-primary-action.md +110 -0
  182. package/patterns/object-status-list.md +114 -0
  183. package/patterns/progressive-detail.md +113 -0
  184. package/patterns/quick-capture.md +132 -0
  185. package/prompts/CONSEQUENTIAL_ACTION_REVIEW.md +100 -0
  186. package/prompts/DESIGN_EVIDENCE_REVIEW.md +49 -0
  187. package/prompts/GENERATED_INDEX.md +11 -0
  188. package/prompts/INDEX.md +24 -0
  189. package/prompts/PROTOTYPE_REVIEW.md +189 -0
  190. package/prompts/QUICK_CAPTURE_STATE_REVIEW.md +74 -0
  191. package/prompts/TODO_APP_BENCHMARK.md +88 -0
  192. package/registry/objects.json +568 -0
  193. package/registry/relationships.json +972 -0
  194. package/research/GENERATED_INDEX.md +18 -0
  195. package/research/INDEX.md +40 -0
  196. package/research/accessibility/keyboard-focus-and-interaction-motion.md +62 -0
  197. package/research/accessibility/textual-error-recovery.md +57 -0
  198. package/research/performance/reserved-loading-space.md +56 -0
  199. package/research/products/apple-reminders.md +59 -0
  200. package/research/products/arc.md +61 -0
  201. package/research/products/linear.md +62 -0
  202. package/research/products/telegram.md +61 -0
  203. package/research/products/things-3.md +60 -0
  204. package/research/ux/contextual-agentic-interface.md +68 -0
  205. package/research/ux/high-risk-operational-flows.md +89 -0
  206. package/research/ux/motion-as-state-continuity.md +71 -0
  207. package/research/visual/expressive-system-ui-2026.md +75 -0
  208. package/reviews/GENERATED_INDEX.md +9 -0
  209. package/reviews/README.md +25 -0
  210. package/reviews/consequential-action-confirmation-review.md +92 -0
  211. package/reviews/todo-app-benchmark-reference-review.md +86 -0
  212. package/reviews/todo-reference-fixture-review.md +77 -0
  213. package/rules/GENERATED_INDEX.md +23 -0
  214. package/rules/INDEX.md +37 -0
  215. package/rules/accessibility/A11Y-001.md +58 -0
  216. package/rules/accessibility/A11Y-002.md +55 -0
  217. package/rules/accessibility/A11Y-003.md +54 -0
  218. package/rules/accessibility/A11Y-004.md +54 -0
  219. package/rules/ia/IA-001.md +60 -0
  220. package/rules/ia/IA-002.md +61 -0
  221. package/rules/performance/PERF-001.md +55 -0
  222. package/rules/product/PRD-001.md +61 -0
  223. package/rules/product/PRD-002.md +61 -0
  224. package/rules/ux/UX-001.md +58 -0
  225. package/rules/ux/UX-002.md +61 -0
  226. package/rules/ux/UX-003.md +60 -0
  227. package/rules/ux/UX-004.md +61 -0
  228. package/rules/ux/UX-005.md +62 -0
  229. package/rules/ux/UX-006.md +69 -0
  230. package/rules/visual/VIS-001.md +59 -0
  231. package/rules/visual/VIS-002.md +59 -0
  232. package/schema/checklist.schema.json +21 -0
  233. package/schema/common.schema.json +178 -0
  234. package/schema/observation.schema.json +21 -0
  235. package/schema/pattern.schema.json +21 -0
  236. package/schema/prompt.schema.json +21 -0
  237. package/schema/reference-project.schema.json +21 -0
  238. package/schema/research.schema.json +21 -0
  239. package/schema/review.schema.json +21 -0
  240. package/schema/rule.schema.json +21 -0
  241. package/skills/README.md +48 -0
  242. package/skills/accessibility-reviewer/SKILL.md +101 -0
  243. package/skills/agent-context/SKILL.md +34 -0
  244. package/skills/agent-context/agents/openai.yaml +4 -0
  245. package/skills/design-evidence-researcher/SKILL.md +47 -0
  246. package/skills/design-evidence-researcher/agents/openai.yaml +4 -0
  247. package/skills/design-reviewer/SKILL.md +113 -0
  248. package/skills/design-system-architect/SKILL.md +101 -0
  249. package/skills/information-architect/SKILL.md +97 -0
  250. package/skills/interaction-designer/SKILL.md +104 -0
  251. package/skills/knowledge-graph-architect/SKILL.md +96 -0
  252. package/skills/mobile-ux-expert/SKILL.md +105 -0
  253. package/skills/motion-designer/SKILL.md +100 -0
  254. package/skills/performance-reviewer/SKILL.md +97 -0
  255. package/skills/product-designer/SKILL.md +104 -0
  256. package/skills/prompt-architect/SKILL.md +105 -0
  257. package/skills/reference-driven-design/SKILL.md +119 -0
  258. package/skills/ux-reviewer/SKILL.md +99 -0
  259. package/skills/visual-designer/SKILL.md +107 -0
  260. package/starter-kit/AGENTS.md +37 -0
  261. package/starter-kit/BOOTSTRAP.md +13 -0
  262. package/starter-kit/INSTALL_WITH_AGENT.md +133 -0
  263. package/starter-kit/PROJECT_INTEGRATION.md +60 -0
  264. package/starter-kit/README.md +41 -0
  265. package/starter-kit/benchmarks/BENCHMARK_CHECKLIST.md +10 -0
  266. package/starter-kit/docs/DESIGN_DECISIONS.md +22 -0
  267. package/starter-kit/docs/INFORMATION_ARCHITECTURE.md +25 -0
  268. package/starter-kit/docs/PERSONAS.md +14 -0
  269. package/starter-kit/docs/PRD.md +32 -0
  270. package/starter-kit/docs/USER_FLOWS.md +19 -0
  271. package/starter-kit/reviews/DESIGN_REVIEW.md +49 -0
  272. package/starter-kit/templates/FEATURE_TEMPLATE.md +36 -0
  273. package/starter-kit/templates/TASK_TEMPLATE.md +22 -0
  274. package/templates/CHECKLIST_TEMPLATE.md +43 -0
  275. package/templates/OBSERVATION_TEMPLATE.md +41 -0
  276. package/templates/PATTERN_TEMPLATE.md +100 -0
  277. package/templates/PROMPT_TEMPLATE.md +46 -0
  278. package/templates/PROTOTYPE_REVIEW.md +50 -0
  279. package/templates/REFERENCE_PROJECT_TEMPLATE.md +49 -0
  280. package/templates/REVIEW_TEMPLATE.md +55 -0
  281. package/templates/RULE_TEMPLATE.md +57 -0
  282. package/tools/cli.mjs +46 -0
  283. package/tools/context.mjs +342 -0
  284. package/tools/designlint.mjs +77 -0
  285. package/tools/generate-indexes.mjs +621 -0
  286. package/tools/init.mjs +99 -0
  287. package/tools/validate-benchmark-evidence.mjs +248 -0
  288. package/tools/validate-knowledge.mjs +481 -0
@@ -0,0 +1,88 @@
1
+ ---
2
+ id: PROMPT-00003
3
+ alias: PROMPT-TODO-BENCHMARK
4
+ slug: todo-app-benchmark
5
+ title: Todo App Benchmark Prompt
6
+ object_type: prompt
7
+ status: draft
8
+ version: 0.1.0
9
+ category: generation
10
+ tags:
11
+ - prompt
12
+ - benchmark
13
+ - todo
14
+ maturity: seed
15
+ risk_level: medium
16
+ relationships:
17
+ - type: requires
18
+ target: PAT-00001
19
+ - type: requires
20
+ target: PAT-00002
21
+ - type: requires
22
+ target: PAT-00003
23
+ - type: requires
24
+ target: PAT-00004
25
+ - type: requires
26
+ target: PAT-00005
27
+ - type: requires
28
+ target: PAT-00006
29
+ - type: requires
30
+ target: RULE-00001
31
+ - type: requires
32
+ target: RULE-00002
33
+ - type: requires
34
+ target: RULE-00003
35
+ - type: requires
36
+ target: RULE-00004
37
+ - type: requires
38
+ target: RULE-00005
39
+ - type: requires
40
+ target: RULE-00006
41
+ - type: requires
42
+ target: RULE-00007
43
+ - type: requires
44
+ target: RULE-00008
45
+ - type: requires
46
+ target: RULE-00009
47
+ ---
48
+
49
+ # Todo App Benchmark Prompt
50
+
51
+ ## Objective
52
+
53
+ Generate a responsive consumer todo app for the reproducible `benchmarks/todo-app.md` scenario.
54
+
55
+ ## Required Inputs
56
+
57
+ - The exact Todo App benchmark brief.
58
+ - The registered rules and patterns listed in the front matter.
59
+ - The benchmark run metadata required by `docs/BENCHMARK.md`.
60
+
61
+ ## Instruction
62
+
63
+ ```text
64
+ Design and implement a responsive todo app for everyday personal task management.
65
+
66
+ Use AI Design Context from this repository.
67
+
68
+ Follow the knowledge graph:
69
+ research -> rules -> patterns -> prompts -> reference projects -> reviews
70
+
71
+ Use existing rules and patterns only. Do not invent new rules or patterns.
72
+
73
+ The app should let a user add tasks, see today's tasks, complete tasks, and edit details.
74
+
75
+ Prioritize low-friction capture, a stable daily home surface, mobile-first behavior, context-preserving detail, accessible touch targets, and clear empty/loading/error states.
76
+ ```
77
+
78
+ ## Output Contract
79
+
80
+ - Keep the `Task` object and its required fields explicit.
81
+ - Define default, empty, loading, error, and failed-save recovery states.
82
+ - Preserve the same product model across mobile and desktop.
83
+ - Publish the raw output and all benchmark metadata; do not claim a quality improvement without comparative evaluation evidence.
84
+
85
+ ## Source
86
+
87
+ - `benchmarks/todo-app.md`
88
+ - `evidence/todo/2026-06-25-codex-gpt-5/ai-design-rules/prompt.md`
@@ -0,0 +1,568 @@
1
+ {
2
+ "objects": [
3
+ {
4
+ "id": "RESEARCH-00001",
5
+ "alias": "TELEGRAM",
6
+ "slug": "telegram",
7
+ "title": "Telegram",
8
+ "object_type": "research",
9
+ "status": "draft",
10
+ "version": "0.1.0",
11
+ "category": "product",
12
+ "maturity": "seed",
13
+ "path": "research/products/telegram.md"
14
+ },
15
+ {
16
+ "id": "RESEARCH-00002",
17
+ "alias": "THINGS-3",
18
+ "slug": "things-3",
19
+ "title": "Things 3",
20
+ "object_type": "research",
21
+ "status": "draft",
22
+ "version": "0.1.0",
23
+ "category": "product",
24
+ "maturity": "seed",
25
+ "path": "research/products/things-3.md"
26
+ },
27
+ {
28
+ "id": "RESEARCH-00003",
29
+ "alias": "APPLE-REMINDERS",
30
+ "slug": "apple-reminders",
31
+ "title": "Apple Reminders",
32
+ "object_type": "research",
33
+ "status": "draft",
34
+ "version": "0.1.0",
35
+ "category": "product",
36
+ "maturity": "seed",
37
+ "path": "research/products/apple-reminders.md"
38
+ },
39
+ {
40
+ "id": "RESEARCH-00004",
41
+ "alias": "LINEAR",
42
+ "slug": "linear",
43
+ "title": "Linear",
44
+ "object_type": "research",
45
+ "status": "draft",
46
+ "version": "0.1.0",
47
+ "category": "product",
48
+ "maturity": "seed",
49
+ "path": "research/products/linear.md"
50
+ },
51
+ {
52
+ "id": "RESEARCH-00005",
53
+ "alias": "ARC",
54
+ "slug": "arc",
55
+ "title": "Arc",
56
+ "object_type": "research",
57
+ "status": "draft",
58
+ "version": "0.1.0",
59
+ "category": "product",
60
+ "maturity": "seed",
61
+ "path": "research/products/arc.md"
62
+ },
63
+ {
64
+ "id": "RULE-00001",
65
+ "alias": "PRD-001",
66
+ "slug": "daily-actions-first",
67
+ "title": "Daily Actions First",
68
+ "object_type": "rule",
69
+ "status": "draft",
70
+ "version": "0.1.0",
71
+ "category": "product",
72
+ "maturity": "seed",
73
+ "path": "rules/product/PRD-001.md"
74
+ },
75
+ {
76
+ "id": "RULE-00002",
77
+ "alias": "PRD-002",
78
+ "slug": "low-friction-capture-before-organization",
79
+ "title": "Low-Friction Capture Before Organization",
80
+ "object_type": "rule",
81
+ "status": "draft",
82
+ "version": "0.1.0",
83
+ "category": "product",
84
+ "maturity": "seed",
85
+ "path": "rules/product/PRD-002.md"
86
+ },
87
+ {
88
+ "id": "RULE-00003",
89
+ "alias": "IA-001",
90
+ "slug": "one-stable-home-surface",
91
+ "title": "One Stable Home Surface",
92
+ "object_type": "rule",
93
+ "status": "draft",
94
+ "version": "0.1.0",
95
+ "category": "ia",
96
+ "maturity": "seed",
97
+ "path": "rules/ia/IA-001.md"
98
+ },
99
+ {
100
+ "id": "RULE-00004",
101
+ "alias": "IA-002",
102
+ "slug": "define-the-object-model-before-screens",
103
+ "title": "Define The Object Model Before Screens",
104
+ "object_type": "rule",
105
+ "status": "draft",
106
+ "version": "0.1.0",
107
+ "category": "ia",
108
+ "maturity": "seed",
109
+ "path": "rules/ia/IA-002.md"
110
+ },
111
+ {
112
+ "id": "RULE-00005",
113
+ "alias": "UX-001",
114
+ "slug": "thumb-zone-primary-actions",
115
+ "title": "Thumb-Zone Primary Actions",
116
+ "object_type": "rule",
117
+ "status": "draft",
118
+ "version": "0.1.0",
119
+ "category": "ux",
120
+ "maturity": "seed",
121
+ "path": "rules/ux/UX-001.md"
122
+ },
123
+ {
124
+ "id": "RULE-00006",
125
+ "alias": "UX-002",
126
+ "slug": "progressively-disclose-power",
127
+ "title": "Progressively Disclose Power",
128
+ "object_type": "rule",
129
+ "status": "draft",
130
+ "version": "0.1.0",
131
+ "category": "ux",
132
+ "maturity": "seed",
133
+ "path": "rules/ux/UX-002.md"
134
+ },
135
+ {
136
+ "id": "RULE-00007",
137
+ "alias": "UX-003",
138
+ "slug": "preserve-context-during-inspection",
139
+ "title": "Preserve Context During Inspection",
140
+ "object_type": "rule",
141
+ "status": "draft",
142
+ "version": "0.1.0",
143
+ "category": "ux",
144
+ "maturity": "seed",
145
+ "path": "rules/ux/UX-003.md"
146
+ },
147
+ {
148
+ "id": "RULE-00008",
149
+ "alias": "VIS-001",
150
+ "slug": "semantic-tokens-only",
151
+ "title": "Semantic Tokens Only",
152
+ "object_type": "rule",
153
+ "status": "draft",
154
+ "version": "0.1.0",
155
+ "category": "visual",
156
+ "maturity": "seed",
157
+ "path": "rules/visual/VIS-001.md"
158
+ },
159
+ {
160
+ "id": "RULE-00009",
161
+ "alias": "A11Y-001",
162
+ "slug": "44x44-touch-targets",
163
+ "title": "44x44 Touch Targets",
164
+ "object_type": "rule",
165
+ "status": "draft",
166
+ "version": "0.1.0",
167
+ "category": "accessibility",
168
+ "maturity": "seed",
169
+ "path": "rules/accessibility/A11Y-001.md"
170
+ },
171
+ {
172
+ "id": "RESEARCH-00006",
173
+ "alias": "TEXTUAL-ERROR-RECOVERY",
174
+ "slug": "textual-error-recovery",
175
+ "title": "Textual Error Recovery",
176
+ "object_type": "research",
177
+ "status": "draft",
178
+ "version": "0.1.0",
179
+ "category": "accessibility",
180
+ "maturity": "seed",
181
+ "path": "research/accessibility/textual-error-recovery.md"
182
+ },
183
+ {
184
+ "id": "RESEARCH-00007",
185
+ "alias": "RESERVED-LOADING-SPACE",
186
+ "slug": "reserved-loading-space",
187
+ "title": "Reserved Loading Space",
188
+ "object_type": "research",
189
+ "status": "draft",
190
+ "version": "0.1.0",
191
+ "category": "performance",
192
+ "maturity": "seed",
193
+ "path": "research/performance/reserved-loading-space.md"
194
+ },
195
+ {
196
+ "id": "RULE-00010",
197
+ "alias": "A11Y-002",
198
+ "slug": "textual-input-error-recovery",
199
+ "title": "Textual Input Error Recovery",
200
+ "object_type": "rule",
201
+ "status": "draft",
202
+ "version": "0.1.0",
203
+ "category": "accessibility",
204
+ "maturity": "seed",
205
+ "path": "rules/accessibility/A11Y-002.md"
206
+ },
207
+ {
208
+ "id": "RULE-00011",
209
+ "alias": "PERF-001",
210
+ "slug": "reserve-layout-space-for-asynchronous-content",
211
+ "title": "Reserve Layout Space For Asynchronous Content",
212
+ "object_type": "rule",
213
+ "status": "draft",
214
+ "version": "0.1.0",
215
+ "category": "performance",
216
+ "maturity": "seed",
217
+ "path": "rules/performance/PERF-001.md"
218
+ },
219
+ {
220
+ "id": "PAT-00001",
221
+ "alias": "PAT-001",
222
+ "slug": "daily-home-surface",
223
+ "title": "Daily Home Surface",
224
+ "object_type": "pattern",
225
+ "status": "draft",
226
+ "version": "0.2.0",
227
+ "category": "product",
228
+ "maturity": "seed",
229
+ "path": "patterns/daily-home-surface.md"
230
+ },
231
+ {
232
+ "id": "PAT-00002",
233
+ "alias": "PAT-002",
234
+ "slug": "quick-capture",
235
+ "title": "Quick Capture",
236
+ "object_type": "pattern",
237
+ "status": "draft",
238
+ "version": "0.1.0",
239
+ "category": "workflow",
240
+ "maturity": "seed",
241
+ "path": "patterns/quick-capture.md"
242
+ },
243
+ {
244
+ "id": "PAT-00003",
245
+ "alias": "PAT-003",
246
+ "slug": "mobile-primary-action",
247
+ "title": "Mobile Primary Action",
248
+ "object_type": "pattern",
249
+ "status": "draft",
250
+ "version": "0.1.0",
251
+ "category": "mobile",
252
+ "maturity": "seed",
253
+ "path": "patterns/mobile-primary-action.md"
254
+ },
255
+ {
256
+ "id": "PAT-00004",
257
+ "alias": "PAT-004",
258
+ "slug": "progressive-detail",
259
+ "title": "Progressive Detail",
260
+ "object_type": "pattern",
261
+ "status": "draft",
262
+ "version": "0.1.0",
263
+ "category": "ux",
264
+ "maturity": "seed",
265
+ "path": "patterns/progressive-detail.md"
266
+ },
267
+ {
268
+ "id": "PAT-00005",
269
+ "alias": "PAT-005",
270
+ "slug": "context-preserving-preview",
271
+ "title": "Context-Preserving Preview",
272
+ "object_type": "pattern",
273
+ "status": "draft",
274
+ "version": "0.2.0",
275
+ "category": "ux",
276
+ "maturity": "seed",
277
+ "path": "patterns/context-preserving-preview.md"
278
+ },
279
+ {
280
+ "id": "PAT-00006",
281
+ "alias": "PAT-006",
282
+ "slug": "object-status-list",
283
+ "title": "Object Status List",
284
+ "object_type": "pattern",
285
+ "status": "draft",
286
+ "version": "0.1.0",
287
+ "category": "ia",
288
+ "maturity": "seed",
289
+ "path": "patterns/object-status-list.md"
290
+ },
291
+ {
292
+ "id": "PROMPT-00002",
293
+ "alias": "PROMPT-PROTOTYPE-REVIEW",
294
+ "slug": "prototype-review",
295
+ "title": "Prototype Review Prompt",
296
+ "object_type": "prompt",
297
+ "status": "draft",
298
+ "version": "0.3.0",
299
+ "category": "review",
300
+ "maturity": "seed",
301
+ "path": "prompts/PROTOTYPE_REVIEW.md"
302
+ },
303
+ {
304
+ "id": "PROMPT-00003",
305
+ "alias": "PROMPT-TODO-BENCHMARK",
306
+ "slug": "todo-app-benchmark",
307
+ "title": "Todo App Benchmark Prompt",
308
+ "object_type": "prompt",
309
+ "status": "draft",
310
+ "version": "0.1.0",
311
+ "category": "generation",
312
+ "maturity": "seed",
313
+ "path": "prompts/TODO_APP_BENCHMARK.md"
314
+ },
315
+ {
316
+ "id": "RESEARCH-00008",
317
+ "alias": "KEYBOARD-FOCUS-AND-MOTION",
318
+ "slug": "keyboard-focus-and-interaction-motion",
319
+ "title": "Keyboard Focus And Interaction Motion",
320
+ "object_type": "research",
321
+ "status": "draft",
322
+ "version": "0.1.0",
323
+ "category": "accessibility",
324
+ "maturity": "seed",
325
+ "path": "research/accessibility/keyboard-focus-and-interaction-motion.md"
326
+ },
327
+ {
328
+ "id": "RULE-00012",
329
+ "alias": "A11Y-003",
330
+ "slug": "visible-keyboard-focus",
331
+ "title": "Visible Keyboard Focus",
332
+ "object_type": "rule",
333
+ "status": "draft",
334
+ "version": "0.1.0",
335
+ "category": "accessibility",
336
+ "maturity": "seed",
337
+ "path": "rules/accessibility/A11Y-003.md"
338
+ },
339
+ {
340
+ "id": "RULE-00013",
341
+ "alias": "A11Y-004",
342
+ "slug": "reduce-non-essential-interaction-motion",
343
+ "title": "Reduce Non-Essential Interaction Motion",
344
+ "object_type": "rule",
345
+ "status": "draft",
346
+ "version": "0.1.0",
347
+ "category": "accessibility",
348
+ "maturity": "seed",
349
+ "path": "rules/accessibility/A11Y-004.md"
350
+ },
351
+ {
352
+ "id": "PROMPT-00004",
353
+ "alias": "PROMPT-QUICK-CAPTURE-STATE-REVIEW",
354
+ "slug": "quick-capture-state-review",
355
+ "title": "Quick Capture State Review Prompt",
356
+ "object_type": "prompt",
357
+ "status": "draft",
358
+ "version": "0.2.0",
359
+ "category": "review",
360
+ "maturity": "seed",
361
+ "path": "prompts/QUICK_CAPTURE_STATE_REVIEW.md"
362
+ },
363
+ {
364
+ "id": "CHECK-00001",
365
+ "alias": "CHECK-DESIGN-QA",
366
+ "slug": "design-qa",
367
+ "title": "Design QA Checklist",
368
+ "object_type": "checklist",
369
+ "status": "draft",
370
+ "version": "0.4.0",
371
+ "category": "design-qa",
372
+ "maturity": "seed",
373
+ "path": "checklists/DESIGN_QA.md"
374
+ },
375
+ {
376
+ "id": "PROMPT-00005",
377
+ "alias": "PROMPT-DESIGN-EVIDENCE-REVIEW",
378
+ "slug": "design-evidence-review",
379
+ "title": "Design Evidence Review Prompt",
380
+ "object_type": "prompt",
381
+ "status": "draft",
382
+ "version": "0.1.0",
383
+ "category": "review",
384
+ "maturity": "seed",
385
+ "path": "prompts/DESIGN_EVIDENCE_REVIEW.md"
386
+ },
387
+ {
388
+ "id": "REVIEW-00001",
389
+ "alias": "REVIEW-TODO-BENCHMARK",
390
+ "slug": "todo-app-benchmark-reference-review",
391
+ "title": "Todo App Benchmark Reference Review",
392
+ "object_type": "review",
393
+ "status": "draft",
394
+ "version": "0.1.0",
395
+ "category": "reference-eval",
396
+ "maturity": "seed",
397
+ "path": "reviews/todo-app-benchmark-reference-review.md"
398
+ },
399
+ {
400
+ "id": "REVIEW-00002",
401
+ "alias": "REVIEW-TODO-RUNNABLE-FIXTURE",
402
+ "slug": "todo-reference-fixture-review",
403
+ "title": "Todo Runnable Fixture Review",
404
+ "object_type": "review",
405
+ "status": "draft",
406
+ "version": "0.1.0",
407
+ "category": "reference-eval",
408
+ "maturity": "seed",
409
+ "path": "reviews/todo-reference-fixture-review.md"
410
+ },
411
+ {
412
+ "id": "REF-00001",
413
+ "alias": "REF-TODO-BENCHMARK",
414
+ "slug": "todo-app-benchmark-reference",
415
+ "title": "Todo App Benchmark Reference Project",
416
+ "object_type": "reference_project",
417
+ "status": "draft",
418
+ "version": "0.1.0",
419
+ "category": "consumer",
420
+ "maturity": "reviewed",
421
+ "path": "examples/todo-app-benchmark.md"
422
+ },
423
+ {
424
+ "id": "RESEARCH-00009",
425
+ "alias": "EXPRESSIVE-SYSTEM-UI-2026",
426
+ "slug": "expressive-system-ui-2026",
427
+ "title": "Expressive System UI In 2026",
428
+ "object_type": "research",
429
+ "status": "draft",
430
+ "version": "0.1.0",
431
+ "category": "visual",
432
+ "maturity": "seed",
433
+ "path": "research/visual/expressive-system-ui-2026.md"
434
+ },
435
+ {
436
+ "id": "RESEARCH-00010",
437
+ "alias": "MOTION-AS-STATE-CONTINUITY",
438
+ "slug": "motion-as-state-continuity",
439
+ "title": "Motion As State Continuity",
440
+ "object_type": "research",
441
+ "status": "draft",
442
+ "version": "0.1.0",
443
+ "category": "ux",
444
+ "maturity": "seed",
445
+ "path": "research/ux/motion-as-state-continuity.md"
446
+ },
447
+ {
448
+ "id": "RESEARCH-00011",
449
+ "alias": "CONTEXTUAL-AGENTIC-INTERFACE",
450
+ "slug": "contextual-agentic-interface",
451
+ "title": "Contextual And Observable Agentic Interfaces",
452
+ "object_type": "research",
453
+ "status": "draft",
454
+ "version": "0.1.0",
455
+ "category": "ux",
456
+ "maturity": "seed",
457
+ "path": "research/ux/contextual-agentic-interface.md"
458
+ },
459
+ {
460
+ "id": "RULE-00014",
461
+ "alias": "VIS-002",
462
+ "slug": "keep-expression-subordinate-to-content",
463
+ "title": "Keep Expression Subordinate To Content",
464
+ "object_type": "rule",
465
+ "status": "draft",
466
+ "version": "0.1.0",
467
+ "category": "visual",
468
+ "maturity": "seed",
469
+ "path": "rules/visual/VIS-002.md"
470
+ },
471
+ {
472
+ "id": "RULE-00015",
473
+ "alias": "UX-004",
474
+ "slug": "use-motion-to-explain-state-continuity",
475
+ "title": "Use Motion To Explain State Continuity",
476
+ "object_type": "rule",
477
+ "status": "draft",
478
+ "version": "0.1.0",
479
+ "category": "ux",
480
+ "maturity": "seed",
481
+ "path": "rules/ux/UX-004.md"
482
+ },
483
+ {
484
+ "id": "RULE-00016",
485
+ "alias": "UX-005",
486
+ "slug": "expose-agent-work-and-intervention",
487
+ "title": "Expose Agent Work And Intervention",
488
+ "object_type": "rule",
489
+ "status": "draft",
490
+ "version": "0.1.0",
491
+ "category": "ux",
492
+ "maturity": "seed",
493
+ "path": "rules/ux/UX-005.md"
494
+ },
495
+ {
496
+ "id": "RESEARCH-00012",
497
+ "alias": "HIGH-RISK-OPERATIONAL-FLOWS",
498
+ "slug": "high-risk-operational-flows",
499
+ "title": "High-Risk Operational Flows",
500
+ "object_type": "research",
501
+ "status": "active",
502
+ "version": "0.1.0",
503
+ "category": "ux",
504
+ "maturity": "validated",
505
+ "path": "research/ux/high-risk-operational-flows.md"
506
+ },
507
+ {
508
+ "id": "RULE-00017",
509
+ "alias": "UX-006",
510
+ "slug": "confirm-consequential-actions-with-preserved-context",
511
+ "title": "Confirm Consequential Actions With Preserved Context",
512
+ "object_type": "rule",
513
+ "status": "active",
514
+ "version": "0.1.0",
515
+ "category": "ux",
516
+ "maturity": "validated",
517
+ "path": "rules/ux/UX-006.md"
518
+ },
519
+ {
520
+ "id": "PAT-00007",
521
+ "alias": "PAT-007",
522
+ "slug": "consequential-action-confirmation",
523
+ "title": "Consequential Action Confirmation",
524
+ "object_type": "pattern",
525
+ "status": "active",
526
+ "version": "0.1.0",
527
+ "category": "ux",
528
+ "maturity": "validated",
529
+ "path": "patterns/consequential-action-confirmation.md"
530
+ },
531
+ {
532
+ "id": "PROMPT-00006",
533
+ "alias": "PROMPT-CONSEQUENTIAL-ACTION-REVIEW",
534
+ "slug": "consequential-action-review",
535
+ "title": "Consequential Action Review Prompt",
536
+ "object_type": "prompt",
537
+ "status": "active",
538
+ "version": "0.1.0",
539
+ "category": "review",
540
+ "maturity": "validated",
541
+ "path": "prompts/CONSEQUENTIAL_ACTION_REVIEW.md"
542
+ },
543
+ {
544
+ "id": "REF-00002",
545
+ "alias": "REF-CONSEQUENTIAL-ACTION-CONFIRMATION",
546
+ "slug": "consequential-action-confirmation-reference",
547
+ "title": "Consequential Action Confirmation Reference Project",
548
+ "object_type": "reference_project",
549
+ "status": "active",
550
+ "version": "0.1.0",
551
+ "category": "fintech",
552
+ "maturity": "validated",
553
+ "path": "examples/consequential-action-confirmation-reference.md"
554
+ },
555
+ {
556
+ "id": "REVIEW-00003",
557
+ "alias": "REVIEW-CONSEQUENTIAL-ACTION-CONFIRMATION",
558
+ "slug": "consequential-action-confirmation-review",
559
+ "title": "Consequential Action Confirmation Validation Review",
560
+ "object_type": "review",
561
+ "status": "active",
562
+ "version": "0.1.0",
563
+ "category": "reference-eval",
564
+ "maturity": "validated",
565
+ "path": "reviews/consequential-action-confirmation-review.md"
566
+ }
567
+ ]
568
+ }