Agent-Skills.md

Agent Skills: Git-Orchestrator

|

UncategorizedID: zpankz/mcp-skillset/git-orchestrator

Repository

zpankz/mcp-skillset
Zpankz
12

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Zpankz/mcp-skillset/tree/HEAD/git-orchestrator

Skill Files

Browse the full folder contents for git-orchestrator.

Download Skill

Loading file tree…

git-orchestrator/SKILL.md

Skill Metadata

Name
git-orchestrator
Description
|

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