Add Org clarify/wait workflow logging

2 files changed, 16 insertions, 3 deletions

diff --git a/README.md b/README.md
index fce2dd2..197cb64 100644
--- a/README.md
+++ b/README.md
@@ -153,8 +153,16 @@ The capture model has two distinct paths:
 - fast operational capture goes to `~/org/journal.org`
 - durable notes use Denote in the PARA directories under `~/org/`
 
-Journal capture uses a Year -> Day outline in `journal.org` with explicit
-`Tasks`, `Notes`, and `Meetings` headings beneath each day entry.
+`~/org/journal.org` remains the operational capture surface. Journal capture
+uses a Year -> Day outline in `journal.org` with explicit `Tasks`, `Notes`,
+and `Meetings` headings beneath each day entry.
+
+Questions that come up during the day can be tracked as Org tasks under the
+day's `Tasks` heading. The intended task workflow is `TODO`, `CLARIFY`,
+`WAIT`, `DONE`, and `CANCELLED`: use `CLARIFY` for open questions or ambiguity,
+and `WAIT` once the question has been asked and the answer is pending.
+Completing an item prompts for a note so the answer can be recorded in the
+task log, and those state logs are stored in a `LOGBOOK` drawer.
 
 The configured capture templates cover:
 
diff --git a/lisp/ss-org.el b/lisp/ss-org.el
index 4a8836c..e75208d 100644
--- a/lisp/ss-org.el
+++ b/lisp/ss-org.el
@@ -79,7 +79,12 @@
     :config
     (setq org-directory ss-org-directory
           org-hide-emphasis-markers t
-          org-agenda-search-headline-for-time t)
+          org-agenda-search-headline-for-time t
+          org-todo-keywords
+          '((sequence "TODO(t)" "CLARIFY(c)" "WAIT(w@/!)" "|"
+                      "DONE(d)" "CANCELLED(x@)"))
+          org-log-done 'note
+          org-log-into-drawer t)
     (add-hook 'org-mode-hook
               (lambda ()
                 (setq-local org-hide-emphasis-markers t)