## AKOS — API knowledge (append to a project's CLAUDE.md)
- AKOS is the system of record for external APIs: https://akos.spboucher.ai (MCP `akos`, CLI `akos`, SDK `akos.sdk`).
- Before writing an integration: `search_knowledge` / `akos search <q>`; reuse the AKP client (`akos inspect <akp_id>`, `/api/v1/akps/<id>/bundle.zip`).
- Acquire data only via `execute_api` (gateway) or the generated client in `gateway` transport, so provenance exists; register new APIs with `discover_api`.
- Secrets: AKOS vault references only (`vault://keychain/akos/<name>`); never put tokens in code, prompts or .env committed to git.