1 files changed, 32 insertions, 0 deletions
diff --git a/.agent/narrative.md b/.agent/narrative.md
new file mode 100644
index 0000000..778df85
--- /dev/null
+++ b/.agent/narrative.md
@@ -0,0 +1,32 @@
+# Engineering Narrative & Project Evolution
+
+This document tracks the chronological history and major milestones of the **Doot** ecosystem (including its relationship with Claudomator).
+
+## 1. Ecosystem Origins (Claudomator)
+**Claudomator** was developed as the core "task-execution engine." It introduced:
+- **Human-in-the-Loop Workflow:** A `READY` state that requires operator sign-off (`Accept/Reject`) before a task is considered `COMPLETED`.
+- **Question/Answer Flow:** Agents can transition a task to `BLOCKED` by writing a `question.json` file, allowing users to provide context asynchronously.
+- **Subtask Graphing:** The `claudomator` CLI allows agents to break complex goals into manageable subtasks.
+
+## 2. The Birth of Doot (Consolidation)
+**Doot** (this project) was created to solve "Context Blindness." Instead of managing tasks across Todoist, Trello, and Google Calendar separately, Doot aggregates them into a single, high-speed interface.
+
+### Key Milestones:
+- **Phase 1: Read-Only Aggregation:** Initial dashboard with Trello, Todoist, and PlanToEat.
+- **Phase 2: Authentication:** Wired up `internal/auth` with SQLite sessions and default admin user.
+- **Phase 3: Timeline & Google Integration:** Added the "Timeline" view, aggregating Google Calendar and Google Tasks via a cached store layer.
+- **Phase 4: Agent Context API:** Built the `/agent/context` endpoint and WebSocket-based approval flow to let AI agents "see" what the user is working on safely.
+
+## 3. Current Direction: Strategic Execution
+The project is currently evolving into a **Strategic Agent Studio**, where:
+- Doot serves as the "Lens" (View/Approve).
+- Claudomator serves as the "Muscle" (Execute/Deliver).
+- The `.agent/` directory serves as the "Brain" (Config/Context).
+
+## 4. Historical Activity Log (Raw)
+
+--- 2026-03-16T01:52:44Z ---
+Do a thorough review for refactoring opportunities, logic bugs and code, redundancy and shaky abstractions. Create claudomator tasks for each
+
+--- 2026-03-17T09:02:26Z ---
+Completing Trello tasks doesn't work: failed to load content (Fix: Verified and corrected Trello API param mapping)