`DW-Agents/dw-agents/QUICK_REFERENCE.md`

203 lines
# DW-Agents Quick Reference

## Agent Ports & Access

| Agent | Port | Purpose | Auth |
|-------|------|---------|------|
| task-orchestrator | 9900 | Master coordination | SSO |
| purchasing-office | 9880 | Office supplies | admin/2025 |
| accounting | 9882 | Financial management | Session |
| master-hub | Various | Status dashboard | - |

## Directory Quick Access

```bash
# Main DW-Agents directory
cd /root/DW-Agents/

# Specific agent
cd /root/DW-Agents/agent-[agent-name]/

# View agent list
ls -la /root/DW-Agents/agent-*/

# View agent README
cat /root/DW-Agents/agent-[agent-name]/README.md

# View agent memory
cat /root/DW-Agents/agent-[agent-name]/MEMORY.md
```

## Common Tasks

### Check Agent Status
```bash
pm2 list
```

### View Agent Logs
```bash
pm2 logs [agent-name]
```

### Restart Agent
```bash
pm2 restart [agent-name]
```

### Test Agent Endpoint
```bash
curl http://localhost:[port]
```

## File Locations

### Configuration
- `/root/DW-Agents/.env` - Environment variables
- `/root/DW-Agents/ecosystem.config.js` - PM2 configuration

### Data Files
- `/root/DW-Agents/tasks-database.json` - All tasks
- `/root/DW-Agents/task-memory.json` - Orchestrator memory
- `/root/DW-Agents/todays-real-highlights.json` - Daily highlights
- `/root/DW-Agents/known-fixes.json` - Known issue resolutions

### Logs
- `/root/DW-Agents/logs/` - Application logs

## Agent Categories

### Coordination
- **task-orchestrator**: Routes and manages all tasks

### Operations
- **purchasing-office**: Supply ordering
- **accounting**: Financial management

### Customer
- **zendesk-chat**: Support conversations
- **new-client-signup**: Onboarding
- **digital-samples**: Sample requests

### Marketing
- **marketing**: Campaigns
- **trend-research**: Market analysis
- **todays-highlights**: Daily summaries

### System
- **server-uptime**: Health monitoring
- **needs-attention**: Alert escalation
- **completed-tasks**: Task archival

### Processing
- **in-parallel**: Parallel tasks
- **parallel-processes**: Multi-process

### Legal
- **legal-team**: Legal & compliance

## Memory System Usage

### Read Memory
```bash
cat /root/DW-Agents/agent-[agent-name]/MEMORY.md
```

### Update Memory (as Claude)
1. Read current MEMORY.md
2. Add new learnings under relevant section
3. Append to Memory Log with timestamp
4. Save updated file

### Memory Sections
- Learned Behaviors
- Domain-Specific Data
- Performance Notes
- Common Patterns
- Future Improvements
- Memory Log (chronological)

## Integration Points

### Task Flow
1. User/System → **task-orchestrator**
2. task-orchestrator → Specialized Agent
3. Specialized Agent → Completion Report
4. Completion → **completed-tasks**

### Alert Flow
1. Any Agent → Issue Detected
2. Issue → **needs-attention**
3. needs-attention → Escalation
4. Resolution → **completed-tasks**

### Daily Flow
1. All Agents → Generate Data
2. **todays-highlights** → Aggregate
3. Daily Summary → **master-hub**
4. Team Notification

## Key Files by Agent

### task-orchestrator
- tasks-database.json
- task-memory.json

### purchasing-office
- amazon-real-orders.ts (helper)
- Order tracking data

### accounting
- Financial reports
- Expense data

### todays-highlights
- todays-real-highlights.json

## Common Commands

```bash
# Start all agents
pm2 start ecosystem.config.js

# Stop all agents
pm2 stop all

# View all agents
pm2 list

# Monitor in real-time
pm2 monit

# Save PM2 configuration
pm2 save

# View specific agent info
pm2 describe [agent-name]
```

## Documentation Access

```bash
# View master index
cat /root/DW-Agents/AGENTS_INDEX.md

# View setup info
cat /root/DW-Agents/SETUP_COMPLETE.md

# View this quick reference
cat /root/DW-Agents/QUICK_REFERENCE.md
```

## For Claude

When working with an agent:
1. Check `/root/DW-Agents/agent-[agent-name]/README.md` for purpose
2. Review `/root/DW-Agents/agent-[agent-name]/MEMORY.md` for patterns
3. Update MEMORY.md after learning something new
4. Reference AGENTS_INDEX.md for integration points

---

Last Updated: 2025-11-07