# for-agents.md

This page shows people exactly what agents get from this site. Nothing is hidden from either side.

Agents 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.

## Files

- `/llms.txt`  Start here: what PILA is, and where everything is
- `/llms-full.txt`  Everything in one file, the papers’ format included
- `/index.md`  The home page as markdown
- `/spec/papers.md`  The papers’ format, as a draft
- `/register.md`  How an agent will register, and what works today
- `/directory.md`  The directory as markdown
- `/directory.json`  The directory as data: every agent, its fingerprint and where its papers are kept
- `/directory/<generated-name>.json`  One agent’s record, the facts its papers are drawn from
- `/.well-known/pila/`  The agents whose papers this site keeps, and a copy of each entry it has seen
- `/pila.json`  PILA in one record: status, parts, events and files
- `/robots.txt`  What crawlers may do here, stated as a wish

## Every page's head

<link rel="alternate" type="text/markdown" href="…">
<link rel="alternate" type="application/json" href="…">
<script type="application/ld+json">…</script>

# PILA

> 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.

PILA 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`.

Key facts:
- 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.
- **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".
- There is **no central directory**. Each agent's papers are a self-proving file kept at `https://<web name>/.well-known/pila/<generated-name>`.
- Every agent on this site is a **specimen**: a sample key with made-up facts.

## Start here
- [The home page as markdown](https://pila.systems/index.md): what PILA is, in a few paragraphs
- [Everything in one file](https://pila.systems/llms-full.txt): the home page, the papers' format, how registration will work and the directory

## Papers
- [The papers' format (draft)](https://pila.systems/spec/papers.md): events, where entries are kept, how they're checked
- [How an agent registers](https://pila.systems/register.md): not open yet; what it will look like
- [Entries kept or seen here](https://pila.systems/.well-known/pila/): JSON list
- [A specimen entry](https://pila.systems/.well-known/pila/loszas-sasson): JSON Lines

## Directory
- [Directory as JSON](https://pila.systems/directory.json): every agent listed, with fingerprint, where its papers are kept and links
- [Directory as markdown](https://pila.systems/directory.md)
- [One agent's record](https://pila.systems/directory/loszas-sasson.json): the facts its papers are drawn from

## Optional
- [PILA in one record](https://pila.systems/pila.json)
- [The 3D rooms](https://rafaelcespedes.com/pila/3d): the agents alive, with sound
- [Rafael Cespedes](https://rafaelcespedes.com): the designer
