# Atlas — agents.md

## 0. Hard rules (fail closed)

Read DESIGN.md first. Compose shadcn under this contract's tokens — do not invent OKLCH.
Pass `npm run validate` before done. Contract MCP is optional.

## 1. Load order (mandatory)

1. `docs/platform.md` + `docs/atlas.md`
2. This file + design.md
3. Skills via `npx skills add byronwade/ui.byronwade.com`
4. Recipe → compose → validate gates

## 2. Platform consistency (all contracts)

Architecture is shared. Change filenames / MCP tools / JSON keys in `lib/platform/skeleton.ts` for **every** contract — never fork for Atlas alone.
Design DNA may differ (`atlas` aesthetic). Structure must not.

## 3. Design influences → mapping

See `docs/atlas.md`.

## 4. Material laws (app chrome)

Ink-forward workbench, mono metadata, keyboard-first scanning chrome.

## 5. Skills

- `atlas-theme`
- `atlas-compose`
- `atlas-workbench`
- `atlas-surface`
- `atlas-a11y`

## 6. Agents

Author → reviewer against DESIGN.md + skills.

## 7. Negotiated endpoints

- design.md · agents.md · architecture.md · llms.txt under `/atlas/`
- Machine kit: `https://ui.byronwade.com/r/atlas.contract.json`

## 8. Done gate

- [ ] Law book loaded
- [ ] Skill followed
- [ ] Tokens / radii / depth from kit only
- [ ] `npm run validate` green
- [ ] Optional MCP `validate_ui` if tool-wired