This repository holds org-wide defaults and shared CI for aletheia-works.
| Path | Purpose |
|---|---|
profile/README.md |
Shown on the org landing page |
CODE_OF_CONDUCT.md |
Contributor Covenant 2.1 — inherited by every repo in the org |
SECURITY.md |
Vulnerability reporting policy |
CONTRIBUTING.md |
Shared contribution expectations |
.github/ISSUE_TEMPLATE/*.yml |
Default issue forms for new repos |
.github/PULL_REQUEST_TEMPLATE.md |
Default PR template |
.github/workflows/*.yml |
Reusable workflows (workflow_call) — terraform-plan, terraform-apply, terraform-autofix, commitlint, claude-review, dependency-review, dependabot-auto-merge, labeler, assign — plus repo-local automations (thin callers such as dotgithub-claude-review, seed-state, terraform-state-backup, ghqr-weekly) |
actions/install-playwright/ |
Composite action: playwright install --with-deps with the apt packages it downloads cached |
infra/github-org/ |
OpenTofu config for org-level GitHub settings |
infra/dotgithub/ |
OpenTofu config for this .github repository's own settings |
brand/ |
Org icon and shared brand assets |
mise.toml |
Tool versions for ad-hoc local authoring (opentofu for tofu fmt/validate); plan/apply runs in CI |
Individual repositories may override any of the org-wide health files (SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md, issue/PR templates) by placing their own versions in the repo root or .github/.
Repos under aletheia-works/ consume the workflows in .github/workflows/ via workflow_call. Notable callers and patterns:
terraform-plan.yml/terraform-apply.yml/terraform-autofix.yml— used by both this repo'sinfra/github-org/andinfra/dotgithub/, and by per-repoinfra/github/(e.g. vivarium/infra/github/). Caller repos pass a thin wrapper; state and secrets stay in the caller's context.commitlint.yml— Conventional Commits enforcement, called from each repo's CI.claude-review.yml— Claude Code review of pull requests opened by the listed authors, also when aletheia-works-bot pushed the latest commit (a lint autofix). Callers run it onpull_request_target, passrules(what the review holds the diff against) and theCLAUDE_CODE_OAUTH_TOKENsecret. This repository calls it throughdotgithub-claude-review.yml.dependency-review.yml,dependabot-auto-merge.yml,labeler.yml,assign.yml— the same pull-request automations in every repository. This repository runs them on its own events too.labeler.ymlreads the calling repository's own.github/labeler.ymlrules.dependabot-auto-merge.ymlsets up the merge as the organisation bot with the organisation variableBOT_CLIENT_IDwhen the caller passesBOT_PRIVATE_KEY(a Dependabot secret), so the merge starts the caller's push workflows.actions/install-playwright— a composite action rather than a workflow: callers use it as a step,uses: aletheia-works/.github/actions/install-playwright@<sha> # vX.Y.Z, withbrowsersand thecommandthat runs their own Playwright CLI.
The reusables are versioned. release.yml cuts a vX.Y.Z tag and a GitHub release whenever one of them changes on main, bumping major for a breaking change, minor for feat, patch for anything else. Callers pin uses: aletheia-works/.github/.github/workflows/<name>.yml@<sha> # vX.Y.Z; Dependabot follows the tag and moves the SHA and the comment together. A # main comment beside a SHA is one Dependabot can never update.
A reusable workflow runs with the permissions its caller grants, so each caller job grants what the workflow's permissions: block lists.
See infra/github-org/README.md for the org-state Terraform layout, infra/dotgithub/README.md for this .github repo's own settings, and each repo's own infra/github/README.md for per-repo settings.
Apache License 2.0.