How ren-lingyu/git-agent-workflow works
GAW is a Git-native tool for keeping agent workspace state and history alongside a project repository. Its principal workflow is to select a workspace, validate it, edit and stage its contents, commit agent history (optionally associated with project commits), and inspect that history. The README also documents repository initialization, deployment, branch lifecycle operations, local ref metadata, and hook-based protection. No source excerpts were provided, so relationships below rely only on README statements; directory paths identify unsampled subsystems.
Main entry points: cli.api.lisp Command interface · deploy Deploy local state · config Config validation · init Initialize history
Components 16
User interface
- Command interface
lisp/src/cli/cli.api.lisp
Repository lifecycle
- Initialize history
lisp/src/init - Deploy local state
lisp/src/deploy - Branch lifecycle
lisp/src/branch
Daily workflow
- Workspace selection
lisp/src/workspace - Config validation
lisp/src/config - Repository checks
lisp/src/check - Agent commits
lisp/src/commit - History display
lisp/src/show
Git protocol
- Workflow state
lisp/src/state - Reference operations
lisp/src/refs - Current source ref
lisp/src/refs/current.core.lisp - Git operations
lisp/src/git - Branch protection hook
lisp/src/hook
Other components
- Git user
- Git repository
Connections 18
- Git user → Command interface: runs commands
README.org - Command interface → Initialize history: initializes
README.org - Command interface → Deploy local state: deploys
README.org - Command interface → Branch lifecycle: manages branches
README.org - Command interface → Repository checks: checks state
README.org - Command interface → Agent commits: commits state
README.org - Command interface → History display: shows history
README.org - Initialize history → Deploy local state: uses deployment
README.org - Deploy local state → Repository checks: verifies worktree
README.org - Deploy local state → Branch protection hook: installs protection
README.org - Config validation → Current source ref: resolves source ref
README.org - Config validation → Git operations: reads config blob
README.org - Workspace selection → Git repository: manages workspace paths
README.org - Agent commits → Git repository: records agent history
README.org - Reference operations → Git repository: tracks local metadata
README.org - Git operations → Git repository: operates on
README.org - Branch protection hook → Git repository: protects branches
README.org - History display → Git repository: reads history
README.org