Label governance & policy foundation (Phases 1a, 1b, 2)

[paynejd]

Summary

Establish org-wide label taxonomy, development policies, and governance documentation for the OpenConceptLab GitHub org. This is the foundation for AI-assisted delivery (triage, review, planning, implementation).

What was done

Phase 1a — Labels & Templates

• Defined 33-label scoped taxonomy (type/, priority/, component/, signal/, origin/, stage/) in labels.yml
• Wrote idempotent provisioning script (provision-labels.sh)
• Provisioned all 33 labels across all 36 active repos (1,188 labels created)
• Added org-wide issue templates (bug, feature) with auto-labeling and PR template to .github repo

Phase 2 — Migration

• Bulk-migrated 1,073 issues on ocl_issues from old labels to new taxonomy
• Deleted 62 old labels from ocl_issues
• Deleted 243 GitHub default labels across all 36 repos

Phase 1b — Draft Policies

• Published CONTRIBUTING.md to .github repo (community-facing contributor guide)
• Published 5 governance docs to ocl-online-docs/governance/:
  • Ticket filing policy, PR policy, release strategy, AI content policy, label governance
• Updated governance README as the team policy review master doc with:
  • Repo audit of policy file coverage (LICENSE, CONTRIBUTING, SECURITY, etc.)
  • Plan from draft to approved status

What's next

• Phase 3: Read-only agents (TRIAGE + REVIEWER) on OCL repos
• Experimentation pause: Validate agent accuracy before enforcement
• Phase 4: Policy enforcement (release.yml, branch protection, GitHub Actions)
• Phase 5: Write agents (WORKER/PLANNER)

References

• Label governance proposal v2 (ocl-workspace)
• Governance review guide
• CONTRIBUTING.md
• Provisioning tools

[paynejd]

Closing — Phases 1a, 1b, and 2 are complete.

Key commits across repos:

.github repo:

• e01754c — labels.yml, issue/PR templates, provisioning script (Phase 1a)
• eb00f26 — migration and cleanup scripts (Phase 2)
• 4961803 — CONTRIBUTING.md (Phase 1b)

ocl-online-docs:

• 3a48382 — governance policy docs (Phase 1b)
• f98dc55 — governance review guide (Phase 1b)

Closes #2452