From a6414c49bd6f72bbabedaccf62b2535ae00d58af Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Thu, 22 Jan 2026 14:59:24 -0600
Subject: Add retrospective workflow and PRINCIPLES.org for continuous
 improvement

- docs/PRINCIPLES.org: Behavioral lessons from retrospectives
- docs/retrospectives/: Directory for retrospective records
- docs/protocols.org: Add PRINCIPLES.org to session startup reading list

Establishes pattern for learning from problem-solving sessions and
capturing behavioral (not just technical) lessons.
---
 docs/PRINCIPLES.org | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 docs/PRINCIPLES.org

(limited to 'docs/PRINCIPLES.org')

diff --git a/docs/PRINCIPLES.org b/docs/PRINCIPLES.org
new file mode 100644
index 0000000..fc34b80
--- /dev/null
+++ b/docs/PRINCIPLES.org
@@ -0,0 +1,49 @@
+#+TITLE: Working Principles
+#+DESCRIPTION: Behavioral lessons learned from retrospectives. Read at session start.
+
+* How We Work Together
+
+** Sync Before Action
+- Confirm before destructive or irreversible actions
+- State what I'm about to do and wait for go-ahead
+- "Wait, wait, wait" is valid and important feedback
+- Don't assume the next step - ask or confirm
+
+** Clean Up After Yourself
+- After chroot work: reset mountpoints, verify settings before export
+- After testing: remove debug flags, temp files, test labels
+- Before reboot: verify the system is in expected state
+
+** Verify Assumptions
+- When something "should work" but doesn't, question the assumption
+- Test one variable at a time to isolate causes
+- Don't stack fixes - apply one, test, then apply next
+
+** Research Before Guessing
+- Check community forums, release notes, known issues
+- External sources (videos, blog posts) often have answers
+- The obvious fix isn't always the right fix
+
+** Patience Over Speed
+- Taking time to sync improves effectiveness
+- Rushing creates mistakes that cost more time
+- Working together > working fast
+
+* Checklists
+
+** After Chroot Work
+- [ ] Reset ZFS mountpoints (remove /mnt prefix)
+- [ ] Verify /etc files weren't overwritten with .pacnew
+- [ ] Check hostid consistency
+- [ ] Clean export of ZFS pool
+
+** Before Reboot
+- [ ] Confirm which kernel/entry will boot
+- [ ] Verify GRUB timeout allows menu selection
+- [ ] Know the fallback plan if boot fails
+
+* Revision History
+
+| Date       | Change                                      |
+|------------+---------------------------------------------|
+| 2026-01-22 | Initial version from ratio boot fix session |
-- 
cgit v1.2.3