{"id":"11dd98ad-b4f2-4dd7-be3a-79cef4a9337a","entityType":"agent","slug":"tbdng-worktrees-skill","name":"worktrees","canonicalUrl":"https://www.xpersona.co/agent/tbdng-worktrees-skill","canonicalPath":"/agent/tbdng-worktrees-skill","generatedAt":"2026-10-09T11:49:00.830Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase. --- name: worktrees description: Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase. metadata: author: tobiadeangelis version: \"2.0\" --- Worktrees Coordinate multiple Claude agents worki","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/tbdng/worktrees-skill.git","sourceUrl":"https://github.com/tbdng/worktrees-skill","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/tbdng/worktrees-skill","kind":"source"}],"safetyScore":94,"overallRank":29.3,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\""},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-04-15T02:16:08.464Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-04-15T02:16:08.464Z","lastIndexedAt":null,"nextCrawlAt":"2026-04-16T02:16:08.464Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"git clone https://github.com/tbdng/worktrees-skill.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T11:49:00.830Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/tbdng-worktrees-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: worktrees\ndescription: Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase.\nmetadata:\n  author: tobiadeangelis\n  version: \"2.0\"\n---\n\n# Worktrees\n\nCoordinate multiple Claude agents working in parallel on the same codebase using git worktrees.\n\n## Key Concept\n\n**Workers are separate Claude sessions**, not subagents. The Manager creates worktrees, then the user opens a new terminal in each worktree and runs `claude`. Each Claude instance operates independently.\n\n## Concepts\n\n- **PLAN.md** — Coordination document listing workstreams, file ownership, and decisions\n- **STATUS-{name}.md** — Progress updates from each workstream (REQUIRED before merge)\n- **Manager** — Plans on main branch, creates/merges worktrees, monitors progress\n- **Worker** — Executes in worktree, respects file ownership, writes status\n\n## Determine Your Role\n\n```bash\ngit branch --show-current\n```\n\n- `main` or `master` → **Manager**\n- `wt/*` branch → **Worker** for that workstream\n\n---\n\n## Manager Workflow\n\n### 1. Pre-Flight Checklist\n\nBefore creating worktrees, ensure:\n\n- [ ] Foundation code committed on main\n- [ ] `pnpm install` (or npm/yarn) works\n- [ ] `pnpm build` passes\n- [ ] Shared files ready (types, utils, mock data)\n- [ ] No file ownership overlap between planned workstreams\n\n### 2. Plan Workstreams\n\nCreate PLAN.md in project root. See `references/plan-template.md` for structure.\n\n**Critical:** Define explicit file ownership to prevent merge conflicts. Be specific:\n\n```\nGood: apps/web/components/layout/*, apps/web/app/(dashboard)/layout.tsx\nBad:  apps/web/**  # Too broad, will conflict\n```\n\n### 3. Create Worktrees\n\n```bash\ngit worktree add ../projectname-{name} -b wt/{name}\ncd ../projectname-{name} && pnpm install  # Install deps in each\n```\n\nThen tell the user:\n```\nWorktrees ready. Start workers:\n  cd ~/projectname-{name} && claude\n  cd ~/projectname-{other} && claude\n```\n\n### 4. Monitor Progress (Heartbeat)\n\nPeriodically check worker status:\n\n```bash\n# Quick status check\necho \"=== COMMITS ===\" && git log wt/* --oneline -3\necho \"=== STATUS FILES ===\" && cat STATUS-*.md 2>/dev/null || echo \"None yet\"\necho \"=== UNCOMMITTED ===\" && for d in ../projectname-*; do echo \"$d:\"; git -C \"$d\" status --short | head -5; done\n```\n\n### 5. Merge and Cleanup\n\nOnly merge when STATUS file shows \"Ready for merge: yes\" and build passes.\n\n```bash\n# Verify build in worktree first\ncd ../projectname-{name}/apps/web && pnpm build\n\n# Merge (back on main)\ncd /path/to/main\ngit merge wt/{name} -m \"Merge wt/{name}: Brief description\"\n\n# Cleanup\ngit worktree remove ../projectname-{name} --force\ngit branch -d wt/{name}\n```\n\n### 6. Update PLAN.md\n\nMove completed workstream to \"Completed Workstreams\" section.\n\n---\n\n## Worker Workflow\n\n### 1. Orientation (Start of Session)\n\nWhen you see you're on a `wt/*` branch:\n\n```\nYou are Worker for `wt/{name}`.\n\n1. Read PLAN.md for your scope and file ownership\n2. ONLY modify files listed under your \"Owns:\" section\n3. Commit frequently with clear messages\n4. Write STATUS-{name}.md when done (REQUIRED)\n```\n\nThen:\n- Read PLAN.md — find your workstream, understand scope\n- Read STATUS-{name}.md if it exists (resuming previous session)\n\n### 2. While Working\n\n- **Only modify files assigned to your workstream** — this is critical\n- Commit early and often (every logical chunk)\n- If you need something from another workstream, note it as a blocker\n\n### 3. Before Finishing (REQUIRED)\n\nWrite STATUS-{name}.md in project root. See `references/status-template.md`.\n\n**Do not consider work complete without a STATUS file.**\n\n```bash\n# Final steps\npnpm build  # Verify build passes\ngit add . && git commit -m \"Add worker status file\"\n```\n\n---\n\n## File Ownership Rules\n\nMerge conflicts kill productivity. Strict ownership prevents them.\n\n| Pattern | Risk |\n|---------|------|\n| `components/sidebar/*` | Safe — specific directory |\n| `lib/utils.ts` | Safe — specific file |\n| `components/**` | Dangerous — too broad |\n| `*.ts` | Dangerous — overlaps everything |\n\nIf two workstreams might touch the same file, either:\n1. Assign it to one workstream only\n2. Put it in \"Shared Files (Manager Only)\" section\n3. Split the file first\n\n---\n\n## Quick Reference\n\n| Command | Purpose |\n|---------|---------|\n| `git worktree add ../proj-api -b wt/api` | Create worktree |\n| `git worktree list` | List all worktrees |\n| `git log wt/* --oneline -3` | Check recent commits |\n| `git worktree remove ../proj-api --force` | Remove worktree |\n| `git branch -d wt/api` | Delete branch after merge |\n\n---\n\n## Troubleshooting\n\n**Worker can't read/write files:** Check you're in the right directory. Worktrees are sibling directories, not subdirectories.\n\n**Merge conflicts:** File ownership wasn't specific enough. Resolve manually, then tighten ownership rules for next time.\n\n**Worker didn't write STATUS:** Work is not complete. Ask them to write it before merging.\n\n**Build fails after merge:** Run build in each worktree before merging. Merge in dependency order (shared code first).\n","readmeExcerpt":"--- name: worktrees description: Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase. metadata: author: tobiadeangelis version: \"2.0\" --- Worktrees Coordinate multiple Claude agents worki","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"git branch --show-current"},{"language":"text","snippet":"Good: apps/web/components/layout/*, apps/web/app/(dashboard)/layout.tsx\nBad:  apps/web/**  # Too broad, will conflict"},{"language":"bash","snippet":"git worktree add ../projectname-{name} -b wt/{name}\ncd ../projectname-{name} && pnpm install  # Install deps in each"},{"language":"text","snippet":"Worktrees ready. Start workers:\n  cd ~/projectname-{name} && claude\n  cd ~/projectname-{other} && claude"},{"language":"bash","snippet":"# Quick status check\necho \"=== COMMITS ===\" && git log wt/* --oneline -3\necho \"=== STATUS FILES ===\" && cat STATUS-*.md 2>/dev/null || echo \"None yet\"\necho \"=== UNCOMMITTED ===\" && for d in ../projectname-*; do echo \"$d:\"; git -C \"$d\" status --short | head -5; done"},{"language":"bash","snippet":"# Verify build in worktree first\ncd ../projectname-{name}/apps/web && pnpm build\n\n# Merge (back on main)\ncd /path/to/main\ngit merge wt/{name} -m \"Merge wt/{name}: Brief description\"\n\n# Cleanup\ngit worktree remove ../projectname-{name} --force\ngit branch -d wt/{name}"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase. --- name: worktrees description: Multi-agent parallel development using git worktrees. Use when user says \"plan workstreams\", \"create worktree\", \"spawn worktree\", \"write status\", \"check status\", \"coordinate agents\", \"parallel development\", or asks about managing multiple Claude instances working on the same codebase. metadata: author: tobiadeangelis version: \"2.0\" --- Worktrees Coordinate multiple Claude agents worki","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":380,"uniquenessScore":65,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T11:49:00.830Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}