feat(hve-core-guidance-instructions): update guidance artifacts and MCP config

[agreaves-ms]

feat(hve-core-guidance-instructions): update guidance artifacts and MCP config

Description

This PR updated guidance artifacts for subagent behavior and location fallback rules, and expanded MCP configuration inputs and servers.

• Added the agent frontmatter field to the pull request prompt definition.
• Added HVE Core location guidance instructions for missing prompt, instruction, agent, or script lookups.
• Clarified runSubagent limitations when dispatching subagents in the RPI agent guidance.
• Expanded .vscode/mcp.json with Azure DevOps inputs and new MCP servers for Terraform, Context7, Microsoft Docs, and Azure DevOps.

Details

This works by abusing this part of the System Message for GitHub Copilot:

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)

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

User Request:
Generate a PR description from pr-reference.xml and ensure it follows the repository template.

Execution Flow:

• Read pr-reference.xml to capture commit history and diffs.
• Detect AI artifact changes and apply template checkboxes.
• Produce a complete PR description with the required sections.

Output Artifacts:

• pr.md

Success Indicators:

• The PR description uses the repository template and reflects all significant changes from pr-reference.xml.

For detailed contribution requirements, see:

• Common Standards: docs/contributing/ai-artifacts-common.md - Shared standards for XML blocks, markdown quality, RFC 2119, validation, and testing
• Agents: docs/contributing/custom-agents.md - Agent configurations with tools and behavior patterns
• Prompts: docs/contributing/prompts.md - Workflow-specific guidance with template variables
• Instructions: docs/contributing/instructions.md - Technology-specific standards with glob patterns

Testing

Not run (not requested).

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

[github-actions]

Dependency Review

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

Scanned Files

None

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 60.93%. Comparing base (1dd31ad) to head (b299a45).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #402      +/-   ##
==========================================
- Coverage   60.96%   60.93%   -0.04%     
==========================================
  Files          19       19              
  Lines        3233     3233              
==========================================
- Hits         1971     1970       -1     
- Misses       1262     1263       +1     

Flag	Coverage Δ
pester	60.93% <ø> (-0.04%)	⬇️

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.

[Copilot]

Pull request overview

This PR adds an agent frontmatter field to the pull request prompt, introduces HVE Core location fallback guidance for missing artifacts, and clarifies runSubagent limitations when dispatching subagents in the RPI agent.

Changes:

• Added agent: agent frontmatter field to the pull request prompt definition
• Created new location fallback instructions for missing prompts, instructions, agents, or scripts
• Enhanced RPI agent guidance to inform subagents about runSubagent unavailability

Reviewed changes

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

File	Description
.github/prompts/pull-request.prompt.md	Added agent frontmatter field to delegate prompt execution to an agent
.github/instructions/hve-core-location.instructions.md	New instruction file providing fallback guidance for locating missing artifacts
.github/agents/rpi-agent.agent.md	Added clarification about subagent runSubagent limitations when dispatching

[katriendg]

Nice approach!
Approving but note you may need to update your PR description around MCP settings, no mcp.json file is part of this PR as far as I see...