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