dotfiles: Instructions file for Claude Code

CLAUDE.md

This file provides guidance on how Claude Code (claude.ai/code) handles the code in this repository.

Vim to Neovim Migration Guidelines

When migrating Vim configuration to Neovim:

Complete Migration Philosophy

• Migrate ALL files: Every file in the Vim configuration directory structure must be migrated faithfully to Neovim
• No function removal: Never comment out or remove functionality due to missing dependencies or different concepts between Vim and Neovim
• Implement missing concepts: When Neovim lacks a Vim concept (like autoload), implement a better custom solution rather than removing functionality
• Preserve all keymappings: All keymappings must be preserved and functional in the migrated configuration

Directory Structure Mapping

Vim (.vim/)                     → Neovim (.config/nvim/)
├── .vimrc                      → init.lua
├── autoload/**/*.vim           → lua/**/*.lua (custom implementation)
├── plugin/**/*.vim             → plugin/**/*.lua
├── ftdetect/**/*.vim           → ftdetect/**/.lua
├── after/ftplugin/**/*.vim     → after/ftplugin/**/*.lua
├── syntax/**/*.vim             → syntax/**/*.lua
└── indent/**/*.vim             → indent/**/*.lua

Conversion Patterns

• set option=value → vim.opt.option = value
• nnoremap key action → vim.keymap.set('n', 'key', 'action')
• autocmd Event pattern action → vim.api.nvim_create_autocmd('Event', {pattern = 'pattern', callback = function() ... end})
• command! Name action → vim.api.nvim_create_user_command('Name', function() ... end, opts)
• " comment → -- comment

Vital.vim Replacement

Since vital.vim doesn't exist for Neovim, create custom Lua modules:

• vital#vimrc#import('Data.List') → require('utils.list')
• vital#vimrc#import('Vim.Message') → require('utils.message')
• Implement expected functionality in separate modules under lua/utils/