32 lines (23 loc) · 1.34 KB

Agent Guidance

This repo is a personal Neovim configuration. When editing it, please follow these guidelines.

General Principles

Prefer small, focused diffs. One logical change per session.
Preserve existing style. Match indentation (2-space), naming, and module layout.
Do not refactor unrelated code. Fix only what was asked.
Explain changes clearly. Summarize what you changed and why.
Run relevant checks. If you edit Lua, verify nvim --headless loads without errors.

Architecture

init.lua is the entry point. It delegates to lua/edwin/init.lua.
lua/edwin/init.lua loads modules in a fixed order. Add new modules there.
lua/edwin/packer.lua declares plugins. Keep plugin declarations alphabetical-ish by concern.
after/plugin/ contains plugin-specific config that must run after plugins load.
Prefer Lua over Vimscript.

Key Conventions

Leader key is , (comma).
Do not overwrite existing keymaps without asking.
Plugin configs live in lua/edwin/<name>.lua (or after/plugin/<name>.lua if needed).
Use pcall(require, ...) for optional plugins.

Safety

Do not delete plugins or modules unless explicitly requested.
Do not change the color scheme or core editor settings without asking.
Keep the config reversible: someone should be able to git checkout to undo a bad change.