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

git-orchestrator

Safety Notice

Copy this and send it to your AI assistant to learn