ace-design 0.2.0

data/handbook/benchmarks/app-support/fixtures.json

@@ -0,0 +1,41 @@
+{
+  "title": "Support queue",
+  "primary_action": "Triage the next ticket",
+  "description": "Triage incoming customer tickets by priority, ownership and waiting time.",
+  "records": [
+    {
+      "id": "ticket-1042",
+      "title": "Cannot reset account password",
+      "status": "New",
+      "priority": "Urgent",
+      "customer": "Maya Chen",
+      "assignee": null,
+      "waiting_minutes": 18,
+      "channel": "Email",
+      "summary": "Reset link expires before the customer can use it."
+    },
+    {
+      "id": "ticket-1043",
+      "title": "Invoice address needs correction",
+      "status": "Assigned",
+      "priority": "Normal",
+      "customer": "Alex Rivera",
+      "assignee": "Sam Patel",
+      "waiting_minutes": 45,
+      "channel": "Chat",
+      "summary": "Customer requests an updated billing address on the latest invoice."
+    },
+    {
+      "id": "ticket-1044",
+      "title": "Export missing last week of records",
+      "status": "Waiting on customer",
+      "priority": "High",
+      "customer": "Jo Morgan",
+      "assignee": "Lee Kim",
+      "waiting_minutes": 120,
+      "channel": "Email",
+      "summary": "Awaiting the date range and export settings used by the customer."
+    }
+  ],
+  "data_notice": "Fictional benchmark data; fixed across baseline and candidate runs."
+}

data/handbook/benchmarks/site-community/brief.md

@@ -0,0 +1,8 @@
+# Local community garden
+Audience: people completing the primary task: join a weekend session.
+Primary action: Join a weekend session.
+Explore three directions: Event-led, place-led, volunteer story.
+Use fixtures.json without changing records across variants. One language (en).
+Scope: first screen and one following section.
+After the initial comparison, request a less dense B while retaining its hierarchy; change only B.
+Observe time and results; do not invent baseline or candidate measurements.

data/handbook/benchmarks/site-community/fixtures.json

@@ -0,0 +1,41 @@
+{
+  "title": "Local community garden",
+  "primary_action": "Join a weekend session",
+  "description": "Help neighbors choose a weekend garden activity and join a session.",
+  "records": [
+    {
+      "id": "planting",
+      "title": "Plant winter greens",
+      "status": "Places available",
+      "date": "2026-11-07",
+      "time": "09:00–11:00",
+      "location": "North garden beds",
+      "places_remaining": 12,
+      "activity": "Planting",
+      "experience": "Beginners welcome"
+    },
+    {
+      "id": "compost",
+      "title": "Build a compost bay",
+      "status": "Few places left",
+      "date": "2026-11-07",
+      "time": "13:00–15:00",
+      "location": "Garden tool shed",
+      "places_remaining": 2,
+      "activity": "Workshop",
+      "experience": "No experience required"
+    },
+    {
+      "id": "harvest",
+      "title": "Community harvest morning",
+      "status": "Full",
+      "date": "2026-11-08",
+      "time": "09:00–12:00",
+      "location": "Main garden gate",
+      "places_remaining": 0,
+      "activity": "Harvest",
+      "experience": "All ages welcome"
+    }
+  ],
+  "data_notice": "Fictional benchmark data; fixed across baseline and candidate runs."
+}

data/handbook/benchmarks/site-course/brief.md

@@ -0,0 +1,8 @@
+# Practical cooking course
+Audience: people completing the primary task: choose a course.
+Primary action: Choose a course.
+Explore three directions: Schedule-led, instructor-led, outcome-led.
+Use fixtures.json without changing records across variants. One language (en).
+Scope: first screen and one following section.
+After the initial comparison, request a less dense B while retaining its hierarchy; change only B.
+Observe time and results; do not invent baseline or candidate measurements.

data/handbook/benchmarks/site-course/fixtures.json

@@ -0,0 +1,41 @@
+{
+  "title": "Practical cooking course",
+  "primary_action": "Choose a course",
+  "description": "Compare practical cooking courses by skill level, schedule and learning outcome.",
+  "records": [
+    {
+      "id": "weeknight",
+      "title": "Confident weeknight cooking",
+      "status": "Enrolling",
+      "level": "Beginner",
+      "sessions": 4,
+      "price_eur": 160,
+      "instructor": "Nora Silva",
+      "starts_on": "2026-11-09",
+      "outcome": "Plan and prepare three balanced weekday dinners."
+    },
+    {
+      "id": "bread",
+      "title": "Bread from first principles",
+      "status": "Few places left",
+      "level": "Beginner",
+      "sessions": 3,
+      "price_eur": 135,
+      "instructor": "Eli Martin",
+      "starts_on": "2026-11-14",
+      "outcome": "Mix, shape and bake a reliable loaf at home."
+    },
+    {
+      "id": "seasonal",
+      "title": "Seasonal vegetable kitchen",
+      "status": "Waitlist",
+      "level": "Intermediate",
+      "sessions": 5,
+      "price_eur": 210,
+      "instructor": "Amira Khan",
+      "starts_on": "2026-11-18",
+      "outcome": "Build satisfying vegetable dishes using seasonal produce."
+    }
+  ],
+  "data_notice": "Fictional benchmark data; fixed across baseline and candidate runs."
+}

data/handbook/benchmarks/site-studio/brief.md

@@ -0,0 +1,8 @@
+# Architecture studio
+Audience: people completing the primary task: request a consultation.
+Primary action: Request a consultation.
+Explore three directions: Project-led gallery, editorial story, restrained portfolio.
+Use fixtures.json without changing records across variants. One language (en).
+Scope: first screen and one following section.
+After the initial comparison, request a less dense B while retaining its hierarchy; change only B.
+Observe time and results; do not invent baseline or candidate measurements.

data/handbook/benchmarks/site-studio/fixtures.json

@@ -0,0 +1,38 @@
+{
+  "title": "Architecture studio",
+  "primary_action": "Request a consultation",
+  "description": "Explore architectural projects and request a consultation for a similar brief.",
+  "records": [
+    {
+      "id": "courtyard-home",
+      "title": "Courtyard house",
+      "status": "Completed",
+      "project_type": "Residential",
+      "location": "Coastal town",
+      "year": 2024,
+      "area_m2": 180,
+      "summary": "A family home organized around a shaded courtyard and natural ventilation."
+    },
+    {
+      "id": "neighborhood-library",
+      "title": "Neighborhood reading room",
+      "status": "Completed",
+      "project_type": "Community",
+      "location": "City neighborhood",
+      "year": 2025,
+      "area_m2": 320,
+      "summary": "An adaptable reading room with daylight, quiet study and shared meeting space."
+    },
+    {
+      "id": "workshop-reuse",
+      "title": "Workshop conversion",
+      "status": "In progress",
+      "project_type": "Adaptive reuse",
+      "location": "Former industrial district",
+      "year": 2026,
+      "area_m2": 240,
+      "summary": "A former workshop converted into flexible studios while retaining its structure."
+    }
+  ],
+  "data_notice": "Fictional benchmark data; fixed across baseline and candidate runs."
+}

data/handbook/catalog/app/error-recovery.md

@@ -0,0 +1,11 @@
+---
+id: "error-recovery"
+surface: "app"
+title: "Help users identify and recover from errors"
+use_when: "Forms and failed task steps"
+avoid_when: "Color-only errors or losing all entered data"
+source: "https://www.w3.org/WAI/WCAG22/Understanding/error-identification.html"
+verified_at: "2026-10-16"
+---
+
+Identify the affected input in text, preserve useful input and provide an actionable recovery path. Exercise a failure case in the production verification, even if exploration used a mock.

data/handbook/catalog/app/status-feedback.md

@@ -0,0 +1,11 @@
+---
+id: "status-feedback"
+surface: "app"
+title: "Expose meaningful asynchronous status"
+use_when: "Saving, searching or loading application data"
+avoid_when: "Silent changes that leave task outcome ambiguous"
+source: "https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html"
+verified_at: "2026-10-16"
+---
+
+Plan loading, success, empty and error states around the primary task. Use suitable semantic status communication and avoid repeatedly interrupting users for routine updates.

data/handbook/catalog/app/task-first-density.md

@@ -0,0 +1,11 @@
+---
+id: "task-first-density"
+surface: "app"
+title: "Choose density from the task"
+use_when: "Data-rich working screens"
+avoid_when: "Treating a complex tool as a marketing landing page"
+source: "https://github.com/pbakaus/impeccable/tree/6af45ac9a5eb8792f033d3242f52e99812fd91fa"
+verified_at: "2026-10-16"
+---
+
+Show the information needed for the next decision. Compare a table-led, detail-led or queue-led composition using the same records. Keep secondary controls subordinate without hiding essential task context.

data/handbook/catalog/shared/automated-a11y-boundary.md

@@ -0,0 +1,11 @@
+---
+id: "automated-a11y-boundary"
+surface: "shared"
+title: "Combine automated and manual accessibility checks"
+use_when: "Verifying an implemented interface"
+avoid_when: "Claiming full accessibility from zero axe violations"
+source: "https://playwright.dev/docs/accessibility-testing"
+verified_at: "2026-10-16"
+---
+
+Use automated checks to find concrete issues, then test keyboard and the real task flow manually. Record incomplete rules and untested states. Automated checks cannot establish all usability and accessibility requirements.

data/handbook/catalog/shared/bounded-exploration.md

@@ -0,0 +1,11 @@
+---
+id: "bounded-exploration"
+surface: "shared"
+title: "Separate exploration from production"
+use_when: "Choosing among alternative directions"
+avoid_when: "Shipping a disposable mockup as production"
+source: "https://github.com/superdesigndev/superdesign-skill"
+verified_at: "2026-10-16"
+---
+
+Keep the first comparison to one representative screen and shared data. After selection, deliberately switch to project architecture, actual states, accessibility and tests.

data/handbook/catalog/shared/context-before-style.md

@@ -0,0 +1,11 @@
+---
+id: "context-before-style"
+surface: "shared"
+title: "Choose a direction from the subject"
+use_when: "Starting a new visual direction"
+avoid_when: "Treating a single fashionable aesthetic as mandatory"
+source: "https://github.com/Leonxlnx/taste-skill/tree/f624f37a8c650b9cc550253104925efe4c8de246"
+verified_at: "2026-10-16"
+---
+
+Identify subject, audience and primary action before selecting type, spacing and imagery. Compare composition and hierarchy rather than swapping accent colors. This is an original synthesis of the referenced workflow, not a claim of benchmark superiority.

data/handbook/catalog/shared/contextual-cards.md

@@ -0,0 +1,11 @@
+---
+id: "contextual-cards"
+surface: "shared"
+title: "Keep knowledge contextual and searchable"
+use_when: "Reusing lessons across different products"
+avoid_when: "Universal bans on colors, gradients or animation"
+source: "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/tree/56ea9cf174ed86786187daa9de0e6247cb0747e4"
+verified_at: "2026-10-16"
+---
+
+Store use and avoid conditions beside each design recommendation. Search only relevant cards; a catalog is not a checklist to paste into every prompt.

data/handbook/catalog/shared/focus-visible.md

@@ -0,0 +1,11 @@
+---
+id: "focus-visible"
+surface: "shared"
+title: "Keep keyboard focus visible"
+use_when: "Interactive controls and navigation"
+avoid_when: "Decorative elements with no interaction"
+source: "https://www.w3.org/WAI/WCAG22/Understanding/focus-visible.html"
+verified_at: "2026-10-16"
+---
+
+Use semantic controls and a visible focus treatment. Check the actual tab sequence and ensure the focused element can be located against its background.

data/handbook/catalog/shared/responsive-reflow.md

@@ -0,0 +1,11 @@
+---
+id: "responsive-reflow"
+surface: "shared"
+title: "Preserve meaning when content reflows"
+use_when: "Narrow screens and larger text"
+avoid_when: "Hiding essential actions merely to avoid overflow"
+source: "https://www.w3.org/WAI/WCAG22/Understanding/reflow.html"
+verified_at: "2026-10-16"
+---
+
+Check reading order and task completion at narrow widths. Data tables and other inherently two-dimensional content need deliberate treatment, not indiscriminate wrapping or hidden content.

data/handbook/catalog/site/critique-versus-defect.md

@@ -0,0 +1,11 @@
+---
+id: "critique-versus-defect"
+surface: "site"
+title: "Separate design critique from verified defects"
+use_when: "Reviewing a landing page direction"
+avoid_when: "Calling a subjective aesthetic preference a bug"
+source: "https://github.com/pbakaus/impeccable/tree/6af45ac9a5eb8792f033d3242f52e99812fd91fa"
+verified_at: "2026-10-16"
+---
+
+Give subjective direction suggestions with rationale and tradeoffs. Attach concrete evidence to defects such as unreadable text, overflow or a broken primary action.

data/handbook/catalog/site/purposeful-links.md

@@ -0,0 +1,11 @@
+---
+id: "purposeful-links"
+surface: "site"
+title: "Make navigation and CTA destinations clear"
+use_when: "Pages with conversion and navigation actions"
+avoid_when: "Several identical vague links with different destinations"
+source: "https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html"
+verified_at: "2026-10-16"
+---
+
+Label actions so their purpose is understood from their text and context. Compare how each direction leads from explanation and proof to the primary action.

data/handbook/catalog/site/subject-specific-hero.md

@@ -0,0 +1,11 @@
+---
+id: "subject-specific-hero"
+surface: "site"
+title: "Make the first screen specific"
+use_when: "A marketing site introducing a distinct offer"
+avoid_when: "Generic dashboard decoration unrelated to the offer"
+source: "https://github.com/anthropics/skills/tree/main/skills/frontend-design"
+verified_at: "2026-10-16"
+---
+
+Use a clear subject, concrete headline and appropriate visual material. Let composition express the offer; do not force the same centered hero into every brief.

data/handbook/guides/design/process.g.md

@@ -0,0 +1,20 @@
+---
+doc-type: guide
+title: Design stages and evidence
+purpose: Explain the shared site/app design process
+ace-docs:
+  last-updated: 2026-10-16
+  last-checked: 2026-10-16
+---
+
+# Design stages and evidence
+
+Exploration selects direction quickly: one brief, one fixture, three default variants, one language, targeted feedback. The ace-design runner launches one coding agent per declared preset slot, with a separate workspace and optional caller-supplied prompt. Use explore, recreate or reimagine to start a session, then revise, status, resume and select through the CLI; do not duplicate orchestration in the calling skill. Render once to catch an unusable preview; defer full reviews and production integrations.
+
+Selection is an explicit user decision. A fixture hash binds that decision to the data seen during comparison. `ace-design validate SESSION` checks artifact structure and selection integrity; it cannot prove semantic distinctness or enforce how arbitrary JavaScript uses data. The coordinator must verify those obligations.
+
+Engineering then uses the real project stack, data, required languages, states, tests and independent review. Browser inspection reports automatic evidence and manual gaps separately. Clean automatic checks do not certify accessibility or visual quality.
+
+Inspiration changes are tested proposals. They do not become universal style rules and do not automatically update installed skills. Native platforms are a separate future family.
+
+Project assumptions live in inherited `.ace-config/design/` contexts, each with defaults.md, user.md and effective design.md. The adjust skills refresh installed defaults and preserve explicit user decisions; normal generation uses a frozen effective snapshot. Views and components have distinct assumptions and output scopes. See `wfi://design/adjust`.

data/handbook/skills/as-design-app/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: as-design-app
+description: Generate preset-driven design variants with shared mock data for a web application
+# bundle: wfi://design/explore
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/explore
+---
+
+Bind `surface=app`. Load `ace-bundle wfi://design/explore` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Choose `--kind view|component` and the appropriate `--profile`; use the matching adjust skill for project-wide preference changes. Use the CLI runner and supply per-variant extra prompts when useful. Preserve this binding throughout. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/skills/as-design-app-adjust/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: as-design-app-adjust
+description: Personalize and refresh project design assumptions for app views and components
+# bundle: wfi://design/adjust
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+  - Edit
+  - Write
+user-invocable: true
+argument-hint: "[preferences or refresh] [view|component] [context]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/adjust
+---
+
+Bind `surface=app`. Load `ace-bundle wfi://design/adjust` and execute it in the target project. In the ACE repository use `bin/ace-bundle` and `bin/ace-design`. Preserve the surface binding and the user's view/component scope. Use the runner to compose assumptions; do not independently overwrite generated context files, except to restore verified candidate/previous evidence during the workflow's explicit manual-edit recovery.

data/handbook/skills/as-design-app-audit/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: as-design-app-audit
+description: Audit design with browser and optional source evidence for a web application
+# bundle: wfi://design/audit
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+  - Edit
+  - Write
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/audit
+---
+
+Bind `surface=app`. Load `ace-bundle wfi://design/audit` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Preserve this binding when delegating. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/skills/as-design-app-implement/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: as-design-app-implement
+description: Implement a selected direction with production verification for a web application
+# bundle: wfi://design/implement
+# agent: general-purpose
+allowed-tools:
+  - Bash
+  - Read
+  - Edit
+  - Write
+  - Glob
+  - Grep
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/implement
+---
+
+Bind `surface=app`. Load `ace-bundle wfi://design/implement` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Preserve this binding when delegating. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/skills/as-design-look-for-inspiration/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: as-design-look-for-inspiration
+description: Research new design evidence and prepare a tested package change for review
+# bundle: wfi://design/look-for-inspiration
+# agent: general-purpose
+allowed-tools:
+  - Bash
+  - Read
+  - Edit
+  - Write
+  - Glob
+  - Grep
+  - WebFetch
+  - WebSearch
+user-invocable: true
+argument-hint: "[--surface shared|site|app] [source checkout] [since date or revision]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/look-for-inspiration
+---
+
+Load `ace-bundle wfi://design/look-for-inspiration` and execute it. In the ACE repository use `bin/ace-bundle`. Produce a concrete reviewable proposal; never automatically merge or publish.

data/handbook/skills/as-design-site/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: as-design-site
+description: Generate preset-driven design variants with shared mock data for a web site
+# bundle: wfi://design/explore
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/explore
+---
+
+Bind `surface=site`. Load `ace-bundle wfi://design/explore` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Choose `--kind view|component` and the appropriate `--profile`; use the matching adjust skill for project-wide preference changes. Use the CLI runner and supply per-variant extra prompts when useful. Preserve this binding throughout. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/skills/as-design-site-adjust/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: as-design-site-adjust
+description: Personalize and refresh project design assumptions for site views and components
+# bundle: wfi://design/adjust
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+  - Edit
+  - Write
+user-invocable: true
+argument-hint: "[preferences or refresh] [view|component] [context]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/adjust
+---
+
+Bind `surface=site`. Load `ace-bundle wfi://design/adjust` and execute it in the target project. In the ACE repository use `bin/ace-bundle` and `bin/ace-design`. Preserve the surface binding and the user's view/component scope. Use the runner to compose assumptions; do not independently overwrite generated context files, except to restore verified candidate/previous evidence during the workflow's explicit manual-edit recovery.

data/handbook/skills/as-design-site-audit/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: as-design-site-audit
+description: Audit design with browser and optional source evidence for a web site
+# bundle: wfi://design/audit
+# agent: general-purpose
+allowed-tools:
+  - Bash(ace-design:*)
+  - Bash(ace-bundle:*)
+  - Bash(bin/ace-design:*)
+  - Bash(bin/ace-bundle:*)
+  - Read
+  - Edit
+  - Write
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/audit
+---
+
+Bind `surface=site`. Load `ace-bundle wfi://design/audit` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Preserve this binding when delegating. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/skills/as-design-site-implement/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: as-design-site-implement
+description: Implement a selected direction with production verification for a web site
+# bundle: wfi://design/implement
+# agent: general-purpose
+allowed-tools:
+  - Bash
+  - Read
+  - Edit
+  - Write
+  - Glob
+  - Grep
+user-invocable: true
+argument-hint: "[brief or session or URL] [project path]"
+source: ace-design
+skill:
+  kind: workflow
+  execution:
+    workflow: wfi://design/implement
+---
+
+Bind `surface=site`. Load `ace-bundle wfi://design/implement` in the current project and execute the workflow with that surface binding. In the ACE repository use `bin/ace-bundle`. Preserve this binding when delegating. This skill concerns web interfaces; native platforms use a separate future family.

data/handbook/templates/design/benchmark-result.template.md

@@ -0,0 +1,14 @@
+# Benchmark result
+- Brief ID / fixture SHA-256:
+- Baseline revision / candidate revision:
+- Agent/model/tools and environment:
+- Applicable guidance and excluded cases:
+- Baseline / candidate artifact paths:
+- Time to first comparable variants (observed):
+- Same fixture bytes in all variants:
+- Distinct composition and hierarchy:
+- Feedback request / targeted edit time:
+- Executed browser checks:
+- Human judgment:
+- Model judgment (not proof):
+- Failures / unexecuted checks:

data/handbook/templates/design/brief.template.md

@@ -0,0 +1,12 @@
+# Design brief
+- Surface: site | app
+- Audience:
+- Primary action:
+- Representative screen and following section/interaction:
+- One exploration language:
+- Brand constraints:
+- Shared fixture path and assumptions:
+- A — composition / hierarchy / type / density:
+- B — composition / hierarchy / type / density:
+- C — composition / hierarchy / type / density:
+- Mocked behaviors and production follow-up:

data/handbook/templates/design/feedback.template.md

@@ -0,0 +1,8 @@
+# Feedback
+## Round 1
+- Targets: a | b | c
+- User request:
+- Interpretation:
+- Changes made:
+- Result / remaining questions:
+- Shared fixture changes (invalidate selection if changed):

data/handbook/templates/design/proposal.template.md

@@ -0,0 +1,15 @@
+# Inspiration proposal
+- Status: experimental | review-pending | reviewed
+- Sources, checked revisions/dates and licenses:
+- Candidate and user problem:
+- Use / avoid / surface:
+- Exact affected files:
+- Before / after evidence:
+- Executed tests and results:
+- Applicable benchmark cases and exclusions:
+- Observed timing / data compliance / distinctness:
+- Human feedback (separate from model judgment):
+- Tradeoffs and rejected candidates:
+- Independent review verdict / unresolved findings:
+- Proposed accept or reject decision:
+- No merge or publication performed.

data/handbook/templates/design/source-ledger.template.md

@@ -0,0 +1,5 @@
+# Source ledger
+Append one entry per check; preserve last successful source revision after failed requests.
+
+| Source URL | Checked at | Last successful revision | License | Change / error | Proposal / status |
+| --- | --- | --- | --- | --- | --- |