PR Summary

Backport of PowerShell#26219 adding automated markdown link verification infrastructure to release/v7.5.

Triggered by @TravisEz13 on behalf of @TravisEz13

Original CL Label: CL-General

/cc @PowerShell/powershell-maintainers

PR Context

Adds GitHub Actions workflow and PowerShell scripts to automatically verify markdown links in PRs, catching broken links before merge. Includes parameter naming convention instructions.

Changes:

• New .github/actions/infrastructure/markdownlinks/ action with PowerShell-based link parser and verifier
• Workflow runs on markdown changes, PRs, and weekly schedule to catch link rot
• Instruction file for PowerShell parameter naming conventions

Backport Details:

• Cherry-picked cleanly with no conflicts
• 6 files, 916 insertions
• Merge commit: 7bcdda7
• Low risk: tooling-only, no runtime code changes

Agent Improvement Prompt:

The backport process revealed areas for enhancement in .github/agents/backport-agent.md:

1. Branch divergence issue: Agent uses git reset --hard which causes divergence when branch exists on origin, preventing push. Need pre-flight check and alternative approach.
2. Missing instruction files: Agent references non-existent files under .github/instructions/backports/. Create these or update agent to reference actual .github/prompts/backport-pr-to-release-branch.prompt.md.
3. Branch naming: Current branch copilot/backport-powershell-26219 lacks explicit version indicator. Enforce pattern like copilot/backport-pr-{PR#}-to-v{VERSION}.
4. CL label detection: No guidance for detecting original PR's CL label without gh CLI access. Need git-based or API alternatives.
5. Risk/impact templates: Add structured criteria and decision trees for consistency across backports.

Suggested task: "Update backport agent to prevent branch divergence, standardize naming conventions with version indicators, create missing instruction files, and add CL label detection methods without GitHub CLI dependency."

PR Checklist

• PR has a meaningful title
• Summarized changes
• Make sure all .h, .cpp, .cs, .ps1 and .psm1 files have the correct copyright header
• This PR is ready to merge
• Breaking changes
  • None
• User-facing changes
  • Not Applicable
• Testing - New and feature
  • N/A or can only be tested interactively

Custom agent used: backport-agent
Specialized agent for backporting merged PRs to PowerShell release branches using git cherry-pick workflow

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.