CLAUDE.md@rabbitmq-agents/archive/v3-demo3-fixed-2 · git:20251211.7a6a589 · 2025-12-11 · sha256 eda3257d76ccfc00
CLAUDE.md@rabbitmq-agents/archive/v3-demo3-fixed-2 git:20251211.7a6a589A
Immutable. This exact content is served forever at /api/v1/blob/eda3257d76ccfc00.
# CLAUDE.md - System Inspector Demo v6.0.0
## ULTRATHINK EDITION - Fully Verified & Documented
**Bu demo %100 calisir durumda. Asagidaki komutlari kullan.**
---
## HIZLI BASLATMA (2 KOMUT)
```bash
# 1. BASLAT (Task 1-5)
cd /Users/umitkacar/Documents/github-pluginagentmarketplace/claude-collective-intelligence/rabbitmq-agents/demos/demo-3-system-inspector && python3 orchestrator.py
# 2. KAPAT (Task Final - RabbitMQ cleanup dahil!)
python3 orchestrator.py --task task_final --load-context
```
**Veya kisa yol:**
```bash
./run.sh # Baslat
./run.sh shutdown # Kapat
```
---
## Bu Demo Ne Yapar?
Multi-agent terminal orchestration pipeline - Mac dual-monitor setup:
| Task | Isim | Aciklama | Sure |
|------|------|----------|------|
| 1 | Display Inspector | Mac ekranlarini tespit eder | ~0.3s |
| 2 | Terminal Setup | 3 terminal acar + Window ID yakalar | ~3s |
| 3 | Screenshot Validator | Dogrulama screenshot'i alir | ~1.7s |
| 4 | Claude Launcher | Her terminalde Claude Code baslatir | ~21s |
| 5 | Role Prompter | RabbitMQ rollerini atar (doc-based) | ~54s |
| **Final** | **Safe Shutdown** | **RabbitMQ cleanup + /exit + terminal kapat** | ~38s |
**Toplam:** ~80s (Task 1-5) + ~38s (Task Final) = ~118s
---
## KRITIK: Ogrenilen Dersler (v6.0.0)
### 1. RabbitMQ Credentials
```
YANLIS: guest/guest (YOK!)
DOGRU: admin/rabbitmq123 (docker-compose.yml'dan)
```
### 2. RabbitMQ Management API Path
```
YANLIS: http://localhost:15672/api/
DOGRU: http://localhost:15672/rabbitmq/api/ (path_prefix "/rabbitmq")
```
### 3. Agent Baglanti Komutu
```bash
# YANLIS - Slash komutlari orchestrator.js'i calistirmiyor!
/join-team worker
/orchestrate team-leader
# DOGRU - Direkt bash komutu
cd /Users/umitkacar/.../claude-collective-intelligence && \
AGENT_ID="worker-1" AGENT_NAME="Worker 1" node src/core/orchestrator.js worker
```
### 4. RESOURCE_LOCKED Hatasi Onleme
Shutdown sirasinda exclusive queue'lar silinmeli:
- `brainstorm.team-leader-main`
- `brainstorm.results.team-leader-main`
- `status.team-leader-main`
- `brainstorm.worker-1`, `brainstorm.results.worker-1`
- `brainstorm.worker-2`, `brainstorm.results.worker-2`
**Cozum:** task_final.py v2.0 - RabbitMQ cleanup eklendi!
---
## Pipeline Architecture v6.0.0
```
==========================================================================
SYSTEM INSPECTOR PIPELINE v6.0.0
ULTRATHINK EDITION
==========================================================================
TASK 1 TASK 2 TASK 3 TASK 4 TASK 5
Display -----> Terminal -----> Screenshot -----> Claude -----> Role
Inspector Setup Validator Launcher Prompter
| |
v v
Window ID Capture Doc-Based
[26488, 26490, 26492] Rol Atama
| |
+------------------+------------------+ |
| | | |
v v v |
LEADER WORKER-1 WORKER-2 |
| | | |
v v v |
LEADER.md WORKER-1.md WORKER-2.md |
| | | |
v v v |
RabbitMQ'ya RabbitMQ'ya RabbitMQ'ya |
Baglan Baglan Baglan |
| | | |
+------------------+------------------+ |
| |
v |
TASK FINAL <----------------------------+
Safe Shutdown v2.0
|
+------------------+------------------+
| | |
v v v
RabbitMQ RabbitMQ RabbitMQ
Cleanup Cleanup Cleanup
(queues) (connections) (exclusive)
| | |
v v v
/exit /exit /exit
close close close
==========================================================================
```
---
## Dosya Yapisi v6.0.0
```
demo-3-system-inspector/
|
+-- ENTRY POINTS
| +-- orchestrator.py # Ana script
| +-- run.sh # Shell shortcut
| +-- CLAUDE.md # Bu dosya
|
+-- CONFIG
| +-- config/
| +-- workflow.yaml # Pipeline v6.0.0
|
+-- TASKS
| +-- tasks/
| +-- __init__.py
| +-- base.py # BaseTask
| +-- display_inspector.py # Task 1 (v1.0.0)
| +-- terminal_setup.py # Task 2 (v3.0.0)
| +-- screenshot_validator.py # Task 3 (v1.0.0)
| +-- claude_launcher.py # Task 4 (v2.0.0)
| +-- role_prompter.py # Task 5 (v3.0.0 - doc-based)
| +-- task_final.py # Task Final (v2.0.0 - RabbitMQ cleanup!)
|
+-- DOCS (Agent Talimatlari - KRITIK!)
| +-- docs/
| +-- README.md # Docs aciklamasi
| +-- roles/
| | +-- LEADER.md # Team Leader talimatlari
| | +-- WORKER-1.md # Worker 1 talimatlari
| | +-- WORKER-2.md # Worker 2 talimatlari
| +-- rabbitmq/
| +-- CONNECTION.md # RabbitMQ baglanti bilgileri
|
+-- QUICK-START (Hizli Baslatma)
| +-- quick-start/
| +-- 1-prerequisites.md # Gereksinimler
| +-- 2-run-pipeline.md # Pipeline calistirma
| +-- 3-verify-agents.md # Agent dogrulama
| +-- 4-shutdown.md # Guvenli kapatma
|
+-- SCREENSHOTS (Kanitlar)
| +-- screenshots/
| +-- WORKED_3_*.png # En son basarili calisma
|
+-- REPORTS
| +-- reports/
| +-- pipeline_report_WORKED_3.json
|
+-- SCRIPTS
+-- scripts/
+-- setup_terminals.scpt # Auto-generated
```
---
## RabbitMQ Baglanti Dogrulama
Agent'lar baglandiktan sonra kontrol et:
```bash
# Baglanti sayisi (3 olmali)
docker exec agent_rabbitmq rabbitmqctl list_connections user
# Queue consumer sayilari
docker exec agent_rabbitmq rabbitmqctl list_queues name messages consumers | grep -E "agent\.|brainstorm\.|status\."
# Beklenen cikti:
# agent.results 0 1 (LEADER dinliyor)
# agent.tasks 0 2 (WORKER-1 + WORKER-2)
```
---
## Hata Giderme
### RESOURCE_LOCKED Hatasi
```
Error: RESOURCE_LOCKED - cannot obtain exclusive access to locked queue
```
**Cozum:** Shutdown sirasinda RabbitMQ cleanup yapilmamis. Manuel temizlik:
```bash
# Tum baglantilari kapat
curl -u admin:rabbitmq123 -X DELETE "http://localhost:15672/rabbitmq/api/connections/URL_ENCODED_NAME"
# veya Docker restart
docker restart agent_rabbitmq
```
### Agent Baglanmiyor
```
Error: Connection refused
```
**Kontrol:**
1. RabbitMQ calisiyor mu? `docker ps | grep rabbitmq`
2. Port acik mi? `nc -zv localhost 5672`
3. Credentials dogru mu? `admin:rabbitmq123`
### Management API 404
```
{"error":"Object Not Found","reason":"Not Found"}
```
**Cozum:** Path prefix eksik. Dogru URL:
```
http://localhost:15672/rabbitmq/api/overview
```
---
## Version History
| Version | Tarih | Degisiklikler |
|---------|-------|---------------|
| 6.0.0 | 2025-12-11 | RabbitMQ cleanup (task_final v2.0), doc-based rol atama, credentials fix, path_prefix fix |
| 5.1.0 | 2025-12-11 | Task Final (safe shutdown), --load-context |
| 5.0.0 | 2025-12-11 | Window ID tracking, RabbitMQ role assignment |
| 4.0.0 | 2025-12-11 | role_prompter task |
| 3.0.0 | 2025-12-11 | claude_launcher task |
| 2.0.0 | 2025-12-11 | screenshot_validator task |
| 1.0.0 | 2025-12-11 | Initial release |
---
## Kanitlar (WORKED_3)
- `screenshots/WORKED_3_all_agents_connected.png` - 3 agent RabbitMQ'ya bagli
- `reports/pipeline_report_WORKED_3.json` - Pipeline raporu
---
**Version:** 6.0.0 (ULTRATHINK EDITION)
**Status:** WORKING - VERIFIED
**Last Updated:** 2025-12-11