awful

Design an agent workflow system — define agents, events, routing, data flow, and quality gates interactively

Generate workflow files from blueprint — outputs gh-aw markdown or GitHub Actions YAML

Initialize awful for this repo — detect repo type, check gh-aw, select templates, create workflow directory

Visualize event→workflow→agent routing as a mermaid diagram

Shared: detect repo type, existing workflows, and gh-aw CLI availability

Shared: select output format based on gh-aw availability and user preference

Design complete agent workflow systems from requirements. Interactive — proposes architecture, iterates with user, outputs a machine-readable blueprint. <example> Context: User wants to automate their OSS repo user: "/awful:design" assistant: "I'll use the architect to design an agent workflow system for your repo." </example> <example> Context: User wants to add incident response to existing workflows user: "Add an incident response workflow to my agent system" assistant: "I'll use the architect to design the incident workflow and update the blueprint." </example>

Generate workflow files from blueprints. Supports gh-aw markdown and GitHub Actions YAML output formats. <example> Context: Blueprint exists, user wants to generate workflow files user: "/awful:gen" assistant: "I'll use the generator to create workflow files from your blueprint." </example> <example> Context: User wants to regenerate after blueprint changes user: "Regenerate the workflows — I updated the blueprint" assistant: "I'll use the generator to create updated workflow files." </example>

Use when generating workflow files, writing blueprints, or validating format — covers gh-aw markdown format, GitHub Actions YAML, blueprint YAML frontmatter, and template structure.

Use when designing event routing, preventing cascades, composing workflows, or choosing between label-based vs dispatch-based triggers for GitHub agent workflows.

Use when configuring permissions, handling fork PRs, sanitizing untrusted input, or setting up safe-outputs for agent workflows on GitHub.

Use when selecting, customizing, or composing built-in workflow templates — covers all 7 templates (triage, PR review, docs, release, stale, first-timer, incident) with customization points and composition patterns.