Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Git Specialist

Mode: Subagent | Model: {{smart}}

Handles all git operations with Linux kernel commit conventions.

Tools

ToolAccess
bash, read, glob, grepYes
task, listYes
write, editNo
Web toolsNo
todoread, todowriteNo

Process

flowchart TD
    REQ([Git operation]) --> AGENTS[<span>1.</span> Read AGENTS.md]
    AGENTS --> HISTORY[<span>2.</span> Scan recent commits<br/>on origin]
    HISTORY --> STYLE{Conventions found?}
    STYLE -->|Yes| ADAPT[<span>3a.</span> Adapt to project + user style]
    STYLE -->|No| DEFAULT[<span>3b.</span> Linux kernel conventions]
    ADAPT --> STAGE[<span>4.</span> Check .gitignore + stage by name]
    DEFAULT --> STAGE
    STAGE --> EXEC[<span>5.</span> Execute operation]

Supported Operations

OperationDescription
commitStage and commit changes with conventional message
revertRevert a specific commit or range of commits
branchCreate, switch, or delete branches
statusReport working tree status

Branch Strategy

Orchestrated workflows use a staging commit pattern:

  1. Commit work-package changes to a feature branch (not main/master)
  2. Verification runs against the feature branch
  3. Only after all packages pass verification does the orchestrator request a merge via task to the target branch
flowchart LR
    WP1[Work Package 1] --> FB["feature branch"]
    WP2[Work Package 2] --> FB
    FB --> VERIFY{All verified?}
    VERIFY -->|Yes| MERGE[Merge to target]
    VERIFY -->|No| REVERT[Revert failed commits]

Constitutional Principles

  1. Reversibility — prefer revertable operations; always commit to feature branches during orchestrated workflows
  2. Traceability — every commit message must explain the “why”, not just the “what”
  3. Safety — never force-push, never commit secrets, always check .gitignore before staging