Skip to content

refactor!: restructure RPI collection to HVE Core naming convention#668

Merged
katriendg merged 3 commits intomainfrom
refactor/create-hve-core-all-collection
Feb 19, 2026
Merged

refactor!: restructure RPI collection to HVE Core naming convention#668
katriendg merged 3 commits intomainfrom
refactor/create-hve-core-all-collection

Conversation

@agreaves-ms
Copy link
Collaborator

refactor!: restructure RPI collection to HVE Core naming convention

Description

This PR promotes the RPI collection to flagship status by renaming it to HVE Core and redesigning how repo-specific AI artifacts are identified and excluded from distribution. The change touches every layer of the system: artifact directories, collection manifests, plugin outputs, extension packaging, validation scripts, tests, and documentation.

Previously, all RPI workflow agents, prompts, and instructions lived under .github/{type}/rpi/ directories, and repo-specific artifacts were identified by living under an hve-core/ subdirectory. This created a collision: the hve-core/ name was simultaneously used for repo-internal exclusions and as the natural identity for the flagship collection.

The restructuring resolves this by:

  • Moving all .github/{type}/rpi/ directories to .github/{type}/hve-core/, making the collection identity match the project name.

  • Replacing the subdirectory-based exclusion convention with root-level detection. Repo-specific artifacts now live directly at the root of .github/agents/, .github/instructions/, .github/prompts/, or .github/skills/ (no subdirectory). Collection-scoped, distributable artifacts reside in subdirectories like hve-core/, ado/, shared/, etc.

  • Updating the exclusion functions Test-HveCoreRepoSpecificPath (from $RelativePath -like 'hve-core/*' to $RelativePath -notlike '*/*') and Test-HveCoreRepoRelativePath (from .github/.*/hve-core/ regex to ^\.github/(agents|instructions|prompts|skills)/[^/]+$).

  • Renaming rpi.collection.yml to hve-core.collection.yml with updated metadata, and creating the corresponding plugins/hve-core/ output directory while removing plugins/rpi/.

  • Reassigning the flagship extension identity from hve-core-all to hve-core, so the hve-core collection now produces extension/package.json and extension/README.md (the default extension artifacts), while hve-core-all gets explicit package.hve-core-all.json and README.hve-core-all.md files.

  • Updating marketplace.json to register the new hve-core plugin entry and remove the rpi entry.

  • Updating VS Code settings (.vscode/settings.json) to point at the new hve-core directories instead of rpi.

  • Updating all internal cross-references within agents, subagents, documentation, the installer agent, workflow README, and contributing guides to use hve-core/ paths.

  • Rewriting all affected tests across PluginHelpers.Tests.ps1, Validate-Collections.Tests.ps1, and Prepare-Extension.Tests.ps1 to validate the new root-level exclusion convention and updated collection identity.

Related Issue(s)

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)

Note for AI Artifact Contributors:

  • Agents: Research, indexing/referencing other project (using standard VS Code GitHub Copilot/MCP tools), planning, and general implementation agents likely already exist. Review .github/agents/ before creating new ones.
  • Skills: Must include both bash and PowerShell scripts. See Skills.
  • Model Versions: Only contributions targeting the latest Anthropic and OpenAI models will be accepted. Older model versions (e.g., GPT-3.5, Claude 3) will be rejected.
  • See Agents Not Accepted and Model Version Requirements.

Other:

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

Sample Prompts (for AI Artifact Contributions)

Not applicable — this PR renames and restructures existing artifacts without changing their behavior. All agents, prompts, and instructions retain their original functionality under new paths.

Testing

  • PluginHelpers.Tests.ps1 — 46/46 passing, validates root-level exclusion logic (Test-HveCoreRepoSpecificPath, Test-HveCoreRepoRelativePath) and Get-ArtifactFiles filtering.
  • Validate-Collections.Tests.ps1 — 18/18 passing, validates that root-level repo-specific paths are rejected from collection manifests while subdirectory paths are accepted.
  • Prepare-Extension.Tests.ps1 — 131/131 passing, validates updated flagship collection identity, extension packaging, collection generation, and maturity filtering with hve-core as the default collection.

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
  • Skill structure validation: npm run validate:skills
  • Link validation: npm run lint:md-links
  • PowerShell analysis: npm run lint:ps

GHCP Artifact Maturity

Warning

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

  • .github/agents/hve-core/doc-ops.agent.md
  • .github/prompts/hve-core/checkpoint.prompt.md
File Type Maturity Notes
.github/agents/hve-core/doc-ops.agent.md Agent ⚠️ experimental Renamed from rpi/
.github/agents/hve-core/memory.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/pr-review.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/prompt-builder.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/rpi-agent.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/task-implementor.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/task-planner.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/task-researcher.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/task-reviewer.agent.md Agent ✅ stable Renamed from rpi/
.github/agents/hve-core/subagents/prompt-evaluator.agent.md Agent ✅ stable Renamed from rpi/subagents/
.github/agents/hve-core/subagents/prompt-updater.agent.md Agent ✅ stable Renamed from rpi/subagents/
.github/prompts/hve-core/checkpoint.prompt.md Prompt ⚠️ experimental Renamed from rpi/
.github/prompts/hve-core/task-research.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/task-plan.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/task-implement.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/task-review.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/pull-request.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/git-commit.prompt.md Prompt ✅ stable Renamed from rpi/
.github/prompts/hve-core/git-merge.prompt.md Prompt ✅ stable Renamed from rpi/
.github/instructions/hve-core/commit-message.instructions.md Instructions ✅ stable Renamed from rpi/
.github/instructions/hve-core/git-merge.instructions.md Instructions ✅ stable Renamed from rpi/
.github/instructions/hve-core/markdown.instructions.md Instructions ✅ stable Renamed from rpi/
.github/instructions/hve-core/prompt-builder.instructions.md Instructions ✅ stable Renamed from rpi/
.github/instructions/hve-core/writing-style.instructions.md Instructions ✅ stable Renamed from rpi/
.github/instructions/workflows.instructions.md Instructions ✅ stable Moved to root-level (repo-specific)

GHCP Maturity Acknowledgment

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

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

  • Plugin installation command changed: copilot plugin install rpi@hve-core becomes copilot plugin install hve-core@hve-core.
  • VS Code settings paths changed: Users referencing rpi directories in chat.agentFilesLocations, chat.promptFilesLocations, or chat.instructionsFilesLocations must update to hve-core.
  • The workflows.instructions.md file moved from .github/instructions/hve-core/ (collection-scoped) to .github/instructions/ (root-level, repo-specific), reflecting that it applies only to this repository's CI workflows.

🔄 - Generated by Copilot

- move .github/**/rpi/ directories to .github/**/hve-core/
- rename rpi.collection.yml to hve-core.collection.yml with updated metadata
- rename exclusion convention from hve-core/ to _repo/ across scripts and tests
- reassign flagship extension name from hve-core-all to hve-core collection
- update all cross-references in agents, docs, settings, and installer

🔄 - Generated by Copilot
…lines

- refine exclusion criteria for artifacts in .github directories
- clarify that root-level artifacts are repo-specific and excluded from collection manifests
- update related documentation and validation scripts to reflect new structure
- enhance tests to ensure proper exclusion of repo-specific artifacts

🔒 - Generated by Copilot
…ore collections

- change references from rpi to hve-core in instructions and prompts
- remove obsolete workflows instructions from collection manifest
- clarify repo-specific instructions and their distribution scope

🔧 - Generated by Copilot
@agreaves-ms agreaves-ms requested a review from a team as a code owner February 19, 2026 06:45
@github-actions
Copy link
Contributor

Dependency Review

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

Scanned Files

None

@codecov-commenter
Copy link

Codecov Report

❌ Patch coverage is 76.66667% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 85.25%. Comparing base (11b93cb) to head (d68caf7).

Files with missing lines Patch % Lines
scripts/extension/Prepare-Extension.ps1 73.07% 7 Missing ⚠️
Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #668      +/-   ##
==========================================
- Coverage   85.84%   85.25%   -0.59%     
==========================================
  Files          24       24              
  Lines        4769     4776       +7     
==========================================
- Hits         4094     4072      -22     
- Misses        675      704      +29     
Flag Coverage Δ
pester 85.25% <76.66%> (-0.59%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
scripts/extension/Package-Extension.ps1 95.10% <100.00%> (ø)
scripts/plugins/Modules/PluginHelpers.psm1 88.50% <100.00%> (-8.37%) ⬇️
scripts/plugins/Validate-Collections.ps1 69.56% <100.00%> (ø)
scripts/extension/Prepare-Extension.ps1 91.78% <73.07%> (-0.74%) ⬇️

... and 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.

Copy link
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.

I love the 'Flagship RPI' naming into HVE-CORE.
You have outdone yourself on this PR, either my agent friend or myself could not find any missing updates or discrepancies in docs/packaging. Thank you!

@katriendg katriendg merged commit 120dde0 into main Feb 19, 2026
19 checks passed
WilliamBerryiii pushed a commit that referenced this pull request Feb 20, 2026
🤖 I have created a release *beep* *boop*
---


##
[3.0.0](hve-core-v2.3.10...hve-core-v3.0.0)
(2026-02-20)


### ⚠ BREAKING CHANGES

* **skills:** migrate PR reference generation to self-contained skill
([#669](#669))
* restructure RPI collection to HVE Core naming convention
([#668](#668))

### ✨ Features

* **agents:** add agile-coach agent
([#562](#562))
([de8d86c](de8d86c))
* **agents:** add DT coach agent with tiered instruction loading
([#656](#656))
([206d3a7](206d3a7))
* **agents:** add product manager advisor and UX/UI designer agents
([#627](#627))
([539eb8a](539eb8a))
* **agents:** add system architecture reviewer for design trade-offs and
ADR creation ([#626](#626))
([de5cfd6](de5cfd6))
* **build:** pin devcontainer image and align tool parity
([#704](#704))
([6258b1c](6258b1c))
* **design-thinking:** add manufacturing industry context template
([#682](#682))
([ce864bf](ce864bf))
* **instructions:** add DT coaching state protocol for session
persistence ([#654](#654))
([5a5be4e](5a5be4e))
* **instructions:** add dt-coaching-identity ambient instruction
([#642](#642))
([6209a0d](6209a0d))
* **instructions:** add dt-method-01-deep for advanced scope
conversation techniques
([#673](#673))
([cc92ef9](cc92ef9))
* **instructions:** add dt-method-03-deep for advanced input synthesis
techniques ([#676](#676))
([0079a4f](0079a4f))
* **instructions:** add dt-method-09-deep instructions for Method 9
advanced coaching
([#703](#703))
([150b2a6](150b2a6))
* **instructions:** add dt-method-sequencing ambient instruction
([#650](#650))
([e465b2f](e465b2f))
* **instructions:** add dt-quality-constraints and design-thinking
collection ([#645](#645))
([17002bd](17002bd))
* **instructions:** add DT-to-RPI handoff contract specification
([#679](#679))
([87f9962](87f9962))
* **instructions:** add energy industry context template
([#687](#687))
([41088d8](41088d8))
* **instructions:** add healthcare industry context template
([#686](#686))
([b2d5281](b2d5281))
* **instructions:** add Method 1 Scope Conversations coaching knowledge
([#651](#651))
([93e2d48](93e2d48))
* **instructions:** add Method 2 Design Research coaching knowledge
([#652](#652))
([30f7f3b](30f7f3b))
* **instructions:** add Method 3 Input Synthesis coaching knowledge
([#653](#653))
([1efdb7d](1efdb7d))
* **instructions:** add Method 7 High-Fidelity Prototypes coaching
instruction ([#666](#666))
([9233eab](9233eab))
* **instructions:** add pull request instructions for PR generation
workflow ([#706](#706))
([73d23eb](73d23eb))
* **instructions:** create DT curriculum content (9 modules)
([#690](#690))
([9f7378f](9f7378f)),
closes [#617](#617)
* **instructions:** create dt-method-02-deep.instructions.md
([#700](#700))
([4d4d0ca](4d4d0ca))
* **instructions:** create dt-method-06-lofi-prototypes.instructions.md
([#684](#684))
([4d5f757](4d5f757))
* **instructions:** create dt-method-07-deep.instructions.md
([#678](#678))
([d3ec70d](d3ec70d))
* **instructions:** Create dt-method-08-deep.instructions.md
([#683](#683))
([d9e1115](d9e1115))
* **instructions:** create dt-method-08-testing.instructions.md
([#681](#681))
([3008ad8](3008ad8))
* **instructions:** create dt-method-09-iteration.instructions.md
([#685](#685))
([9d7f4f5](9d7f4f5))
* **instructions:** create dt-rpi-research-context.instructions.md
([#689](#689))
([34c7b89](34c7b89))
* **instructions:** create manufacturing reference learning scenario
([#692](#692))
([1bd3994](1bd3994))
* **instructions:** Design Thinking Method 4 brainstorming instruction
file ([#664](#664))
([06f90b0](06f90b0))
* **prompts:** add DT start-project prompt for coaching initialization
([#657](#657))
([ce583d5](ce583d5))
* **prompts:** add dt-resume-coaching prompt for session recovery
([#665](#665))
([11b93cb](11b93cb))
* **prompts:** create dt-handoff-problem-space.prompt.md
([#688](#688))
([277963d](277963d))
* **scripts:** add collection-level maturity field with validation,
gating, and notices
([#697](#697))
([7b1c8e8](7b1c8e8))
* **scripts:** add per-violation CI annotations and colorized console
output ([#637](#637))
([bd7d512](bd7d512))
* **skills:** edit SKILL frontmatter schema, add CI validation, and
documentation ([#625](#625))
([0138a78](0138a78))
* **skills:** mandate unit testing and document language support
([#636](#636))
([9263617](9263617))
* **skills:** migrate PR reference generation to self-contained skill
([#669](#669))
([cf8805f](cf8805f))


### 🐛 Bug Fixes

* **collections:** migrate artifacts into collection-based
subdirectories
([#658](#658))
([dfa5261](dfa5261))
* **instructions:** optimize Phase 1 DT token budgets and close
[#564](https://github.com/microsoft/hve-core/issues/564)/[#565](https://github.com/microsoft/hve-core/issues/565)
gaps ([#675](#675))
([4f42f00](4f42f00))
* **scripts:** add CI annotations and step summary to copyright header
check ([#638](#638))
([5fa6328](5fa6328))
* **scripts:** add grouped link-lang console diagnostics and failure
summary ([#661](#661))
([4d6871f](4d6871f))
* **scripts:** add per-violation Write-Host and Write-CIAnnotation
output to Test-DependencyPinning
([#640](#640))
([9d3b71d](9d3b71d))
* **scripts:** align agent frontmatter schema with VS Code spec
([#469](#469))
([254d445](254d445))
* **scripts:** optimize PSScriptAnalyzer linting performance in WSL2
([#667](#667))
([f120b93](f120b93))
* **scripts:** stabilize YAML display key ordering in collection
manifest ([#701](#701))
([73c0d2c](73c0d2c))
* **scripts:** use text stubs for plugin links when symlinks unavailable
([#695](#695))
([d7650a3](d7650a3))
* **skills:** fix powershell test coverage in pr-reference skill
([#699](#699))
([408e6b7](408e6b7))


### 📚 Documentation

* **dt:** add Method 5 Concepts and Method 6 Lo-Fi Prototypes
instructions ([#693](#693))
([cfdcf11](cfdcf11))
* **hve-guide:** add role-based guides and project lifecycle
documentation ([#663](#663))
([17a85da](17a85da))


### ♻️ Refactoring

* restructure RPI collection to HVE Core naming convention
([#668](#668))
([120dde0](120dde0))
* **scripts:** consolidate duplicate logging into shared SecurityHelpers
module ([#655](#655))
([627a877](627a877))
* **scripts:** use shared SecurityHelpers and CIHelpers modules in
security scripts
([#705](#705))
([3a0baa7](3a0baa7))


### 🔧 Maintenance

* **deps-dev:** bump markdownlint-cli2 from 0.20.0 to 0.21.0 in the
npm-dependencies group
([#609](#609))
([1486dd7](1486dd7))

---
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.

3 participants