discussion-frontend

# discussion-frontend

Frontend development specialist participant for discussions

## Overview

`discussion-frontend` is a CmdForge tool that acts as a frontend development specialist in orchestrated AI discussions. It analyzes discussion context, provides expert frontend insights, and can generate diagrams to illustrate UI/UX concepts and architectural decisions.

## Installation

This is a CmdForge tool. Install it using:

```bash
cmdforge install discussion-frontend
```

Or publish it to your local registry if you have the tool configuration.

## Usage

The tool accepts discussion context via stdin and outputs structured responses with comments and votes:

```bash
# Basic usage with discussion context
echo "Discussion context here..." | discussion-frontend

# With a specific callout or @mention
echo "Should we use React or Vue?" | discussion-frontend --callout "@frontend what's your take?"

# Custom templates and diagram directories
cat discussion.txt | discussion-frontend --templates-dir ./my-templates --diagrams-dir ./output

# With progress logging
echo "Discuss component architecture" | discussion-frontend --log-file progress.log
```

## Arguments

| Flag | Variable | Default | Description |
|------|----------|---------|-------------|
| `--callout` | callout | "" | 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 | "" | Path to log file for progress updates |

## How It Works

The tool executes a 9-step pipeline:

1. **Phase Detection** - Analyzes the input to determine the current discussion phase and extract relevant context
2. **Diagram Preparation** - Prepares diagram generation capabilities if needed for visual explanations
3. **Progress Logging** - Logs initial progress to the specified log file (if provided)
4. **AI Analysis** - Sends context to Claude AI with frontend specialist persona to generate expert insights
5. **Progress Update** - Logs completion of AI analysis
6. **JSON Extraction** - Extracts structured JSON response from the AI output
7. **Response Parsing** - Parses the comment, vote, and any diagram content from the JSON
8. **Diagram Saving** - Saves generated diagrams (if any) to the specified directory
9. **Final Formatting** - Formats the final response with all components

The output is structured JSON containing the frontend specialist's comment, vote, and optional diagram references.

## Dependencies

None - this is a standalone CmdForge tool that uses the Claude provider for AI-powered responses.