Agent Components

CI-Copilot is composed of multiple specialized agents coordinated by a Supervisor. Each agent has a defined scope and its own set of tools.

1. Supervisor Agent

Entry point. Routes requests — CI/CD tasks go to the Generation Supervisor, everything else gets handled directly (greetings, out-of-scope).

Tool	Purpose
`transfer_to_ci_generation`	Delegates CI/CD tasks to the Generation Supervisor
`request_human_input`	Asks the user for clarification or input

Orchestrates the detect → validate → render flow using a LangGraph state machine (CIPipelineState). Manages handoffs between the sub-agents.

Tool	Purpose
`transfer_context_to_renderer`	Passes context from Context Detector to Renderer
`transfer_to_renderer`	Hands off to Renderer for YAML generation
`complete_workflow`	Marks workflow completion

Connects to GitHub via MCP and runs a thorough analysis of the target repo. Supports Node.js, Python, Go, Java, Rust, Ruby, PHP, .NET.

Tool	What it does
`fetch_repository_information`	Repo metadata — default branch, language, visibility
`fetch_repository_files`	Pulls manifest files, Dockerfiles, CI configs
`detect_runtime_and_package_manager`	Identifies language + package manager from manifests
`extract_project_dependencies`	LLM-powered dep extraction with CI usage classification
`check_for_existing_ci`	Detects existing CI across GitHub Actions, Jenkins, GitLab CI, etc.
`infer_ci_capabilities`	Generates a full `CISpec` — stages, capabilities, triggers, service deps

After building the spec, it presents a CI plan for your approval (first HITL gate).

Checks the plan before rendering against security, compliance, and best practices.

Tool	Purpose
`validate_security_policies`	Security policy checks
`check_license_compliance`	License compliance validation
`validate_ci_best_practices`	Best-practice validation
`calculate_policy_compliance_score`	Overall compliance score

Takes the approved spec and turns it into real YAML. Shows you the final pipeline for approval before committing (second HITL gate).

Tool	What it does
`intent_to_commands`	Maps CI capabilities to concrete shell commands
`plan_workflow`	Structures jobs, stages, and dependency graphs
`render_workflows`	Generates the final GitHub Actions YAML
`workflow_refiner`	Validates with `actionlint`, applies corrections via reflection loop
`generate_workflow_explanation`	Produces a human-readable pipeline summary
`commit_and_create_pr`	Commits to a branch and opens a PR

CI-Copilot enforces two approval gates:

Gate	Trigger	Purpose
Plan Approval	After Context Detector builds the CISpec	Review the proposed pipeline structure and capabilities
Commit Approval	Before Renderer commits and opens PR	Review the final YAML and approve the commit

Nothing gets committed without your explicit sign-off.