feat(git-plugin): Build complete git workflow automation suite #62

New Issue

Claude · 2026-07-04T17:30:15Z

Claude commented

2026-07-04 17:30:15 +00:00

Summary

Complete git workflow automation with dual interfaces (human skill + agent orchestrator) enabling seamless git operations across human-driven CLI workflows and agent-based automation pipelines.

Artifacts to Build

Domain Skills (6 units)

git:commits — Create, amend, reword, cherry-pick, revert operations
git:branches — Create, delete, switch, track/untrack, list operations
git:history — View logs, diffs, blame, show file history
git:submodules — Initialize, update, clone, status operations
git:worktrees — Create, list, remove, repair, prune operations
git:remotes — Add, remove, fetch, push, track operations

Orchestrator Layer

git:orchestrate — Agent-facing orchestrator that composes domain skills for multi-step workflows; enables agents to invoke git automation with transaction-like semantics

Human-Friendly Interface

git-workflow — User-facing skill wrapping the orchestrator; provides ergonomic CLI interface with progress indicators and context preservation

Configuration & Versioning

Plugin manifest and version bump (coordinate with kyberforge plugin-author)

Key Design Decisions

Session-Scoped Context

Hybrid session persistence: explicit carries between operations
Agents can chain operations with maintained context (working directory, current branch, uncommitted state tracking)
State snapshots at operation boundaries for error recovery

Destructive Operations Require Explicit Confirmation

The following operations require explicit user confirmation before execution:

Force-push (git push --force)
Branch deletion (git branch -D)
Rebase with history loss (interactive rebase, rebase --onto)
Force-checkout (git checkout -f, git restore -f)

Error Handling Strategy

Attempt automatic resolution where deterministic (merge conflicts → cherry-pick abort, detached HEAD → safe reattach)
Fail gracefully with diagnostic output when automatic recovery is unsafe
Preserve working directory and index state on recoverable errors

Composability First

Domain skills are atomic building blocks with no orchestration logic
Both human skill and agent orchestrator compose domain skills
Skills designed for reuse across multiple interfaces without branching logic

## Summary Complete git workflow automation with dual interfaces (human skill + agent orchestrator) enabling seamless git operations across human-driven CLI workflows and agent-based automation pipelines. ## Artifacts to Build ### Domain Skills (6 units) - **git:commits** — Create, amend, reword, cherry-pick, revert operations - **git:branches** — Create, delete, switch, track/untrack, list operations - **git:history** — View logs, diffs, blame, show file history - **git:submodules** — Initialize, update, clone, status operations - **git:worktrees** — Create, list, remove, repair, prune operations - **git:remotes** — Add, remove, fetch, push, track operations ### Orchestrator Layer - **git:orchestrate** — Agent-facing orchestrator that composes domain skills for multi-step workflows; enables agents to invoke git automation with transaction-like semantics ### Human-Friendly Interface - **git-workflow** — User-facing skill wrapping the orchestrator; provides ergonomic CLI interface with progress indicators and context preservation ### Configuration & Versioning - Plugin manifest and version bump (coordinate with kyberforge plugin-author) ## Key Design Decisions ### Session-Scoped Context - Hybrid session persistence: explicit carries between operations - Agents can chain operations with maintained context (working directory, current branch, uncommitted state tracking) - State snapshots at operation boundaries for error recovery ### Destructive Operations Require Explicit Confirmation The following operations require explicit user confirmation before execution: - Force-push (`git push --force`) - Branch deletion (`git branch -D`) - Rebase with history loss (interactive rebase, rebase --onto) - Force-checkout (`git checkout -f`, `git restore -f`) ### Error Handling Strategy - Attempt automatic resolution where deterministic (merge conflicts → cherry-pick abort, detached HEAD → safe reattach) - Fail gracefully with diagnostic output when automatic recovery is unsafe - Preserve working directory and index state on recoverable errors ### Composability First - Domain skills are atomic building blocks with no orchestration logic - Both human skill and agent orchestrator compose domain skills - Skills designed for reuse across multiple interfaces without branching logic

Defame1297 closed this issue

2026-07-04 18:42:31 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Defame1297/holocron#62