#+TITLE: System Logbook: Regressions, Heuristics, & Learnings
#+author: Amero Garcia
#+created: [2026-03-16 Mon 14:28]
#+DATE: 2026-03-11
#+STARTUP: content
#+FILETAGS: :system:meta:learning

* Performance Regressions
** [2026-03-11] Agora Context Stall & Recovery
- *Symptom:* Previous session failed (procrastination apology). This session initially struggled to find the "8-hour log."
- *Root Cause:* The "log" was actually a mental state, not a single massive file (it was the cumulative context). The user's "overhaul" had cleared the task list (gtd.org), leaving the agent without a "needle" on the record.
- *Fix:* Manually reconstructed the project scope from the daily summary and expanded it to 14 atomic notes.
- *Heuristic:* If a project feels "stalled," check gtd.org first. If empty, reconstruct the task list from the most recent daily log (1_daily/).

* Operational Heuristics
** [2026-03-11] Separation of Identity vs. Experience
- *Symptom:* Attempting to put all "Fixes" and "Regressions" in SOUL.md caused user friction (it felt too heavy/rigid).
- *Lesson:* Identity (SOUL.md) should be strategic and "Vibe" based. Experience (LOGBOOK.org) should be technical and chronological.
- *Fix:* Created this Logbook.
- *Heuristic:* Never put "Reporting Rituals" (e.g., "Report every 30 min") in SOUL.md. Instead, put "Resilience Rituals" (e.g., "Check HEARTBEAT.md on boot") in AGENTS.md.

** [2026-03-11] Tool Efficiency Audit
- *Metric:* Parallelized `grep` and `ls` calls significantly reduced discovery time.
- *Metric:* `write_file` was used correctly for new notes, but `replace` should be prioritized for project files to avoid overwriting user-added metadata.

** [2026-03-15] Root Cause of "Procrastination" & Malformed Tools
- *Symptom:* Agent procrastinating; broken files in root with tool-call names.
- *Root Cause:* Context saturation from bloated HEARTBEAT.md session log + lack of "On Boot" ritual in AGENTS.md.
- *Fix:* Archived session logs to `session-history.org`; implemented Resilience Rituals in AGENTS.md; added Procrastination Check to SOUL.md.
- *Heuristic:* If filenames in root look like `>functions write...`, immediately archive logs and reduce context.

* Prediction Log
| Date | Prediction | Confidence | Outcome |
|------+------------+------------+---------|
| 03-11| Logbook will reduce context pressure | 90% | SUCCESS (SOUL.md is now 50% leaner) |
| 03-11| HEARTBEAT.md task pointer prevents stalls | 95% | SUCCESS (with 03-15 ritual fix) |
| 03-15| Resilience Rituals will stop tool malformation | 98% | PENDING |