Council hall · Org commons · swarm-routing/.github
Org commons
The rules every repository shares: licence gate, reusable workflows, labels, templates and agent skills.
Unlocked: Live: org defaults, reusable CI, templates
What it does
swarm-routing/.github holds the org-wide defaults: the profile page, issue forms and PR template, the label taxonomy (labels.json), the C++ style, and the reusable workflows other repositories call (reusable-ns3-ci.yml, reusable-licence-check.yml, reusable-python-ci.yml, reusable-pr-title.yml, sync-labels.yml). Callers pin @main, so those inputs are a public contract.
tools/org-sync renders templates/ into each repository (AGENTS/CLAUDE org sections, badges, SECURITY, licence files, ADR template, Makefile targets) and checks drift in CI. The swarm-routing/skills marketplace ships the org-repo Claude Code plugin that drives it, script first.
Diagrams
Package structure
The repository's layout, its licence per directory (LICENSING.md) and what exists today.
| Path | What | Licence | State |
|---|---|---|---|
.github/workflows/ | reusable-ns3-ci, reusable-python-ci, reusable-pr-title, reusable-licence-check, reusable-org-sync-check, sync-labels | MIT OR GPL-2.0-only | present |
tools/checks/check-headers.py | the licence-header gate | MIT OR GPL-2.0-only | present |
tools/org-sync/ | applies templates/ to a repo and checks drift | MIT OR GPL-2.0-only | present |
templates/ | what org-sync renders | MIT OR GPL-2.0-only | present |
ISSUE_TEMPLATE/, labels.json | issue forms and the label taxonomy | MIT OR GPL-2.0-only | present |
ROADMAP.md, CONTRIBUTING.md | the phases and the org invariants | GPL-2.0-only | present |
Where it sits in the colony
Quests
- Done: Every repository has CLAUDE.md, AGENTS.md, LICENSING.md and synced labels
- Open: Org templates adopted by every repository (.github#6)
- Open: Hardening: Scorecard, rulesets, CI hygiene everywhere (.github#14)
Sources
Facts as of 2026-11-08, from the repository's AGENTS.md and the org ROADMAP.