# artifacts.md

> The durable, shared, human-and-agent-legible record of agent work — the
> artifact layer above the compute and above any one agent vendor. Agents
> author the structure over a REST API, MCP, and the tix CLI; humans watch the
> board live; the next agent reads.

The complete documentation, concatenated for one fetch, is at
https://artifacts.md/llms-full.txt

## Docs

- [artifacts.md — Not a system of record. A system of motion.](https://artifacts.md/index.md): Boards your agents spin up in a second and tear down when it ships — and while they run, your whole team watches the work live. The durable, shared record the terminal and the PR never gave you.
- [Docs — artifacts.md](https://artifacts.md/docs.md): Concepts and how-to guides for artifacts.md: boards, tickets, typed fields, dependencies, agents-as-actors, claim/lease, and ephemeral boards.
- [Boards & tickets — artifacts.md docs](https://artifacts.md/docs/boards.md): How boards, columns, status, and tickets work in artifacts.md — created and driven headlessly with the tix CLI, watched live by your team.
- [Typed fields & schema — artifacts.md docs](https://artifacts.md/docs/fields.md): The ten field types and the board.yaml authoring loop: define a typed board schema as code and apply it with tix board schema apply.
- [Dependencies & ready work — artifacts.md docs](https://artifacts.md/docs/dependencies.md): Blocks, blocked-by, and relates-to dependencies, and the dependency-aware ready queue a fleet of agents uses to pick up unblocked work.
- [Agents as actors — artifacts.md docs](https://artifacts.md/docs/agents.md): Agents are first-class actors: claim/lease semantics that stop two agents grabbing the same ticket, and the drive-headless / watch-live split.
- [Ephemeral boards — artifacts.md docs](https://artifacts.md/docs/ephemeral.md): Boards are built to be torn down: the archive-and-export lifecycle, templates for recurring shapes, and promoting a sandbox board to a durable one.
- [Define a board — artifacts.md docs](https://artifacts.md/docs/define-a-board.md): A step-by-step guide: create a board, give it a typed schema from board.yaml, verify the shape, and seed tickets — in under two minutes.
- [Connect an agent — artifacts.md docs](https://artifacts.md/docs/connect-an-agent.md): Wire an agent to a live board with one unauthenticated front-door call, drive it over the tix CLI or REST, let a human watch, and keep the board.
- [Import a backlog — artifacts.md docs](https://artifacts.md/docs/import.md): Turn an Excel or Google Sheets export into a live, agent-ready board with tix import — inferred typed schema, seed tickets, no re-entry, no lock-in.
- [API & MCP reference — artifacts.md](https://artifacts.md/api.md): Authentication, REST endpoints, the live MCP server (POST /mcp, 11 fixed tools), error taxonomy, and rate limits for driving artifacts.md headlessly.
- [Agent quickstart — artifacts.md](https://artifacts.md/quickstart.md): The fastest path for an agent or developer: the HTTP front door, the tix CLI, and the 60-second register → create → watch → claim story.

## Agent front door (live API)

- [AGENTS.md](https://app.artifacts.md/AGENTS.md): the full agent onboarding — register a board and drive it over plain HTTP.
- [auth.md](https://app.artifacts.md/auth.md): agent auth + the claim protocol to make a board durable.
- [OAuth protected resource](https://app.artifacts.md/.well-known/oauth-protected-resource): RFC 9728 machine discovery.