Agent operating contract

Use Forma as a presentation boundary, not an application runtime.

Agents reuse canonical patterns, preserve native semantics, and leave behavioral and domain authority in the systems that own it.

Required sequence

  1. Identify the user task and domain state.
  2. Find the closest canonical pattern under patterns/.
  3. Use its public <forma-…> authoring tag around the canonical pattern.
  4. Preserve its semantic elements, class structure, labels, IDs, and ARIA relationships.
  5. Supply application content and rendered state.
  6. Put non-native behavior in the consuming application/Limen.
  7. Keep legal transitions, permissions, obligations, and scoring in Ordo/application state.
  8. Run repository and site verification before claiming completion.

Boundary ownership

ConcernOwner
Typography, color, spacing, layout, responsive presentationForma
Checked/open/required/disabled and native stateNative HTML rendered by the application
Async search, ranking movement, rule editingApplication / Limen
Legal transitions, capabilities, obligations, permissionsOrdo/application domain state
Scores and assessment interpretationApplication domain logic

Do not

Mobile is part of the component contract

Every Forma pattern must recompose at 320 CSS px without changing its semantic meaning or domain authority.

Character grids

For terminal-style, keyboard-first screens use the CharacterGrid family (patterns/character-grid*.html). Declare cell coordinates, write runs in row-major order, keep fields native, and leave key mapping, Enter/Clear/Reset/PF processing, transitions, and reveal orchestration to Limen/application code. See docs/CHARACTER-GRID-AUTHORING.md.

Use the catalog

Every component page answers "what is the smallest correct HTML?" in its Basic example, then shows scenario and mobile examples, the native attributes, the CSS hooks derived from the shipped stylesheet, states, accessibility responsibilities, and related components. Pages share one structure: learn one, read all.

Build and verify

npm install
npm run build
npm run check
npm run catalog:check
npm run site:check
./ros registry check
./ros validate

The repository source of truth for this contract is docs/AGENT-USAGE.md.