herd-worktree

# Laravel Herd Worktree Spin up an isolated, runnable copy of a Laravel project on its own Herd site for feature-branch work - without colliding with your main checkout or, on **Herd Pro**, your shared dev database. **Announce at start:** "Using laravel-herd-worktree to set up an isolated Laravel + Herd workspace." ## Design: this is a thin Herd layer on top of `vd:worktree` Do **not** reinvent worktree mechanics. `vd:worktree` already creates the worktree under `.worktrees/<repo>-<feature>/`, copies all `.env*` (nested included), assigns a deterministic 10-port block (`.env.worktree` → `WORKTREE_PORT_BASE`), keeps `.git/info/exclude` clean, anchors agent artifacts to the main checkout, and enters the worktree. This skill only adds what Herd needs and then defers finishing to `vd:ship` / `vd:git`. | Concern | Owner | |---|---| | Worktree + branch + `.env` copy + ports | **`vd:worktree`** | | Herd site (link/secure), `.env` URL/session rewrite, DB isolation, Vite | **this skill** | | Commit / push / PR / version | **`vd:ship`** / **`vd:git`** | ## Prerequisites - **Laravel Herd** (Pro adds shared MySQL/Postgres/Redis services - relevant to DB isolation below). macOS. - **Vite** + **npm** frontend (adjust if yarn/pnpm). - **Laravel Sanctum** only if the project uses it (steps below are conditional). ## Setup ### 1. Create the worktree via `vd:worktree` Detect the branch (ticket key is authoritative), then: ```bash WT="$(for d in "$HOME/skills/skills/worktree" "$HOME/...