discussion-ux

# discussion-ux

User experience specialist participant for discussions

## Installation

This is a CmdForge tool. Install it from the registry:

```bash
cmdforge install discussion-ux
```

## Description

A specialized discussion participant tool that provides UX-focused analysis and feedback. This tool analyzes discussion context and contributes insights from a user experience perspective, with support for visual diagram generation.

## Usage

Pipe discussion context into the tool:

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

With specific callout or mention:

```bash
echo "Discussion context..." | discussion-ux --callout "@ux what about mobile users?"
```

Custom template and diagram paths:

```bash
echo "Discussion..." | discussion-ux --templates-dir ./my-templates --diagrams-dir ./ux-diagrams
```

With progress logging:

```bash
echo "Discussion..." | discussion-ux --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 input to determine current discussion phase and extract relevant context
2. **Diagram Setup** - Prepares diagram generation environment if needed
3. **Progress Log (Pre)** - Logs initial progress status
4. **AI Analysis** - Calls Gemini provider with UX-focused prompt using discussion context
5. **Progress Log (Post)** - Logs completion status
6. **JSON Extraction** - Parses structured response from AI
7. **Response Parsing** - Extracts comment, vote, and diagram content from JSON
8. **Diagram Saving** - Saves generated diagram (if any) to the diagrams directory
9. **Final Output** - Formats and returns the complete response with vote and comment

The tool uses the Gemini provider for AI-powered UX analysis and can generate visual diagrams to illustrate user experience concepts.

## Dependencies

None