personal-agent-os/_meta/decision-log.md

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