Git-Orchestrator

##Trigger Patterns

• "/git-orchestrator init"
• "/git-orchestrator commit"
• "/git-orchestrator worktree"
• "initialize claude config repo"
• "commit my configuration changes"
• "create worktree for experiment"
• "show configuration history"

Applicable Agents

• git-orchestrator-agent (primary meta-orchestrator)
• refactor-agent (consumer for 24hr commits)
• build-domain-agent (git-master integration)

Infrastructure Dependencies

Tool	Purpose	Health Check
bv	Graph analysis, metrics	bv --version
bd	Issue tracking, DAG	bd --version
git	Version control	git --version
claude-mem	Activity logging	curl localhost:37777/health

Core Operations

1. Repository Initialization

~/.claude/skills/git-orchestrator/scripts/init-repo.sh

2. Session Lifecycle

• SessionStart: Record initial state, create session branch
• PostToolUse (Write|Edit): Track pending changes
• SessionEnd: Auto-commit with detailed message

3. Worktree Management

• Create: Isolated experimentation environments
• Switch: Parallel configuration testing
• Cleanup: Remove stale worktrees

Integration Points

Pillar	Hook	Purpose
refactor-agent	PostToolUse	Commit optimizations
code-skill	PreToolUse	Preflight validation
claude-mem	SessionStart	Activity context
ralph-loop	Notification	Activity logging
learn-skill	Stop	Crystallize learnings

Progressive Loading

L0 - Trigger (50 tokens)

Frontmatter only - activation check

L1 - Core (300 tokens)

Core architecture, session hooks, commit automation

L2 - Worktree Operations (500 tokens)

Branch management, parallel experimentation, worktree lifecycle

L3 - Pillar Integration (800 tokens)

Cross-pillar coordination, bv/bd integration, compound engineering

Scripts Reference

Script	Purpose	Hook
init-repo.sh	Initialize ~/.claude as git repository	Manual
session-start.sh	Record session state, create branch	SessionStart
track-change.sh	Log file modifications, bd tracking	PostToolUse
session-commit.sh	Auto-commit, merge, push	SessionEnd
worktree-manager.sh	Create/list/remove worktrees	Manual
atomic-write.sh	Resilience layer for safe writes	Utility
lock-manager.sh	Detect and fix stale locks	Utility
secret-scanner.sh	Pre-commit secret validation	Utility

Commands

Command	Usage
/git-orchestrator init	Initialize repository
/git-orchestrator commit	Manual commit
/git-orchestrator worktree create <name>	Create worktree
/git-orchestrator worktree list	List worktrees
/git-orchestrator worktree cleanup	Remove stale worktrees

Invariants

• K-Monotonicity: Configuration changes preserve history (git never loses commits)
• Homoiconicity: Meta-orchestrator manages its own versioning
• Vertex-Sharing: Integration preserved across all pillars
• Orthogonality: Worktrees enable parallel experimentation without conflict

See Also

• Git-Orchestrator Agent — Meta-orchestrator implementation
• Refactor Agent — Consumer for 24hr auto-commits
• Git-Master Skill — Git operations expert
• Learn Skill — Knowledge compounding integration