update

MIGRATION_PLAN.md

@@ -50,6 +50,7 @@ Source of truth for the step-by-step rebuild. Keep this concise and up to date.
 - [x] Decision: Enable Markdown LSP = `marksman`
 - [x] Decision: Use legacy `listchars` and `showbreak` values
 - [x] Decision: Support per‑project config for `intelephense.includePaths`
+- [x] Decision: No direnv fallback for local config
 
 ## Phase 3.2 — Non-plugin settings to Lua
 - [ ] Port non-plugin settings to Lua (options, listchars, showbreak, spelllang=en_gb)
@@ -57,12 +58,13 @@ Source of truth for the step-by-step rebuild. Keep this concise and up to date.
 ## Phase 3.3 — Core completion stack
 - [ ] Add core completion stack: `nvim-cmp`, `cmp-nvim-lsp`, `cmp-buffer`, `cmp-path`, `LuaSnip`
 
-## Phase 3.4 — Project‑local configuration
+## Phase 3.4 — Project‑local configuration (neoconf)
 - [ ] Confirm scope and priorities for this subphase
-- [ ] Choose local config format and location (e.g., `.nvim.lua` or `.nvim/config.lua` at project root)
-- [ ] Implement loader to read nearest project config (git root fallback)
-- [ ] Wire `intelephense.includePaths` from local config into LSP setup
-- [ ] Document usage in repo README (example config)
+- [x] Choose approach: use `folke/neoconf.nvim` (replaces custom loader)
+- [ ] Add `folke/neoconf.nvim` plugin spec and minimal setup
+- [ ] Document `.neoconf.json` usage and example in README
+- [ ] Verify neoconf merges settings into lspconfig
+- [ ] Wire `intelephense.environment.includePaths` via `.neoconf.json`
 
 ## Phase 3.5 — LSP minimal defaults
 - [ ] Add `nvim-lspconfig` with minimal defaults (no over-configuration)
@@ -178,3 +180,4 @@ Notes:
 - Keep plugin specs minimal; configure in their own `lua/plugins/*.lua` files.
 - Avoid adding plugins not listed in the guide unless explicitly requested.
 - Prefer simple defaults; only add settings that clearly improve workflow.
+- Plugin approval policy: unlisted plugins may be proposed, but must be explicitly confirmed before installation.