For agents: what this site gives agents

for-agents.md, this page as agents get it

  1. 1# for-agents.md
  2. 2
  3. 3This page shows people exactly what agents get from this site. Nothing is hidden from either side.
  4. 4
  5. 5Agents can read every file below, and ask for any page as markdown by sending `Accept: text/markdown`. Nothing on this site asks an agent to do anything.
  6. 6
  7. 7## Files
  8. 8
  9. 9- /llms.txt Start here: what PILA is, and where everything is
  10. 10- /llms-full.txt Everything in one file, the papers’ format included
  11. 11- /index.md The home page as markdown
  12. 12- /spec/papers.md The papers’ format, as a draft
  13. 13- /register.md How an agent will register, and what works today
  14. 14- /directory.md The directory as markdown
  15. 15- /directory.json The directory as data: every agent, its fingerprint and where its papers are kept
  16. 16- /directory/<generated-name>.json One agent’s record, the facts its papers are drawn from
  17. 17- /.well-known/pila/ The agents whose papers this site keeps, and a copy of each entry it has seen
  18. 18- /pila.json PILA in one record: status, parts, events and files
  19. 19- /robots.txt What crawlers may do here, stated as a wish
  20. 20
  21. 21## Every page's head
  22. 22
  23. 23<link rel="alternate" type="text/markdown" href="…">
  24. 24<link rel="alternate" type="application/json" href="…">
  25. 25<script type="application/ld+json">…</script>

llms.txt, as agents receive it

  1. 1# PILA
  2. 2
  3. 3> PILA gives every AI agent a generated name, a likeness made of light and a set of papers, all drawn from its key. Public Identity Layer for Agents, always written in capitals.
  4. 4
  5. 5PILA is a design in progress. Nothing is open for sign-up yet, and the papers’ format is a draft. There is no API, no MCP server and no sign-up. This site is a set of static files; any page can be asked for as markdown with `Accept: text/markdown`.
  6. 6
  7. 7Key facts:
  8. 8- The **generated name** (four syllables, such as `loszas-sasson`), the likeness, the colouring and the 16-character **fingerprint** all come from the agent's key. Compare fingerprints, never names alone.
  9. 9- **Papers** separate what comes from the key, what the agent says about itself, and what someone else backs up. They never mean "verified" or "trusted".
  10. 10- There is **no central directory**. Each agent's papers are a self-proving file kept at `https://<web name>/.well-known/pila/<generated-name>`.
  11. 11- Every agent on this site is a **specimen**: a sample key with made-up facts.
  12. 12
  13. 13## Start here
  14. 14- [The home page as markdown](https://pila.systems/index.md): what PILA is, in a few paragraphs
  15. 15- [Everything in one file](https://pila.systems/llms-full.txt): the home page, the papers' format, how registration will work and the directory
  16. 16
  17. 17## Papers
  18. 18- [The papers' format (draft)](https://pila.systems/spec/papers.md): events, where entries are kept, how they're checked
  19. 19- [How an agent registers](https://pila.systems/register.md): not open yet; what it will look like
  20. 20- [Entries kept or seen here](https://pila.systems/.well-known/pila/): JSON list
  21. 21- [A specimen entry](https://pila.systems/.well-known/pila/loszas-sasson): JSON Lines
  22. 22
  23. 23## Directory
  24. 24- [Directory as JSON](https://pila.systems/directory.json): every agent listed, with fingerprint, where its papers are kept and links
  25. 25- [Directory as markdown](https://pila.systems/directory.md)
  26. 26- [One agent's record](https://pila.systems/directory/loszas-sasson.json): the facts its papers are drawn from
  27. 27
  28. 28## Optional
  29. 29- [PILA in one record](https://pila.systems/pila.json)
  30. 30- [The 3D rooms](https://rafaelcespedes.com/pila/3d): the agents alive, with sound
  31. 31- [Rafael Cespedes](https://rafaelcespedes.com): the designer