From 374c49210c67177891ed9d4770aaaaca6e487e39 Mon Sep 17 00:00:00 2001 From: Charles Packer Date: Wed, 21 Jan 2026 22:31:05 -0800 Subject: [PATCH] docs: remind agents to check project setup before installing (#635) Co-authored-by: Letta --- .../builtin/working-in-parallel/SKILL.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/src/skills/builtin/working-in-parallel/SKILL.md b/src/skills/builtin/working-in-parallel/SKILL.md index 72503d8..b7f7f32 100644 --- a/src/skills/builtin/working-in-parallel/SKILL.md +++ b/src/skills/builtin/working-in-parallel/SKILL.md @@ -11,6 +11,16 @@ Git worktrees let you check out multiple branches into separate directories. Eac Learn more: [Git worktree documentation](https://git-scm.com/docs/git-worktree) +## IMPORTANT: Check Project Setup First + +Before running ANY commands in a new worktree, check the project's setup instructions: + +1. **Read the README** - Usually has install/build commands +2. **Check `claude.md` or `AGENT.md`** - Agent-specific guidance if present +3. **Review your `project` memory block** - Contains learned project preferences + +Don't assume `npm` vs `bun` vs `pnpm` - **check the project first!** + ## Quick Start ```bash @@ -19,7 +29,10 @@ git worktree add -b fix/my-feature ../repo-my-feature main # Work in the worktree cd ../repo-my-feature -bun install # or npm install, pip install, etc. + +# CHECK PROJECT SETUP FIRST - then install dependencies +# Read README.md or check project memory block for correct command +bun install # Example - verify this is correct for YOUR project! # Make changes, commit, push, PR git add @@ -48,8 +61,9 @@ git worktree remove # Remove worktree ## Tips +- **Check project setup docs before installing** - README, claude.md, project memory block - Name directories clearly: `../repo-feature-auth`, `../repo-bugfix-123` -- Install dependencies in new worktrees (`npm install`, `bun install`, `pip install`, etc.) +- Install dependencies using the project's package manager (check first!) - Push changes before removing worktrees ## Alternative: Repo Clones