# skills/create-applications-with-the-copilot-cli architecture

> Architecture diagram of the GitHub repository skills/create-applications-with-the-copilot-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skills/create-applications-with-the-copilot-cli
- Repository: https://github.com/skills/create-applications-with-the-copilot-cli

## Overview

##### Project type and purpose (from README + tree)

This repo is **not the Node.js calculator app itself**. It’s a **GitHub Skills training/exercise template** whose purpose is to **teach developers how to use the standalone GitHub Copilot CLI** for:
- creating/managing GitHub Issues (from templates),
- generating code iteratively,
- collaborating from the terminal,
- and progressing through a multi-step exercise that is **orchestrated by GitHub Actions**.

The “Node.js calculator app” is something the learner will create during the exercise; it’s **not present in this repository’s file tree**.

##### What the file tree tells you about the architecture

Key directories/files and what they imply:

##### GitHub Actions-driven exercise engine
- `.github/workflows/0-start-exercise.yml`
- `.github/workflows/1-step.yml`
- `.github/workflows/2-step.yml`
- `.github/workflows/3-step.yml`
- `.github/workflows/4-step.yml`

These are the “control plane.” They likely:
- detect learner actions (issue created, file changes, etc.),
- update the repo state (issues, PRs, comments, branches),
- and “unlock” next steps.

##### Curriculum content & guidance
- `.github/steps/1-step.md ... 4-step.md`
- `.github/steps/x-review.md`

These are the “content plane”: step instructions that the workflow(s) probably reference or post to the learner.

##### Issue templates for structured work items
- `.github/ISSUE_TEMPLATE/feature_request.md`

This enables the “create an issue from a template” part of the exercise. It’s a key artifact in the system.

##### Dev environment scaffolding
- `.devcontainer/devcontainer.json`
- `.vscode` (editor defaults)

This tells you the exercise expects an optional **containerized dev environment**, which is part of the learner-side architecture.

##### Static documentation assets
- `README.md`, `images/`, `.github/images`

- **Developer/Learner workstation** (terminal + Copilot CLI + Node.js runtime if/when the calculator is created)
- **GitHub repository** (content, issue template, workflows)
- **GitHub Actions runners** (execute workflows, check conditions, write back to repo)
- **GitHub APIs** (Issues, Checks, PRs, Contents)
- **Copilot services** (Copilot CLI calling model endpoints; auth via GitHub)
- Optional: **Dev Container** environment (Docker/VS Code Remote Containers)

##### Learner Environment
- Terminal
- GitHub Copilot CLI (standalone)
- Git client
- Node.js 22+ runtime (used when building the calculator)
- (Optional) VS Code + Dev Container

##### GitHub Platform
- GitHub Repository (this repo)
- `.github/workflows/*` (exercise automation)
- `.github/steps/*` (lesson content)
- `.github/ISSUE_TEMPLATE/*` (issue template)
- `.github/instructions/*` (CLI reference)
- GitHub Issues (issue objects created from template)
- GitHub Actions (workflow orchestrator)
- GitHub Actions Runner (execution environment)

##### Copilot/AI Services
- Copilot CLI backend / model endpoints (OpenAI/Google models abstracted behind Copilot)
- AuthN/AuthZ (GitHub identity + Copilot subscription entitlement)

##### External/Optional Tooling
- Model Context Protocol (MCP) servers (mentioned in README; optional integration point)
- Gists (for `/share`)

Primary flows explicitly:

**Flow 1: Exercise initialization**
- Learner → GitHub (copies template repo)
- GitHub Actions (`0-start-exercise.yml`) → GitHub Repo state (creates instructions, sets initial issue/comments, or prepares the next step)

**Flow 2: Issue-driven workflow**
- Learner (Copilot CLI or GitHub UI) → GitHub Issues (create issue from template)
- GitHub Actions (step workflow) → reads Issue events / repo contents → posts guidance/comments → marks step complete

**Flow 3: Copilot CLI interactive development**
- Learner Terminal → Copilot CLI → Copilot service (model inference)
- Copilot CLI → local filesystem changes (generates/edits Node.js calculator app files once created)
- Git client → pushes commits to GitHub Repo
- GitHub Actions → validates expected artifacts (files present, tests pass, etc.) → updates next step

**Flow 4: Sharing/delegation (if used)**
- Copilot CLI `/share` → GitHub Gist or markdown output
- Copilot CLI `/delegate` → Copilot coding agent → produces patches/commands → applied back to repo

##### Important architectural patterns

- **Event-driven automation:** GitHub Actions triggered by repo/issue events drives progression.
- **Separation of planes:**
- Content plane: `.github/steps`, docs/images
- Control plane: `.github/workflows`
- Interaction plane: Issues + Copilot CLI sessions
- **Human-in-the-loop AI:** Copilot CLI proposes; learner reviews/applies; workflows validate.

##### Technologies/frameworks that matter here

- GitHub Actions (YAML workflows)
- GitHub Issues templates
- Copilot CLI (standalone)
- Node.js 22+ (target runtime for the app being built)
- Dev Container (Docker + VS Code Remote, implied)
- GitHub API surfaces (Issues/Checks/Contents)

Elements explicitly:

- “creates issue”
- “triggers workflow”
- “calls Copilot inference”
- “pushes commits”
- “posts step feedback”
- Blue rectangles: compute/execution (Runner, workstation)
- Green rectangles: automation/control (Workflows)
- Orange rectangles: external services (Copilot, Gist, MCP)

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =======================
%% Legend
%% =======================
subgraph "Legend"
direction TB
L1["Human_action_(manual)"]:::human
L2["API_call_or_network"]:::api
L3["Workflow_automation"]:::control
L4[("Data_store/state")]:::data
end

%% =======================
%% Learner environment
%% =======================
subgraph "Learner_Environment_(Workstation)"
direction TB
Learner["Learner/Developer"]:::human
Terminal["Terminal"]:::compute
VSCode["VS_Code_(optional)"]:::compute
DevContainer["Dev_Container_(Docker,_optional)"]:::compute
CopilotCLI["GitHub_Copilot_CLI_(standalone)"]:::compute
GitClient["Git_client"]:::compute
NodeRuntime["Node.js_22+_runtime_(for_calculator_app_when_created)"]:::compute
LocalWD[("Local_working_directory_(calculator_app_files_once_created)")]:::data

Learner -.->|"uses"| Terminal
Learner -.->|"uses"| VSCode
VSCode -.->|"attaches_to"| DevContainer
Terminal -.->|"runs"| CopilotCLI
Terminal -.->|"runs"| GitClient
Terminal -.->|"runs"| NodeRuntime
CopilotCLI -->|"writes/edits_files"| LocalWD
end

%% =======================
%% GitHub platform (repo + automation)
%% =======================
subgraph "GitHub_Platform"
direction TB

subgraph "Repository_(Training_Template)"
direction TB
Repo[("GitHub_Repo_(this_template_repo_contents)")]:::data

subgraph "Control_Plane_(.github/workflows)"
direction TB
WF0["0-start-exercise.yml"]:::control
WF1["1-step.yml"]:::control
WF2["2-step.yml"]:::control
WF3["3-step.yml"]:::control
WF4["4-step.yml"]:::control
end

subgraph "Content_Plane_(.github/steps,_docs,_assets)"
direction TB
StepsDir["Steps_directory"]:::content
Step1["1-step.md"]:::content
Step2["2-step.md"]:::content
Step3["3-step.md"]:::content
Step4["4-step.md"]:::content
Review["x-review.md"]:::content

Readme["README"]:::content
Images["images/"]:::content
GHImages[".github/images"]:::content
end

subgraph "Templates_&_Instructions"
direction TB
IssueTemplatesDir["Issue_templates_directory"]:::content
FeatureReqTemplate["feature_request.md"]:::content
CopilotRef["copilot-cli-ref.instructions.md"]:::content
VSCodeSettings[".vscode/"]:::content
DevcontainerJson["devcontainer.json"]:::content
end

Repo -->|"contains"| WF0
Repo -->|"contains"| WF1
Repo -->|"contains"| WF2
Repo -->|"contains"| WF3
Repo -->|"contains"| WF4

Repo -->|"contains"| StepsDir
StepsDir -->|"contains"| Step1
StepsDir -->|"contains"| Step2
StepsDir -->|"contains"| Step3
StepsDir -->|"contains"| Step4
StepsDir -->|"contains"| Review

Repo -->|"contains"| IssueTemplatesDir
IssueTemplatesDir -->|"contains"| FeatureReqTemplate
Repo -->|"contains"| CopilotRef
Repo -->|"contains"| VSCodeSettings
Repo -->|"contains"| DevcontainerJson
Repo -->|"contains"| Readme
Repo -->|"contains"| Images
Repo -->|"contains"| GHImages
end

Issues[("GitHub_Issues_(issue_objects)")]:::data
ActionsOrchestrator["GitHub_Actions_(orchestrator)"]:::control
Runner["GitHub-hosted_Runner_(execution_environment)"]:::compute
Checks[("Checks/Statuses_&_Action_Logs")]:::data

ActionsOrchestrator -->|"schedules_jobs"| Runner
Runner -->|"updates"| Checks
Runner -->|"reads/writes_contents"| Repo
end

%% =======================
%% Copilot / AI services
%% =======================
subgraph "Copilot_/_AI_Services"
direction TB
Auth["GitHub_AuthN/AuthZ_+_Copilot_entitlement"]:::external
CopilotGateway["Copilot_Service_(model_gateway/endpoints)"]:::external
CodingAgent["Copilot_Coding_Agent_(for_/delegate,_optional)"]:::external

Auth -->|"authorizes"| CopilotGateway
CopilotGateway -->|"may_use"| CodingAgent
end

%% =======================
%% Optional external tooling
%% =======================
subgraph "Optional_External_Tooling"
direction TB
MCP["MCP_Servers_(optional_integration)"]:::external
Gist[("GitHub_Gist_(for_/share,_optional)")]:::data
end

%% =======================
%% Primary flows (vertical, event-driven)
%% =======================

%% Flow 1: initialization
Learner -.->|"copies_template_repo"| Repo
Repo -->|"event_trigger"| ActionsOrchestrator
WF0 -->|"drives_initialization"| ActionsOrchestrator
ActionsOrchestrator -->|"runs"| Runner
Runner -->|"posts_initial_guidance/comments"| Issues
Runner -->|"references_step_content"| Step1

%% Flow 2: issue-driven workflow progression
Learner -.->|"creates_issue_from_template"| Issues
FeatureReqTemplate -->|"structures_issue_fields"| Issues
Issues -->|"issue_event_trigger"| ActionsOrchestrator
WF1 -->|"step_1_automation"| ActionsOrchestrator
WF2 -->|"step_2_automation"| ActionsOrchestrator
WF3 -->|"step_3_automation"| ActionsOrchestrator
WF4 -->|"step_4_automation"| ActionsOrchestrator

Runner -->|"posts_step_feedback"| Issues
Runner -->|"unlocks_next_step"| Issues
WF1 -->|"references"| Step1
WF2 -->|"references"| Step2
WF3 -->|"references"| Step3
WF4 -->|"references"| Step4
Runner -->|"checkpoint_guidance"| Review

%% Flow 3: Copilot CLI interactive development loop
Terminal -.->|"prompts/commands"| CopilotCLI
CopilotCLI -->|"API_calls"| CopilotGateway
CopilotCLI -->|"auth_via"| Auth
CopilotCLI -->|"applies_changes"| LocalWD
NodeRuntime -->|"runs_tests/build_locally"| LocalWD
GitClient -->|"commits"| LocalWD
GitClient -->|"pushes_commits"| Repo
Repo -->|"push_event_trigger"| ActionsOrchestrator
Runner -->|"validates_expected_artifacts/tests"| Repo
Runner -->|"writes_results"| Checks
Runner -->|"guidance_on_fail/pass"| Issues

%% Flow 4: sharing and delegation (optional)
CopilotCLI -->|"share_/share"| Gist
CopilotCLI -->|"delegate_/delegate"| CodingAgent
CodingAgent -->|"returns_patches/commands"| CopilotCLI
CopilotCLI -.->|"optional_context_tools"| MCP

%% =======================
%% Click events (from component mapping)
%% =======================
click WF0 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/workflows/0-start-exercise.yml"
click WF1 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/workflows/1-step.yml"
click WF2 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/workflows/2-step.yml"
click WF3 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/workflows/3-step.yml"
click WF4 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/workflows/4-step.yml"

click StepsDir "https://github.com/skills/create-applications-with-the-copilot-cli/tree/main/.github/steps/"
click Step1 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/steps/1-step.md"
click Step2 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/steps/2-step.md"
click Step3 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/steps/3-step.md"
click Step4 "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/steps/4-step.md"
click Review "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/steps/x-review.md"

click IssueTemplatesDir "https://github.com/skills/create-applications-with-the-copilot-cli/tree/main/.github/ISSUE_TEMPLATE/"
click FeatureReqTemplate "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/ISSUE_TEMPLATE/feature_request.md"
click CopilotRef "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/instructions/copilot-cli-ref.instructions.md"

click DevcontainerJson "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.devcontainer/devcontainer.json"
click VSCodeSettings "https://github.com/skills/create-applications-with-the-copilot-cli/tree/main/.vscode/"

click Readme "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/README.md"
click Images "https://github.com/skills/create-applications-with-the-copilot-cli/tree/main/images/"
click GHImages "https://github.com/skills/create-applications-with-the-copilot-cli/blob/main/.github/images"

%% =======================
%% Styles
%% =======================
classDef human fill:#F5F5F5,stroke:#616161,stroke-width:1px,color:#111
classDef compute fill:#D6EAF8,stroke:#1B4F72,stroke-width:1px,color:#0B1F2A
classDef control fill:#D5F5E3,stroke:#196F3D,stroke-width:1px,color:#0B2A17
classDef data fill:#E8DAEF,stroke:#512E5F,stroke-width:1px,color:#1F1026
classDef external fill:#FAD7A0,stroke:#7D6608,stroke-width:1px,color:#2A2205
classDef content fill:#FEF9E7,stroke:#7D6608,stroke-width:1px,color:#2A2205
```
