From 742edd774289382efca9f2aca66df005eb27e9fe Mon Sep 17 00:00:00 2001
From: Greg Gauthier <gmgauthier@protonmail.com>
Date: Mon, 2 Mar 2026 19:18:20 +0000
Subject: [PATCH] docs(readme): add TODO workflow section

Add documentation for the TODO workflow policy and process, including branching, PRs, and post-merge steps.
---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 0b3a4fe..b2e5987 100644
--- a/README.md
+++ b/README.md
@@ -454,6 +454,33 @@ grokkit/
 └── scripts/          # Install scripts
 ```
 
+### TODO Workflow
+
+**Policy:**  
+From now on, the only thing to be committed directly to the `master` branch will be to-do items (.md files in `todo/queued/`).
+
+**Process:**  
+1. When deciding to work on a to-do item: create a branch, implement on the branch, submit PR to `master`.  
+2. After PR merge: move the item to `todo/completed/`.
+
+**Example workflow:**  
+```bash
+git checkout -b feature/some-todo
+# Implement changes, test with make test lint
+git add .
+git commit -m "feat: implement some-todo"
+git push -u origin feature/some-todo
+# Create and merge PR to master
+
+# Post-merge:
+git checkout master
+git pull
+mv "todo/queued/SOME_TODO.md" "todo/completed/SOME_TODO.md"
+git add todo/
+git commit -m "chore: complete some-todo"
+git push origin master
+```
+
 ## Documentation
 
 - 📖 [Troubleshooting Guide](docs/TROUBLESHOOTING.md) - Common issues and solutions