Skip to content

docs(agents): require declarative layout before runtime measurement #208

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DoctorDerek merged 1 commit into from
Sep 7, 2026
Merged

docs(agents): require declarative layout before runtime measurement #208

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ You must mentally and explicitly process every task through this sequence to pre
- _Exception 1 (Zero-Major):_ Packages starting with `0` do not follow semver safely; they MUST use `^0.MINOR.PATCH`.
- _Exception 2 (Expo Override):_ If the project utilizes Expo / React Native, you are CONSTITUTIONALLY MANDATED to pull up the Expo SDK Reference page at `https://docs.expo.dev/versions/latest/#each-expo-sdk-version-depends-on-a-react-native-version`. You must look up the current Expo SDK version and rigidly pin the EXACT package versions for its dependencies (React, React Native, React Native Web, etc.) as listed on that page.
- **Package Verification:** Never hallucinate package versions. Execute `pnpm info <package> version` in the terminal to verify factual data before updating lockfiles.
- **Typography:** You must exclusively use “Curly Double Quotes” (“ ”) and curly apostrophes (’) in all UI-facing text. Straight quotes are banned in the UI presentation layer.
- **Styling, Geometry, and Typography:** This is a web-only Next.js repository. Preserve component Tailwind CSS v4 utilities, shared tokens and keyframes in `styles/globals.css`, and the SVG theme-toggle styling in `styles/theme-toggle.css`, together with the existing motion owners and approved responsive breakpoints. CSS must own sizing, positioning, and motion geometry it can express through existing layout constraints, intrinsic sizing, percentages, supported CSS arithmetic, and authored inputs. Do not reconstruct those relationships through `ResizeObserver`, resize listeners, layout reads, or measurement-derived React state. Evaluate the complete measurement → state/style update → layout/animation feedback loop, including unnecessary renders, visible corrections, and repeated-layout risks; observation must be justified together with the behavior it drives. Authored asset dimensions and genuine runtime animation inputs do not authorize measuring CSS-owned output into a second layout authority. A measurement-based exception requires a concrete approved behavior, a demonstrated limitation of the supported platform’s declarative layout, and explicit approval for the smallest scoped implementation. Cleanup, batching, and passing tests do not establish necessity. Preserve fluid sizing, wrapping, and accessible text scaling; do not introduce a new styling or measurement framework. You must exclusively use “Curly Double Quotes” (“ ”) and curly apostrophes (’) in all UI-facing text. Straight quotes are banned in the UI presentation layer.

## 5. THE 40 PILLARS OF MQA (MINIMUM QREAM ARCHITECTURE)

Expand Down