AGENTS.md@apps/ui ยท diff

git:20261024.74df172 to git:20261027.d205f65

9 added, 0 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

## UI
Next.js app. Iterate without the full stack: `./node_modules/.bin/next dev --port 9120`.
### Navigation
Add page destinations and search aliases to `src/lib/navigation.ts`, or Settings destinations
to `src/lib/settings-navigation.ts`. Sidebar and Command-K share these models and visibility
rules; do not add a separate command-palette page list.
+ ### Localization
+
+ Mark product-owned copy with `useUiTranslations` and add its Ukrainian message in
+ `src/lib/messages/uk/`, preserving interpolation tokens. Use the entity localization
+ helpers with `displayLocale` for agent and harness presentation. Keep authored
+ content, stable identifiers and execution instructions outside translation calls.
+ Interface and execution locales are separate; follow the
+ [localization contract](../../knowledge/operations/localization.md).
+
### Design system (Slate)
`src/app/design-system.css` is the runtime source of truth; [`DESIGN.md`](./DESIGN.md) is its
agent-readable companion in the [DESIGN.md format](https://github.com/google-labs-code/design.md).
Change tokens in both together, then run `pnpm run design:lint`.
Design intent and brand rationale live in [`knowledge/ui/brand.md`](../../knowledge/ui/brand.md).
Light and dark both ship. Style with semantic tokens (`bg-background`,
`text-muted-foreground`, `border-border`), not raw palette colors โ€” a
`text-gray-500` looks fine in light mode and disappears in dark. `.dark` on
`<html>` is the only switch; `src/lib/theme.ts` owns the cookie and the
pre-paint script.
<!-- BEGIN:nextjs-agent-rules -->
## This is NOT the Next.js you know
This version has breaking changes โ€” APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
This block is written and re-added by `next dev` โ€” verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
<!-- END:nextjs-agent-rules -->