Skip to content

Add CodeBoarding architecture analysis - #2

Open
ivanmilevtues wants to merge 1 commit into
mainfrom
codeboarding/setup-action
Open

ivanmilevtues wants to merge 1 commit into
mainfrom
codeboarding/setup-action

Conversation

@ivanmilevtues

@ivanmilevtues ivanmilevtues commented Oct 26, 2026 •

Copy link
Copy Markdown
Member

Preview first, merge when ready

View your map · Configure & merge

The preview runs on this pull request. Merge the workflow to keep maps updated. Settings can be changed in this same pull request before merging.

This PR adds CodeBoarding in one workflow file, codeboarding.yml, with two jobs:

  • review keeps an architecture-diff comment current on pull requests and publishes their diagrams for the viewer.
  • sync saves the diagram of main on pushes and manual runs.

Sync delivery

Sync saves the generated diagram on its own codeboarding/baseline branch in this repository; main never changes and there is nothing to merge.

Protect codeboarding/baseline

Sync and review load a Python pickle from that branch, and loading a pickle runs code, so anyone
who can push to it can run code in these workflows. Import a ruleset under Settings, Rules,
Rulesets, New ruleset, Import a ruleset, before the first sync:

  • baseline-branch-ruleset-actions.json fits this workflow
    as generated, which pushes with the default github.token. It stops people pushing by hand,
    but any workflow with contents: write can still write the branch.
  • baseline-branch-ruleset.json lets only the CodeBoarding Review app
    write it. Use it when sync pushes with the app's token as github_token.

More in the baseline branch. Rulesets on a private
repository need a paid GitHub plan.

Works out of the box

Just merge it: the Action runs on the free tier, with no secret to add. The
id-token: write permission lets it identify your repo to CodeBoarding’s hosted LLM,
metered against a weekly limit for the repository owner.

Want more, or unmetered, usage?

Switching is a change to this workflow file rather than a secret you add, because the
file names which credentials a run uses. Use Configure & merge in the viewer to pick:

  • a CodeBoarding plan (unmetered, and raises the analysis-depth ceiling from 3 to 10), or
  • your own provider key: OpenRouter, Anthropic, OpenAI, Google, AWS Bedrock and
    others.

Before merging, this updates the same setup pull request and tells you which secret to
add under Settings → Secrets and variables → Actions.
After merging, use repository settings in the dashboard to open an update PR.

Opened for you by CodeBoarding.

Pull requests to preview

Before you merge, this pull request's run also reviews #1 so you can see it on your map in CodeBoarding. Nothing is posted on it. Change the list in CodeBoarding, or edit the numbers below.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 26, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-26T13:41:48.930633Z dc56860 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

github-actions Bot commented Oct 26, 2026 •

Copy link
Copy Markdown

CodeBoarding review

Status: 0 changed components (no analysed file changed)

See the full change in CodeBoarding.

graph LR
    n_Command_Line_Interface_and_Devtools_UI["Command-Line Interface and Devtools UI"]
    n_Core_Agent_Runtime_and_Services["Core Agent Runtime and Services"]
    n_Build_and_Documentation_Scripts["Build and Documentation Scripts"]
    n_Caretaker_Bots_and_Benchmark_Setups["Caretaker Bots and Benchmark Setups"]
    n_Evaluation_and_Benchmark_Suite["Evaluation and Benchmark Suite"]
    n_Agent_to_Agent_Communication_Server["Agent-to-Agent Communication Server"]
    n_Shared_Testing_Infrastructure["Shared Testing Infrastructure"]
    n_VS_Code_IDE_Companion_Extension["VS Code IDE Companion Extension"]
    n_Client_SDK["Client SDK"]
    n_Command_Line_Interface_and_Devtools_UI -- "delegates execution to core agent services" --> n_Core_Agent_Runtime_and_Services
    n_Command_Line_Interface_and_Devtools_UI -- "references test mocks for extensions" --> n_Evaluation_and_Benchmark_Suite
    n_Build_and_Documentation_Scripts -- "extracts settings and keybinding definitions" --> n_Command_Line_Interface_and_Devtools_UI
    n_Build_and_Documentation_Scripts -- "validates tool names against core declarations" --> n_Core_Agent_Runtime_and_Services
    n_Caretaker_Bots_and_Benchmark_Setups -- "resolves binary paths from core tools" --> n_Core_Agent_Runtime_and_Services
    n_Caretaker_Bots_and_Benchmark_Setups -- "configures isolated test environments" --> n_Shared_Testing_Infrastructure
    n_Evaluation_and_Benchmark_Suite -- "executes CLI AppRig harness for evaluations" --> n_Command_Line_Interface_and_Devtools_UI
    n_Evaluation_and_Benchmark_Suite -- "benchmarks core services and storage mechanisms" --> n_Core_Agent_Runtime_and_Services
    n_Evaluation_and_Benchmark_Suite -- "formats execution traces with script utilities" --> n_Build_and_Documentation_Scripts
    n_Evaluation_and_Benchmark_Suite -- "runs simulated scenarios on TestRig harness" --> n_Shared_Testing_Infrastructure
    n_Agent_to_Agent_Communication_Server -- "coordinates tasks using core Gemini client" --> n_Core_Agent_Runtime_and_Services
    n_VS_Code_IDE_Companion_Extension -- "inspects IDE environment via core utilities" --> n_Core_Agent_Runtime_and_Services
    n_Client_SDK -- "manages sessions and tools via core runtime" --> n_Core_Agent_Runtime_and_Services
    classDef added fill:#1f883d,stroke:#0b5d23,color:#ffffff;
    classDef modified fill:#bf8700,stroke:#7d4e00,color:#ffffff;
    classDef deleted fill:#cf222e,stroke:#82071e,color:#ffffff,stroke-dasharray:5 3;
Loading

download artifacts · run 40426550891

@github-actions github-actions Bot added the size/M M: 50-249 lines changed label Oct 26, 2026
@github-actions

Copy link
Copy Markdown

📊 PR Size: size/M

  • Lines changed: 59
  • Additions: +59
  • Deletions: -0
  • Files changed: 1

@ivanmilevtues
ivanmilevtues force-pushed the codeboarding/setup-action branch from dc56860 to 3618740 Compare October 27, 2026 00:27
@github-actions

Copy link
Copy Markdown

@ivanmilevtues your CodeBoarding map of main is ready, and #1 is reviewed on it.

Open #1 in CodeBoarding · feat(core): configure model routing by request complexity

This is a preview. Merge this PR to keep the map up to date and review every pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M M: 50-249 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant