This repository is a dotfiles and tooling repository.
Characteristics:
- Multiple independent subtrees (shell, nvim, ai, scripts, etc.)
- Not a single application
- Focus on developer environment, not runtime behavior
- No deployment target
Expect:
- Shell configurations
- Editor configurations
- Scripts
- Cross-platform concerns
Guidelines for agents:
- Do not assume a build system
- Do not assume an application life-cycle
- Treat subdirectories as largely independent
- Prefer explanation and planning over code generation
- Never create symlinks (copies only — symlinks break on branch switch)
Git workflow:
- Always use git worktrees for implementation work, never work in the main checkout directly
- Worktree naming:
${repo-name}-${suffix}as a sibling directory
When unsure:
- Ask for clarification rather than guessing