aboutsummaryrefslogtreecommitdiff
path: root/docs/protocols.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-01-19 14:36:35 -0600
committerCraig Jennings <c@cjennings.net>2026-01-19 14:36:35 -0600
commit837f4ccdb6166ac47aff036d4af9287675c1db9a (patch)
tree42aa4755bbf75453847147c22e09eae5682e429b /docs/protocols.org
parent3b51fa5a1880ba409e171bcc2444d80f4cfb8550 (diff)
downloadarchangel-837f4ccdb6166ac47aff036d4af9287675c1db9a.tar.gz
archangel-837f4ccdb6166ac47aff036d4af9287675c1db9a.zip
Sync templates, add session context
Diffstat (limited to 'docs/protocols.org')
-rw-r--r--docs/protocols.org25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/protocols.org b/docs/protocols.org
index c17987e..1dee40f 100644
--- a/docs/protocols.org
+++ b/docs/protocols.org
@@ -221,6 +221,31 @@ When Craig says this phrase:
- Say: "I don't see '[workflow-name]' yet. Create it using create-workflow process?"
- If yes: Run create-workflow to define it, then use immediately (validates new workflow)
+** Long-Running Process Status Updates
+
+When monitoring a long-running process (rsync, large downloads, builds, etc.), provide status updates every 5 minutes.
+
+***Format:***
+#+begin_example
+**14:32** - Rsync in progress: 312GB of 640GB transferred (~49%), ETA ~25 min
+**14:37** - Rsync continuing: 389GB of 640GB (~61%), ETA ~18 min
+#+end_example
+
+***Guidelines:***
+- Check in approximately every 5 minutes
+- Include current time (run =date= to get accurate time)
+- Brief description of what's happening
+- Progress indication (percentage, files transferred, etc.)
+- ETA when possible (even a ballpark estimate is helpful)
+- Format doesn't need to be strict - just be descriptive
+- If ETA cannot be determined, omit it rather than guessing wildly
+
+***Why This Matters:***
+- Craig may be working on other things while waiting
+- Status updates provide confidence the process is still running
+- ETAs help with planning (e.g., "I have time for coffee" vs "stay close")
+- If something stalls, the updates make it obvious
+
** "Wrap it up" / "That's a wrap" / "Let's call it a wrap"
When Craig says any of these phrases (or variations), execute wrap-up workflow: