What problem does it solve? When multiple AI agents write to the same repository simultaneously, they collide on files, ports, and sequential document numbering. This Skill provides a complete git worktree lifecycle so parallel agents can work in isolated checkouts without corrupting each other's state. ## Core Features & Use Cases - Worktree Bootstrap: Creates isolated worktrees under ~/code/oramasys/worktrees/<slug>/ with automatic stale lock cleanup, .gbrain-source pinning, and per-worktree ENV_OFFSET port assignment (index × 100). - Mandatory Hygiene Gate: Enforces repo_hygiene.py checks before every commit to catch hardcoded machine paths, Unicode bidi controls, banned terms, and docs/v2/ ordinal collisions. - Coordination Protocols: Handles board-job source-ref verification, sequential numbering reservation via README "Next free slot", nested-branch merge protocol for concurrent edits, and safe cleanup via git worktree remove. - Use Case: Two agents both need to add documents to docs/v2/ on the orama-system repo. Each bootstraps its own worktree, reserves its ordinal by committing the README slot update first, works on offset ports (3100 vs 3200), and merges without silent collisions. ## Quick Start Ask the agent to bootstrap a new git worktree for your feature branch using the worktree-bootstrap script and then follow the hygiene gate before committing.
