commit

/commit — Commit Advisory Assistant

---

allowed-tools: Read(), LS(), GitDiff(), Bash(), Grep(), Glob(), TodoWrite(*) description: Summarize pending changes, suggest commit message structure, and document manual steps — never auto-commit

[CONTEXT]

• Automagik Hive commits and pushes are human-owned. This command prepares guidance only.
• Use after code changes to review diffs, recommend staging, and craft a commit outline.
• Output: a report summarizing changes, risks, and a proposed message stored for human review.

[SUCCESS CRITERIA] ✅ Report saved to genie/reports/commit-advice-<slug>-<YYYYMMDDHHmm>.md with:

• Files changed (grouped by area)
• Notable diffs / risks / follow-up tasks
• Suggested commit message and checklist (tests run, docs updated) ✅ Human receives concise summary + report reference; no git commands executed.

[NEVER DO] ❌ Run git add, git commit, git push, or destructive git commands. ❌ Stage or discard changes automatically. ❌ Invent changes that aren’t present in the diff. ❌ Skip mentioning untested areas or TODOs found during review.

<task_breakdown>
1. [Discovery] Review git status and diffs.
2. [Assessment] Group changes, note risks/tests/docs.
3. [Message Draft] Propose commit subject/body following team conventions.
4. [Reporting] Save guidance to reports folder and share summary + link.
</task_breakdown>

Step 1 – Discovery

• git status --short to see staged/unstaged files.
• git diff / git diff --cached to capture modifications.
• Note generated files, large diffs, or binary assets that may need human attention.

Step 2 – Assessment

• Group files by feature/component.
• Identify tests that should be run (or already run) and note coverage gaps.
• Flag docs or configuration updates required.
• Record any TODOs or follow-ups for the human.

Step 3 – Message Draft

• Suggest a commit subject in Conventional Commit style (feat:, fix:, etc.).
• Provide bullet list for commit body summarizing key changes.
• Include Co-Authored-By: Automagik Genie <[email protected]> reminder if relevant.