메뉴
MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | agentic-acp-protocol-flow |
| description | MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim. |
Use this skill for ACP runtime behavior. For schema facts, also load
agentic-acp-docs-and-schema.
ACPClient in acp_client.lua.config_default.lua entry under acp_providers unless
the provider deviates from ACP in a new way.ACPClient methods, not adapter files.provider subprocess
-> ACPTransport
-> ACPClient
-> SessionManager subscriber
-> MessageWriter / PermissionManager / TodoList / ChatHistory
references/client-lifecycle.md: ACPClient.state, ready listeners, sync vs
async dispatch, reconnect, pending callback draining.references/transport-framing.md: stdio line framing, partial chunks,
subprocess process-group termination.references/tool-calls-permissions.md: session/update routing, tool-call
lifecycle, permission request normalization, provider quirks.references/provider-switch-options.md: provider switch replay, modes/models,
thought level, config options.Current extension points:
| Method | Behavior |
|---|---|
__handle_tool_call | Builds ToolCallBlock, notifies subscriber |
__build_tool_call_message | Parses ACP fields and quirk fallbacks |
__handle_tool_call_update | Builds partial, notifies subscriber |
__handle_request_permission | Sends permission result to provider |
__handle_session_update | Routes by sessionUpdate type |
Only subclass or extend these when a real provider deviation requires it.
Handle protocol deviations inline in __build_tool_call_message.
rawInput fallback builds diffs when content is missing for edit
tool calls.locations fallback extracts file_path from update.locations[0].path.MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD. Covers mini.test workflow, red/green rules, commands, mark-count checks, and which test references to load.
MANDATORY before writing or editing ANY .lua file in this repo - classes, methods, fields, functions, or LuaCATS annotations. Holds the project's enforced Lua style: class pattern, visibility prefixes (_private, __protected), and optional-type syntax. Skipping it produces luals/selene failures at make validate. Load it before the first edit, not after.
Use when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation
Use when creating, listing, or managing GitHub discussions in carlos-algms/agentic.nvim repository
Use when neovim documentation is needed for the current task or the user asks for specific neovim features or neovim lua apis. It gives instructions on how to read current Neovim's documentation locally and offline, and also how to read online if it fails
MANDATORY before editing runtime Lua under lua/agentic, except pure tests or docs. Covers multi-tab safety, public API session resolution, scoped Neovim state, buffer/window/keymap isolation, and scheduled callback rules.