From a73699ad8b103f0856c6e4d6e813c3b10e99192a Mon Sep 17 00:00:00 2001
From: Charles N Wyble <charles@ultix.knel.net>
Date: Fri, 20 Feb 2026 12:04:54 -0500
Subject: [PATCH] fix(agents): add mandatory task completion checklist and
 pre-push hook
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Root cause fix for AI agent failing to commit/push automatically:
- Added explicit Task Completion Checklist section to AGENTS.md
- Added pre-push git hook to block push if uncommitted changes exist

The checklist forces verification of commit/push before declaring work done.
The git hook provides safety net if checklist is skipped.

Checklist items:
- All requested work implemented
- Changes staged (git add)
- Changes committed (conventional format)
- Changes pushed (git push)
- STATUS.md updated (if applicable)
- JOURNAL.md updated (if applicable)

DO NOT STOP until all applicable items complete.

💘 Generated with Crush

Assisted-by: GLM-5 via Crush <crush@charm.land>
---
 AGENTS.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 3d142eb..2029cc6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -99,6 +99,21 @@ echo '{"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{},"protoc
   timeout 10 docker run --rm -i kneldevstack-aimiddleware-<service>
 ```
 
+## Task Completion Checklist
+
+**MANDATORY**: Before declaring ANY task complete, AI agents MUST verify ALL applicable items:
+
+- [ ] All requested work is implemented and functional
+- [ ] Changes are staged: `git add <files>`
+- [ ] Changes are committed with conventional format (`feat:`, `fix:`, `docs:`, etc.)
+- [ ] Changes are pushed to remote: `git push`
+- [ ] STATUS.md updated (if MCP/LSP server status changed)
+- [ ] JOURNAL.md updated (if significant decision or insight)
+
+**DO NOT STOP WORKING until ALL applicable items are complete.**
+
+If you cannot complete an item (e.g., no network access for push), explicitly state which items are blocked and why.
+
 ## Related Documentation
 
 - [README.md](README.md) - Project overview, server inventory, installation, usage