Skip to content

Require feature triage and coverage review for release notes - #10600

Merged
danroth27 merged 4 commits into
mainfrom
release-notes/feature-coverage-review
Sep 26, 2026
Merged

danroth27 merged 4 commits into
mainfrom
release-notes/feature-coverage-review

Conversation

@danroth27

Copy link
Copy Markdown
Member

Summary

  • Require a real features.json with shipped changes, commit mapping, and scored noteworthy candidates before drafting component release notes; reject schema stubs and slim candidate lists.
  • Require final editorial review to reconcile noteworthy candidates with the completed drafts, including refreshed milestone branches, and record reasons for intentional omissions.
  • Remove the review fallback that inferred scoring from a draft when features.json was missing.

This intentionally does not add fallback handling for missing milestones or incorrect area labels; those are upstream metadata/automation concerns.

Fixes #10435

Validation

  • Targeted markdownlint and link checks passed for all five edited skill files; git diff --check passed.
  • Checkov was unavailable (no Checkov or Python installer on this machine). Repository-wide Prettier reports existing formatting warnings across 5,384 files.

Reject placeholder features.json files, carry scored candidates into component drafting, and reconcile noteworthy omissions during final and incremental review.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 7e7e9011-e85b-469d-88f5-7843d1de691f

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Feature validation and cross-branch aggregation remain incomplete.

Review effort: Lite
Findings: 1 Medium severity · 1 Low severity

Open (2)
What changed in this PR

Strengthens the release-notes workflow with complete feature triage and final editorial coverage review.

Changes:

  • Requires populated, scored features.json before drafting.
  • Removes draft-based scoring fallback.
  • Adds final review for milestone drafts and omissions.
File Description
.github/​skills/​update-existing-branch/​SKILL.md Adds final review to refresh workflows.
.github/​skills/​review-release-notes/​SKILL.md Enforces complete triage and omission reconciliation.
.github/​skills/​release-notes/​SKILL.md Adds triage and final-review gates.
.github/​skills/​release-notes/​references/​changes-schema.md Clarifies feature manifest requirements.
.github/​skills/​generate-features/​SKILL.md Requires shipped-change data and scored candidates.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Compare complete feature and change manifests, review drafts on their component branches, and record intentional omissions in feature score reasons.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 7e7e9011-e85b-469d-88f5-7843d1de691f

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Resolve conflicting manifest guidance and make ID and commit-key preservation mandatory.

Review effort: Lite
Findings: 2 Low severity

Open (2)
Resolved since last review (1)

Keep every shipped change and commit key in features.json while scoring only noteworthy candidates.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 7e7e9011-e85b-469d-88f5-7843d1de691f

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Unresolved issues remain around durable omission rationale, workflow enforcement, and coverage of breaking changes.

Review effort: Lite
Findings: None

Resolved since last review (2)

@danroth27
danroth27 marked this pull request as ready for review September 26, 2026 20:00
@danroth27
danroth27 merged commit 4e2c097 into main Sep 26, 2026
6 checks passed
@danroth27
danroth27 deleted the release-notes/feature-coverage-review branch September 26, 2026 20:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Require scored feature triage and coverage review for release notes

3 participants