# github/actions-migrations-via-copilot architecture

> Architecture diagram of the GitHub repository github/actions-migrations-via-copilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/github/actions-migrations-via-copilot
- Repository: https://github.com/github/actions-migrations-via-copilot

## Overview

This repository packages Copilot agents for migrating CI/CD pipelines to GitHub Actions, through cloud-agent and CLI-plugin surfaces. The principal workflow reads a source pipeline, applies platform-specific mappings and migration guardrails, generates and validates workflows, then documents the result in a pull request. It also includes a reusable-workflow builder. Relationships below follow README documentation; source excerpts were unavailable, so implementation-level wiring is not inferred.

Main entry points: [`agents`](https://github.com/github/actions-migrations-via-copilot/tree/main/agents) (Cloud agents), [`plugin`](https://github.com/github/actions-migrations-via-copilot/tree/main/plugin) (CLI plugin), [`knowledge`](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge) (Cloud knowledgebase), [`agents/reusable-workflow-builder.md`](https://github.com/github/actions-migrations-via-copilot/blob/main/agents/reusable-workflow-builder.md) (Reusable workflow builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["Agent surfaces"]
  node_cloud["Cloud agents"]
  node_cli["CLI plugin"]
  node_builder["Reusable workflow builder"]
  node_clibuilder["CLI workflow builder"]
end

subgraph group_migration["Migration knowledge"]
  node_cloudknowledge["Cloud knowledgebase"]
  node_cliskills["Composable skills"]
  node_mappings["Platform mappings"]
  node_guardrails["Migration standards"]
  node_patterns["Migration patterns"]
  node_reportspecs["Report templates"]
end

subgraph group_deliverables["Migration outputs"]
  node_generated["GitHub workflows"]
  node_archive["CI archive"]
  node_report["Migration report"]
  node_reusable["Reusable workflows"]
end

node_user(("Engineer"))
node_source["Source pipelines"]
node_lint["actionlint"]
node_pullrequest["Pull request"]
node_mcp["GitHub MCP"]
node_orgworkflows["Org workflows"]

node_user -->|"runs migration"| node_cloud
node_user -->|"runs migration"| node_cli
node_cloud -->|"reads"| node_source
node_cloud -->|"references"| node_cloudknowledge
node_cloud -->|"fetches knowledge"| node_mcp
node_mcp -->|"serves"| node_cloudknowledge
node_cli -->|"reads"| node_source
node_cli -->|"uses"| node_cliskills
node_cloud -->|"generates"| node_generated
node_cloud -->|"validates with"| node_lint
node_cloud -->|"preserves originals"| node_archive
node_cloud -->|"documents"| node_report
node_cli -->|"generates"| node_generated
node_cli -->|"validates with"| node_lint
node_cli -->|"preserves originals"| node_archive
node_cli -->|"documents"| node_report
node_mappings -->|"informs"| node_cloudknowledge
node_patterns -->|"informs"| node_cloudknowledge
node_guardrails -->|"guides"| node_cloudknowledge
node_reportspecs -->|"templates"| node_cloudknowledge
node_report -->|"included in"| node_pullrequest
node_user -->|"runs analysis"| node_builder
node_user -->|"runs analysis"| node_clibuilder
node_builder -->|"scans"| node_orgworkflows
node_clibuilder -->|"scans"| node_orgworkflows
node_builder -->|"generates"| node_reusable
node_clibuilder -->|"generates"| node_reusable

click node_cloud "https://github.com/github/actions-migrations-via-copilot/tree/main/agents"
click node_cli "https://github.com/github/actions-migrations-via-copilot/tree/main/plugin"
click node_cloudknowledge "https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge"
click node_cliskills "https://github.com/github/actions-migrations-via-copilot/tree/main/plugin/skills"
click node_mappings "https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/actions-mapping"
click node_guardrails "https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge"
click node_patterns "https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/patterns"
click node_reportspecs "https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/report-template"
click node_builder "https://github.com/github/actions-migrations-via-copilot/blob/main/agents/reusable-workflow-builder.md"
click node_clibuilder "https://github.com/github/actions-migrations-via-copilot/blob/main/plugin/agents/reusable-workflow-builder.agent.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cloud,node_cli,node_builder,node_clibuilder toneBlue
class node_cloudknowledge,node_cliskills,node_mappings,node_guardrails,node_patterns,node_reportspecs toneAmber
class node_generated,node_archive,node_report,node_reusable,node_pullrequest toneMint
class node_user,node_source,node_lint,node_mcp,node_orgworkflows toneIndigo
```

## Components

### Agent surfaces

- [Cloud agents](https://github.com/github/actions-migrations-via-copilot/tree/main/agents): `agents`
- [CLI plugin](https://github.com/github/actions-migrations-via-copilot/tree/main/plugin): `plugin`
- [Reusable workflow builder](https://github.com/github/actions-migrations-via-copilot/blob/main/agents/reusable-workflow-builder.md): `agents/reusable-workflow-builder.md`
- [CLI workflow builder](https://github.com/github/actions-migrations-via-copilot/blob/main/plugin/agents/reusable-workflow-builder.agent.md): `plugin/agents/reusable-workflow-builder.agent.md`

### Migration knowledge

- [Cloud knowledgebase](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge): `knowledge`
- [Composable skills](https://github.com/github/actions-migrations-via-copilot/tree/main/plugin/skills): `plugin/skills`
- [Platform mappings](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/actions-mapping): `knowledge/actions-mapping`
- [Migration standards](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge): `knowledge`
- [Migration patterns](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/patterns): `knowledge/patterns`
- [Report templates](https://github.com/github/actions-migrations-via-copilot/tree/main/knowledge/report-template): `knowledge/report-template`

### Migration outputs

- **GitHub workflows**
- **CI archive**
- **Migration report**
- **Reusable workflows**

### Other components

- **Engineer**
- **Source pipelines**
- **actionlint**
- **Pull request**
- **GitHub MCP**
- **Org workflows**

## Connections

- Engineer → Cloud agents: runs migration
- Engineer → CLI plugin: runs migration
- Cloud agents → Source pipelines: reads
- Cloud agents → Cloud knowledgebase: references
- Cloud agents → GitHub MCP: fetches knowledge
- GitHub MCP → Cloud knowledgebase: serves
- CLI plugin → Source pipelines: reads
- CLI plugin → Composable skills: uses
- Cloud agents → GitHub workflows: generates
- Cloud agents → actionlint: validates with
- Cloud agents → CI archive: preserves originals
- Cloud agents → Migration report: documents
- CLI plugin → GitHub workflows: generates
- CLI plugin → actionlint: validates with
- CLI plugin → CI archive: preserves originals
- CLI plugin → Migration report: documents
- Platform mappings → Cloud knowledgebase: informs
- Migration patterns → Cloud knowledgebase: informs
- Migration standards → Cloud knowledgebase: guides
- Report templates → Cloud knowledgebase: templates
- Migration report → Pull request: included in
- Engineer → Reusable workflow builder: runs analysis
- Engineer → CLI workflow builder: runs analysis
- Reusable workflow builder → Org workflows: scans
- CLI workflow builder → Org workflows: scans
- Reusable workflow builder → Reusable workflows: generates
- CLI workflow builder → Reusable workflows: generates