refactor(agents): reorganize AI artifacts from hve-core into shared collection subdirectories

.github/agents/hve-core/doc-ops.agent.md → .github/agents/shared/doc-ops.agent.md

@@ -147,7 +147,7 @@ Run three `researcher-subagent` agents in parallel with `runSubagent` or `task`
 Run a `researcher-subagent` agent with:
 
 * Task: Scan all in-scope files for divergences from writing-style.instructions.md and markdown.instructions.md.
-* Instructions to read: [writing-style.instructions.md](.github/instructions/hve-core/writing-style.instructions.md), [markdown.instructions.md](.github/instructions/hve-core/markdown.instructions.md).
+* Instructions to read: [writing-style.instructions.md](.github/instructions/shared/writing-style.instructions.md), [markdown.instructions.md](.github/instructions/shared/markdown.instructions.md).
 * File scope: All files matching Included Files patterns, excluding Excluded Files patterns.
 * Response format: List each issue with file path, line number, violation type, and suggested fix.
 * Requirement: Indicate whether additional passes are needed and report total issue count.
@@ -209,7 +209,7 @@ If using the `runSubagent` tool then include instructions for each to read and f
 Each `phase-implementor` agent receives:
 
 * Task: Execute assigned work items from the plan.
-* Instructions to follow: [writing-style.instructions.md](.github/instructions/hve-core/writing-style.instructions.md), [markdown.instructions.md](.github/instructions/hve-core/markdown.instructions.md).
+* Instructions to follow: [writing-style.instructions.md](.github/instructions/shared/writing-style.instructions.md), [markdown.instructions.md](.github/instructions/shared/markdown.instructions.md).
 * Work items: Specific numbered items from the plan.
 * Response format: Report each change with file path, change description, and completion status.
 * Requirement: Report any new issues discovered during implementation and whether additional passes are needed.
@@ -257,8 +257,8 @@ Prompt:
 You are a documentation discovery subagent. Your task is to [CAPABILITY FOCUS].
 
 Read and apply conventions from:
-- .github/instructions/hve-core/writing-style.instructions.md
-- .github/instructions/hve-core/markdown.instructions.md
+- .github/instructions/shared/writing-style.instructions.md
+- .github/instructions/shared/markdown.instructions.md
 
 Scope: Process only these file patterns:
 [IN-SCOPE PATTERNS]
@@ -316,8 +316,8 @@ Prompt:
 You are a documentation implementation subagent. Execute fixes from the work plan.
 
 Read and follow conventions from:
-- .github/instructions/hve-core/writing-style.instructions.md
-- .github/instructions/hve-core/markdown.instructions.md
+- .github/instructions/shared/writing-style.instructions.md
+- .github/instructions/shared/markdown.instructions.md
 
 Work items to complete:
 [NUMBERED WORK ITEMS]
@@ -410,4 +410,4 @@ When all phases complete, provide:
 | Validation Status | Passed, Failed with count, or Partial       |
 | Followup Items    | Count requiring manual intervention         |
 
-Suggest a commit message following [commit-message.instructions.md](.github/instructions/hve-core/commit-message.instructions.md). Exclude `.copilot-tracking/` files from the commit.
+Suggest a commit message following [commit-message.instructions.md](.github/instructions/shared/commit-message.instructions.md). Exclude `.copilot-tracking/` files from the commit.

.github/agents/hve-core/rpi-agent.agent.md → .github/agents/shared/rpi-agent.agent.md

@@ -341,7 +341,7 @@ Compile all validation findings into a review log at `.copilot-tracking/reviews/
 
 Determine next action based on review status:
 
-* Complete (no critical or major findings): present a commit message in a markdown code block following `.github/instructions/hve-core/commit-message.instructions.md`, excluding `.copilot-tracking` files. Proceed to Phase 5 to discover next work items.
+* Complete (no critical or major findings): present a commit message in a markdown code block following `.github/instructions/shared/commit-message.instructions.md`, excluding `.copilot-tracking` files. Proceed to Phase 5 to discover next work items.
 * Iterate (critical or major findings require fixes): return to Phase 3 Step 2 with specific fixes from review findings.
 * Escalate (deeper research or plan revision needed): return to Phase 1 or Phase 2.
 
@@ -465,7 +465,7 @@ When Phase 4 (Review) completes, follow the appropriate pattern:
 
 | Status   | Action                 | Template                                                                                                                                                                                                                         |
 |----------|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Complete | Proceed to Phase 5     | Show summary with iteration count, files changed, artifact paths. Include commit message in a markdown code block following `.github/instructions/hve-core/commit-message.instructions.md`, excluding `.copilot-tracking` files. |
+| Complete | Proceed to Phase 5     | Show summary with iteration count, files changed, artifact paths. Include commit message in a markdown code block following `.github/instructions/shared/commit-message.instructions.md`, excluding `.copilot-tracking` files. |
 | Iterate  | Return to Phase 3      | Show review findings and required fixes                                                                                                                                                                                          |
 | Escalate | Return to Phase 1 or 2 | Show identified gap and investigation focus                                                                                                                                                                                      |
 

.github/agents/hve-core/subagents/prompt-evaluator.agent.md → .github/agents/shared/subagents/prompt-evaluator.agent.md

@@ -38,8 +38,8 @@ Create and update an *evaluation-log.md* file in the sandbox folder and progress
 ### Pre-requisite: Load Evaluation Context
 
 1. Create the evaluation log with placeholders if it does not already exist.
-2. Read and follow instructions from `.github/instructions/hve-core/prompt-builder.instructions.md` in full for prompt engineering quality standards.
-3. Read and follow instructions from `.github/instructions/hve-core/writing-style.instructions.md` in full for style standards.
+2. Read and follow instructions from `.github/instructions/shared/prompt-builder.instructions.md` in full for prompt engineering quality standards.
+3. Read and follow instructions from `.github/instructions/shared/writing-style.instructions.md` in full for style standards.
 
 ### Step 1: Evaluate Execution Log Findings
 

.github/agents/hve-core/subagents/prompt-updater.agent.md → .github/agents/shared/subagents/prompt-updater.agent.md

@@ -38,8 +38,8 @@ Create and update a tracking file(s) located at `.copilot-tracking/prompts/{{YYY
 ### Pre-requisite: Prepare Prompt and Tracking File(s)
 
 1. Interpret the provided details and determine which prompt files require modification or creation.
-2. Read and follow instructions from `.github/instructions/hve-core/prompt-builder.instructions.md` in full for prompt engineering quality standards.
-3. Read and follow instructions from `.github/instructions/hve-core/writing-style.instructions.md` in full for style standards.
+2. Read and follow instructions from `.github/instructions/shared/prompt-builder.instructions.md` in full for prompt engineering quality standards.
+3. Read and follow instructions from `.github/instructions/shared/writing-style.instructions.md` in full for style standards.
 4. Create the prompt file(s) with placeholders if they do not already exist.
 5. Create the prompt updater tracking file(s) with placeholders if they do not already exist.
 

.github/agents/hve-core/task-implementor.agent.md → .github/agents/shared/task-implementor.agent.md

@@ -28,7 +28,7 @@ Every implementation produces self-sufficient, working code aligned with impleme
 * Avoid partial implementations that leave completed steps in an indeterminate state.
 * Implement only what the implementation details specify.
 * Review existing tests and scripts for updates rather than creating new ones.
-* Follow commit-message conventions from `.github/instructions/hve-core/commit-message.instructions.md`.
+* Follow commit-message conventions from `.github/instructions/shared/commit-message.instructions.md`.
 * Reference relevant guidance in `.github/instructions/**` before editing code.
 * Run subagents for inline research when context is missing.
 
@@ -158,7 +158,7 @@ Review planning files and interpret the work completed. Present completion using
 
 * Present phase and step completion summary.
 * Include outstanding clarification requests or blockers.
-* Provide commit message in a markdown code block following `.github/instructions/hve-core/commit-message.instructions.md`, excluding `.copilot-tracking` files.
+* Provide commit message in a markdown code block following `.github/instructions/shared/commit-message.instructions.md`, excluding `.copilot-tracking` files.
 * Offer next steps: plan with `/task-plan`, research with `/task-research`, review with `/task-review`, or continue implementation from updated planning files.
 
 ## User Interaction

.github/copilot-instructions.md

@@ -95,7 +95,7 @@ All tracking files use markdown format with frontmatter and follow patterns from
 
 ### Agents and Subagents
 
-By convention, custom agents are organized under `.github/agents/{collection-id}/`. Each collection typically places its agents in a dedicated subdirectory (e.g., `.github/agents/hve-core/`, `.github/agents/ado/`). Subagents are typically organized under `.github/agents/{collection-id}/subagents/`.
+By convention, custom agents are organized under `.github/agents/{collection-id}/`. Each collection typically places its agents in a dedicated subdirectory (e.g., `.github/agents/shared/`, `.github/agents/ado/`). Subagents are typically organized under `.github/agents/{collection-id}/subagents/`.
 Parent agents reference subagents using glob paths like `.github/agents/**/researcher-subagent.agent.md` so resolution works regardless of nesting depth.
 
 Collection manifests in `collections/` define bundles of agents, prompts, instructions, and skills:

.github/instructions/README.md

@@ -1,3 +1,3 @@
 ---
 title: GitHub Copilot Instructions
 description: Repository-specific coding guidelines and conventions for GitHub Copilot
@@ -141,6 +141,8 @@
 │   ├── markdown.instructions.md
 │   ├── prompt-builder.instructions.md
 │   └── writing-style.instructions.md
+├── project-planning/                      # Project planning
+│   └── story-quality.instructions.md
 ├── shared/                           # Cross-collection
 │   └── hve-core-location.instructions.md
 └── README.md

.github/instructions/ado/ado-backlog-sprint.instructions.md

@@ -5,7 +5,7 @@ applyTo: '**/.copilot-tracking/workitems/sprint/**'
 
 # ADO Sprint Planning
 
-Plan Azure DevOps iterations by analyzing work item coverage, capacity, dependencies, and gaps. Follow all instructions from #file:./ado-wit-planning.instructions.md while executing this workflow. Apply story quality conventions from #file:../shared/story-quality.instructions.md when assessing backlog items and grooming recommendations.
+Plan Azure DevOps iterations by analyzing work item coverage, capacity, dependencies, and gaps. Follow all instructions from #file:./ado-wit-planning.instructions.md while executing this workflow. Apply story quality conventions from #file:../project-planning/story-quality.instructions.md when assessing backlog items and grooming recommendations.
 
 ## Required Phases
 

.github/instructions/hve-core/prompt-builder.instructions.md → .github/instructions/shared/prompt-builder.instructions.md

@@ -143,7 +143,7 @@ Characteristics:
 
 * Optionally include `user-invocable: false` frontmatter to prevent direct user invocation.
 * Frontmatter includes `tools:` listing the tools available to the subagent.
-* Typically live under a `subagents/` subdirectory within their collection folder (for example, `.github/agents/hve-core/subagents/`) to separate them from user-facing agents.
+* Typically live under a `subagents/` subdirectory within their collection folder (for example, `.github/agents/shared/subagents/`) to separate them from user-facing agents.
 * Parent agents declare subagent dependencies in their `agents:` frontmatter using the human-readable name from each subagent's `name:` frontmatter.
 * Referenced using glob paths like `.github/agents/**/name.agent.md` so resolution works regardless of whether the subagent is at the root or in the `subagents/` folder.
 * Cannot run their own subagents; only the parent agent orchestrates subagent calls.

.github/instructions/hve-core/pull-request.instructions.md → .github/instructions/shared/pull-request.instructions.md

@@ -72,7 +72,7 @@ Validate that the working branch is current with the base branch before generati
 5. Execute the selected strategy:
    * Merge: `git merge --no-edit ${baseRef}`
    * Rebase: `git rebase --empty=drop --reapply-cherry-picks ${baseRef}`
-6. If conflicts occur, follow `.github/instructions/hve-core/git-merge.instructions.md` before continuing.
+6. If conflicts occur, follow `.github/instructions/shared/git-merge.instructions.md` before continuing.
 
 Exit criteria:
 

.github/prompts/hve-core/git-commit-message.prompt.md

@@ -5,7 +5,7 @@ description: 'Generates a commit message following the commit-message.instructio
 
 # Generate Commit Message
 
-Follow all instructions from #file:../../instructions/hve-core/commit-message.instructions.md
+Follow all instructions from #file:../../instructions/shared/commit-message.instructions.md
 
 ## Input
 

.github/prompts/hve-core/git-commit.prompt.md

@@ -5,7 +5,7 @@ description: 'Stages all changes, generates a conventional commit message, shows
 
 # Stage, Generate, and Commit
 
-Must follow all instructions provided by #file:../../instructions/hve-core/commit-message.instructions.md
+Must follow all instructions provided by #file:../../instructions/shared/commit-message.instructions.md
 
 Protocol:
 

.github/prompts/hve-core/git-merge.prompt.md

@@ -5,7 +5,7 @@ description: 'Coordinate Git merge, rebase, and rebase --onto workflows with con
 
 # Git Merge & Rebase Orchestrator
 
-Follow all instructions from #file:../../instructions/hve-core/git-merge.instructions.md
+Follow all instructions from #file:../../instructions/shared/git-merge.instructions.md
 
 ## Overview
 

.github/skills/installer/hve-core-installer/SKILL.md

@@ -385,16 +385,18 @@ Enumerate each collection subdirectory under `.github/agents/`, `.github/prompts
 {
   "chat.agentFilesLocations": {
     "<PREFIX>/.github/agents/ado": true,
+    "<PREFIX>/.github/agents/coding-standards": true,
     "<PREFIX>/.github/agents/data-science": true,
     "<PREFIX>/.github/agents/design-thinking": true,
     "<PREFIX>/.github/agents/github": true,
     "<PREFIX>/.github/agents/project-planning": true,
-    "<PREFIX>/.github/agents/hve-core": true,
-    "<PREFIX>/.github/agents/hve-core/subagents": true,
+    "<PREFIX>/.github/agents/shared": true,
+    "<PREFIX>/.github/agents/shared/subagents": true,
     "<PREFIX>/.github/agents/security-planning": true
   },
   "chat.promptFilesLocations": {
     "<PREFIX>/.github/prompts/ado": true,
+    "<PREFIX>/.github/prompts/coding-standards": true,
     "<PREFIX>/.github/prompts/design-thinking": true,
     "<PREFIX>/.github/prompts/github": true,
     "<PREFIX>/.github/prompts/hve-core": true,
@@ -405,7 +407,8 @@ Enumerate each collection subdirectory under `.github/agents/`, `.github/prompts
     "<PREFIX>/.github/instructions/coding-standards": true,
     "<PREFIX>/.github/instructions/design-thinking": true,
     "<PREFIX>/.github/instructions/github": true,
-    "<PREFIX>/.github/instructions/hve-core": true,
+    "<PREFIX>/.github/instructions/shared": true,
+    "<PREFIX>/.github/instructions/project-planning": true,
     "<PREFIX>/.github/instructions/shared": true
   },
   "chat.agentSkillsLocations": {
@@ -471,16 +474,18 @@ Add to devcontainer.json:
       "settings": {
         "chat.agentFilesLocations": {
           "/workspaces/hve-core/.github/agents/ado": true,
+          "/workspaces/hve-core/.github/agents/coding-standards": true,
           "/workspaces/hve-core/.github/agents/data-science": true,
           "/workspaces/hve-core/.github/agents/design-thinking": true,
           "/workspaces/hve-core/.github/agents/github": true,
           "/workspaces/hve-core/.github/agents/project-planning": true,
-          "/workspaces/hve-core/.github/agents/hve-core": true,
-          "/workspaces/hve-core/.github/agents/hve-core/subagents": true,
+          "/workspaces/hve-core/.github/agents/shared": true,
+          "/workspaces/hve-core/.github/agents/shared/subagents": true,
           "/workspaces/hve-core/.github/agents/security-planning": true
         },
         "chat.promptFilesLocations": {
           "/workspaces/hve-core/.github/prompts/ado": true,
+          "/workspaces/hve-core/.github/prompts/coding-standards": true,
           "/workspaces/hve-core/.github/prompts/design-thinking": true,
           "/workspaces/hve-core/.github/prompts/github": true,
           "/workspaces/hve-core/.github/prompts/hve-core": true,
@@ -491,7 +496,8 @@ Add to devcontainer.json:
           "/workspaces/hve-core/.github/instructions/coding-standards": true,
           "/workspaces/hve-core/.github/instructions/design-thinking": true,
           "/workspaces/hve-core/.github/instructions/github": true,
-          "/workspaces/hve-core/.github/instructions/hve-core": true,
+          "/workspaces/hve-core/.github/instructions/shared": true,
+          "/workspaces/hve-core/.github/instructions/project-planning": true,
           "/workspaces/hve-core/.github/instructions/shared": true
         },
         "chat.agentSkillsLocations": {
@@ -1110,11 +1116,11 @@ Present upgrade summary:
 📋 Upgrade Summary
 
 Files to update (managed):
-  ✅ .github/agents/hve-core/task-researcher.agent.md
-  ✅ .github/agents/hve-core/task-planner.agent.md
+  ✅ .github/agents/shared/task-researcher.agent.md
+  ✅ .github/agents/shared/task-planner.agent.md
 
 Files requiring decision (modified):
-  ⚠️ .github/agents/hve-core/task-implementor.agent.md
+  ⚠️ .github/agents/shared/task-implementor.agent.md
 
 Files skipped (ejected):
   🔒 .github/agents/custom-agent.agent.md
@@ -1136,7 +1142,7 @@ When user requests diff:
 <!-- <diff-display> -->
 ```text
 ─────────────────────────────────────
-File: .github/agents/hve-core/task-implementor.agent.md
+File: .github/agents/shared/task-implementor.agent.md
 Status: modified
 ─────────────────────────────────────
 

.github/workflows/README.md

@@ -555,8 +555,8 @@ Use `continue-on-error: true` to prevent workflow failure on SARIF upload issues
 | `.markdownlint.json`                                  | Markdown formatting rules    | `markdown-lint.yml`         |
 | `scripts/linting/markdown-link-check.config.json`     | Link checking configuration  | `markdown-link-check.yml`   |
 | `.cspell.json`                                        | Spell checking configuration | `spell-check.yml`           |
-| `.github/instructions/hve-core/markdown.instructions.md`       | Markdown style guide         | All markdown workflows      |
-| `.github/instructions/hve-core/commit-message.instructions.md` | Commit message standards     | All workflows (informative) |
+| `.github/instructions/shared/markdown.instructions.md`       | Markdown style guide         | All markdown workflows      |
+| `.github/instructions/shared/commit-message.instructions.md` | Commit message standards     | All workflows (informative) |
 
 ## Resources
 

.markdownlint.json

@@ -154,14 +154,14 @@
         "message": "Do not use em dashes (—); use colons, commas, or parentheses instead",
         "searchPattern": "/—/g",
         "searchScope": "text",
-        "information": "https://github.com/microsoft/hve-core/blob/main/.github/instructions/hve-core/writing-style.instructions.md"
+        "information": "https://github.com/microsoft/hve-core/blob/main/.github/instructions/shared/writing-style.instructions.md"
       },
       {
         "name": "no-bolded-prefix-list",
         "message": "Do not use bolded-prefix list items (e.g., '* **Label**: desc'); use tables, headings, or plain lists",
         "searchPattern": "/\\*\\*[^*]+\\*\\*\\s*[:—–-]/g",
         "searchScope": "text",
-        "information": "https://github.com/microsoft/hve-core/blob/main/.github/instructions/hve-core/writing-style.instructions.md"
+        "information": "https://github.com/microsoft/hve-core/blob/main/.github/instructions/shared/writing-style.instructions.md"
       }
     ]
   }