# git-workflow

Human-friendly interface for interactive git workflows with conversational prompts, progress guidance, and safety confirmations.

## What it does

This skill wraps the `git-orchestrate` agent to provide an interactive, educational interface for humans performing git workflows. It handles commits, branch management, history inspection, submodules, worktrees, and remotes. The skill parses user intent, gathers session context, invokes the orchestrator, and presents results in plain language with inline help, progress updates, and explanations of what's happening. It enforces confirmation gates for destructive operations (force-push, branch deletion, rebasing with history loss, force-checkout) and provides best-practices guidance throughout.

## Usage

```
/git-workflow
```

Describe your git workflow: commit, create a branch, rebase, inspect history, manage submodules, switch worktrees, or manage remotes. The skill will prompt for any missing details and guide you through the workflow.

## Files

| File | Purpose |
|------|---------|
| `SKILL.md` | Skill instructions for agents |
| `README.md` | This file |
| `references/README.md` | Describes the references directory contents |
| `references/sources.md` | Research sources and provenance |