← back to Daily Reporting

HIERARCHY-DIAGRAM.md

441 lines

# DW-Agents Organizational Hierarchy

Visual representation of the complete agent reporting structure.

```
                     ┌─────────────────────────────────────┐
                     │   👔 MASTER HUB (PRESIDENT)        │
                     │   Port: 9893                        │
                     │   Central Command & Coordination    │
                     └─────────────────────────────────────┘
                                      │
          ┌───────────────────────────┼───────────────────────────┐
          │                           │                           │
    ┌─────▼─────┐              ┌─────▼─────┐              ┌─────▼─────┐
    │ EXECUTIVE │              │ DEPARTMENT │             │  SUPPORT  │
    │   LEVEL   │              │   HEADS    │             │ SERVICES  │
    └───────────┘              └─────┬─────┘              └─────┬─────┘
                                      │                           │
                    ┌─────────────────┼─────────────────┐        │
                    │                 │                 │        │
             ┌──────▼──────┐   ┌─────▼──────┐   ┌─────▼──────┐ │
             │  OPERATIONS  │   │  FINANCE & │   │  CUSTOMER  │ │
             │              │   │   LEGAL    │   │ ENGAGEMENT │ │
             └──────────────┘   └────────────┘   └────────────┘ │
                                                                  │
                    ┌─────────────────────────────────────────────┘
                    │
          ┌─────────┼─────────────────┬──────────────┐
          │         │                 │              │
    ┌─────▼─────┐  │          ┌──────▼──────┐  ┌───▼────────┐
    │    IT     │  │          │   PRODUCT   │  │    OTHER   │
    │ OPERATIONS│  │          │  & DESIGN   │  │  SERVICES  │
    └───────────┘  │          └─────────────┘  └────────────┘
                   │
```

## EXECUTIVE LEVEL

```
👔 MASTER HUB (President)
├─ Port: 9893
├─ Role: Central Command & Coordination
├─ Department: Executive
└─ Metrics:
   ├─ Total agents online
   ├─ System health score
   ├─ Critical alerts
   └─ Daily task completion rate
```

## DEPARTMENT HEADS

### Legal & Compliance
```
⚖️ LEGAL TEAM
├─ Port: 9878
├─ Reports to: Master Hub
├─ Department: Legal
└─ Metrics:
   ├─ Settlement compliance checks
   ├─ Contract reviews completed
   ├─ Legal issues flagged
   └─ Compliance score
```

### Finance
```
💰 ACCOUNTING
├─ Port: 9882
├─ Reports to: Master Hub
├─ Department: Finance
└─ Metrics:
   ├─ Daily revenue
   ├─ Expenses tracked
   ├─ P&L accuracy
   ├─ Budget variance
   └─ Outstanding invoices
```

### Marketing
```
📢 MARKETING
├─ Port: 9881
├─ Reports to: Master Hub
├─ Department: Marketing
└─ Metrics:
   ├─ Blog posts published
   ├─ Social media engagement
   ├─ Email campaigns sent
   ├─ Lead generation
   └─ Campaign ROI
```

### Operations - Procurement
```
🛒 PURCHASING OFFICE
├─ Port: 9880
├─ Reports to: Master Hub
├─ Department: Operations
└─ Metrics:
   ├─ Orders placed
   ├─ Cost savings identified
   ├─ Vendor response time
   ├─ Inventory alerts
   └─ Price comparisons run
```

### Operations - Sample Processing
```
📦 DIGITAL SAMPLES
├─ Port: 9879
├─ Reports to: Master Hub
├─ Department: Operations
└─ Metrics:
   ├─ DIG-series orders processed
   ├─ Files delivered
   ├─ Processing time avg
   ├─ Customer satisfaction
   └─ Pending requests
```

### Strategy
```
📊 TREND RESEARCH
├─ Port: 9883
├─ Reports to: Master Hub
├─ Department: Strategy
└─ Metrics:
   ├─ Trends identified
   ├─ Market reports generated
   ├─ Competitor analysis
   └─ Forecast accuracy
```

## SUPPORT SERVICES

### Customer Service
```
💬 ZENDESK CHAT
├─ Port: 9884
├─ Reports to: Master Hub
├─ Department: Customer Service
└─ Metrics:
   ├─ Tickets handled
   ├─ Response time avg
   ├─ Customer satisfaction
   ├─ Open tickets
   └─ Chat sessions
```

### Sales
```
🛍️ SHOPIFY STORE MANAGER
├─ Port: 7238
├─ Reports to: Master Hub
├─ Department: Sales
└─ Metrics:
   ├─ Orders processed
   ├─ Inventory sync status
   ├─ Product updates
   └─ Store health score
```

### IT Operations
```
🖥️ SERVER UPTIME MONITOR
├─ Port: 7242
├─ Reports to: Master Hub
├─ Department: IT Operations
└─ Metrics:
   ├─ Server uptime %
   ├─ Response times
   ├─ Resource usage
   └─ Incidents detected

📝 LOG MONITOR
├─ Port: 7239
├─ Reports to: Master Hub
├─ Department: IT Operations
└─ Metrics:
   ├─ Errors detected
   ├─ Critical issues
   ├─ Auto-resolved
   └─ Logs analyzed

🔄 RESTART ANALYZER
├─ Port: 7241
├─ Reports to: Master Hub
├─ Department: IT Operations
└─ Metrics:
   ├─ Restart patterns detected
   ├─ Agent health scores
   ├─ Stability metrics
   └─ Recommendations
```

### Product & Design
```
🎨 UI MANAGER
├─ Port: 7240
├─ Reports to: Master Hub
├─ Department: Product
└─ Metrics:
   ├─ UI consistency score
   ├─ Theme updates
   ├─ User feedback
   └─ Accessibility score
```

## OPERATIONS & ORCHESTRATION

```
🎯 TASK ORCHESTRATOR
├─ Port: 9900
├─ Reports to: Master Hub
├─ Department: Operations
└─ Metrics:
   ├─ Tasks routed
   ├─ Completion rate
   ├─ Agent utilization
   └─ Queue depth

⚠️ NEEDS ATTENTION
├─ Port: 7243
├─ Reports to: Master Hub
├─ Department: Operations
└─ Metrics:
   ├─ Issues flagged
   ├─ Escalations
   ├─ Resolution time
   └─ Priority distribution
```

## REPORTING FLOW

```
┌─────────────────────────────────────────────────────────────────┐
│  6:00 AM - Morning Standup Report                               │
└─────────────────────────────────────────────────────────────────┘
           │
           ├──► 1. Collect metrics from all agents (parallel)
           │
           ├──► 2. Generate Executive Summary
           │     └─ System health, tasks completed, critical issues
           │
           ├──► 3. Generate Department Reports
           │     ├─ Executive Level
           │     ├─ Department Heads (Legal, Finance, Marketing, etc.)
           │     ├─ Support Services (Customer Service, IT, Product)
           │     └─ Operations & Orchestration
           │
           ├──► 4. Identify Issues Requiring Attention
           │     ├─ Critical: Offline agents, system failures
           │     ├─ High: Error rates, performance issues
           │     ├─ Medium: Degraded performance
           │     └─ Low: Minor warnings
           │
           ├──► 5. Generate Action Items
           │     └─ Prioritized next steps
           │
           ├──► 6. Calculate Q&A Readiness
           │     └─ Agent status and recent activities
           │
           ├──► 7. Format for Slack
           │     └─ Clean markdown with health bars and emojis
           │
           └──► 8. Send to #morning-report channel
                 └─ @channel mention if critical issues

┌─────────────────────────────────────────────────────────────────┐
│  5:00 PM - End-of-Day Summary                                   │
└─────────────────────────────────────────────────────────────────┘
           │
           └──► Same process as above, with full day statistics
```

## DEPARTMENT GROUPING

### By Function

**Core Business**
- Legal Team
- Accounting
- Marketing
- Purchasing Office
- Digital Samples

**Customer Facing**
- Zendesk Chat
- Shopify Store Manager

**Technology Infrastructure**
- Server Uptime Monitor
- Log Monitor
- Restart Analyzer
- UI Manager

**Strategic**
- Trend Research
- Task Orchestrator

**Operational Support**
- Needs Attention

### By Priority Level

**Priority 1 - Mission Critical**
- Master Hub
- Task Orchestrator
- Server Uptime Monitor
- Log Monitor

**Priority 2 - Business Operations**
- Digital Samples
- Purchasing Office
- Accounting
- Zendesk Chat

**Priority 3 - Business Development**
- Marketing
- Trend Research
- Legal Team

**Priority 4 - Support & Enhancement**
- UI Manager
- Restart Analyzer
- Needs Attention
- Shopify Store Manager

## COMMUNICATION PATHS

```
User Request
     │
     ▼
Master Hub ──────────────► Slack #morning-report
     │                           │
     ├─► Department Heads        ├─► Team notifications
     │   ├─► Legal               ├─► Critical alerts
     │   ├─► Accounting          └─► Daily summaries
     │   ├─► Marketing
     │   ├─► Purchasing
     │   ├─► Digital Samples
     │   └─► Trend Research
     │
     ├─► Support Services
     │   ├─► Zendesk Chat
     │   ├─► Shopify Store
     │   ├─► Server Uptime
     │   ├─► Log Monitor
     │   ├─► UI Manager
     │   └─► Restart Analyzer
     │
     └─► Operations
         ├─► Task Orchestrator
         └─► Needs Attention
```

## ACCESS MATRIX

| Agent | Port | Dashboard | API | Reports To |
|-------|------|-----------|-----|------------|
| Master Hub | 9893 | ✅ | ✅ | - |
| Legal Team | 9878 | ✅ | ✅ | Master Hub |
| Accounting | 9882 | ✅ | ✅ | Master Hub |
| Marketing | 9881 | ✅ | ✅ | Master Hub |
| Purchasing | 9880 | ✅ | ✅ | Master Hub |
| Digital Samples | 9879 | ✅ | ✅ | Master Hub |
| Trend Research | 9883 | ✅ | ✅ | Master Hub |
| Zendesk Chat | 9884 | ✅ | ✅ | Master Hub |
| Shopify Store | 7238 | ✅ | ✅ | Master Hub |
| Server Uptime | 7242 | ✅ | ✅ | Master Hub |
| Log Monitor | 7239 | ✅ | ✅ | Master Hub |
| UI Manager | 7240 | ✅ | ✅ | Master Hub |
| Restart Analyzer | 7241 | ✅ | ✅ | Master Hub |
| Task Orchestrator | 9900 | ✅ | ✅ | Master Hub |
| Needs Attention | 7243 | ✅ | ✅ | Master Hub |

## METRICS COLLECTION ORDER

Reports collect data in this order for optimal efficiency:

1. **Executive Level** (1 agent)
   - Master Hub

2. **Department Heads** (6 agents in parallel)
   - Legal Team
   - Accounting
   - Marketing
   - Purchasing Office
   - Digital Samples
   - Trend Research

3. **Support Services** (6 agents in parallel)
   - Zendesk Chat
   - Shopify Store Manager
   - Server Uptime Monitor
   - Log Monitor
   - UI Manager
   - Restart Analyzer

4. **Operations** (2 agents in parallel)
   - Task Orchestrator
   - Needs Attention

Total: **15 agents** queried in **4 parallel batches** (~5 seconds total)

## STATUS INDICATORS

```
✅ Online and healthy (green)
⚠️ Degraded performance (yellow)
❌ Offline or critical error (red)
🔄 Restarting (blue)
🔧 Maintenance mode (gray)
```

## ESCALATION PATH

```
Issue Detected
     │
     ▼
Log Monitor / Needs Attention
     │
     ▼
Master Hub Dashboard
     │
     ├─► Slack Alert (@channel for critical)
     │
     ├─► Email (if configured)
     │
     └─► Daily Report Summary
```

---

For more details, see:
- `/root/.claude/skills/daily-reporting/README.md`
- `/root/.claude/skills/daily-reporting/agent-hierarchy.ts`