Decision Log

Decision Log

This log records significant architectural and operational decisions — what was decided, why, and what comes next. Each entry follows the format:

• Decision: What was chosen or changed
• Why: The reasoning or problem being solved
• Owner: Who made or owns the decision
• Next: Follow-up actions or status

---

February 2026

2026-02-22: Agent operating modes + daily goals pattern

• Decision: Introduce two agent states (AUTONOMOUS and ORCHESTRATOR) and per-agent DAILY_GOALS.md as session-reset/heartbeat context anchor.
• Why: Improve continuity, reduce context loss on resets, and make autonomous work explicit/observable in Mission Control.
• Owner: Chris + Winnie
• Next: Default all agents to ORCHESTRATOR initially; selectively enable AUTONOMOUS with guardrails and heartbeat checks.

2026-02-21: Claude Code as primary coding tool

• Decision: Use Claude Code CLI (Plan→Execute pattern) for all serious builds instead of sessions_spawn.
• Why: Iterates on errors, explores codebase, coordinates multi-file changes, built-in skills.
• Owner: Winnie
• Next: All agents updated with skill docs. Stream-JSON mode for real-time monitoring.

2026-02-21: Mission Control dashboard architecture

• Decision: Next.js 15 + SQLite + Tailwind 4, served via Tailscale.
• Why: Gives Chris visibility into tasks, agents, research, activity. SQLite for persistence without external DB.
• Owner: Winnie + Claude Code
• Next: Move from /tmp to permanent path. Implement heartbeat integration.

2026-02-21: Heartbeat improvements needed

• Decision: Current heartbeat setup has gaps — needs Mission Control integration, autonomous work triggers, per-agent policies.
• Why: Research found: no MC integration, no process monitoring, no autonomous work queue.
• Owner: Winnie
• Next: Implement findings from memory/research/heartbeat-improvements/README.md.

2026-02-20: Sub-agent architecture

• Decision: dev-backend + dev-frontend converted from persistent agents to sub-agent templates.
• Why: Devs don’t need persistent state. PMs spawn them as needed.
• Owner: Winnie
• Next: Working well. Claude Code now preferred over spawned dev agents for complex builds.

2026-02-20: Agent-to-agent comms

• Decision: Always use timeoutSeconds=0 (fire-and-forget) on sessions_send.
• Why: Nested lane has concurrency=1, no config knob. Without fire-and-forget, calls queue and timeout.
• Owner: Winnie
• Next: GitHub issue filed (openclaw/openclaw#22167).

2026-02-17: HQ access control

• Decision: Only Chris (8267352500) can trigger group replies. General topic no mention required, all others require mention.
• Owner: Chris
• Next: Stable, no changes needed.