Memory
## Amy v1 - Complete Architecture Design ### Overview Amy is Mike's private agentic workspace — a multi-workspace assistant platform built on assistant-ui (frontend) and Cloudflare Agents/Project Think (backend). ### Architecture Summary ``` ┌─────────────────────────────────────────────────────────────────┐ │ assistant-ui (React) │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │Personal │ │Coding │ │Research │ │Business │ │ │ │Assistant │ │Coordinator│ │Agent │ │Agent │ │ │ │Workspace │ │Workspace │ │Workspace │ │Workspace │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ │ │ │ │ └─────────────┴────────────┴─────────────┘ │ │ useAISDKRuntime │ └─────────────────────────────────────────────────────────────────┘ │ useAgentChat + useAgent │ ┌─────────┴─────────┐ │ WebSocket │ └─────────┬─────────┘ │ ┌─────────────────────────────────────────────────────────────────┐ │ Cloudflare Workers (4 Durable Objects) │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │Assistant │ │Coding │ │Research │ │Business │ │ │ │Think │ │Think │ │Think │ │Think │ │ │ │Instance │ │Instance │ │Instance │ │Instance │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ │ │ │ │ └─────────────┴────────────┴─────────────┘ │ │ Second-Brain (shared memory) │ └─────────────────────────────────────────────────────────────────┘ │ ┌─────────┴─────────┐ │ Todomator MCP │ │ (Coordination) │ └───────────────────┘ ``` ### Components #### 1. Frontend (assistant-ui) - **Multi-workspace UI**: Sidebar with workspace switcher (Personal, Coding, Research, Business) - **Dark mode**: Default theme - **Thread management**: Each workspace has its own thread list - **Tool call UI**: Generative UI for tool results - **Voice mode**: `@cloudflare/voice` integration (v1) - **RTK video calls**: Deferred to v2 #### 2. Backend (Cloudflare Agents / Project Think) - **4 Standalone Think agents**: One per workspace - **Each agent**: Own Durable Object, SQLite persistence, WebSocket connection - **Model routing**: AI Gateway → Workers AI (primary), other providers later - **Built-in tools**: Think workspace tools (file ops) - **Custom tools**: Added per agent role #### 3. Shared Memory (Second-Brain) - **Cross-agent knowledge**: Facts, decisions, preferences - **Used by all agents**: Via prompts/instructions - **Persistent**: Survives session restarts #### 4. Coordination (Todomator MCP) - **Task management**: Create, assign, track tasks across agents - **Agent-to-agent handoff**: Agent A assigns task to Agent B via Todomator - **Status tracking**: Ticket statuses, time tracking, comments - **Integration**: Cloudflare Worker wrapping Todomator API as MCP server ### Agent Roles & Tools | Agent | Purpose | Key Tools | |-------|---------|-----------| | Personal Assistant | General chat, tasks, memory | Second-Brain, Todomator, Voice | | Coding Coordinator | Plan/code tasks, create Workers | Think workspace, Todomator, MCP | | Research Agent | Research, documents, crawling | Second-Brain, Document Intelligence, Crawlberg | | Business Agent | Strategy, planning, operations | Second-Brain, Todomator | ### Build Phases #### Phase 1: Core (v1) 1. Scaffold Cloudflare Worker + assistant-ui frontend 2. Implement 4 Think agents with basic chat 3. Add multi-workspace UI with thread management 4. Dark mode theming 5. Todomator MCP integration 6. Voice mode integration 7. Second-Brain memory integration #### Phase 2: Enhancements 1. RTK video calls 2. Additional MCP servers 3. Custom API tools per agent 4. Advanced tool UI (generative) 5. Cross-agent context sharing via Second-Brain ### Technical Decisions - **Agent Topology**: Standalone agents (Option C) - **Voice & RTK**: Voice in v1, RTK in v2 - **Thread Scope**: Separate workspaces with threads, multiple open simultaneously - **Memory**: Second-Brain as shared memory - **Coordination**: Todomator via MCP server
Tags: project-amy, architecture, v1-design, complete, project:amy, duplicate-candidate, kind:semantic — Source: claude — 2026-07-04 11:37:46 UTC