Create GitHub Actions Workflow Specification

Generates formal, AI-optimized specifications for GitHub Actions workflows to standardize documentation and enable maintenance.

- Produces structured markdown specifications with execution flow diagrams, job dependency matrices, and requirement tables designed for token efficiency

- Covers functional, security, and performance requirements alongside input/output contracts, error handling strategies, and quality gates

- Includes sections for monitoring, compliance, edge cases, and change management to support long-term workflow governance

- Abstracts implementation details to focus on workflow behavior and constraints rather than specific syntax or tool versions

Create GitHub Actions Workflow Specification

Create a comprehensive specification for the GitHub Actions workflow: ${input:WorkflowFile}.

This specification serves as a specification for the workflow's behavior, requirements, and constraints. It must be implementation-agnostic, focusing on what the workflow accomplishes rather than how it's implemented.

AI-Optimized Requirements

- Token Efficiency: Use concise language without sacrificing clarity

- Structured Data: Leverage tables, lists, and diagrams for dense information

- Semantic Clarity: Use precise terminology consistently throughout

- Implementation Abstraction: Avoid specific syntax, commands, or tool versions

- Maintainability: Design for easy updates as workflow evolves

Specification Template

Save as: /spec/spec-process-cicd-[workflow-name].md