From solopreneur
Creates git worktree for tasks under .worktrees/, copies gitignored config files, and writes structured docs/CONTEXT.md with problem context for session handoff.
npx claudepluginhub hanamizuki/solopreneur --plugin neo4j-devThis skill uses the workspace's default tool permissions.
Create an isolated workspace for a new or in-progress task, and write the complete
Creates git worktree for new branch in separate directory with setup and test baseline. Enables parallel Claude Code sessions on multi-repo projects without disturbing main workspace.
Creates isolated git worktrees for feature branches with smart directory selection, gitignore checks, auto project setup detection, and baseline test verification. Use for task isolation from main workspace.
Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.
Share bugs, ideas, or general feedback.
Create an isolated workspace for a new or in-progress task, and write the complete task context into the new worktree so the next session doesn't need to start from scratch.
Name based on task type and description:
| Task Type | Branch Prefix | Example |
|---|---|---|
| Bug fix | fix/ | fix/sleep-calculation |
| New feature | feature/ | feature/health-connect-edit |
| Refactor | refactor/ | refactor/sleep-sessionizer |
| Research | research/ | research/healthkit-sources |
Worktree directory name = branch name slug (strip prefix, use - separators).
Always place worktrees under .worktrees/:
git worktree add .worktrees/<slug> -b <branch-name>
Prohibited:
.worktrees/Worktrees are separate directories — files excluded by .gitignore don't carry over
automatically. After creating the worktree, check for and copy relevant config files:
# Get the main repo root
MAIN_REPO="$(git worktree list | head -1 | awk '{print $1}')"
WORKTREE=".worktrees/<slug>"
# Find gitignored config files that exist in the main repo
# Common patterns: .env, *.xcconfig, local.properties, secrets.json
# Copy any that are relevant to this project
Detection strategy:
.gitignore for patterns that match config/secret filesPrinciple: Only copy gitignored environment config files. Never copy build artifacts or caches.
Write the complete task context into docs/CONTEXT.md in the new worktree.
This file is the next session's sole knowledge source.
CONTEXT.md structure:
# Context: <branch-name>
## Problem Background
[Why is this being done? User reports? Screenshots? Logs?]
## Root Cause
[Known technical issues, include file paths + line numbers]
## Items to Fix / Implement
[Checklist, with expected approach for each item]
## Key Files
[Table: file path | description]
## Current Progress
[Not started / which steps are already done]
Writing principles:
If docs/CONTEXT.md already exists (from another task on main), overwrite its entire
content with the current task's context.
Output this message so the user can paste it into a new session:
cd /path/to/repo/.worktrees/<slug>
Read `docs/CONTEXT.md` first — it contains the full context for <one-line task description>.
Branch: `<branch-name>`, <one sentence describing the core problem or goal>.
User says: "Open a worktree to fix the sleep calculation — the issue is duplicate sources from HealthKit"
git worktree add .worktrees/fix-sleep-calculation -b fix/sleep-calculation
CONTEXT.md content: full problem background, root cause (HealthKit not deduplicating), key files list, suggested fix direction.
Output for user:
cd /path/to/project/.worktrees/fix-sleep-calculation
Read `docs/CONTEXT.md` first — it contains the full context for the sleep calculation fix.
Branch: `fix/sleep-calculation`, the issue is that HealthKit multi-source sleep samples
aren't being deduplicated, causing displayed sleep time to exceed Apple Health's value.