docs: initial decision log — repo structure and daily brief decisions

2026-06-20 16:38:37 +00:00
parent 8de1f1b8bd
commit 6fc291fb22
1 changed files with 29 additions and 0 deletions
@@ -0,0 +1,29 @@
+# Decision Log
+
+Records key architectural decisions for the Personal Agent OS.
+
+## 2026-06-20: Initial Repo Structure
+
+**Decision:** Created `personal-agent-os` as a single repo under `Tony_tech` org with `projects/`, `knowledge-base/`, `archive/`, `templates/`, `agent-config/`, and `_meta/`.
+
+**Rationale:**
+- Single repo over multiple repos: easier for Hermes to search_files across everything, simpler cross-referencing between projects and knowledge
+- `archive/` over deletion: git history preserves everything, but active views stay clean
+- `_meta/` at root (not under kb): repo-wide conventions and decision log should be immediately discoverable
+- No auto-generating tag index in a folder: better to rebuild via cron script periodically
+
+**Migrated from:** `Tony_tech/research/hermes-automation/` into `knowledge-base/automation-blueprints/hermes/`
+
+**Trade-offs accepted:**
+- Single repo means one default branch; projects share tag space (mitigated by hierarchical dir names)
+- Cron scripts stored in two places: local disk (runs from) and repo (documentation). Must keep in sync.
+
+## 2026-06-20: Daily Brief — Script + Context-From Pattern
+
+**Decision:** Replaced agent-driven web/X search data gathering with a no-agent shell script that fetches free public APIs (wttr.in, HN Firebase, GitHub API).
+
+**Why:** web_search and x_search were silently failing (Firecrawl unconfigured, xAI credits exhausted). The brief was returning `[SILENT]` for weeks.
+
+**Result:** Working brief in <5 minutes, zero API costs, reliable data every tick.
+
+**Cron job ID:** e94447937052