# Agentic Acp Docs And Schema

> Use when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation

- Skill: `carlos-algms/agentic-acp-docs-and-schema` (Agent Skill)
- Install (CLI): `npx skillmds@latest add carlos-algms/agentic-acp-docs-and-schema`
- Raw SKILL.md: https://api.skillmd.com/api/skills/carlos-algms/agentic-acp-docs-and-schema/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: carlos-algms (https://skillmd.com/u/carlos-algms)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/carlos-algms/agentic-acp-docs-and-schema

---


# 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`.