BlueFly Agent Platform - Quick Reference

Separation of Duties: See Separation of Duties - Getting started guides document onboarding. They do NOT own agent manifests, execution, or infrastructure configuration.

Last Updated: 2025-01-XX
Status: Production Ready
Purpose: One-page quick reference for daily development

---

The Stack

  CLIENTS                                                                     
   Claude Desktop + MCP Servers     GitLab Duo     AgentStudio IDE        
   Screens 5 (VNC remote access)                                            

  NETWORK LAYER                                                               
  Internet  Spectrum Modem  Ethernet                                       
     Deco X60 Mesh WiFi (general network)                                 
     GL-BE3600 Router (BlueflyMesh: 192.168.8.0/24)                       
          Tailscale (100.116.110.123) - Subnet router                     

  INFRASTRUCTURE                                                              
   OrbStack (Kubernetes/Docker)     DDEV (Drupal)     K8s/K9s             

  AGENT ROUTER (Port 3006) - LLM Gateway                                      
  Routes to: Ollama (11434)  OpenAI  Anthropic  Gemini                     
  Strategies: auto-route | cost | performance | quality                       

  AGENT MESH (Port 3003 REST, 50051 gRPC) - Backend Coordination              
   Agent Registry  Discovery  Health Monitoring                            
   Load Balancing: round-robin | least-loaded | priority | capability        
   Circuit Breaker + Rate Limiter                                            

  AGENT SERVICES (Ports 3000-3015)                                           
   Agent Brain (3000) - Vector DB     Agent Chat (3001) - Chat interface   
   Agent Docker (3002) - Containers   Agent Mesh (3003) - Coordination     
   Agent Ops (3004) - Operations      Agent Protocol (3005) - OSSA          
   Agent Router (3006) - LLM routing  Agent Studio (3007) - IDE             
   Agent Tracer (3008) - Tracing      Agentic Flows (3009) - Workflows     
   Compliance Engine (3010)           Doc Engine (3011)                    
   Foundation Bridge (3012)           RFP Automation (3013)                
   Studio UI (3014)                   Workflow Engine (3015)                

  OBSERVABILITY                                                               
  Phoenix (6006)  Prometheus (9090)  Jaeger (16686)  Grafana (3009)        

  DATA SERVICES                                                              
  PostgreSQL (5432)  Qdrant (6333)  Redis (6379)  MinIO (9000/9001)       

---

Network (Tailscale)

Tailscale Network Devices

Tailnet: tailcf98b3.ts.net | MagicDNS: Enabled | Funnel: Available

Network Infrastructure

• Spectrum Modem - Primary internet connection
• Deco X60 Mesh WiFi - https://www.tp-link.com/us/deco-mesh-wifi/product-family/deco-x60/
• GL-BE3600 Router - https://www.gl-inet.com/products/gl-be3600/
  • Local IP: 192.168.8.1
  • Tailscale IP: 100.116.110.123
  • Subnet routing: 192.168.8.0/24

---

Daily Workflow

Option 1: Docker Compose (Local)

cd $LLM_ROOT/kagent-demo/demo && docker-compose up -d
curl http://localhost:3008/health  # Agent Tracer
curl http://localhost:3006/health  # Agent Router
curl http://localhost:3003/health  # Agent Mesh

Option 2: DDEV (Drupal Platform)

cd $LLM_ROOT/demo_llm-platform
ddev start
ddev platform status
open https://llm-platform.ddev.site

Option 3: OrbStack Kubernetes

kubectl apply -f deployment/orbstack/
kubectl get pods -n development
open http://192.168.139.2:4000  # Agent Router
open http://192.168.139.2:6006  # Phoenix

Option 4: LLMCLI Infrastructure

llmcli infra core    # Core services
llmcli infra ai      # AI services
llmcli infra all     # Full platform
llmcli infra status  # Check status

---

Agent Routing Rules (Auto)

---

OSSA Manifest Structure

apiVersion: ossa/v0.4.9
kind: Agent
metadata:
  name: my-agent
  namespace: blueflyio
spec:
  taxonomy:
    role: worker | governor | critic | observer
  llm:
    provider: anthropic | openai | ollama
    model: claude-3-5-sonnet | gpt-4 | qwen2.5-coder
  capabilities:
    - code-generation
    - testing
    - review
  tools:
    - read_file
    - write_file
    - search
  extensions:
    kagent:  # Kubernetes deployment
    buildkit:  # Build orchestration
    drupal:  # Drupal integration

---

Key Files

---

CLI Quick Reference

# BuildKit
buildkit golden test          # Run all quality checks
buildkit golden deploy --env dev
buildkit agents list          # List available agents
buildkit swarm spawn --tasks tasks.json

# GitLab
glab issue create --title "..."
glab mr create --title "..." --source-branch feature/x
glab mr merge --yes

# Tailscale (expose services)
tailscale funnel 3006         # Expose agent-router
tailscale funnel 3003         # Expose agent-mesh
tailscale funnel 4000         # Expose LLM Gateway

# Tailscale network management
tailscale status
tailscale ping 100.116.110.123  # Test router connectivity
tailscale up --advertise-routes=192.168.8.0/24  # Advertise BlueflyMesh subnet

---

Port Reference

Core Orchestrators

Agent Services (3000-3099)

Observability

Data Services

AI Services

---

Key Domains

---

The Golden Rule

Everything is an agent. Everything is declarative. Everything flows through the mesh.

Issue  Agent assigns  MR created  Agent reviews 
Pipeline validates  Merge train  Release  Deployed

---

Related Documentation

• Architecture & Infrastructure
• Network Infrastructure
• Development Workflow & CI/CD
• Reference Links
• Action Items & TODOs

---

Full docs: https://gitlab.com/blueflyio/agent-platform/technical-docs/-/wikis/home