discussion-performance

# discussion-performance

Performance optimization specialist participant for discussions

## Installation

This is a CmdForge tool. Install it using:

```bash
cmdforge install discussion-performance
```

Or if published to a registry:

```bash
cmdforge download discussion-performance
```

## Usage

This tool is designed to be used in orchestrated discussions as a performance optimization specialist. It accepts discussion context via stdin and outputs structured responses with comments and votes.

**Basic usage:**

```bash
echo "Discussion context here..." | discussion-performance
```

**With specific callout:**

```bash
echo "Discussion context..." | discussion-performance --callout "@performance What's the bottleneck?"
```

**With custom paths:**

```bash
cat discussion.txt | discussion-performance \
  --templates-dir ./my-templates \
  --diagrams-dir ./output/diagrams \
  --log-file ./perf.log
```

## Arguments

| Flag | Variable | Default | Description |
|------|----------|---------|-------------|
| `--callout` | callout | (empty) | Specific question or @mention context |
| `--templates-dir` | templates_dir | templates | Path to templates directory |
| `--diagrams-dir` | diagrams_dir | diagrams | Path to save diagrams |
| `--log-file` | log_file | (empty) | Path to log file for progress updates |

## How It Works

This tool follows a 7-step pipeline:

1. **Phase Detection** - Analyzes the discussion context to determine the current phase
2. **Progress Logging** - Logs initial progress to the log file (if specified)
3. **AI Analysis** - Uses the `opencode-reasoner` provider to generate performance optimization insights
4. **Progress Update** - Logs analysis completion
5. **Response Parsing** - Extracts JSON from the AI response
6. **Vote & Comment Extraction** - Parses the structured comment and vote from JSON
7. **Final Formatting** - Formats the output for the discussion orchestrator

The tool expects input containing discussion context and outputs structured JSON with performance-focused comments and voting decisions.

## Dependencies

None

## Output Format

The tool outputs structured data containing:
- Performance analysis comments
- Vote decisions (based on optimization feasibility)
- Phase-aware responses tailored to the discussion stage