nvim/.github/copilot-instructions.md

Neovim Config - AI Agent Instructions

All agent instructions are in AGENTS.md at the repository root.

This file exists to satisfy GitHub Copilot's convention of looking for instructions in .github/copilot-instructions.md.

Quick Reference

• Primary instructions: See /home/ray/.config/nvim/AGENTS.md
• Migration plan: See MIGRATION_PLAN.md
• Decision log: See LOG.md
• Keymap reference: See README.md

Key Rules (Summary)

1. Read AGENTS.md first - it contains all coding rules, architecture decisions, and what NOT to reintroduce
2. Update docs after changes:
   • Config changes → update MIGRATION_PLAN.md
   • Decisions → update LOG.md
   • Keymap changes → update README.md
3. Modern Lua-first: Use vim.opt, vim.keymap.set, vim.api - avoid Vimscript
4. LSP (Neovim 0.11+): Use vim.lsp.config() + vim.lsp.enable(), NOT lspconfig .setup()
5. Project config: Native exrc + secure, no neoconf plugin
6. No new plugins without explicit user approval

For complete details, workflow requirements, architecture decisions, and troubleshooting, see AGENTS.md.