git-coworker

What problem does it solve?

AI agents often edit code in the user's active workspace, causing interruptions and conflicts. This Skill enables AI agents to work alongside human developers by using git worktrees to host isolated agent branches, so changes can be made in parallel without disturbing the human's working tree.

Core Features & Use Cases

• Isolated agent worktrees on dedicated branches (agent/*) to enable parallel development.
• Safe lifecycle guidance: create, work, commit, push, signal, and cleanup without touching the user's branch.
• Submodule-aware strategies and comprehensive safety guardrails for monorepos.
• Clear integration options for when to merge, PR, squash, or rebase.

Use cases include: background task automation across multiple files, code changes that require multiple commits, or long-running tasks that should not disrupt the developer’s current work.

Quick Start

• Navigate to the repository root.
• Ensure a .worktrees directory is available and .worktrees/ is ignored by git.
• Create a new agent worktree: git worktree add -b agent/feat/<description> .worktrees/agent-<description> main
• Move into the new worktree: cd .worktrees/agent-<description>
• Perform work, then commit and push: git add -A git commit -m "feat(agent): initial parallel work" git push -u origin agent/feat/<description>
• Report status to the human and propose merge options.