Konflux Release Flow Specification

Overview

This document defines the complete workflow for OpenShift z-stream release orchestration under the Konflux release platform. All releases from 4.12 to 4.20 follow this flow.

Target Audience: AI agents (Claude Code) and human release engineers

Execution Method: All oar commands are executed via the MCP (Model Context Protocol) server, NOT local CLI. The MCP server exposes OAR commands as structured tools with proper input validation and output parsing.

Architecture Components

StateBox (M2 - Primary Source of Truth)

• Primary source of truth for AI workflow resumption and task execution state
• Persists in GitHub: _releases/{y-stream}/statebox/{release}.yaml
• Stores complete release context:
  • Metadata (advisories, builds, Jira ticket, release date, shipment MR)
  • Task execution history with AI-readable results (sensitive data masked)
  • Blocking issues with resolution tracking