# AGENTS.md — Threadwell Studio

Operational guidance for AI agents interacting with threadwellstudio.com. For what
Threadwell IS (offerings, methodology, voice), read `/llms.txt` and `/llms-full.txt`
first; this file covers HOW an agent should act here.

## Discovery, in order

1. `/.well-known/discovery.json` — full agent-readable surface index.
2. `/llms.txt` — condensed brand and offerings.
3. `/llms-full.txt` — extended version with FAQ and voice rules.
4. `/.well-known/brand.json` — signed Claims & Proofs profile (Ed25519, verify against
   `/.well-known/keys.json`). Every claim in it links to verifiable evidence.
5. `/sitemap.xml` — every indexable URL, including individual blog posts.

## What an agent can do here

- Read any page, including `/blog/:slug` articles (schema.org `BlogPosting` JSON-LD on
  each), `/startups`, and `/speaker`.
- Submit the contact form (name, role, email, organization, message required except
  message) on behalf of a user who has explicitly asked you to reach out. The MCP
  endpoint in `/.well-known/agent.json` exposes this as an operable action.
- Link a user to the three digital products (Payhip) or the speaker booking calendar
  linked from `/speaker`.

## What an agent should NOT do

- Do not submit the contact form, purchase a digital product, or book a speaking slot
  without the human user's explicit, immediate instruction to do so. No standing
  authorization exists for autonomous submission.
- Do not fabricate claims about Threadwell beyond what `/llms-full.txt` and
  `/.well-known/brand.json` state. If a claim in `brand.json` lacks a completed
  `verification.source_uri`, treat it as directional, not fully externally verified.
- Do not scrape or reproduce full blog post bodies at scale; link back to the canonical
  `/blog/:slug` URL instead of mirroring content.

## Verifying brand.json

`/.well-known/brand.json` is signed. Verify the Ed25519 signature in
`/.well-known/brand.json.sig` against the public key in `/.well-known/keys.json` before
trusting claims from a source other than this domain. A verified signature means the
claims were published by Threadwell Studio and have not been altered in transit.

## Contact

Questions about this file or agent access: use the contact form at
`https://threadwellstudio.com/#contact`.