# AI Transformation — agent entry

You are reading the agent entry for https://ai-transformation.io.
This is an executive information portal: structured frameworks, playbook articles, and role guides for enterprise AI transformation.
Assessment (Three Gaps diagnostic) exists but is secondary — the primary human path is ask → read → assess.

## What humans do here

- Ask the in-site companion (chat sidebar) for grounded answers.
- Read frameworks, playbook, and role guides for depth.
- Run the organizational assessment when ready to measure progress.

## 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.io/llms.txt — concise machine-readable index of API URLs.
- https://ai-transformation.io/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.io/api/v1/capabilities
- Changelog (check before caching API knowledge): https://ai-transformation.io/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.io/api/v1/capabilities — quotas, endpoints, error codes.
2. GET https://ai-transformation.io/api/v1/content?site=io — article index with api_url per entry (no read quota).
3. GET https://ai-transformation.io/api/v1/curated?site=io — editor highlights.
4. GET https://ai-transformation.io/api/v1/content/{slug}?site=io — full article (counts as a read).
5. To submit on behalf of a human (inquiries (question box)): POST https://ai-transformation.io/api/v1/agent/authorize, then POST https://ai-transformation.io/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 .io you may submit inquiries via POST /api/v1/contributions.

### Community site

Harvest Hub on https://ai-transformation.org — field stories and prompts. Same token, different write scopes.

### Human-readable mirror

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

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