discussion-pragmatist

# discussion-pragmatist

Shipping-focused pragmatist participant for discussions

## Installation

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

```bash
cmdforge install discussion-pragmatist
```

## Usage

This tool is designed to participate in orchestrated discussions as a pragmatic voice focused on shipping and practical outcomes. It accepts discussion context via stdin and returns a structured response with a comment and vote.

### Basic Usage

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

### With Callout

Use the `--callout` flag to provide specific questions or @mention context:

```bash
cat discussion.txt | discussion-pragmatist --callout "What's the MVP scope?"
```

### Custom Paths

```bash
echo "Discussion input..." | discussion-pragmatist \
  --templates-dir ./custom-templates \
  --diagrams-dir ./output/diagrams \
  --log-file ./discussion.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 processes discussion input through a 9-step pipeline:

1. **Phase Detection** - Analyzes input to determine current discussion phase and context
2. **Diagram Check** - Identifies if diagram content is needed based on phase
3. **Progress Log (Start)** - Logs initial progress if log file is specified
4. **AI Response** - Generates pragmatic comment and vote using the `opencode-deepseek` provider
5. **Progress Log (Complete)** - Logs completion status
6. **JSON Extraction** - Extracts structured JSON response from AI output
7. **Response Parsing** - Parses comment, vote, and any diagram content from JSON
8. **Diagram Save** - Saves diagram to specified directory if generated
9. **Format Output** - Formats final structured response for the orchestration system

The pragmatist persona prioritizes:
- Shipping quickly over perfect solutions
- Practical implementation over theoretical debates
- MVP scope and iterative improvement
- Identifying blockers and actionable next steps

## Dependencies

None - this tool uses the standard CmdForge execution environment.