a-teams/docs/OUTPUT-SYSTEM.md

a-teams by Worksona - worksona agents and agentic teams in claude.ai. Enterprise-grade multi-agent workflow system with 60+ specialized agents, comprehensive template system, and advanced orchestration capabilities for business, technical, and research ta

# Agent Output System

The a-teams framework now automatically exports all agent execution results to markdown files and stores them in memory with **zero configuration required**.

## Features

✅ **Automatic Markdown Export** - Every agent execution creates a timestamped markdown report  
✅ **Memory Integration** - Results stored in memory for agent coordination  
✅ **Workflow Summaries** - Complete workflow reports with all agent results  
✅ **Minimal Technology** - Uses existing infrastructure, no new dependencies  
✅ **Universal Coverage** - Works with all 60+ existing agents automatically  

## Output Structure

```
outputs/
├── agents/                    # Individual agent executions
│   └── {agent-name}/
│       └── {timestamp}-{execution-id}.md
└── workflows/                 # Workflow executions  
    └── {workflow-id}/
        ├── summary.md         # Complete workflow summary
        └── agents/            # All agents in this workflow
            └── {agent-name}-{timestamp}.md
```

## Usage

The system works automatically with **no changes required** to existing agent definitions or workflow specifications:

### Individual Agent Execution
```bash
a-teams run project-planner --task "Analyze the mobile app requirements"
```
**Output:** `outputs/agents/project-planner/2025-08-11T18-32-45-123Z-exec-1754938745.md`

### Workflow Execution  
```bash
a-teams workflow --template fullstack-development
```
**Output:** 
- `outputs/workflows/{workflow-id}/summary.md` - Complete workflow report
- `outputs/workflows/{workflow-id}/agents/*.md` - Individual agent reports

## Markdown Format

Each agent report includes:

```markdown
---
agent: project-planner
execution_id: exec-1754938745
timestamp: 2025-08-11T18:32:45.123Z
status: completed
duration: 2100ms
workflow_id: workflow-001  # (if part of workflow)
phase: 1                   # (if part of workflow)
---

# Agent Execution Report: project-planner

**Execution Date:** 8/11/2025, 11:32:45 AM
**Status:** completed
**Duration:** 2100ms

## Task Description
Analyze the mobile app requirements

## Execution Results
[Agent-specific results and output]

## Workflow Context
[Context if part of workflow]
```

## Memory Integration

Results are automatically stored in memory with these keys:

- **Individual agents:** `output:agent:{name}:{execution-id}`
- **Workflow agents:** `output:workflow:{workflow-id}:agent:{name}:{execution-id}`  
- **Workflow summaries:** `output:workflow:{workflow-id}:summary`

## Technical Implementation

The system extends existing patterns with minimal code:

1. **OutputManager** (`src/utils/output-manager.js`) - Core logic for writing files
2. **Integration Points** - 3 small additions to existing workflow systems
3. **Zero Dependencies** - Uses existing `fs`, `path`, and `chalk` modules

## Compatibility

- ✅ **Backward Compatible** - All existing functionality unchanged
- ✅ **No Configuration** - Works immediately with existing agents
- ✅ **No Documentation Updates** - Follows existing patterns
- ✅ **Memory Preserved** - Maintains all existing memory functionality

The system provides comprehensive output tracking with minimal new technology, exactly as requested.