aboutsummaryrefslogtreecommitdiff
path: root/docs/workflows/session-wrap-up.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-01-31 16:22:54 -0600
committerCraig Jennings <c@cjennings.net>2026-01-31 16:22:54 -0600
commit8b2a1ffce5cbd3c2be2498a7a86e02469787e68b (patch)
tree794389cdf195b2d4d25406bb9366826432f2c0e2 /docs/workflows/session-wrap-up.org
parentd32546a050e08c666ec54cd422bd8a79d66e81c3 (diff)
downloadarchangel-8b2a1ffce5cbd3c2be2498a7a86e02469787e68b.tar.gz
archangel-8b2a1ffce5cbd3c2be2498a7a86e02469787e68b.zip
docs: update protocols and session wrap-up workflow
- Add Wayland environment section to protocols (wl-copy, Hyprland) - Add session-context deletion step to wrap-up workflow - Add clean git state verification before valediction - Update todo.org tasks
Diffstat (limited to 'docs/workflows/session-wrap-up.org')
-rw-r--r--docs/workflows/session-wrap-up.org47
1 files changed, 45 insertions, 2 deletions
diff --git a/docs/workflows/session-wrap-up.org b/docs/workflows/session-wrap-up.org
index ff1d703..d7a8b35 100644
--- a/docs/workflows/session-wrap-up.org
+++ b/docs/workflows/session-wrap-up.org
@@ -359,7 +359,47 @@ git status
Should show: "working tree clean" and indicate branch is up to date with remote.
-** Step 3: Valediction
+** Step 3: Delete Session Context File
+
+The session context file must be deleted at the end of every successful wrap-up.
+
+*** Why This Is Critical
+
+The existence of =docs/session-context.org= indicates an interrupted session. If you don't delete it:
+- Next session will think the previous session crashed
+- Context recovery will be triggered unnecessarily
+- Creates confusion about session state
+
+*** How to Delete
+
+#+begin_src bash
+rm docs/session-context.org
+#+end_src
+
+*** When to Skip
+
+NEVER skip this step. If the file doesn't exist, that's fine (the rm command will just report no file). But if it exists, it MUST be deleted.
+
+** Step 4: Verify Clean Git State
+
+*** CRITICAL: Git Status Must Be Completely Clean
+
+Before proceeding to valediction, =git status= MUST show:
+- "nothing to commit, working tree clean"
+- Branch is up to date with remote(s)
+
+*** If Git Status Is NOT Clean
+
+1. **Untracked files exist:** Ask Craig - "There are untracked files. Should I add and commit them, or leave them untracked?"
+2. **Uncommitted changes exist:** Ask Craig - "There are uncommitted changes. Should I commit them now?"
+3. **Unpushed commits exist:** Push them (this shouldn't require asking)
+4. **Any other unclear state:** Ask Craig before proceeding
+
+*** The Rule
+
+Unless Craig explicitly says "leave git dirty" or "don't worry about that file," the working tree must be clean at session end. When in doubt, ASK.
+
+** Step 5: Valediction
Provide a brief, warm goodbye message to Craig.
@@ -451,6 +491,8 @@ Do NOT:
8. **Forgetting to verify clean working tree** - Always confirm =git status= shows clean
9. **Making session notes too brief** - Better too much detail than too little
10. **Not checking if files were actually modified** - Run =git status= first
+11. **Leaving session-context.org behind** - MUST be deleted at end of every wrap-up
+12. **Leaving dirty git state without explicit approval** - Ask Craig if anything is unclear
* Validation Checklist
@@ -466,8 +508,9 @@ Before considering wrap-up complete, verify:
- [ ] Commit message follows required format (no Claude attribution)
- [ ] Commit executed successfully
- [ ] Pushed to ALL remote repositories (checked with =git remote -v=)
-- [ ] =git status= shows "working tree clean"
+- [ ] =git status= shows "nothing to commit, working tree clean" (CRITICAL - ask if unclear)
- [ ] Push confirmed successful to all remotes
+- [ ] =docs/session-context.org= DELETED (CRITICAL - file must not exist after wrap-up)
- [ ] Valediction provided with accomplishments, readiness, reminders
- [ ] Critical reminders surfaced if they exist
- [ ] Warm, professional closing provided