docs(agents): require declarative layout before runtime measurement

[DoctorDerek]

Closes #207

Summary

• Reconcile the existing Typography bullet into one approved Styling, Geometry, and Typography paragraph in AGENTS.md.
• Identify this repository's web-only Next.js styling owners and preserve existing responsive breakpoints, motion owners, typography, and approval/review gates.
• Require declarative CSS layout before runtime measurement, assess the complete measurement-to-update-to-layout/animation feedback loop, and require an approved behavior, demonstrated platform limitation, and explicit approval for any exception.

Scope

One focused commit changes AGENTS.md only. No application code, dependencies, scripts, CI, tests, private authority documents, or live documents were changed. Runtime measurement observations from the audit remain separate from this documentation correction.

Verification

• Node v24.18.0 through fnm; pnpm 11.9.0.
• pnpm exec prettier --write AGENTS.md passed without additional formatting changes.
• pnpm exec prettier --check AGENTS.md passed.
• pnpm lint passed.
• git diff --check passed.
• Exact-content comparison confirmed the original AGENTS.md plus only the approved paragraph replacement matches the final file.
• Complete diff inspected: one file, one paragraph replacement.

Formatting was scoped to AGENTS.md to avoid unrelated changes. No server, build, export, deployment, runtime QA, or manual workflow dispatch was launched. Existing repository automation was not changed.

Review checklist

• Confirm the paragraph preserves the existing styling owners, typography, and review gates.
• Confirm declarative ownership, full feedback-loop review, and the three-part exception gate match the approved wording.
• Confirm the changed-files list contains only AGENTS.md.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
doctor-derek	Ready	Preview	Sep 7, 2026 10:12pm UTC

[github-actions]

🧹 ESLint

Quality check 1 of 3

✅ Zero warnings.

[github-actions]

🧪 Vitest

Quality check 2 of 3

✅ Vitest completed successfully.

 Test Files  49 passed (49)
      Tests  224 passed (224)
   Duration  11.30s (transform 1.15s, setup 6.92s, import 3.07s, tests 4.12s, environment 10.70s)

[github-actions]

🎭 Playwright

Quality check 3 of 3

✅ Playwright completed successfully.

Running 90 tests using 1 worker
  90 passed (3.6m)

Open preview deployment

[github-actions]

🗺️ XState v5 State Machine Diff Visualization

Architecture visualization

Base 65c7eba686d4 → Head 2bd5e1574dd9

No XState state-machine topology changes detected.

Download canonical graphs, structured diff, Mermaid, and diagnostics

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (65c7eba) to head (2bd5e15).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #208   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           65        65           
  Lines         1515      1515           
  Branches       320       320           
=========================================
  Hits          1515      1515           

Flag	Coverage Δ
vitest	100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[DoctorDerek]

Code reviewed and approved. QA pass (AGENTS.md change). Merging now.