discussion-architect

# discussion-architect

Systems architect participant for discussions

## Installation

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

```bash
cmdforge install discussion-architect
```

## Description

`discussion-architect` is a specialized discussion participant that provides systems architecture expertise. It analyzes discussion context, creates technical diagrams when appropriate, and provides structured architectural feedback with voting recommendations.

## Usage

This tool is designed to work with the Orchestrated Discussions system. It receives discussion context via stdin and outputs structured JSON responses with comments, votes, and optional architecture diagrams.

### Basic Usage

```bash
echo "Discussion content..." | discussion-architect
```

### With Callout/Mention

```bash
echo "Discussion content..." | discussion-architect --callout "@architect what's your take on the database design?"
```

### Custom Directories

```bash
echo "Discussion content..." | discussion-architect \
  --templates-dir ./my-templates \
  --diagrams-dir ./output/diagrams \
  --log-file ./progress.log
```

## Arguments

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

## How It Works

The tool executes a 10-step pipeline:

1. **Parse Phase Context** - Extracts the current discussion phase from input
2. **Initialize Diagram Path** - Sets up diagram output location
3. **Determine Diagram Need** - Decides if architectural diagram is warranted
4. **Log Progress** - Records "Analyzing architecture..." to log file
5. **Generate Response** - Calls AI provider (opencode-grok) with architect persona and discussion context
6. **Log Completion** - Records response generation completion
7. **Extract JSON** - Parses structured JSON from AI response
8. **Parse Response Fields** - Extracts comment, vote, and diagram content
9. **Save Diagram** - Writes Mermaid diagram to file if generated
10. **Format Final Output** - Produces final JSON with all metadata

The tool outputs JSON containing:
- `comment`: Architectural analysis and recommendations
- `vote`: Voting decision (yes/no/abstain) with reasoning
- `diagram`: Path to generated Mermaid diagram (if applicable)

## Dependencies

None - uses CmdForge's built-in functionality and the `opencode-grok` AI provider.