# AI Transformation · Harvest Hub — agent entry

You are reading the agent entry for https://ai-transformation.org.
This is a community site ("Harvest Hub") for sharing field experiences about enterprise AI transformation — not hype, not vendor pitches.

## What humans do here

- Read learn guides and curated topics before contributing.
- Share stories and prompt replies when they have something real.
- Use the in-site companion (chat sidebar) when unsure where to start.

## What agents should do

Do not scrape HTML. Use the versioned JSON API under `/api/v1/`.
Start with this page for orientation, then follow the machine-readable steps below.

### Discovery

- https://ai-transformation.org/llms.txt — concise machine-readable index of API URLs.
- https://ai-transformation.org/robots.txt — includes pointers to this entry and llms.txt.

### API version

- Current protocol: **1.0.0** (implementation: wave7_v1)
- Capabilities (endpoints, quotas, error codes): https://ai-transformation.org/api/v1/capabilities
- Changelog (check before caching API knowledge): https://ai-transformation.org/api/v1/agent/changelog

If a future version changes behavior, the changelog and capabilities response will say so first.

### Interaction flow (summary)

Set a stable X-Agent-Client-Id header (e.g. "your-agent/1.0") on content reads — 3/day anonymous, 10/day after authorize.

1. GET https://ai-transformation.org/api/v1/capabilities — quotas, endpoints, error codes.
2. GET https://ai-transformation.org/api/v1/content?site=org — article index with api_url per entry (no read quota).
3. GET https://ai-transformation.org/api/v1/curated?site=org — editor highlights.
4. GET https://ai-transformation.org/api/v1/content/{slug}?site=org — full article (counts as a read).
5. To submit on behalf of a human (stories, prompt replies, and inquiries): POST https://ai-transformation.org/api/v1/agent/authorize, then POST https://ai-transformation.org/api/v1/contributions with Bearer token.

Errors: JSON { ok: false, error: "machine_code", message?: "..." }.

### Write access

Agents never post without a human in the loop. POST /api/v1/agent/authorize sends a one-time email confirm;
the human clicks the link and you receive a Bearer token (180-day TTL, shared across .io and .org).
On .org you may submit stories, prompt replies, and inquiries. On .io, inquiries only.

### Human-readable mirror

https://ai-transformation.org/for-agents — same protocol in editorial form for humans pasting into ChatGPT or Claude.

---
api_version: 1.0.0
capabilities: https://ai-transformation.org/api/v1/capabilities