<!-- BEGIN CUTTLEFISH-MANAGED -->
<!-- Auto-generated by Cuttlefish. Manual edits inside this block will be overwritten. -->

## Cuttlefish

### Worktree Setup (MANDATORY)

You MUST use `register_worktree` (Cuttlefish MCP) for every task. NEVER use bare `git worktree add`.

`register_worktree` with `hydrate: true` (the default) CoW-clones critical build artifacts into the new worktree. **Without these artifacts, the worktree cannot build.**

Port allocation is enabled (base port: 3100). Each worktree gets a unique port written to `.env.worktree`.

After `register_worktree` returns:
1. `cd` into the returned `worktreePath`
2. Use the worktree path as the root for ALL file operations
3. When done, commit and push your branch, then call `mark_complete`

### Available MCP Tools

- `register_worktree` — Create a git worktree with hydration
- `mark_complete` — Signal worktree work is done
- `remove_worktree` — Remove a worktree checkout
- `convert_to_branch` — Convert worktree to branch, preserving commits
- `list_worktrees` — List all worktrees and their status
- `get_repo_info` — Repository info and recent commits
- `get_symbols` — Symbol outline for a file
- `find_references` — Find all references to a symbol
- `go_to_definition` — Jump to symbol definition
- `get_hover_info` — Type info and documentation for a symbol
- `check_symbol_conflicts` — Check for cross-worktree symbol conflicts
- `get_symbol_history` — Git history of a function or symbol
- `get_task_briefing` — Curated context briefing for a task
- `push_branch` — Push a branch to its remote
- `fetch` — Fetch updates from a remote
- `pull` — Pull changes (fast-forward only)
- `list_remotes` — List configured remotes
- `generate_agent_config` — Generate or update this config file

<!-- END CUTTLEFISH-MANAGED -->
