phase 1 mvp

claude-integration-dev.md

@@ -0,0 +1,74 @@
+# Claude Integration Development Notes
+
+## Quick Start
+
+1. Check task progress: `./check-tasks.sh`
+2. View tasks: `nvim tasks.md`
+3. Start implementing: Begin with Phase 1 tasks
+
+## Key Files
+
+- `tasks.md` - Comprehensive task tracking (gitignored)
+- `check-tasks.sh` - Progress tracking script (gitignored)
+- `lua/nvim-claude/` - Plugin code (to be created)
+- `lua/colinzhao/lazy/claude.lua` - Plugin config (to be created)
+
+## Development Workflow
+
+1. Pick a task from `tasks.md`
+2. Implement the feature
+3. Test it thoroughly
+4. Mark task as complete: Change `- [ ]` to `- [x]`
+5. Run `./check-tasks.sh` to see progress
+
+## Testing Commands
+
+```bash
+# Test plugin loading
+nvim -c "echo 'Plugin loaded'" -c "qa"
+
+# Test specific commands (once implemented)
+nvim -c "ClaudeChat" 
+nvim -c "ClaudeBg 'test task'"
+```
+
+## Git Worktree Commands (for reference)
+
+```bash
+# List worktrees
+git worktree list
+
+# Add new worktree
+git worktree add .agent-work/2024-01-15-feature main
+
+# Remove worktree
+git worktree remove .agent-work/2024-01-15-feature
+```
+
+## Tmux Commands (for reference)
+
+```bash
+# Split pane horizontally
+tmux split-window -h -p 40
+
+# Name current pane
+tmux select-pane -T "claude-chat"
+
+# List panes with names
+tmux list-panes -F "#{pane_id} #{pane_title}"
+
+# Send keys to specific pane
+tmux send-keys -t %1 "echo 'Hello'" Enter
+```
+
+## Architecture Notes
+
+- **Tmux-first**: All Claude interactions in tmux panes
+- **Git worktrees**: For agent isolation
+- **State management**: JSON files in `.agent-work/.state/`
+- **No nvim terminal**: Respect existing workflow
+
+## Current Status
+
+- Phase: Planning → Implementation
+- Next: Create plugin skeleton (Task 1.1)