# 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