CI/CD
What runs in .github/workflows, as the site reads
it from the workflows at build time (scripts/workflow_table.py, docs/adr/0011). How work runs is in
CONTRIBUTING.md.
Workflows
Section titled “Workflows”| Workflow | File | Triggers | Jobs | Does |
|---|---|---|---|---|
| Blender Updates | blender-updates.yml |
schedule (0 6 * * 1), workflow_dispatch |
Re-pin Blender | Re-pins Blender to the newest stable release at least 14 days old and opens (or refreshes) a PR, weekly |
| Checks | checks.yml |
push (main), schedule (0 7 * * 1), workflow_dispatch, workflow_call (inputs: deploy) |
Changes, Code, Convex, Model, Sim, Render, Blender, Site, Checks, Deploy | Runs main’s just check, the model tests with the Mech stand-in, sim and STL/STEP export, and builds its site |
| CI Images | ci-images.yml |
schedule (0 4 * * 1), push (main; paths: ci/*.Dockerfile, .github/workflows/ci-images.yml, uv.lock, pyproject.toml, .python-version), workflow_dispatch |
Push | Builds the CI images the Chrome and Blender jobs run in; main pushes them to GHCR |
| Claude Review | claude-review.yml |
pull_request |
Fetch Skills, Review | Claude reviews the PR and approves or requests changes |
| CodeQL | codeql.yml |
schedule (0 4 * * 1), workflow_dispatch |
Analyze | Scans main with CodeQL weekly (and on demand) into the Security tab; a finding gets a follow-up PR |
| Default Branch Failure | default-branch-failure.yml |
workflow_run (workflows: Checks, CI Images; main) |
Report | Opens one default branch failure issue while the default branch’s Checks fail, and closes it once Checks’ Deploy |
| Dependabot Auto-merge | dependabot-auto-merge.yml |
pull_request |
Auto-merge | Turns on auto-merge (squash) for Dependabot’s PRs: each merges once the required checks and Claude’s review pass |
| Image Scan | image-scan.yml |
schedule (0 6 * * 1), workflow_dispatch |
Scan | Scans the two CI images for known vulnerabilities weekly, into the Security tab; never a PR check |
| Issue Labels | issue-labels.yml |
pull_request, issues |
In Progress, Clear Labels | Keeps issues’ state labels in step: a PR sets the issues it links in progress, and closing an issue clears its labels |
| Issue Title | issue-title.yml |
issues |
Title | Checks an issue’s title is a Conventional Commit, as a PR’s is, so the title can become its PR’s (#767) |
| PR Checks | pr-checks.yml |
pull_request |
PR | Checks the PR’s title is a Conventional Commit, its body links its issue, and it adds no vulnerable dependency |
| PR Gate | pr-gate.yml |
pull_request |
Code, Checks | Runs a PR’s slim gate: just check-light (ruff, pyright and the fast tests), then the required Checks |
| Release Assets | release-assets.yml |
push (v*) |
Release Assets | Zips the Core’s program (stamped with its version and commit) and the setup wizard onto the release |
| Release | release.yml |
workflow_run (workflows: Checks; main), workflow_dispatch (inputs: bump) |
Checks, Release | Releases main once its Checks pass: semantic-release tags vX.Y.Z and writes the GitHub release and its notes |
| Skills Updates | skills-updates.yml |
schedule (0 6 * * 1), workflow_dispatch |
Re-pin Skills, Propose | Re-pins skills-lock.json to each source’s HEAD and opens (or refreshes) a PR, weekly |
noggin v0.2.26-6-g09bf9b7 · 09bf9b7