Agent Aware Architecture: an open spec to make sites walkable for AI agents

sierracatalina · x · 2026-10-03

sierracatalina open-sourced agent-aware-starter, proposing Agent Aware Architecture (AAA): a machine-readable handshake so agents read a small set of well-known files instead of inferring intent from the DOM. "Google ranks pages; agents rank paths — make yours walkable."

The handshake fetches /.well-known/llms.txt, agents., and ai-instructions., then honors actionroot: either call only mapped actions or, if "none", open documented pages. The spec covers a Settings surface, safety guardrails and confirmations, ownership boundaries, with JSON Schemas and fixtures included.

Original post →

More from coding & agent

coding & agent channel →