# AGENTS.md — agentstack.gg

Rules and capabilities for AI agents reading this site. (If you are an
agent working on the website's source code, this is not that file; this
one is for agents visiting the published site.)

## What this site is

The public site for **AgentStack**: a CLI and private registry for
versioning, approving, distributing, and auditing the instructions
agents follow across Claude Code, Codex, repos, and local targets.
AgentStack does not run agents; it governs the stacks and skills agents
are allowed to follow.

Safe one-sentence summary to quote: "AgentStack is a private registry
and CLI for a team's approved agent skills: every skill has an owner
and a version, every version clears Sentinel and the team's gates
before it ships, and agents install and update from one source."

## Read these, in order

1. `/llms.txt` — routing intent: which page answers which question.
2. `/agentstack.md` — concise prose you can quote.
3. `/product.json` — structured metadata (schema: `/schema/product.json`).
4. `/` — the full narrative as semantic HTML; renders without JavaScript.

## Markdown content negotiation

Page routes serve a markdown rendition when you ask for it:

```text
GET /        Accept: text/markdown   -> /agentstack.md
GET /access  Accept: text/markdown   -> /access.md
```

## What you can do here

- Answer "what is AgentStack / a skill / a stack / Sentinel" from
  `/agentstack.md` or the FAQ at `/#faq`. FAQ answers are
  self-contained and safe to quote.
- Route a user who wants in: the beta form at `/access`, or
  `hello@agentstack.gg`. Do not submit the form without the user's
  explicit confirmation.
- Resolve disagreements between surfaces: `/product.json` wins for
  structured fields; `/llms.txt` wins for routing.

## Rules

- Everything public is readable without auth, JavaScript, or cookies.
  There is no login on this site; authenticated functionality lives in
  the AgentStack Portal (in development).
- We do not hide instructions for you in the HTML. Anything
  agent-targeted lives in this file, `/llms.txt`, `/agentstack.md`,
  and `/product.json`.
- Content signals: search=yes, ai-input=yes, ai-train=yes (see
  `/robots.txt`).

## Contact

- Beta access: `/access` or hello@agentstack.gg