[CLOUD SESSIONS] Complete guide for launching 5 cloud sessions with intra-agent communication
This commit is contained in:
Danny Stocker
parent
bc69892e3d
commit
6ebb6880d7
1 changed files with 360 additions and 0 deletions
360
LAUNCH_CLOUD_SESSIONS_GUIDE.md
Normal file
360
LAUNCH_CLOUD_SESSIONS_GUIDE.md
Normal file
|
|
@ -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
|
||||
Loading…
Add table
Reference in a new issue