agentic.nvim

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.

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

MANDATORY before editing MessageWriter, PermissionManager, tool-call block rendering, sender headers, thinking blocks, auto-scroll, folds, status rows, permission buttons, or chat-buffer tool-call tests.

Use when writing or updating agentic.nvim vimdoc (doc/agentic.txt), or after changing init.lua, config_default.lua, theme.lua, or README install/keymaps - those edits require a matching vimdoc update. Covers the sync table, format rules, and the helptags regeneration command.