acp-protocol git:20261004.4bb7222A

Immutable. This exact content never changes and is served at /api/v1/blob/06f9ed9bd2559940.

---
description: ACP session readiness, notifications, and wire compatibility
globs:
  - "internal/acp/**/*.go"
  - "cmd/coddy/acp*.go"
  - "examples/acp/**/*.py"
  - "docs/reference/acp-protocol.md"
alwaysApply: false
---
# ACP protocol readiness and compatibility

- Completion of a JSON-RPC response does not mean that session-ready notifications have already arrived.
- After `session/new` or `session/load`, a consumer expecting `available_commands_update` keeps reading until that notification arrives and preserves every intervening notification.
- Do not diagnose an immediately empty catalog as a skill or rule discovery failure before reading the post-response notification.
- Preserve ACP schema wire names and generated camelCase fields.