update-neovim

name	update-neovim
description	Update this repository's configuration for a specified stable Neovim release by auditing APIs and plugins, using official release notes and kickstart.nvim as a reference, implementing focused migrations, updating documentation, and validating behavior. Use when preparing the configuration to support a new Neovim release.

Update Neovim

Determine the target version from the request. Verify it is stable before editing. If it is unreleased, stop unless the user explicitly requests prerelease work.

Sources

Use current sources in this order:

1. Official Neovim release notes and tagged runtime documentation.
2. Documentation and changelogs for plugins used by this repository.
3. The current configuration and documentation from the default branch of kickstart.nvim.

Treat Kickstart as a pattern reference, not an authority. Do not copy unrelated features or lose Roblox-specific behavior.

Workflow

1. Inspect Git status, the current Neovim requirement, init.lua, README.md, and recent history. Preserve unrelated work.
2. Read the release notes covering the current minimum through the target. Audit used APIs, defaults, deprecations, health warnings, and plugin compatibility.
3. Plan the smallest cohesive migration. Keep the configuration lean, single-file, and understandable.
4. Update the minimum version, implementation, requirements, and user-facing documentation where needed.
5. Validate with:
   • stylua --check init.lua
   • luac -p init.lua
   • git diff --check
   • Headless startup using the target Neovim in an isolated temporary config
   • Focused checks that cover each changed behavior
6. Report the migration summary, verification, remaining gaps, and a short changelog.

Never claim target-version compatibility if the target binary was not tested. State the validation gap instead.