From bcf43d5d8339db1fbff213f1624fc4b5950f6378 Mon Sep 17 00:00:00 2001
From: James Brechtel <git@jamesbrechtel.com>
Date: Wed, 13 May 2026 22:01:43 -0400
Subject: [PATCH] updating documentation

---
 AGENTS.md |  2 ++
 TODO.md   | 11 +++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 TODO.md

diff --git a/AGENTS.md b/AGENTS.md
index d282ae9..c58068f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -96,6 +96,8 @@ Tests use **hspec** and create real temporary git repositories — no mocking of
 
 Tests are organized to match `SPEC.md`:
 
+Anytime new behavior is added the `SPEC.md` should be updated and a corresponding hspec test written.
+
 | Spec | Test module | Key tests |
 |---|---|---|
 | Creates commit on file change | `GitCommitSpec` | Commit creation, content inclusion, no duplicate commits |
diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..a08c2bd
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,11 @@
+# Expand desktop notifications
+
+Converge should use notify-send anytime there is a failure with a git operation
+
+# Commit and push uncommitted changes
+
+On startup, Converge should detect any uncommitted changes in a monitored repo and then commit and push them.
+
+# Git write operations should be logged
+
+All git operations that modify repo state should be logged - including the time, command, arguments and exit code. Possibly the standard out and standard error.