diff options
| author | Craig Jennings <c@cjennings.net> | 2026-02-22 23:20:56 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-02-22 23:20:56 -0600 |
| commit | 5e6877e8f3fb552fce3367ff273167d2cf6af75f (patch) | |
| tree | 909f98edbbb940aafb95de02457d4d6f7db3cba4 /docs/retrospectives | |
| parent | b104dde43fcc717681a8733a977eb528c60eb13f (diff) | |
| download | archangel-5e6877e8f3fb552fce3367ff273167d2cf6af75f.tar.gz archangel-5e6877e8f3fb552fce3367ff273167d2cf6af75f.zip | |
chore: add docs/ to .gitignore and untrack personal files
docs/ contains session history, personal workflows, and private
protocols that shouldn't be in a public repository.
Diffstat (limited to 'docs/retrospectives')
| -rw-r--r-- | docs/retrospectives/2026-01-22-ratio-boot-fix.org | 45 |
1 files changed, 0 insertions, 45 deletions
diff --git a/docs/retrospectives/2026-01-22-ratio-boot-fix.org b/docs/retrospectives/2026-01-22-ratio-boot-fix.org deleted file mode 100644 index 430a03d..0000000 --- a/docs/retrospectives/2026-01-22-ratio-boot-fix.org +++ /dev/null @@ -1,45 +0,0 @@ -#+TITLE: Retrospective: Ratio Boot Fix -#+DATE: 2026-01-22 - -* Summary - -Diagnosed and fixed boot failures on ratio (Framework Desktop, AMD Strix Halo). -Root cause: missing linux-firmware 20260110. Secondary issues from chroot cleanup mistakes. - -See [[file:../2026-01-22-ratio-boot-fix-session.org][full session doc]] for technical details. - -* What Went Well - -- Systematic diagnosis - isolated variables (firmware vs kernel vs ZFS) -- External research - video transcript and community posts gave us the firmware fix -- Documentation - captured everything in session doc for future reference -- Collaboration sync - after feedback, stayed in step and confirmed each action -- ZFS snapshots - rollback capability enabled safe experimentation - -* What Didn't Go Well - -- Jumped ahead repeatedly - rebooting without confirming, running commands without checking in -- Chroot cleanup mistakes - left mountpoint=legacy and /mnt prefixes causing boot failures -- Wrong assumptions - initially assumed kernel 6.15 was the fix; firmware was the real issue -- UUID mistake - used wrong boot partition UUID (didn't account for mirrored NVMe) -- SSH debugging waste - spent time on sshpass issues when keys would have been simpler - -* Behavioral Lessons (Added to PRINCIPLES.org) - -1. *Sync Before Action* - Confirm before destructive actions, wait for go-ahead -2. *Clean Up After Yourself* - Reset mountpoints after chroot, verify before export -3. *Verify Assumptions* - When "should work" doesn't, question the assumption -4. *Patience Over Speed* - "Wait, wait, wait" improved our effectiveness - -* What Would We Do Differently - -- Set up SSH keys at start of remote troubleshooting session -- Create a chroot cleanup checklist and follow it every time -- State the plan and wait for confirmation before each reboot -- Test one fix at a time instead of stacking changes - -* Action Items - -- [X] Create PRINCIPLES.org with behavioral lessons -- [X] Add retrospective workflow to protocols -- [X] Document session for future reference |
