herd-worktreelisted
Install: claude install-skill vanducng/skills
# 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 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/.claude/