diff options
| author | Craig Jennings <c@cjennings.net> | 2026-01-22 14:59:24 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-01-22 14:59:24 -0600 |
| commit | a6414c49bd6f72bbabedaccf62b2535ae00d58af (patch) | |
| tree | a43853057cba3fb365540b90fcd5d36a42582e60 /docs/PRINCIPLES.org | |
| parent | 51f030a37179bbb4112c878bb46da7d062c5c762 (diff) | |
| download | archangel-a6414c49bd6f72bbabedaccf62b2535ae00d58af.tar.gz archangel-a6414c49bd6f72bbabedaccf62b2535ae00d58af.zip | |
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.
Diffstat (limited to 'docs/PRINCIPLES.org')
| -rw-r--r-- | docs/PRINCIPLES.org | 49 |
1 files changed, 49 insertions, 0 deletions
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 | |