@siftd/connect-agent 0.2.28 → 0.2.29

package/README.md

@@ -9,7 +9,9 @@ Connect Agent runs on your machine and bridges the Connect web app to Claude Cod
 - **Persistent Memory** - Remembers your preferences, projects, and context across sessions
 - **Worker Delegation** - Delegates complex tasks to Claude Code CLI workers
 - **Task Scheduling** - Schedule tasks for future execution
-- **Semantic Search** - Finds relevant memories by meaning, not just keywords
+- **Hub System** - Organized workspace at `~/Lia-Hub/` for state management
+- **Gallery View** - See all files your workers create in the UI
+- **Progress Tracking** - Real-time progress bars for running workers
 
 ## Quick Start
 
@@ -23,6 +25,12 @@ npx @siftd/connect-agent pair <CODE> --api-key <YOUR_ANTHROPIC_API_KEY>
 npx @siftd/connect-agent start
 ```
 
+On first start, the agent creates `~/Lia-Hub/` with:
+- `AGENTS.md` - Agent identity
+- `CLAUDE.md` - Your custom instructions
+- `LANDMARKS.md` - Current state
+- `notebook-a/` - Working notes and worker logs
+
 ## Modes
 
 ### Orchestrator Mode (Recommended)
@@ -31,6 +39,7 @@ When you provide an Anthropic API key, the agent runs as a **master orchestrator
 - Maintains persistent memory about you and your projects
 - Delegates file/code work to Claude Code CLI workers
 - Schedules future tasks
+- Reads hub files for context on every startup
 
 ### Simple Relay Mode
 Without an API key, the agent acts as a simple relay to `claude -p --continue`.
@@ -59,6 +68,24 @@ connect-agent logout
 - `/reset` or `/clear` - Clear conversation history
 - `/mode` - Check current mode (orchestrator vs simple)
 - `/memory` - Show memory statistics
+- `/verbose` - Toggle verbose tool output
+
+## Hub Structure
+
+```
+~/Lia-Hub/
+├── AGENTS.md           # Agent identity and capabilities
+├── CLAUDE.md           # Your custom instructions (always followed)
+├── LANDMARKS.md        # Current state, active projects
+├── MISTAKES.md         # Lessons learned (never deleted)
+├── notebook-a/
+│   ├── SCRATCHPAD.md   # Working notes and plans
+│   └── WORKER-LOG.md   # All worker history (auto-logged)
+└── shared/
+    └── outputs/        # Worker output files
+```
+
+Edit `CLAUDE.md` to customize the orchestrator's behavior!
 
 ## How It Works
 
@@ -72,7 +99,7 @@ connect-agent logout
                                                  ┌─────────────────┐
                                                  │ Master          │
                                                  │ Orchestrator    │
-                                                 │ (memory, sched) │
+                                                 │ (memory, hub)   │
                                                  └────────┬────────┘
                                                           │ delegates
                                                           ▼
@@ -83,17 +110,32 @@ connect-agent logout
 ```
 
 The orchestrator understands it's the **master**, not a worker. It:
-1. Receives your message from the web
-2. Searches memory for relevant context
-3. Decides what needs to be done
-4. Delegates actual work to Claude Code CLI
-5. Synthesizes results into a clear response
-6. Remembers important things for next time
+1. Loads hub context (AGENTS.md, CLAUDE.md, LANDMARKS.md)
+2. Receives your message from the web
+3. Searches memory for relevant context
+4. Decides what needs to be done
+5. Delegates actual work to Claude Code CLI workers
+6. Shows progress in real-time
+7. Synthesizes results into a clear response
+8. Logs workers to WORKER-LOG.md
+9. Remembers important things for next time
+
+## Customizing Worker Behavior
+
+All worker prompts are defined in `src/prompts/worker-system.ts`. Update this file to change how ALL workers behave:
+
+```typescript
+// src/prompts/worker-system.ts
+export const WORKER_IDENTITY = `...`;
+export const WORKER_OUTPUT_FORMAT = `...`;
+export function buildWorkerPrompt(task, options) { ... }
+```
 
 ## Environment Variables
 
 - `ANTHROPIC_API_KEY` - Alternative to `--api-key` flag
 - `VOYAGE_API_KEY` - (Optional) For better semantic search embeddings
+- `DATABASE_URL` - (Optional) PostgreSQL for cloud memory persistence
 
 ## Requirements
 
@@ -101,6 +143,13 @@ The orchestrator understands it's the **master**, not a worker. It:
 - [Claude Code CLI](https://claude.ai/code) installed and authenticated
 - Anthropic API key (for orchestrator mode)
 
+## Version History
+
+- **v0.2.28** - Lia-Hub structure, CLAUDE.md support, standardized worker prompts
+- **v0.2.27** - Fixed workers opening browser tabs
+- **v0.2.26** - Gallery view, worker asset tracking
+- **v0.2.25** - Progress bars, heartbeat system
+
 ## License
 
 MIT

package/dist/orchestrator.js

@@ -463,11 +463,26 @@ export class MasterOrchestrator {
         const memoryContext = await this.getMemoryContext(message);
         // Build system prompt with hub context, genesis knowledge, and memory context
         const genesisKnowledge = getKnowledgeForPrompt();
-        let systemWithContext = SYSTEM_PROMPT + genesisKnowledge;
-        // Add hub context (landmarks + project bio)
+        let systemWithContext = SYSTEM_PROMPT;
+        // CRITICAL: Inject hub context IMMEDIATELY after system prompt
+        // This ensures the orchestrator sees AGENTS.md, CLAUDE.md, LANDMARKS.md content
         if (hubContextStr) {
-            systemWithContext += `\n\n---\n\nHUB CONTEXT:\n${hubContextStr}`;
+            systemWithContext += `
+
+═══════════════════════════════════════════════════════════════════════════════
+                         YOUR HUB FILES (READ THESE FIRST!)
+═══════════════════════════════════════════════════════════════════════════════
+
+The following are the CURRENT CONTENTS of your hub files at ~/Lia-Hub/.
+ALWAYS check these before responding - especially CLAUDE.md for user instructions.
+
+${hubContextStr}
+
+═══════════════════════════════════════════════════════════════════════════════
+`;
         }
+        // Add genesis knowledge and memory context
+        systemWithContext += genesisKnowledge;
         if (memoryContext) {
             systemWithContext += `\n\nRELEVANT MEMORIES:\n${memoryContext}`;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siftd/connect-agent",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "description": "Master orchestrator agent - control Claude Code remotely via web",
   "type": "module",
   "main": "dist/index.js",