29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
# 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 |