Skip to content

feat(collections): auto-generate collection.md with maturity filtering #1316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
WilliamBerryiii wants to merge 4 commits into
base: main
Choose a base branch
from
Open

feat(collections): auto-generate collection.md with maturity filtering #1316

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7f3ad23
feat(scripts): add maturity filtering and auto-generated artifact mar…
Apr 7, 2026
3e72bbc
fix(scripts): address 7 review findings from task validation
Apr 7, 2026
9720cd6
refactor(scripts): centralize marker constants and extract shared hel…
Apr 10, 2026
1ec452c
chore(docs): regenerate collection.md artifact tables
Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 43 additions & 6 deletions collections/ado.collection.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,46 @@
Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies — all from within VS Code.

This collection includes agents and prompts for:
<!-- BEGIN AUTO-GENERATED ARTIFACTS -->

- **Work Item Management** — Discover, create, update, and plan work items across ADO projects
- **Build Monitoring** — Query build status, review logs, and diagnose failures
- **Pull Request Creation** — Generate PRs with linked work items and reviewer identification
- **PRD-to-Work-Item Conversion** — Transform Product Requirements Documents into ADO feature/user-story/task hierarchies
- **Backlog Management** — Orchestrated triage, discovery, sprint planning, and work item creation workflows through a central ADO Backlog Manager agent
### Chat Agents

| Name | Description |
|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| **ado-backlog-manager** | Orchestrator agent for Azure DevOps backlog management workflows including triage, discovery, sprint planning, PRD-to-work-item conversion, and execution |
| **ado-prd-to-wit** | Product Manager expert for analyzing PRDs and planning Azure DevOps work item hierarchies |

### Prompts

| Name | Description |
|-------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
| **ado-add-work-item** | Create a single Azure DevOps work item with conversational field collection and parent validation |
| **ado-create-pull-request** | Generate pull request description, discover related work items, identify reviewers, and create Azure DevOps pull request with all linkages. |
| **ado-discover-work-items** | Discover Azure DevOps work items through user-centric queries, artifact-driven analysis, or search-based exploration |
| **ado-get-build-info** | Retrieve Azure DevOps build information for a Pull Request or specific Build Number. |
| **ado-get-my-work-items** | Retrieve user's current Azure DevOps work items and organize them into planning file definitions |
| **ado-process-my-work-items-for-task-planning** | Process retrieved work items for task planning and generate task-planning-logs.md handoff file |
| **ado-sprint-plan** | Plan an Azure DevOps sprint by analyzing iteration coverage, capacity, dependencies, and backlog gaps |
| **ado-triage-work-items** | Triage untriaged Azure DevOps work items with field classification, iteration assignment, and duplicate detection |
| **ado-update-wit-items** | Prompt to update work items based on planning files |

### Instructions

| Name | Description |
|-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **ado/ado-backlog-sprint** | Sprint planning workflow for Azure DevOps iterations with coverage analysis, capacity tracking, and gap detection |
| **ado/ado-backlog-triage** | Triage workflow for Azure DevOps work items with field classification, iteration assignment, and duplicate detection |
| **ado/ado-create-pull-request** | Required protocol for creating Azure DevOps pull requests with work item discovery, reviewer identification, and automated linking. |
| **ado/ado-get-build-info** | Required instructions for anything related to Azure Devops or ado build information including status, logs, or details from provided pullrequest (PR), build Id, or branch name. |
| **ado/ado-interaction-templates** | Work item description and comment templates for consistent Azure DevOps content formatting |
| **ado/ado-update-wit-items** | Work item creation and update protocol using MCP ADO tools with handoff tracking |
| **ado/ado-wit-discovery** | Protocol for discovering Azure DevOps work items via user assignment or artifact analysis with planning file output |
| **ado/ado-wit-planning** | Reference specification for Azure DevOps work item planning files, templates, field definitions, and search protocols |
| **shared/hve-core-location** | Important: hve-core is the repository containing this instruction file; Guidance: if a referenced prompt, instructions, agent, or script is missing in the current directory, fall back to this hve-core location by walking up this file's directory tree. |

### Skills

| Name | Description |
|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **pr-reference** | Generates PR reference XML containing commit history and unified diffs between branches with extension and path filtering. Includes utilities to list changed files by type and read diff chunks. Use when creating pull request descriptions, preparing code reviews, analyzing branch changes, discovering work items from diffs, or generating structured diff summaries. |

<!-- END AUTO-GENERATED ARTIFACTS -->
54 changes: 42 additions & 12 deletions collections/coding-standards.collection.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,17 +1,47 @@
Enforce language-specific coding conventions and best practices across your projects, with pre-PR code review agents for catching functional defects early. This collection provides instructions for bash, Bicep, C#, PowerShell, Python, Rust, and Terraform that are automatically applied based on file patterns, plus agents that review branch diffs before opening pull requests.

This collection includes:
<!-- BEGIN AUTO-GENERATED ARTIFACTS -->

- **Code Review Functional** — Pre-PR branch diff reviewer for functional correctness, error handling, edge cases, and testing gaps
- **Code Review Standards** — Skills-based code reviewer that enforces project-defined coding standards via dynamic skill loading
- **Code Review Full** — Orchestrates both functional and standards reviews in a single pass
### Chat Agents

Instructions for:
| Name | Description |
|----------------------------|---------------------------------------------------------------------------------------------------------------------------|
| **code-review-full** | Orchestrator that runs functional and standards code reviews via subagents and produces a merged report |
| **code-review-functional** | Pre-PR branch diff reviewer for functional correctness, error handling, edge cases, and testing gaps |
| **code-review-standards** | Skills-based code reviewer for local changes and PRs - applies project-defined coding standards via dynamic skill loading |

- **Bash** — Shell scripting conventions and best practices
- **Bicep** — Infrastructure as code implementation standards
- **C#** — Code and test conventions including nullable reference types, async patterns, and xUnit testing
- **PowerShell** — Script and module conventions including comment-based help, CmdletBinding, PSScriptAnalyzer compliance, and copyright headers
- **Python** — Scripting implementation with type hints, docstrings, uv project management, and pytest testing
- **Rust** — Rust development conventions targeting the 2021 edition
- **Terraform** — Infrastructure as code with provider configuration and module structure
### Prompts

| Name | Description |
|----------------------------|----------------------------------------------------------------------------------------------------|
| **code-review-full** | Run both functional and standards code reviews on the current branch in a single pass |
| **code-review-functional** | Pre-PR branch diff review for functional correctness, error handling, edge cases, and testing gaps |

### Instructions

| Name | Description |
|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **coding-standards/bash/bash** | Instructions for bash script implementation |
| **coding-standards/bicep/bicep** | Instructions for Bicep infrastructure as code implementation |
| **coding-standards/code-review/diff-computation** | Shared diff computation protocol for code review agents - branch detection, scope locking, large diff handling, and non-source artifact filtering |
| **coding-standards/code-review/review-artifacts** | Shared review artifact persistence protocol for code review agents - folder structure, metadata schema, verdict normalization, and writing rules |
| **coding-standards/csharp/csharp** | Required instructions for C# (CSharp) research, planning, implementation, editing, or creating |
| **coding-standards/csharp/csharp-tests** | Required instructions for C# (CSharp) test code research, planning, implementation, editing, or creating |
| **coding-standards/powershell/pester** | Instructions for Pester testing conventions |
| **coding-standards/powershell/powershell** | Instructions for PowerShell scripting implementation |
| **coding-standards/python-script** | Instructions for Python scripting implementation |
| **coding-standards/python-tests** | Required instructions for Python test code research, planning, implementation, editing, or creating |
| **coding-standards/rust/rust** | Required instructions for Rust research, planning, implementation, editing, or creating |
| **coding-standards/rust/rust-tests** | Required instructions for Rust test code research, planning, implementation, editing, or creating |
| **coding-standards/terraform/terraform** | Instructions for Terraform infrastructure as code implementation |
| **coding-standards/uv-projects** | Create and manage Python virtual environments using uv commands |
| **shared/hve-core-location** | Important: hve-core is the repository containing this instruction file; Guidance: if a referenced prompt, instructions, agent, or script is missing in the current directory, fall back to this hve-core location by walking up this file's directory tree. |

### Skills

| Name | Description |
|-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **pr-reference** | Generates PR reference XML containing commit history and unified diffs between branches with extension and path filtering. Includes utilities to list changed files by type and read diff chunks. Use when creating pull request descriptions, preparing code reviews, analyzing branch changes, discovering work items from diffs, or generating structured diff summaries. |
| **python-foundational** | Foundational Python best practices, idioms, and code quality fundamentals |

<!-- END AUTO-GENERATED ARTIFACTS -->
Loading
Loading