← ClaudeAtlas

herd-worktreelisted

Set up an isolated git worktree for a Laravel project served by Laravel Herd (Pro-aware). Composes vd:worktree for the worktree/.env/port mechanics, then adds the Herd layer: link + scheme-correct site (HTTPS via herd secure when the source is secured), .env rewrite (APP_URL, SESSION_DOMAIN, Sanctum - only when present), opt-in per-worktree database isolation, Vite TLS/CORS, then hands finishing to vd:ship / vd:git. Triggers: 'herd-worktree', 'herd worktree', 'laravel herd worktree', 'isolate a Laravel feature branch', 'work on this Laravel branch with Herd'.
vanducng/skills · ★ 7 · AI & Automation · score 81
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/