dev-worktree

Solid

AI DevKit · Worktree setup and resume guidance for isolated feature work. Use when starting, resuming, switching, or verifying a feature branch/worktree for lifecycle, debugging, implementation, review, or multi-agent workflows.

AI & Automation 1,587 stars 243 forks Updated today

Install

View on GitHub

Quality Score: 81/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
Description 5%
100

Skill Content

# Dev Worktree Set up or resume the correct workspace before feature work. Keep this skill focused on repository context, worktree isolation, and dependency bootstrap. Do not perform requirements, design, planning, implementation, testing, or review work here. ## Phase Contract 1. Propose the exact workspace plan before changing branch or worktree state. 2. Confirm the target branch/worktree with the user before switching contexts. 3. Use `feature-<name>` for branch and worktree names, where `<name>` is normalized kebab-case without the prefix. 4. Prefer a project-local worktree at `<project-root>/.worktrees/feature-<name>`. 5. Use no-worktree mode only when the user explicitly requests it. 6. Run all follow-up commands in the verified target context. ## Start Feature Workspace Use for a new feature start. 1. Normalize feature name to kebab-case `<name>`. 2. Determine the project root, the directory containing `.git`. 3. If the user explicitly requests no worktree: - Continue in the current repository and branch. - Call out that branch/workspace isolation is reduced. - Skip to dependency bootstrap. 4. Otherwise use branch/worktree name `feature-<name>`. 5. Ensure `.worktrees` is listed in the project `.gitignore`; if not, add it. 6. If branch does not exist, run `git worktree add -b feature-<name> .worktrees/feature-<name>`. 7. If branch exists and the target worktree does not, run `git worktree add .worktrees/feature-<name> feature-<name>`. 8. If the target wo...

Details

Author
codeaholicguy
Repository
codeaholicguy/ai-devkit
Created
10 months ago
Last Updated
today
Language
TypeScript
License
None

Similar Skills

Semantically similar based on skill content — not just same category