Skip to content

feat(instructions): replace EVEN/ODD hardcoding with runtime milestone discovery protocol#486

Merged
WilliamBerryiii merged 6 commits intomainfrom
feature/466-agnostic-milestone-discovery
Feb 12, 2026
Merged

feat(instructions): replace EVEN/ODD hardcoding with runtime milestone discovery protocol#486
WilliamBerryiii merged 6 commits intomainfrom
feature/466-agnostic-milestone-discovery

Conversation

@WilliamBerryiii
Copy link
Copy Markdown
Member

Description

Replaced static EVEN/ODD milestone versioning assumptions with a runtime discovery protocol across three GitHub backlog instruction files. The protocol fetches open milestones at runtime, detects naming patterns (SemVer, CalVer, Sprint, Feature), classifies milestones into abstract roles (stable, pre-release, current, next, backlog), and maps issue characteristics to target roles dynamically.

  • Added Milestone Discovery Protocol section to the planning specification with discovery steps, naming pattern detection, role classification, and an assignment map replacing the former Milestone Conventions section.
  • Updated the triage workflow to invoke the discovery protocol during Phase 1 and reference discovered milestone roles instead of EVEN/ODD versioning in milestone recommendation and priority assessment tables.
  • Updated the discovery cross-references table to reference the Milestone Discovery Protocol with role-based classification instead of the former EVEN/ODD convention.
  • Replaced bolded-prefix list items and ALL CAPS directives (MUST, SHOULD, MAY) with writing-style-compliant alternatives across all three files.

Related Issue(s)

Closes #466

Type of Change

Select all that apply:

Code & Documentation:

  • Bug fix (non-breaking change fixing an issue)
  • New feature (non-breaking change adding functionality)
  • Breaking change (fix or feature causing existing functionality to change)
  • Documentation update

Infrastructure & Configuration:

  • GitHub Actions workflow
  • Linting configuration (markdown, PowerShell, etc.)
  • Security configuration
  • DevContainer configuration
  • Dependency update

AI Artifacts:

  • Reviewed contribution with prompt-builder agent and addressed all feedback
  • Copilot instructions (.github/instructions/*.instructions.md)
  • Copilot prompt (.github/prompts/*.prompt.md)
  • Copilot agent (.github/agents/*.agent.md)
  • Copilot skill (.github/skills/*/SKILL.md)

Other:

  • Script/automation (.ps1, .sh, .py)
  • Other (please describe):

Sample Prompts (for AI Artifact Contributions)

User Request:

Triage the untriaged issues in this repository.

Execution Flow:

  1. The triage workflow activates github-backlog-triage.instructions.md via its applyTo glob pattern.
  2. Phase 1, Step 1 invokes the Milestone Discovery Protocol from github-backlog-planning.instructions.md, fetching open milestones and classifying them into abstract roles.
  3. Triage analysis assigns milestones using discovered roles (stable, pre-release, current, next) instead of hardcoded EVEN/ODD version numbers.
  4. The discovery cross-references in github-backlog-discovery.instructions.md direct agents to the new protocol section.

Output Artifacts:

Planning log entries in .copilot-tracking/github-issues/triage/ containing detected naming pattern, per-milestone role classification, and the generated assignment map.

Success Indicators:

  • Milestone assignments use abstract role names (for example, "nearest stable or current") rather than specific version parity.
  • The planning log records discovery confidence level (high, medium, low).
  • Repositories using CalVer, Sprint, or Feature milestones receive correct classifications without code changes.

GHCP Artifact Maturity

Warning

This PR includes experimental GHCP artifacts that may have breaking changes.

  • .github/instructions/github-backlog-planning.instructions.md
  • .github/instructions/github-backlog-triage.instructions.md
  • .github/instructions/github-backlog-discovery.instructions.md
File Type Maturity Notes
.github/instructions/github-backlog-planning.instructions.md Instructions ⚠️ experimental Pre-release only
.github/instructions/github-backlog-triage.instructions.md Instructions ⚠️ experimental Pre-release only
.github/instructions/github-backlog-discovery.instructions.md Instructions ⚠️ experimental Pre-release only

GHCP Maturity Acknowledgment

  • I acknowledge this PR includes non-stable GHCP artifacts
  • Non-stable artifacts are intentional for this change

Testing

All automated validation passes with zero errors:

  • Markdown linting: npm run lint:md
  • Frontmatter validation: npm run lint:frontmatter
  • PowerShell analysis: npm run lint:ps
  • Combined validation: npm run lint:all

Checklist

Required Checks

  • Documentation is updated (if applicable)
  • Files follow existing naming conventions
  • Changes are backwards compatible (if applicable)
  • Tests added for new functionality (if applicable)

AI Artifact Contributions

  • Used /prompt-analyze to review contribution
  • Addressed all feedback from prompt-builder review
  • Verified contribution follows common standards and type-specific requirements

Required Automated Checks

The following validation commands must pass before merging:

  • Markdown linting: npm run lint:md
  • Spell checking: npm run spell-check
  • Frontmatter validation: npm run lint:frontmatter
  • Link validation: npm run lint:md-links
  • PowerShell analysis: npm run lint:ps

Security Considerations

  • This PR does not contain any sensitive or NDA information
  • Any new dependencies have been reviewed for security issues
  • Security-related scripts follow the principle of least privilege

Additional Notes

Three follow-up items identified during review:

  1. .github/milestone-strategy.yml schema design for repositories that declare their milestone strategy explicitly
  2. Cross-repository adoption testing to validate the discovery protocol against diverse milestone naming patterns
  3. Pre-existing maturity: experimental frontmatter on all three modified files

🚀 - Generated by Copilot

…e discovery protocol

- replace Milestone Conventions with Milestone Discovery Protocol in planning spec
- refactor triage workflow from EVEN/ODD to role-based milestone assignment
- update discovery cross-references to reference new protocol section
- fix ALL CAPS directives and bolded-prefix list items for writing style compliance

🚀 - Generated by Copilot
@WilliamBerryiii WilliamBerryiii requested a review from a team as a code owner February 12, 2026 05:54
Copilot AI review requested due to automatic review settings February 12, 2026 05:54
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 12, 2026

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented Feb 12, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.40%. Comparing base (8031557) to head (b4886c2).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #486      +/-   ##
==========================================
- Coverage   83.43%   83.40%   -0.03%     
==========================================
  Files          20       20              
  Lines        3507     3507              
==========================================
- Hits         2926     2925       -1     
- Misses        581      582       +1     
Flag Coverage Δ
pester 83.40% <ø> (-0.03%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@WilliamBerryiii WilliamBerryiii added this to the v2.3.0 milestone Feb 12, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the GitHub backlog instruction set to remove hardcoded EVEN/ODD milestone assumptions and replace them with a role-based “Milestone Discovery Protocol” referenced by planning, triage, and discovery workflows.

Changes:

  • Added a Milestone Discovery Protocol to the planning specification (naming-pattern detection, role classification, assignment map).
  • Updated the triage workflow to invoke the new discovery protocol and use role-based milestone recommendations.
  • Updated the discovery workflow cross-references to point to the new protocol instead of the prior milestone conventions.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File Description
.github/instructions/github-backlog-planning.instructions.md Replaces EVEN/ODD milestone guidance with a runtime milestone discovery protocol and role-based assignment map.
.github/instructions/github-backlog-triage.instructions.md Switches triage milestone guidance to rely on discovered milestone roles and updates recommendation tables accordingly.
.github/instructions/github-backlog-discovery.instructions.md Updates milestone assignment references to point to the new discovery protocol section.

- rewrite milestone discovery step 1 to use search-based workaround
- clarify due-date tiebreaker to separate date roles from naming roles
- add breaking-change human-review gate for partial/manual autonomy
- normalize label taxonomy to canonical role names
- fix heading case and table formatting

🔧 - Generated by Copilot
Copy link
Copy Markdown
Contributor

@katriendg katriendg left a comment

Choose a reason for hiding this comment

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

Nice, and generalizing more for usage across repos.

Copilot AI review requested due to automatic review settings February 12, 2026 20:12
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings February 12, 2026 20:25
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

…protocol

- split Assignment Map into separate Stability Target and Proximity Target columns with deterministic 3-step resolution
- reword milestone-strategy.yml references as optional overrides that may not exist
- align triage Milestone Recommendation table with planning Assignment Map structure

🔧 - Generated by Copilot
@WilliamBerryiii WilliamBerryiii merged commit ae95eb2 into main Feb 12, 2026
17 checks passed
WilliamBerryiii pushed a commit that referenced this pull request Feb 13, 2026
🤖 I have created a release *beep* *boop*
---


##
[2.3.0](hve-core-v2.2.0...hve-core-v2.3.0)
(2026-02-13)


### ✨ Features

* **agents:** add GitHub backlog management pipeline
([#448](#448))
([2b4d123](2b4d123))
* **docs:** define inactivity closure policies for issues and PRs
([#452](#452))
([5e710fd](5e710fd))
* **extension:** implement collection-based plugin distribution system
([#439](#439))
([3156d98](3156d98))
* **instructions:** replace EVEN/ODD hardcoding with runtime milestone
discovery protocol
([#486](#486))
([ae95eb2](ae95eb2))
* **plugin:** support Copilot CLI plugin generation from collection
manifests ([#496](#496))
([e6cee85](e6cee85))
* **scripts:** enhance on-create.sh to install actionlint and PowerShell
modules ([#500](#500))
([67585f5](67585f5))


### 🐛 Bug Fixes

* **docs:** replace broken relative link with inline code reference
([#465](#465))
([8133b36](8133b36))
* **instructions:** prevent local-only paths from leaking into GitHub
issues ([#489](#489))
([497d2fe](497d2fe))
* **workflows:** prevent release-please infinite loop on main branch
([#470](#470))
([134bdd6](134bdd6))
* **workflows:** remove release-please skip guard that prevents tag
creation ([#511](#511))
([5e53271](5e53271))


### 📚 Documentation

* **agents:** add GitHub Backlog Manager documentation and agent catalog
([#503](#503))
([5e818ce](5e818ce))
* align CONTRIBUTING.md with docs/contributing/ guides
([#445](#445))
([73ef6aa](73ef6aa))


### ♻️ Refactoring

* **scripts:** refactor dev-tools and lib scripts to use CIHelpers
module ([#482](#482))
([fdf9145](fdf9145))
* **scripts:** standardize PowerShell entry point guard pattern
([#477](#477))
([6b84a8e](6b84a8e))


### 🔧 Maintenance

* **config:** standardize action mappings in artifact-retention.yml
([#487](#487))
([7927db2](7927db2))
* **deps-dev:** bump cspell from 9.6.2 to 9.6.4 in the npm-dependencies
group ([#461](#461))
([c788095](c788095))
* **deps:** bump actions/setup-python from 5.1.1 to 6.2.0 in the
github-actions group
([#462](#462))
([69ef3c9](69ef3c9))
* **security:** add SBOM artifact retention policy
([#479](#479))
([8031557](8031557)),
closes [#453](#453)

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: hve-core-release-please[bot] <254602402+hve-core-release-please[bot]@users.noreply.github.com>
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.

feat(instructions): discover milestone versioning strategy natively instead of hardcoding EVEN/ODD

4 participants