Decisions

  • Pending: Sequential (Phase 1) vs scaffolding architecture (Phase 2) — when to switch?
  • Pending: Google Calendar MCP server for calendar integration?
  • Pending: How to sync compiled briefing to Atlas (C:\Users\marij\Vaults\My Life Lab)?

User Tasks


Summary

Automated daily briefing that summarizes system status, pending tasks, and relevant updates.

Problem / Motivation

Without a daily summary, it’s easy to lose track of what the system has done, what needs attention, and what’s coming up. A briefing creates a daily rhythm.

Proposed Solution

A scheduled process that generates a daily briefing markdown file in the vault, summarizing feature status, recent changes, and action items.

Architecture: Sections Pattern (Phase 2+) Multiple sub-agents work in parallel, each writing a section file to vault/30_daily/briefings/YYYY-MM-DD/sections/. A compiler agent then merges all sections into the final briefing.

30_daily/
└── briefings/
    └── YYYY-MM-DD/
        ├── sections/        # Agent-written sections
        │   ├── changes.md
        │   ├── features.md
        │   ├── inbox.md
        │   ├── opus-activity.md   # What Opus did autonomously
        │   └── ...          # Future: finances.md, health.md, calendar.md
        └── briefing.md      # Compiled main briefing → also synced to Atlas

Section agents (run in parallel):

AgentReadsWrites
changes-agentGit log, recent vault changesYYYY-MM-DD/sections/changes.md
features-agentAll FR files (status, next-step, current-phase)YYYY-MM-DD/sections/features.md
inbox-agentvault/90_inbox/, vault/10_features/02_new/YYYY-MM-DD/sections/inbox.md
opus-activity-agentGit log filtered to autonomous/non-session commitsYYYY-MM-DD/sections/opus-activity.md
agent-reports-agentvault/00_system/logs/agent-reports/YYYY-MM-DD/YYYY-MM-DD/sections/agent-reports.md
cron-tasks-agentCron/scheduler execution logsYYYY-MM-DD/sections/cron-tasks.md
external-agentCalendar, weather, news (Phase 3)YYYY-MM-DD/sections/external.md

Note: Until autonomous actions are live (FR-066 or similar), changes.md covers Opus activity. Split into opus-activity.md when autonomous Opus actions are enabled.

Compiler agent (runs after all sections are ready):

  • Reads all vault/30_daily/briefings/YYYY-MM-DD/sections/*.md files
  • Applies the briefing template from _templates/briefing.md
  • Produces the final vault/30_daily/briefings/YYYY-MM-DD/briefing.md

This approach is faster (parallel), modular (easy to add new data sources), and testable (each section can be verified independently). Sections are kept for reference. Inspired by Sven’s scaffolding approach in Nexus.


Open Questions

No open questions.


Phase Overview

PhaseDescriptionStatus
Phase 1Basic briefing (sequential)
Phase 2Sections architecture
Phase 3Smart briefing (external data)
Phase 4Delivery (phone, voice)

Phase 1: Basic Briefing (Sequential) —

Goal: Generate a simple daily briefing file from feature overview and recent changes. Includes a daily cron task that refreshes all dashboards first, then generates the briefing with open items.

File / FeatureDetailsOwnerStatus
Dashboard refresh cronDaily task that syncs all dashboards (feature-dashboard, user-review-dashboard, ideas-dashboard, capabilities-dashboard, user-tasks-dashboard) with actual vault statemv
Open items extractionCollect items where Last Changed > User Review from user-review-dashboardmv
Briefing templateUpdate _templates/briefing.md to match sections-based approachopus
Generation scriptReads dashboards, feature overview, and recent changesopus
Output filevault/30_daily/briefings/YYYY-MM-DD/briefing.md — includes “Needs Your Review” section with open itemsmv
Naming conventionYYYY-MM-DD/briefing.md inside briefings/opus

Phase 2: Sections Architecture —

Goal: Implement parallel section agents and a compiler agent for modular briefing generation.

File / FeatureDetailsOwnerStatus
vault/30_daily/briefings/YYYY-MM-DD/sections/Sections directory (per date-folder)opus
changes-agent sectionGit log + recent changesopus
features-agent sectionFR status summaryopus
inbox-agent sectionInbox itemsopus
opus-activity-agent sectionGit log filtered to autonomous/non-session commits → YYYY-MM-DD/sections/opus-activity.mdopus
agent-reports-agent sectionReads vault/00_system/logs/agent-reports/YYYY-MM-DD/, summarizes per-agent activity (what each role did, which FRs, pass/fail) → YYYY-MM-DD/sections/agent-reports.mdopus
cron-tasks-agent sectionReads cron/scheduler execution logs, summarizes system-triggered tasks → YYYY-MM-DD/sections/cron-tasks.mdopus
Compiler agentMerges sections into final briefingopus
/briefing skill updateWire skill to use sections patternopus

Phase 3: Smart Briefing —

Goal: Add external data sources and intelligence to the briefing.

File / FeatureDetailsOwnerStatus
external-agent sectionWeather, calendar, newsopus
Priority-ranked action itemsSmart ordering of tasksopus
Week-over-week progressProgress trackingopus

Phase 4: Delivery —

Goal: Push briefings to other devices and formats.

File / FeatureDetailsOwnerStatus
Phone pushSee FR-032opus
Voice summaryText-to-speech generationopus
NotificationAlert when briefing is readyopus

Prerequisites / Gap Analysis

Requirements

RequirementDescription
REQ-1FR-025 (VPS) — for scheduled execution
REQ-2/briefing skill — to be built in Phase 1
REQ-3FR-044 (Task Scheduler) — for cron-based execution

Current State

ComponentStatusDetails
Feature overviewWIPExists but needs stabilization
Git log accessdoneAvailable via CLI
Briefing templateWIPNeeds update for sections-based approach

Gap (What’s missing?)

GapEffortBlocker?
Briefing template updateLowNo
Generation scriptMedNo
VPS for schedulingHighYes (for automation, not manual)

Test

Manual tests

TestExpectedOwnerActualLast
Daily briefing file is generatedFile in vault/30_daily/briefings/YYYY-MM-DD/mvpending-
Briefing includes feature statusFeature summary section presentmvpending-
Briefing includes recent changesChanges section presentmvpending-
Briefing includes action itemsAction items section presentmvpending-
Briefing is readable in ObsidianProper markdown formattingmvpending-

AI-verified tests

ScenarioExpected behaviorVerification method

E2E tests

ScenarioAssertion

Integration tests

ComponentCoverage

Unit tests

ComponentTestsCoverage

History

DateEventDetails
2026-02-26CreatedAs part of Phase 1 foundation
2026-02-28ReformattedAligned to feature-request template
2026-03-12UpdatedSections-based architecture, date-folders, opus-activity agent, Atlas sync decision

References

  • FR-025 (VPS Deployment) — scheduled execution
  • FR-049 (Error Logging) — error data feeds into briefing
  • FR-043 (Custom Agents) — briefing-compiler agent
  • ClaudeClaw Rebuild Prompt — SQLite-backed cron scheduler pattern with task persistence
  • FR-044 (Task Scheduler) — provides scheduled execution runtime
  • FR-066 — autonomous actions (triggers opus-activity section split)
  • FR-072 (Agency Company Structure) — agent reports and cron task logs feed into daily briefing as dedicated sections