From 6fc291fb224466693387a0cdc25d08a93e3f6cf7 Mon Sep 17 00:00:00 2001 From: Leonard Date: Sat, 20 Jun 2026 16:38:37 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20initial=20decision=20log=20=E2=80=94=20?= =?UTF-8?q?repo=20structure=20and=20daily=20brief=20decisions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- _meta/decision-log.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 _meta/decision-log.md diff --git a/_meta/decision-log.md b/_meta/decision-log.md new file mode 100644 index 0000000..fda215a --- /dev/null +++ b/_meta/decision-log.md @@ -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 \ No newline at end of file