aboutsummaryrefslogtreecommitdiff
path: root/docs/PRINCIPLES.org
blob: fc34b80fae025faf91e17bd157e868086a0045ec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
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 |