Release v0.6.0 — Community Health, Governance Docs, and Meta Agent Foundations

[ashleyshaw]

Release Summary

v0.6.0 is a minor release focused on community health file completeness, governance documentation accuracy, and setting up the foundations for a functional reporting and metrics agent.

This release groups work that has accumulated across several PRs targeting develop since v0.5.x, covering issue template alignment, PR template governance, README accuracy, workflow documentation, and actionable meta/reporting agent improvements.

---

Scope & Proposed Inclusions

Already merged / in-flight (PRs to include)

• PR fix(issue-templates): add about field, align with 25 org issue types, and polish #966 — fix/issue-templates-missing-about-field: Fix "About can't be blank" on all issue templates; align to 25 canonical types; add 08-chore.md; remove 08-user-experience-feedback.md and 26-help.md
• PR (docs/github-community-health-audit) — Community health audit: WCAG 2.2 fixes in 4 PR templates; 15 missing branch prefixes in default template; 27-workflow README rewrite; SAVED_REPLIES/ISSUE_TEMPLATE/DISCUSSION_TEMPLATE README accuracy; AGENTS.md/CLAUDE.md/custom-instructions.md updates
• PR Align template governance routing #955 — Template Enforcement Governance Closeout: canonical PR routing map, root PR router refresh, template-enforcement workflow fixes

Recommended additions for v0.6.0 scope

The following are high-value, bounded tasks that would make this a well-rounded governance release:

• Reporting agent dry-run fix — Remove dry_run: true permanently from reporting.yml so metrics actually commit (Phase 1 of reporting agent completion)
• Metrics JSON persistence — Wire gather-metrics.js to write weekly snapshot JSON to .github/reports/metrics/weekly/YYYY-WW.json instead of logging to stdout only
• npm run audit:readme script — Implement the stub so readme-audit.yml can run a real check rather than a no-op
• CHANGELOG.md v0.6.0 section — Finalise all unreleased entries and cut the [0.6.0] section with today's date

---

Milestones / Checklist

• All in-flight PRs merged to develop
• Reporting agent dry-run removed and metrics persistence implemented (if included)
• audit:readme script implemented (if included)
• CHANGELOG.md unreleased entries reviewed and finalised
• [0.6.0] section cut in CHANGELOG with release date
• Release branch release/v0.6.0 created from develop
• release/v0.6.0 PR opened against main using pr_release.md template
• CI green on release PR
• Release PR reviewed and approved
• Merge release PR → main; tag v0.6.0

Acceptance Criteria

• All issue templates pass GitHub's about field requirement (no "About can't be blank" errors)
• PR template quick-selector table covers all 30 branch prefixes defined in PULL_REQUEST_TEMPLATE/config.yml
• All 27 workflow files documented accurately in .github/workflows/README.md
• WCAG references in all PR templates read "WCAG 2.2 AA or higher"
• CHANGELOG.md v0.6.0 section published with full entry list
• Release tag v0.6.0 exists on main

Additional Context

Key files changed in this release cycle:

• .github/ISSUE_TEMPLATE/ — 25-template alignment
• .github/PULL_REQUEST_TEMPLATE/ — WCAG fixes, full branch prefix coverage
• .github/workflows/README.md — Accurate 27-workflow inventory
• AGENTS.md, CLAUDE.md, .github/custom-instructions.md — Governance doc updates
• .github/SAVED_REPLIES/README.md — 20 missing files added
• docs/ISSUE_CREATION_GUIDE.md — 25-template parity, canonical label fixes

Changelog entries to include: See CHANGELOG.md [Unreleased] — the community health audit entry and the issue template fix entry both belong in this release.

Related issues: #965 (issue template audit), #966 (PR), and the community health audit PR.

---

Definition of Ready (DoR)

• Release goal and scope defined
• Milestones and checklist mapped
• All in-flight PRs confirmed merged to develop

Definition of Done (DoD)

• All checklist and acceptance criteria completed
• CHANGELOG [0.6.0] section published
• Release tag v0.6.0 on main
• Approved by maintainer

[linear-code]

LS-1044