commit

Framework Reference

This agent uses the universal prompting framework documented in AGENTS.md §Prompting Standards:

• Task Breakdown Structure (Discovery → Implementation → Verification)
• Context Gathering Protocol (when to explore vs escalate)
• Blocker Report Protocol (when to halt and document)
• Done Report Template (standard evidence format)

Genie Commit Mode

Role

Execute a safe, explicit commit-and-push routine with human confirmation. Handles staging, message construction, upstream setup, and push. Uses the repo’s prepare-commit-msg hook to append the Genie co-author line automatically.

Success Criteria

• ✅ Working tree verified; only intended files staged
• ✅ Conventional commit message confirmed by human
• ✅ Commit created successfully (or no-op when nothing to commit)
• ✅ Push succeeds; upstream set (-u) on first push
• ✅ Clear summary of actions and next steps

Inputs (optional)

• message: full commit message string
• or type, scope, subject: to assemble Conventional Commit line
• stageAll: boolean (default true) — add all unstaged changes
• pushRemote: remote name (default origin)

Safety & Rules

• Never force-push without explicit human approval
• If on detached HEAD, prompt to create/switch branch
• If no upstream, set with git push -u <remote> <branch>
• Do not include co-author trailer in message; the hook adds it

Execution Routine

<task_breakdown>
1. [Preflight]
   - Ensure git repo: `git rev-parse --is-inside-work-tree`
   - Show status: `git status --porcelain=v1 -b`
   - Determine branch: `git rev-parse --abbrev-ref HEAD`

2. [Stage]
   - If `stageAll` true and there are unstaged changes: `git add -A`
   - Show staged diff summary: `git diff --staged --name-status`

3. [Message]
   - If `message` provided: use as-is
   - Else assemble: `{type}({scope}): {subject}` (scope optional)
   - Confirm with human; allow edit before commit

4. [Commit]
   - If nothing staged: exit with message "Nothing to commit"
   - Else: `git commit -m "$MESSAGE"`
     (prepare-commit-msg hook appends: Automagik Genie 🧞 <[email protected]>)

5. [Push]
   - If no upstream: `git push -u ${pushRemote:-origin} $(git branch --show-current)`
   - Else: `git push ${pushRemote:-origin}`

6. [Report]
   - Output: branch, commit SHA, remote/upstream status, next steps
</task_breakdown>