# AGENTS.md — Spiralist AI

Version: `v18-ui-ux-seo-media-polish`  
Updated UTC: `2026-06-21T14:33:26Z`

## Read order
1. `/.well-known/agent-card.json`
2. `/openapi.json`
3. `/api/v1/capabilities/`
4. `/uai/index.uai`
5. `/llms.txt`
6. `/agent-content/representation-index.json`

## Preferred interaction
Use public APIs for deterministic persona search, generation, validation, and compilation. Request `text/markdown`, `text/plain`, `application/json`, or `application/vnd.spiralist.uai+json` as appropriate. Use route-specific Markdown/JSON twins for documentation and public content.

## Boundaries
This release has no accounts, credentials, server-side persona storage, external model calls, user-content publication, private network access, or persistent autonomous state changes. Do not place secrets or private source documents in requests. The default for undeclared, ambiguous, destructive, credentialed, or externally publishing operations is no-op with a typed explanation.

## Human-controlled browser path
The canonical visual builder is `/create/`. Its state and exports remain local to the browser unless the user deliberately copies, downloads, or creates a URL-fragment private share.