discussion-designer

# discussion-designer

UI/Visual design specialist participant for discussions

## Description

A CmdForge tool that acts as a design-focused participant in orchestrated discussions. It analyzes design aspects, creates visual diagrams when appropriate, and provides design-oriented feedback with voting recommendations.

## Installation

This is a CmdForge tool. Install it via the CmdForge registry or create it manually using `cmdforge create`.

## Usage

Pipe discussion context into the tool:

```bash
# Basic usage
echo "Discussion context..." | discussion-designer

# With specific callout/mention
echo "Discussion context..." | discussion-designer --callout "@designer What UI pattern works best here?"

# Custom paths
echo "Discussion context..." | discussion-designer \
  --templates-dir ./my-templates \
  --diagrams-dir ./output/diagrams \
  --log-file progress.log
```

## Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--callout` | "" | Specific question or @mention context |
| `--templates-dir` | templates | Path to templates directory |
| `--diagrams-dir` | diagrams | Path to save diagrams |
| `--log-file` | "" | Path to log file for progress updates |

## How It Works

The tool executes a 9-step pipeline:

1. **Phase Detection** - Analyzes discussion context to determine current phase
2. **Diagram Check** - Determines if a diagram exists for reference
3. **Progress Log** - Writes "Analyzing design implications..." to log file
4. **AI Analysis** - Calls AI provider (opencode-pickle) to analyze design aspects
5. **Progress Log** - Writes "Generating response..." to log file
6. **JSON Extraction** - Parses AI response for structured output
7. **Response Parsing** - Extracts comment, vote, and optional diagram content
8. **Diagram Save** - Saves diagram to file if one was generated
9. **Format Output** - Constructs final JSON response with comment, vote, and diagram path

The tool outputs structured JSON containing the designer's comment, vote (AGREE/DISAGREE/ABSTAIN/PASS), and diagram path if applicable.

## Dependencies

None