---
name: agentic-acp-docs-and-schema
description:
  Use when ACP schema is necessary to clarify the work or when the user asks for
  ACP data, rules, events, or documentation
---

# ACP documentation and schema

The ACP documentation can be found at:

- Complete Schema: https://agentclientprotocol.com/protocol/schema.md
- Overview: https://agentclientprotocol.com/protocol/overview.md
- Initialization: https://agentclientprotocol.com/protocol/initialization.md
- Session Setup: https://agentclientprotocol.com/protocol/session-setup.md
- https://agentclientprotocol.com/protocol/session-config-options.md
- Prompt Turn: https://agentclientprotocol.com/protocol/prompt-turn.md
- Content: https://agentclientprotocol.com/protocol/content.md
- Tool Calls: https://agentclientprotocol.com/protocol/tool-calls
- File System: https://agentclientprotocol.com/protocol/file-system.md
- Terminals: https://agentclientprotocol.com/protocol/terminals.md
- Agent Plan: https://agentclientprotocol.com/protocol/agent-plan.md
- Session Modes: https://agentclientprotocol.com/protocol/session-modes.md
- Slash Commands: https://agentclientprotocol.com/protocol/slash-commands.md
- Extensibility: https://agentclientprotocol.com/protocol/extensibility.md
- Transports: https://agentclientprotocol.com/protocol/transports.md

## ACP architectural limitations:

- **No partial acceptance of file changes:** Users must accept or reject the
  entire file's changes as a unit. The ACP protocol is async and transactional
  (all-or-nothing tool calls). Implementing partial acceptance would require
  complex workarounds (e.g., auto-accepting then partially reverting) which adds
  significant complexity. This feature is deferred/out of scope.

## Message flow and tool call lifecycle

Required reading for working on adapters, `MessageWriter`, `SessionManager`, or
`PermissionManager`.