From 6ebb6880d7d75f3976f5e9659af584c93ecea9aa Mon Sep 17 00:00:00 2001 From: Danny Stocker Date: Thu, 13 Nov 2025 12:09:10 +0100 Subject: [PATCH] [CLOUD SESSIONS] Complete guide for launching 5 cloud sessions with intra-agent communication --- LAUNCH_CLOUD_SESSIONS_GUIDE.md | 360 +++++++++++++++++++++++++++++++++ 1 file changed, 360 insertions(+) create mode 100644 LAUNCH_CLOUD_SESSIONS_GUIDE.md diff --git a/LAUNCH_CLOUD_SESSIONS_GUIDE.md b/LAUNCH_CLOUD_SESSIONS_GUIDE.md new file mode 100644 index 0000000..f6be6b5 --- /dev/null +++ b/LAUNCH_CLOUD_SESSIONS_GUIDE.md @@ -0,0 +1,360 @@ +# Launch Cloud Sessions - Step-by-Step Guide + +**Status:** ✅ All infrastructure ready (chat system PID 14596, session prompts prepared) +**Time Required:** 15 minutes to launch all 5 sessions +**Updated:** 2025-11-13 11:10 UTC + +--- + +## Prerequisites (Already Complete) + +- ✅ Chat system running (PID 14596) +- ✅ 5 session prompt files created +- ✅ agents.md updated with NaviDocs context +- ✅ GitHub repo accessible (dannystocker/navidocs) +- ✅ StackCP environment verified +- ✅ Demo files deployed + +--- + +## How Cloud Sessions Work + +**Important:** Cloud sessions run in **Claude Code Cloud (web browser)**, NOT directly on StackCP. + +``` +┌─────────────────────────────────────────────────────────────┐ +│ ARCHITECTURE │ +└─────────────────────────────────────────────────────────────┘ + +Local Claude (You) StackCP Server Cloud Sessions (Browser) +┌────────────┐ ┌────────────┐ ┌──────────────┐ +│ Sonnet │─Messages───>│ File Sync │<────────>│ Session 1-5 │ +│ Leader │<───────────>│ (SSH) │ │ (Haiku) │ +└────────────┘ └────────────┘ └──────────────┘ + │ │ │ + └───── Commands ────────────┴────── Work Results ───┘ +``` + +**Key Point:** StackCP is the **message broker** (file storage), not the execution environment. + +--- + +## Step 1: Access Session Prompts + +Each prompt file contains everything a cloud session needs to know: + +```bash +# Location (already created) +/home/setup/navidocs/CLOUD_SESSION_PROMPT_1_PHOTO_INVENTORY.md (4.4K) +/home/setup/navidocs/CLOUD_SESSION_PROMPT_2_DOCUMENT_SEARCH.md (5.5K) +/home/setup/navidocs/CLOUD_SESSION_PROMPT_3_MAINTENANCE_TIMELINE.md (6.0K) +/home/setup/navidocs/CLOUD_SESSION_PROMPT_4_DEMO_POLISH.md (7.5K) +/home/setup/navidocs/CLOUD_SESSION_PROMPT_5_INTEGRATION_TESTING.md (11K) +``` + +**Each prompt includes:** +- Session ID and role +- NaviDocs project context +- Intra-agent communication protocol +- SSH commands for StackCP access +- Task assignments +- Chat system usage instructions + +--- + +## Step 2: Open Claude Code Cloud + +**Option A: Claude.ai (Recommended)** +1. Go to https://claude.ai +2. Click "Continue with Claude Code" or access Claude Code Cloud interface +3. Open 5 browser tabs (one per session) + +**Option B: Claude Code Cloud Direct** +1. Access Claude Code Cloud web interface +2. Open 5 separate sessions + +--- + +## Step 3: Launch Sessions (15 minutes) + +### Session 1: Photo Inventory + OCR + +```bash +# 1. Open session prompt +cat /home/setup/navidocs/CLOUD_SESSION_PROMPT_1_PHOTO_INVENTORY.md + +# 2. Copy ENTIRE file contents +# 3. Paste into Claude Code Cloud Session 1 +# 4. Wait for session to acknowledge and begin work +``` + +**What Session 1 will do:** +- Clone navidocs repo from GitHub +- Build photo inventory system (90 min) +- Integrate OCR for receipts using Claude Code CLI +- Deploy depreciation calculation display +- Report status via `/tmp/send-to-cloud.sh` + +### Session 2: Document Search + +```bash +# 1. Open session prompt +cat /home/setup/navidocs/CLOUD_SESSION_PROMPT_2_DOCUMENT_SEARCH.md + +# 2. Copy and paste into Claude Code Cloud Session 2 +``` + +**What Session 2 will do:** +- Integrate Meilisearch (already running on port 7700) +- Build PDF upload system (60 min) +- Configure instant search <200ms +- Test with Azimut 55S manuals + +### Session 3: Maintenance Timeline + +```bash +cat /home/setup/navidocs/CLOUD_SESSION_PROMPT_3_MAINTENANCE_TIMELINE.md +# Copy and paste into Claude Code Cloud Session 3 +``` + +**What Session 3 will do:** +- Build service log interface (60 min) +- Implement warranty alert system +- Create provider contact management +- Auto-detect warranty duration from online research + +### Session 4: Demo Polish + +```bash +cat /home/setup/navidocs/CLOUD_SESSION_PROMPT_4_DEMO_POLISH.md +# Copy and paste into Claude Code Cloud Session 4 +``` + +**What Session 4 will do:** +- Load Azimut 55S case study data (30 min) +- Apply IBM Carbon + Meilisearch styling +- Polish UI transitions and animations +- Verify mobile responsiveness + +### Session 5: Integration Testing + +```bash +cat /home/setup/navidocs/CLOUD_SESSION_PROMPT_5_INTEGRATION_TESTING.md +# Copy and paste into Claude Code Cloud Session 5 +``` + +**What Session 5 will do:** +- Run integration tests across all features +- Verify chat system communication +- Validate data consistency +- Generate test report +- Coordinate final deployment + +--- + +## Step 4: Monitor Progress (Local Claude) + +### Check Messages from Cloud Sessions + +```bash +# Read all messages from all sessions +/tmp/read-from-cloud.sh + +# Read specific session +/tmp/read-from-cloud.sh 1 # Photo Inventory +/tmp/read-from-cloud.sh 2 # Document Search +/tmp/read-from-cloud.sh 3 # Maintenance Timeline +/tmp/read-from-cloud.sh 4 # Demo Polish +/tmp/read-from-cloud.sh 5 # Integration Testing +``` + +### Send Instructions to Cloud Sessions + +```bash +# Send to specific session +/tmp/send-to-cloud.sh 1 "Status Check" "How's photo inventory progress?" + +# Send to all sessions (broadcast) +for i in {1..5}; do + /tmp/send-to-cloud.sh $i "Priority Update" "Focus on demo-ready features first" +done +``` + +### Monitor Chat Logs + +```bash +# Real-time monitoring +tail -f /tmp/claude-sync.log + +# Check sync status +grep "ERROR" /tmp/claude-sync.log # Should be empty +grep "Sent" /tmp/claude-sync.log | tail -10 # Recent sends +``` + +--- + +## Step 5: Coordinate Work (Sonnet Leader Role) + +As the local Sonnet leader, you: + +1. **Receive blockers:** Cloud Haiku agents report issues via chat +2. **Make decisions:** Architecture choices, priority conflicts, scope changes +3. **Resolve conflicts:** When two sessions need the same resource +4. **Approve deploys:** Final say on production deployments + +**Example Coordination:** + +```bash +# Session 1 reports blocker +/tmp/read-from-cloud.sh 1 +# → "BLOCKER: OCR API rate limit hit (429 errors). Need alternative approach." + +# You respond with decision +/tmp/send-to-cloud.sh 1 "DECISION: OCR Approach" \ + "Switch to local Tesseract OCR instead of API. Install: apt-get install tesseract-ocr" + +# Session 1 acknowledges and continues +/tmp/read-from-cloud.sh 1 +# → "ACKNOWLEDGED: Installing Tesseract locally. ETA 10 min." +``` + +--- + +## Step 6: StackCP agents.md Setup (Optional) + +If you want cloud sessions to have local agents.md reference on StackCP: + +```bash +# Clone infrafabric repo to StackCP +ssh stackcp "cd ~ && git clone https://github.com/dannystocker/infrafabric.git" + +# Update agents.md (already has latest NaviDocs info) +ssh stackcp "cd ~/infrafabric && git pull" + +# Cloud sessions can now read: +# ~/infrafabric/agents.md (lines 988-1200 have NaviDocs context) +``` + +**But this is NOT required** - session prompts already contain all needed context. + +--- + +## Troubleshooting + +### Chat System Issues + +```bash +# Check if sync script is running +ps aux | grep claude-sync +# Should show: PID 14596 /bin/bash /tmp/claude-sync-5-sessions.sh + +# Restart if needed +/tmp/activate-claude-chat.sh + +# Verify directories exist on StackCP +ssh stackcp "ls -la ~/claude-inbox/ ~/claude-outbox/" +``` + +### Session Not Responding + +```bash +# Check if session received message +ssh stackcp "ls -la ~/claude-inbox/session-1/" + +# Check if session sent reply +ssh stackcp "ls -la ~/claude-outbox/session-1/" + +# Manual message check +/tmp/read-from-cloud.sh 1 +``` + +### GitHub Access Issues + +Cloud sessions need GitHub access for private repo. Two options: + +**Option A: Setup Deploy Key** (Recommended - read-only) +```bash +# Follow guide: +cat /home/setup/navidocs/SECURE_GITHUB_ACCESS_FOR_CLOUD.md +``` + +**Option B: Make repo public temporarily** (Quick but not secure) +```bash +# Go to: https://github.com/dannystocker/navidocs/settings +# Change visibility: Private → Public +# After demo: Change back to Private +``` + +--- + +## Quick Reference Commands + +```bash +# Send message to cloud session +/tmp/send-to-cloud.sh <1-5> "Subject" "Body" + +# Read messages from cloud +/tmp/read-from-cloud.sh [session] + +# Monitor chat logs +tail -f /tmp/claude-sync.log + +# Check chat system status +ps aux | grep claude-sync + +# Restart chat system +/tmp/activate-claude-chat.sh + +# Verify StackCP connectivity +ssh stackcp "hostname && whoami" + +# Check Meilisearch running +ssh stackcp "curl -s http://localhost:7700/health" +``` + +--- + +## Expected Timeline + +``` +T+0min: Launch all 5 sessions (copy-paste prompts) +T+5min: Sessions clone repos, verify environment +T+15min: Session 1 begins photo inventory work +T+20min: Session 2 begins document search +T+25min: Session 3 begins maintenance timeline +T+30min: Session 4 begins demo polish +T+90min: Session 1 reports photo inventory complete +T+120min: Sessions 2-4 report feature complete +T+180min: Session 5 runs integration tests +T+200min: ALL SESSIONS COMPLETE → Demo ready +``` + +--- + +## Success Criteria + +**You'll know cloud sessions are working when:** + +1. ✅ `/tmp/read-from-cloud.sh` shows messages from sessions +2. ✅ Sessions report progress every 15-30 minutes +3. ✅ Blockers are escalated and resolved via chat +4. ✅ Features are deployed to StackCP navidocs-app/ +5. ✅ Integration tests pass (Session 5 final report) + +--- + +## Next Steps After Launch + +1. **Monitor first 15 minutes** - Ensure all sessions started successfully +2. **Check for blockers** - Run `/tmp/read-from-cloud.sh` every 10 minutes +3. **Coordinate work** - Respond to questions and approve decisions +4. **Verify deployments** - Test features as they're completed +5. **Final integration** - Session 5 validates everything works together + +--- + +**Status:** Ready to launch cloud sessions NOW +**Demo Deadline:** ~3 hours from now (Riviera Plaisance at 15:00 UTC) +**Communication:** Chat system operational (PID 14596) + +**To begin:** Copy contents of `CLOUD_SESSION_PROMPT_1_PHOTO_INVENTORY.md` into Claude Code Cloud Session 1