discussion-devops

# discussion-devops

DevOps specialist participant for discussions

## Installation

This is a CmdForge tool. Once published to the registry, install it with:

```bash
cmdforge install discussion-devops
```

Or create it locally using `cmdforge create`.

## Usage

This tool is designed to be used in discussion pipelines, typically receiving discussion context via stdin:

```bash
# Basic usage - process discussion context
echo "Discussion context here..." | discussion-devops

# With specific callout or @mention
cat discussion.txt | discussion-devops --callout "@devops what's your take on the deployment strategy?"

# Custom paths for templates and diagrams
echo "..." | discussion-devops --templates-dir ./my-templates --diagrams-dir ./output

# With logging enabled
echo "..." | discussion-devops --log-file discussion.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

This tool implements a DevOps specialist persona for multi-phase discussions:

1. **Phase Detection** - Parses input to determine current discussion phase and context
2. **Diagram Loading** - Loads any existing diagrams from previous phases
3. **Progress Logging** - Logs thinking phase to file (if `--log-file` specified)
4. **AI Response** - Calls Claude to generate DevOps-focused commentary considering infrastructure, deployment, monitoring, and scalability concerns
5. **Progress Update** - Logs response generation completion
6. **JSON Extraction** - Parses structured JSON response from AI output
7. **Response Parsing** - Extracts comment, vote, and optional diagram content
8. **Diagram Saving** - Saves any generated diagrams (architecture, deployment, monitoring) to diagrams directory
9. **Response Formatting** - Formats final JSON output with comment, vote, and diagram reference

The tool integrates with the Orchestrated Discussions framework, providing DevOps perspective across planning, implementation, and review phases.

## Dependencies

None - uses built-in Python libraries and the Claude provider via CmdForge.