diff --git a/AGENTS.md b/AGENTS.md index bc8c6e90a..84b5c4293 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -174,6 +174,39 @@ When a branch or PR review completes, record the reviewed branch/ref, HEAD SHA, + + +# Page and button wiring + +Interactive controls and routes follow conventions the codebase already holds to. Before adding +or moving a button, link, or route, read `docs/wiring-conventions.md`. A control that advertises an +action must perform one; a page that ships must be reachable. + +- **Buttons.** Every interactive ` + + Thing is coming soon. + +``` + +**Read-only indicators are not controls.** The shared `ToggleSwitch` (`ui-primitives.tsx`) renders an +operable `role="switch"` only when an `onToggle` is passed; without it, it is a presentational +indicator by design — a "switch" with no handler is intentional, not a dead control. + +**Never** ship a styled, `aria-label`led ` + + Language and region settings are coming soon. +