summaryrefslogtreecommitdiff
path: root/.agent/narrative.md
blob: 778df8581b5e41e9c1be02c1334c7eab70a20192 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
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)