Skip to content

About

Org-wide defaults for aletheia-works: Code of Conduct, Security Policy, and templates

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

aletheia-works/.github

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/.

Reusable workflows

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's infra/github-org/ and infra/dotgithub/, and by per-repo infra/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 on pull_request_target, pass rules (what the review holds the diff against) and the CLAUDE_CODE_OAUTH_TOKEN secret. This repository calls it through dotgithub-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.yml reads the calling repository's own .github/labeler.yml rules. dependabot-auto-merge.yml sets up the merge as the organisation bot with the organisation variable BOT_CLIENT_ID when the caller passes BOT_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, with browsers and the command that 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.

License

Apache License 2.0.

About

Org-wide defaults for aletheia-works: Code of Conduct, Security Policy, and templates

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages