diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc index 796345fe5..492b588f7 100644 --- a/.markdownlint-cli2.jsonc +++ b/.markdownlint-cli2.jsonc @@ -9,7 +9,6 @@ "extension/README.md", "extension/README.*.md", "extension/CHANGELOG.md", - "collections/*.collection.md", "plugins/**/agents/**", "plugins/**/instructions/**", "plugins/**/commands/**", diff --git a/collections/ado.collection.md b/collections/ado.collection.md index ebcbaed7c..9479f87f2 100644 --- a/collections/ado.collection.md +++ b/collections/ado.collection.md @@ -1,15 +1,17 @@ -Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies — all from within VS Code. +# Azure DevOps Integration + +Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies - all from within VS Code. -### Chat Agents +## 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 +## Prompts | Name | Description | |-------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| @@ -23,7 +25,7 @@ Manage Azure DevOps work items, monitor builds, create pull requests, and conver | **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 +## Instructions | Name | Description | |-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -37,7 +39,7 @@ Manage Azure DevOps work items, monitor builds, create pull requests, and conver | **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 +## Skills | Name | Description | |------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/coding-standards.collection.md b/collections/coding-standards.collection.md index 87d5b50e4..6fbe8936f 100644 --- a/collections/coding-standards.collection.md +++ b/collections/coding-standards.collection.md @@ -1,8 +1,10 @@ +# Coding Standards + 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. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------|---------------------------------------------------------------------------------------------------------------------------| @@ -10,14 +12,14 @@ Enforce language-specific coding conventions and best practices across your proj | **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 | -### Prompts +## 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 +## Instructions | Name | Description | |---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -37,7 +39,7 @@ Enforce language-specific coding conventions and best practices across your proj | **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 +## Skills | Name | Description | |-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/data-science.collection.md b/collections/data-science.collection.md index 97a01155b..e8e1ee4b8 100644 --- a/collections/data-science.collection.md +++ b/collections/data-science.collection.md @@ -1,3 +1,5 @@ +# Data Science + Generate data specifications, Jupyter notebooks, and Streamlit dashboards from natural language descriptions. Evaluate AI-powered data systems against Responsible AI standards. This collection includes specialized agents for data science workflows in Python and RAI assessment. > [!CAUTION] @@ -5,7 +7,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n -### Chat Agents +## Chat Agents | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -16,7 +18,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n | **researcher-subagent** | Research subagent using search tools, read tools, fetch web page, github repo, and mcp tools | | **test-streamlit-dashboard** | Automated testing for Streamlit dashboards using Playwright with issue tracking and reporting | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -25,7 +27,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n | **rai-plan-from-security-plan** | Initiate a responsible AI assessment from a completed Security Plan using the RAI Planner agent in from-security-plan mode (recommended) | | **synth-data-generate** | Generate comprehensive synthetic data for any specified subject with realistic patterns and relationships | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/design-thinking.collection.md b/collections/design-thinking.collection.md index fbc63e5d3..e14874694 100644 --- a/collections/design-thinking.collection.md +++ b/collections/design-thinking.collection.md @@ -1,25 +1,27 @@ +# Design Thinking + Coaching identity, quality constraints, and methodology instructions for AI-enhanced design thinking across nine methods. The collection supports the HVE Design Thinking pyramid structure spanning Problem, Solution, and Implementation spaces. -> **Preview** — Core features are complete and functional. Suitable for adoption with the understanding that refinements may follow. +> Preview: Core features are complete and functional. Suitable for adoption with the understanding that refinements may follow. -### Chat Agents +## Chat Agents | Name | Description | |-----------------------|------------------------------------------------------------------------------------------------------------| | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | -### Prompts +## Prompts | Name | Description | |-------------------------------------|----------------------------------------------------------------------------------------------------------------------------| | **dt-canonical-deck** | Unified canonical deck workflow for opt-in offer, snapshot generation/refresh, and optional customer-card PowerPoint build | | **dt-figma-export** | Export Design Thinking artifacts to a collaborative FigJam board or Figma Design file using the official Figma MCP server | | **dt-handoff-implementation-space** | Compiles DT Methods 7-9 outputs into an RPI-ready handoff artifact targeting Task Researcher | -| **dt-handoff-problem-space** | Problem Space exit handoff — compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | -| **dt-handoff-solution-space** | Solution Space exit handoff — compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-problem-space** | Problem Space exit handoff - compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-solution-space** | Solution Space exit handoff - compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | | **dt-method-04-convergence** | Theme discovery for Design Thinking Method 4c through philosophy-based clustering | | **dt-method-04-ideation** | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation | | **dt-method-05-concepts** | Concept articulation for Design Thinking Method 5b from brainstorming themes | @@ -28,48 +30,48 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-method-06-planning** | Concept analysis and prototype approach design for Design Thinking Method 6a | | **dt-method-06-testing** | Hypothesis-driven testing and constraint validation for Design Thinking Method 6c | | **dt-method-next** | Assess DT project state and recommend next method with sequencing validation | -| **dt-resume-coaching** | Resume a Design Thinking coaching session — reads coaching state and re-establishes context | +| **dt-resume-coaching** | Resume a Design Thinking coaching session - reads coaching state and re-establishes context | | **dt-start-project** | Start a new Design Thinking coaching project with state initialization and first coaching interaction | -### Instructions +## Instructions | Name | Description | |----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **design-thinking/dt-canonical-deck** | Opt-in canonical deck and customer-card workflow for DT coaching | | **design-thinking/dt-coaching-identity** | Required instructions when working with or doing any Design Thinking (DT); Contains instructions for the Design Thinking coach identity, philosophy, and user interaction and communication requirements for consistent coaching behavior. | | **design-thinking/dt-coaching-state** | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning — factory floor improvement project used across all 9 curriculum modules | +| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | **design-thinking/dt-image-prompt-generation** | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | -| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | **design-thinking/dt-method-01-deep** | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | **design-thinking/dt-method-01-scope** | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | | **design-thinking/dt-method-02-deep** | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | **design-thinking/dt-method-02-research** | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | -| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis — advanced affinity analysis, insight frameworks, and problem statement articulation | +| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | | **design-thinking/dt-method-03-synthesis** | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | | **design-thinking/dt-method-04-brainstorming** | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | -| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming — advanced facilitation techniques, creative block recovery, and convergence frameworks | +| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | **design-thinking/dt-method-05-concepts** | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | **design-thinking/dt-method-05-deep** | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | **design-thinking/dt-method-06-deep** | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | | **design-thinking/dt-method-06-lofi-prototypes** | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | | **design-thinking/dt-method-07-deep** | Deep expertise for Method 7: High-Fidelity Prototypes; fidelity translation, architecture, and specification writing | | **design-thinking/dt-method-07-hifi-prototypes** | Design Thinking Method 7: High-Fidelity Prototypes; technical translation, functional prototypes, and specifications | -| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate — advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | | **design-thinking/dt-method-08-testing** | Design Thinking Method 8: User Testing - evidence-based evaluation, test protocols, and non-linear iteration support | -| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale — change management, scaling, and adoption measurement | -| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale — systematic refinement, scaling patterns, and organizational deployment | +| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | +| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | | **design-thinking/dt-method-sequencing** | Method transition rules, nine-method sequence, space boundaries, and non-linear iteration support for Design Thinking coaching | | **design-thinking/dt-quality-constraints** | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | **design-thinking/dt-rpi-handoff-contract** | DT-to-RPI handoff contract defining exit points, artifact schemas, and per-agent input requirements for lateral transitions from Design Thinking to RPI workflow | diff --git a/collections/experimental.collection.md b/collections/experimental.collection.md index 48f4d2feb..b3a141a0c 100644 --- a/collections/experimental.collection.md +++ b/collections/experimental.collection.md @@ -1,8 +1,10 @@ +# Experimental + Experimental and preview artifacts not yet promoted to stable collections. Items in this collection may change or be removed without notice. -### Chat Agents +## Chat Agents | Name | Description | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -10,7 +12,7 @@ Experimental and preview artifacts not yet promoted to stable collections. Items | **pptx** | Creates, updates, and manages PowerPoint slide decks using YAML-driven content with python-pptx | | **pptx-subagent** | Executes PowerPoint skill operations including content extraction, YAML creation, deck building, and visual validation | -### Instructions +## Instructions | Name | Description | |--------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -18,7 +20,7 @@ Experimental and preview artifacts not yet promoted to stable collections. Items | **experimental/pptx** | Shared conventions for PowerPoint Builder agent, subagent, and powerpoint skill | | **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 +## Skills | Name | Description | |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/github.collection.md b/collections/github.collection.md index 0403f490f..8ab58558a 100644 --- a/collections/github.collection.md +++ b/collections/github.collection.md @@ -1,14 +1,16 @@ +# GitHub Backlog Management + Manage GitHub issue backlogs with agents for discovery, triage, sprint planning, and execution. This collection brings structured backlog management workflows directly into VS Code. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------|------------------------------------------------------------------------------------------------------------------------| | **github-backlog-manager** | Orchestrator agent for GitHub backlog management workflows including triage, discovery, sprint planning, and execution | -### Prompts +## Prompts | Name | Description | |----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| @@ -19,7 +21,7 @@ Manage GitHub issue backlogs with agents for discovery, triage, sprint planning, | **github-suggest** | Resume GitHub backlog management workflow after session restore | | **github-triage-issues** | Triage GitHub issues not yet triaged with automated label suggestions, milestone assignment, and duplicate detection | -### Instructions +## Instructions | Name | Description | |-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/gitlab.collection.md b/collections/gitlab.collection.md index ecd2da536..4c8b14d3b 100644 --- a/collections/gitlab.collection.md +++ b/collections/gitlab.collection.md @@ -1,14 +1,16 @@ +# GitLab Integration + Use GitLab merge request and pipeline workflows from VS Code through a focused Python skill for inspecting merge requests, posting notes, triggering pipelines, and reading job logs. -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **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 +## Skills | Name | Description | |------------|--------------------------------------------------------------| diff --git a/collections/hve-core-all.collection.md b/collections/hve-core-all.collection.md index af4781796..f4ac58779 100644 --- a/collections/hve-core-all.collection.md +++ b/collections/hve-core-all.collection.md @@ -1,13 +1,18 @@ +# HVE Core All + HVE Core provides the complete collection of AI chat agents, prompts, instructions, and skills for VS Code with GitHub Copilot. This edition includes every artifact across all domains: development workflows, architecture, Azure DevOps, GitHub and Jira backlog workflows, data science, design thinking, security, and more. Use this edition when you want access to everything without choosing a focused collection. > [!CAUTION] -> This collection includes security, responsible AI, and supply chain security agents and prompts that are **assistive tools only**. They do not replace professional security tooling (SAST, DAST, SCA, penetration testing, compliance scanners) or qualified human review. All AI-generated security and compliance artifacts **must** be reviewed and validated by qualified professionals before use. AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. +> This collection includes security, responsible AI, and supply chain security agents and prompts that are **assistive tools only**. +> They do not replace professional security tooling (SAST, DAST, SCA, penetration testing, compliance scanners) or qualified human review. +> All AI-generated security and compliance artifacts **must** be reviewed and validated by qualified professionals before use. +> AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -63,7 +68,7 @@ Use this edition when you want access to everything without choosing a focused c | **test-streamlit-dashboard** | Automated testing for Streamlit dashboards using Playwright with issue tracking and reporting | | **ux-ui-designer** | UX research specialist for Jobs-to-be-Done analysis, user journey mapping, and accessibility requirements | -### Prompts +## Prompts | Name | Description | |-------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| @@ -83,8 +88,8 @@ Use this edition when you want access to everything without choosing a focused c | **dt-canonical-deck** | Unified canonical deck workflow for opt-in offer, snapshot generation/refresh, and optional customer-card PowerPoint build | | **dt-figma-export** | Export Design Thinking artifacts to a collaborative FigJam board or Figma Design file using the official Figma MCP server | | **dt-handoff-implementation-space** | Compiles DT Methods 7-9 outputs into an RPI-ready handoff artifact targeting Task Researcher | -| **dt-handoff-problem-space** | Problem Space exit handoff — compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | -| **dt-handoff-solution-space** | Solution Space exit handoff — compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-problem-space** | Problem Space exit handoff - compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-solution-space** | Solution Space exit handoff - compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | | **dt-method-04-convergence** | Theme discovery for Design Thinking Method 4c through philosophy-based clustering | | **dt-method-04-ideation** | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation | | **dt-method-05-concepts** | Concept articulation for Design Thinking Method 5b from brainstorming themes | @@ -93,7 +98,7 @@ Use this edition when you want access to everything without choosing a focused c | **dt-method-06-planning** | Concept analysis and prototype approach design for Design Thinking Method 6a | | **dt-method-06-testing** | Hypothesis-driven testing and constraint validation for Design Thinking Method 6c | | **dt-method-next** | Assess DT project state and recommend next method with sequencing validation | -| **dt-resume-coaching** | Resume a Design Thinking coaching session — reads coaching state and re-establishes context | +| **dt-resume-coaching** | Resume a Design Thinking coaching session - reads coaching state and re-establishes context | | **dt-start-project** | Start a new Design Thinking coaching project with state initialization and first coaching interaction | | **git-commit** | Stages all changes, generates a conventional commit message, shows it to the user, and commits using only git add/commit | | **git-commit-message** | Generates a commit message following the commit-message.instructions.md rules based on all changes in the branch | @@ -135,7 +140,7 @@ Use this edition when you want access to everything without choosing a focused c | **task-research** | Initiates research for implementation planning based on user requirements | | **task-review** | Initiates implementation review based on user context or automatic artifact discovery | -### Instructions +## Instructions | Name | Description | |----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -164,38 +169,38 @@ Use this edition when you want access to everything without choosing a focused c | **design-thinking/dt-canonical-deck** | Opt-in canonical deck and customer-card workflow for DT coaching | | **design-thinking/dt-coaching-identity** | Required instructions when working with or doing any Design Thinking (DT); Contains instructions for the Design Thinking coach identity, philosophy, and user interaction and communication requirements for consistent coaching behavior. | | **design-thinking/dt-coaching-state** | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning — factory floor improvement project used across all 9 curriculum modules | +| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | **design-thinking/dt-image-prompt-generation** | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | -| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | **design-thinking/dt-method-01-deep** | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | **design-thinking/dt-method-01-scope** | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | | **design-thinking/dt-method-02-deep** | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | **design-thinking/dt-method-02-research** | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | -| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis — advanced affinity analysis, insight frameworks, and problem statement articulation | +| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | | **design-thinking/dt-method-03-synthesis** | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | | **design-thinking/dt-method-04-brainstorming** | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | -| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming — advanced facilitation techniques, creative block recovery, and convergence frameworks | +| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | **design-thinking/dt-method-05-concepts** | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | **design-thinking/dt-method-05-deep** | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | **design-thinking/dt-method-06-deep** | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | | **design-thinking/dt-method-06-lofi-prototypes** | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | | **design-thinking/dt-method-07-deep** | Deep expertise for Method 7: High-Fidelity Prototypes; fidelity translation, architecture, and specification writing | | **design-thinking/dt-method-07-hifi-prototypes** | Design Thinking Method 7: High-Fidelity Prototypes; technical translation, functional prototypes, and specifications | -| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate — advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | | **design-thinking/dt-method-08-testing** | Design Thinking Method 8: User Testing - evidence-based evaluation, test protocols, and non-linear iteration support | -| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale — change management, scaling, and adoption measurement | -| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale — systematic refinement, scaling patterns, and organizational deployment | +| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | +| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | | **design-thinking/dt-method-sequencing** | Method transition rules, nine-method sequence, space boundaries, and non-linear iteration support for Design Thinking coaching | | **design-thinking/dt-quality-constraints** | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | **design-thinking/dt-rpi-handoff-contract** | DT-to-RPI handoff contract defining exit points, artifact schemas, and per-agent input requirements for lateral transitions from Design Thinking to RPI workflow | @@ -242,7 +247,7 @@ Use this edition when you want access to everything without choosing a focused c | **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. | | **shared/story-quality** | Shared story quality conventions for work item creation and evaluation across agents and workflows | -### Skills +## Skills | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/hve-core.collection.md b/collections/hve-core.collection.md index ce06884de..2dfbc9684 100644 --- a/collections/hve-core.collection.md +++ b/collections/hve-core.collection.md @@ -1,8 +1,10 @@ +# HVE Core Workflow + HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow for completing complex tasks through a structured four-phase process. The RPI workflow dispatches specialized agents that collaborate autonomously to deliver well-researched, planned, and validated implementations. This collection also includes Git workflow prompts for commit messages, merge operations, repository setup, and pull request management. -### Chat Agents +## Chat Agents | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -24,7 +26,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **task-researcher** | Task research specialist for comprehensive project analysis | | **task-reviewer** | Reviews completed implementation work for accuracy, completeness, and convention compliance | -### Prompts +## Prompts | Name | Description | |------------------------|--------------------------------------------------------------------------------------------------------------------------| @@ -44,7 +46,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **task-research** | Initiates research for implementation planning based on user requirements | | **task-review** | Initiates implementation review based on user context or automatic artifact discovery | -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -56,7 +58,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **hve-core/writing-style** | Required writing style conventions for voice, tone, and language in all markdown content | | **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 +## Skills | Name | Description | |------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/installer.collection.md b/collections/installer.collection.md index f34c2fb43..b771ba5f8 100644 --- a/collections/installer.collection.md +++ b/collections/installer.collection.md @@ -1,14 +1,16 @@ +# HVE Core Installer + Deploy HVE Core artifacts across workspace configurations with the hve-core-installer skill. This collection provides decision-driven setup for selecting and installing collections, agents, prompts, and instructions via the VS Code extension or clone-based methods. -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **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 +## Skills | Name | Description | |------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/jira.collection.md b/collections/jira.collection.md index 12d1c1f82..9a4f4b742 100644 --- a/collections/jira.collection.md +++ b/collections/jira.collection.md @@ -1,15 +1,17 @@ +# Jira Integration + Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This collection adds dedicated Jira agents, prompts, and instructions on top of the Jira skill so discovery, triage, execution, and planning workflows use the same tracking and handoff patterns as the rest of HVE Core. -### Chat Agents +## Chat Agents | Name | Description | |--------------------------|---------------------------------------------------------------------------------------------------------------------------| | **jira-backlog-manager** | Orchestrator agent for Jira backlog management workflows including discovery, triage, execution, and single-issue actions | | **jira-prd-to-wit** | Product Manager expert for analyzing PRDs and planning Jira issue hierarchies without mutating Jira | -### Prompts +## Prompts | Name | Description | |--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| @@ -18,7 +20,7 @@ Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This c | **jira-prd-to-wit** | Analyze PRD artifacts and plan Jira issue hierarchies without mutating Jira | | **jira-triage-issues** | Triage Jira issues with bounded JQL, field recommendations, duplicate detection, and optional execution of confirmed updates | -### Instructions +## Instructions | Name | Description | |---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -29,7 +31,7 @@ Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This c | **jira/jira-wit-planning** | Reference specification for Jira PRD work item planning files, hierarchy mapping, field validation, and handoff contracts | | **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 +## Skills | Name | Description | |----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/project-planning.collection.md b/collections/project-planning.collection.md index 63c557195..f188462e2 100644 --- a/collections/project-planning.collection.md +++ b/collections/project-planning.collection.md @@ -1,8 +1,10 @@ -Create architecture decision records, requirements documents, and diagrams — all through guided AI workflows. Evaluate AI-powered systems against Responsible AI standards and conduct STRIDE-based security model analysis with automated backlog generation. +# Project Planning + +Create architecture decision records, requirements documents, and diagrams - all through guided AI workflows. Evaluate AI-powered systems against Responsible AI standards and conduct STRIDE-based security model analysis with automated backlog generation. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -25,7 +27,7 @@ Create architecture decision records, requirements documents, and diagrams — a | **system-architecture-reviewer** | System architecture reviewer for design trade-offs, ADR creation, and well-architected alignment | | **ux-ui-designer** | UX research specialist for Jobs-to-be-Done analysis, user journey mapping, and accessibility requirements | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -41,7 +43,7 @@ Create architecture decision records, requirements documents, and diagrams — a | **sssc-from-prd** | Start an SSSC assessment from existing PRD artifacts using the SSSC Planner agent | | **sssc-from-security-plan** | Extend a Security Planner assessment with supply chain coverage using the SSSC Planner agent | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/rai-planning.collection.md b/collections/rai-planning.collection.md index 31a448486..e44526adf 100644 --- a/collections/rai-planning.collection.md +++ b/collections/rai-planning.collection.md @@ -1,3 +1,5 @@ +# RAI Planning + Assess AI systems for responsible AI risks using structured standards-aligned analysis and impact assessment. > [!CAUTION] @@ -5,14 +7,14 @@ Assess AI systems for responsible AI risks using structured standards-aligned an -### Chat Agents +## Chat Agents | Name | Description | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **rai-planner** | Responsible AI assessment agent with 5-phase conversational workflow. Evaluates AI systems against Microsoft RAI Standard v2 and NIST AI RMF 1.0. Produces RAI security model, impact assessment, control surface catalog, and dual-format backlog handoff. | | **researcher-subagent** | Research subagent using search tools, read tools, fetch web page, github repo, and mcp tools | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -20,7 +22,7 @@ Assess AI systems for responsible AI risks using structured standards-aligned an | **rai-plan-from-prd** | Initiate a responsible AI assessment from PRD/BRD artifacts using the RAI Planner agent in from-prd mode | | **rai-plan-from-security-plan** | Initiate a responsible AI assessment from a completed Security Plan using the RAI Planner agent in from-security-plan mode (recommended) | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/collections/security.collection.md b/collections/security.collection.md index 127c16c34..3e13215db 100644 --- a/collections/security.collection.md +++ b/collections/security.collection.md @@ -1,3 +1,5 @@ +# Security + Security review, planning, incident response, risk assessment, vulnerability analysis, supply chain security, and responsible AI assessment for cloud and hybrid environments. > [!CAUTION] @@ -5,7 +7,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana -### Chat Agents +## Chat Agents | Name | Description | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -19,7 +21,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **skill-assessor** | Assesses a single security knowledge skill against the codebase, reading vulnerability references and returning structured findings | | **sssc-planner** | Guides users through a six-phase assessment of their repository's supply chain security posture against OpenSSF Scorecard, SLSA, Sigstore, and SBOM standards, producing a prioritized backlog referencing reusable workflows from hve-core and microsoft/physical-ai-toolchain. | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -39,7 +41,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **sssc-from-prd** | Start an SSSC assessment from existing PRD artifacts using the SSSC Planner agent | | **sssc-from-security-plan** | Extend a Security Planner assessment with supply chain coverage using the SSSC Planner agent | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -62,7 +64,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **security/standards-mapping** | Embedded OWASP and NIST security standards with researcher subagent delegation for CIS, WAF, CAF, and other runtime lookups | | **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 +## Skills | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/ado/README.md b/plugins/ado/README.md index 0872f25b7..0c79378e1 100644 --- a/plugins/ado/README.md +++ b/plugins/ado/README.md @@ -5,18 +5,20 @@ Azure DevOps work item management, build monitoring, and pull request creation ## Overview -Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies — all from within VS Code. +# Azure DevOps Integration + +Manage Azure DevOps work items, monitor builds, create pull requests, and convert requirements documents into structured work item hierarchies - all from within VS Code. -### Chat Agents +## 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 +## Prompts | Name | Description | |-------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| @@ -30,7 +32,7 @@ Manage Azure DevOps work items, monitor builds, create pull requests, and conver | **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 +## Instructions | Name | Description | |-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -44,7 +46,7 @@ Manage Azure DevOps work items, monitor builds, create pull requests, and conver | **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 +## Skills | Name | Description | |------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/coding-standards/README.md b/plugins/coding-standards/README.md index 5302b2343..8b7397e77 100644 --- a/plugins/coding-standards/README.md +++ b/plugins/coding-standards/README.md @@ -5,11 +5,13 @@ Language-specific coding instructions and pre-PR code review agents for bash, Bi ## Overview +# Coding Standards + 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. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------|---------------------------------------------------------------------------------------------------------------------------| @@ -17,14 +19,14 @@ Enforce language-specific coding conventions and best practices across your proj | **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 | -### Prompts +## 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 +## Instructions | Name | Description | |---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -44,7 +46,7 @@ Enforce language-specific coding conventions and best practices across your proj | **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 +## Skills | Name | Description | |-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/data-science/README.md b/plugins/data-science/README.md index 6c4f69bb1..8e96c30be 100644 --- a/plugins/data-science/README.md +++ b/plugins/data-science/README.md @@ -8,6 +8,8 @@ Data specification generation, Jupyter notebooks, and Streamlit dashboards ## Overview +# Data Science + Generate data specifications, Jupyter notebooks, and Streamlit dashboards from natural language descriptions. Evaluate AI-powered data systems against Responsible AI standards. This collection includes specialized agents for data science workflows in Python and RAI assessment. > [!CAUTION] @@ -15,7 +17,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n -### Chat Agents +## Chat Agents | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -26,7 +28,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n | **researcher-subagent** | Research subagent using search tools, read tools, fetch web page, github repo, and mcp tools | | **test-streamlit-dashboard** | Automated testing for Streamlit dashboards using Playwright with issue tracking and reporting | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -35,7 +37,7 @@ Generate data specifications, Jupyter notebooks, and Streamlit dashboards from n | **rai-plan-from-security-plan** | Initiate a responsible AI assessment from a completed Security Plan using the RAI Planner agent in from-security-plan mode (recommended) | | **synth-data-generate** | Generate comprehensive synthetic data for any specified subject with realistic patterns and relationships | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/design-thinking/README.md b/plugins/design-thinking/README.md index 306e05081..d6e04f188 100644 --- a/plugins/design-thinking/README.md +++ b/plugins/design-thinking/README.md @@ -7,28 +7,30 @@ Design Thinking coaching identity, quality constraints, and methodology instruct ## Overview +# Design Thinking + Coaching identity, quality constraints, and methodology instructions for AI-enhanced design thinking across nine methods. The collection supports the HVE Design Thinking pyramid structure spanning Problem, Solution, and Implementation spaces. -> **Preview** — Core features are complete and functional. Suitable for adoption with the understanding that refinements may follow. +> Preview: Core features are complete and functional. Suitable for adoption with the understanding that refinements may follow. -### Chat Agents +## Chat Agents | Name | Description | |-----------------------|------------------------------------------------------------------------------------------------------------| | **dt-coach** | Design Thinking coach guiding teams through the 9-method HVE framework with Think/Speak/Empower philosophy | | **dt-learning-tutor** | Design Thinking learning tutor providing structured curriculum, comprehension checks, and adaptive pacing | -### Prompts +## Prompts | Name | Description | |-------------------------------------|----------------------------------------------------------------------------------------------------------------------------| | **dt-canonical-deck** | Unified canonical deck workflow for opt-in offer, snapshot generation/refresh, and optional customer-card PowerPoint build | | **dt-figma-export** | Export Design Thinking artifacts to a collaborative FigJam board or Figma Design file using the official Figma MCP server | | **dt-handoff-implementation-space** | Compiles DT Methods 7-9 outputs into an RPI-ready handoff artifact targeting Task Researcher | -| **dt-handoff-problem-space** | Problem Space exit handoff — compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | -| **dt-handoff-solution-space** | Solution Space exit handoff — compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-problem-space** | Problem Space exit handoff - compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-solution-space** | Solution Space exit handoff - compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | | **dt-method-04-convergence** | Theme discovery for Design Thinking Method 4c through philosophy-based clustering | | **dt-method-04-ideation** | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation | | **dt-method-05-concepts** | Concept articulation for Design Thinking Method 5b from brainstorming themes | @@ -37,48 +39,48 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **dt-method-06-planning** | Concept analysis and prototype approach design for Design Thinking Method 6a | | **dt-method-06-testing** | Hypothesis-driven testing and constraint validation for Design Thinking Method 6c | | **dt-method-next** | Assess DT project state and recommend next method with sequencing validation | -| **dt-resume-coaching** | Resume a Design Thinking coaching session — reads coaching state and re-establishes context | +| **dt-resume-coaching** | Resume a Design Thinking coaching session - reads coaching state and re-establishes context | | **dt-start-project** | Start a new Design Thinking coaching project with state initialization and first coaching interaction | -### Instructions +## Instructions | Name | Description | |----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **design-thinking/dt-canonical-deck** | Opt-in canonical deck and customer-card workflow for DT coaching | | **design-thinking/dt-coaching-identity** | Required instructions when working with or doing any Design Thinking (DT); Contains instructions for the Design Thinking coach identity, philosophy, and user interaction and communication requirements for consistent coaching behavior. | | **design-thinking/dt-coaching-state** | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning — factory floor improvement project used across all 9 curriculum modules | +| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | **design-thinking/dt-image-prompt-generation** | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | -| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | **design-thinking/dt-method-01-deep** | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | **design-thinking/dt-method-01-scope** | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | | **design-thinking/dt-method-02-deep** | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | **design-thinking/dt-method-02-research** | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | -| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis — advanced affinity analysis, insight frameworks, and problem statement articulation | +| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | | **design-thinking/dt-method-03-synthesis** | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | | **design-thinking/dt-method-04-brainstorming** | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | -| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming — advanced facilitation techniques, creative block recovery, and convergence frameworks | +| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | **design-thinking/dt-method-05-concepts** | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | **design-thinking/dt-method-05-deep** | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | **design-thinking/dt-method-06-deep** | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | | **design-thinking/dt-method-06-lofi-prototypes** | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | | **design-thinking/dt-method-07-deep** | Deep expertise for Method 7: High-Fidelity Prototypes; fidelity translation, architecture, and specification writing | | **design-thinking/dt-method-07-hifi-prototypes** | Design Thinking Method 7: High-Fidelity Prototypes; technical translation, functional prototypes, and specifications | -| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate — advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | | **design-thinking/dt-method-08-testing** | Design Thinking Method 8: User Testing - evidence-based evaluation, test protocols, and non-linear iteration support | -| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale — change management, scaling, and adoption measurement | -| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale — systematic refinement, scaling patterns, and organizational deployment | +| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | +| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | | **design-thinking/dt-method-sequencing** | Method transition rules, nine-method sequence, space boundaries, and non-linear iteration support for Design Thinking coaching | | **design-thinking/dt-quality-constraints** | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | **design-thinking/dt-rpi-handoff-contract** | DT-to-RPI handoff contract defining exit points, artifact schemas, and per-agent input requirements for lateral transitions from Design Thinking to RPI workflow | diff --git a/plugins/experimental/README.md b/plugins/experimental/README.md index 42c50be35..96654761b 100644 --- a/plugins/experimental/README.md +++ b/plugins/experimental/README.md @@ -7,11 +7,13 @@ Experimental and preview artifacts not yet promoted to stable collections ## Overview +# Experimental + Experimental and preview artifacts not yet promoted to stable collections. Items in this collection may change or be removed without notice. -### Chat Agents +## Chat Agents | Name | Description | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -19,7 +21,7 @@ Experimental and preview artifacts not yet promoted to stable collections. Items | **pptx** | Creates, updates, and manages PowerPoint slide decks using YAML-driven content with python-pptx | | **pptx-subagent** | Executes PowerPoint skill operations including content extraction, YAML creation, deck building, and visual validation | -### Instructions +## Instructions | Name | Description | |--------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -27,7 +29,7 @@ Experimental and preview artifacts not yet promoted to stable collections. Items | **experimental/pptx** | Shared conventions for PowerPoint Builder agent, subagent, and powerpoint skill | | **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 +## Skills | Name | Description | |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/github/README.md b/plugins/github/README.md index 3521c2417..03fe1b3e9 100644 --- a/plugins/github/README.md +++ b/plugins/github/README.md @@ -5,17 +5,19 @@ GitHub issue discovery, triage, sprint planning, and backlog execution agents an ## Overview +# GitHub Backlog Management + Manage GitHub issue backlogs with agents for discovery, triage, sprint planning, and execution. This collection brings structured backlog management workflows directly into VS Code. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------|------------------------------------------------------------------------------------------------------------------------| | **github-backlog-manager** | Orchestrator agent for GitHub backlog management workflows including triage, discovery, sprint planning, and execution | -### Prompts +## Prompts | Name | Description | |----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| @@ -26,7 +28,7 @@ Manage GitHub issue backlogs with agents for discovery, triage, sprint planning, | **github-suggest** | Resume GitHub backlog management workflow after session restore | | **github-triage-issues** | Triage GitHub issues not yet triaged with automated label suggestions, milestone assignment, and duplicate detection | -### Instructions +## Instructions | Name | Description | |-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/gitlab/README.md b/plugins/gitlab/README.md index fd19126bf..0a04fd967 100644 --- a/plugins/gitlab/README.md +++ b/plugins/gitlab/README.md @@ -5,17 +5,19 @@ GitLab merge request and pipeline workflows through a Python skill ## Overview +# GitLab Integration + Use GitLab merge request and pipeline workflows from VS Code through a focused Python skill for inspecting merge requests, posting notes, triggering pipelines, and reading job logs. -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **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 +## Skills | Name | Description | |------------|--------------------------------------------------------------| diff --git a/plugins/hve-core-all/README.md b/plugins/hve-core-all/README.md index 8689ae8c1..e0ab7ce73 100644 --- a/plugins/hve-core-all/README.md +++ b/plugins/hve-core-all/README.md @@ -5,16 +5,21 @@ Full bundle of all stable HVE Core agents, prompts, instructions, and skills ## Overview +# HVE Core All + HVE Core provides the complete collection of AI chat agents, prompts, instructions, and skills for VS Code with GitHub Copilot. This edition includes every artifact across all domains: development workflows, architecture, Azure DevOps, GitHub and Jira backlog workflows, data science, design thinking, security, and more. Use this edition when you want access to everything without choosing a focused collection. > [!CAUTION] -> This collection includes security, responsible AI, and supply chain security agents and prompts that are **assistive tools only**. They do not replace professional security tooling (SAST, DAST, SCA, penetration testing, compliance scanners) or qualified human review. All AI-generated security and compliance artifacts **must** be reviewed and validated by qualified professionals before use. AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. +> This collection includes security, responsible AI, and supply chain security agents and prompts that are **assistive tools only**. +> They do not replace professional security tooling (SAST, DAST, SCA, penetration testing, compliance scanners) or qualified human review. +> All AI-generated security and compliance artifacts **must** be reviewed and validated by qualified professionals before use. +> AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -70,7 +75,7 @@ Use this edition when you want access to everything without choosing a focused c | **test-streamlit-dashboard** | Automated testing for Streamlit dashboards using Playwright with issue tracking and reporting | | **ux-ui-designer** | UX research specialist for Jobs-to-be-Done analysis, user journey mapping, and accessibility requirements | -### Prompts +## Prompts | Name | Description | |-------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| @@ -90,8 +95,8 @@ Use this edition when you want access to everything without choosing a focused c | **dt-canonical-deck** | Unified canonical deck workflow for opt-in offer, snapshot generation/refresh, and optional customer-card PowerPoint build | | **dt-figma-export** | Export Design Thinking artifacts to a collaborative FigJam board or Figma Design file using the official Figma MCP server | | **dt-handoff-implementation-space** | Compiles DT Methods 7-9 outputs into an RPI-ready handoff artifact targeting Task Researcher | -| **dt-handoff-problem-space** | Problem Space exit handoff — compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | -| **dt-handoff-solution-space** | Solution Space exit handoff — compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-problem-space** | Problem Space exit handoff - compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher | +| **dt-handoff-solution-space** | Solution Space exit handoff - compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher | | **dt-method-04-convergence** | Theme discovery for Design Thinking Method 4c through philosophy-based clustering | | **dt-method-04-ideation** | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation | | **dt-method-05-concepts** | Concept articulation for Design Thinking Method 5b from brainstorming themes | @@ -100,7 +105,7 @@ Use this edition when you want access to everything without choosing a focused c | **dt-method-06-planning** | Concept analysis and prototype approach design for Design Thinking Method 6a | | **dt-method-06-testing** | Hypothesis-driven testing and constraint validation for Design Thinking Method 6c | | **dt-method-next** | Assess DT project state and recommend next method with sequencing validation | -| **dt-resume-coaching** | Resume a Design Thinking coaching session — reads coaching state and re-establishes context | +| **dt-resume-coaching** | Resume a Design Thinking coaching session - reads coaching state and re-establishes context | | **dt-start-project** | Start a new Design Thinking coaching project with state initialization and first coaching interaction | | **git-commit** | Stages all changes, generates a conventional commit message, shows it to the user, and commits using only git add/commit | | **git-commit-message** | Generates a commit message following the commit-message.instructions.md rules based on all changes in the branch | @@ -142,7 +147,7 @@ Use this edition when you want access to everything without choosing a focused c | **task-research** | Initiates research for implementation planning based on user requirements | | **task-review** | Initiates implementation review based on user context or automatic artifact discovery | -### Instructions +## Instructions | Name | Description | |----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -171,38 +176,38 @@ Use this edition when you want access to everything without choosing a focused c | **design-thinking/dt-canonical-deck** | Opt-in canonical deck and customer-card workflow for DT coaching | | **design-thinking/dt-coaching-identity** | Required instructions when working with or doing any Design Thinking (DT); Contains instructions for the Design Thinking coach identity, philosophy, and user interaction and communication requirements for consistent coaching behavior. | | **design-thinking/dt-coaching-state** | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale — concepts, techniques, checks, and exercises | -| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning — factory floor improvement project used across all 9 curriculum modules | +| **design-thinking/dt-curriculum-01-scoping** | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-02-research** | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-03-synthesis** | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-04-brainstorming** | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-05-concepts** | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-06-prototypes** | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-07-testing** | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-08-iteration** | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-09-handoff** | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| **design-thinking/dt-curriculum-scenario-manufacturing** | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | **design-thinking/dt-image-prompt-generation** | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | -| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | -| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching — vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-energy** | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-healthcare** | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| **design-thinking/dt-industry-manufacturing** | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | **design-thinking/dt-method-01-deep** | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | **design-thinking/dt-method-01-scope** | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | | **design-thinking/dt-method-02-deep** | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | **design-thinking/dt-method-02-research** | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | -| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis — advanced affinity analysis, insight frameworks, and problem statement articulation | +| **design-thinking/dt-method-03-deep** | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | | **design-thinking/dt-method-03-synthesis** | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | | **design-thinking/dt-method-04-brainstorming** | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | -| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming — advanced facilitation techniques, creative block recovery, and convergence frameworks | +| **design-thinking/dt-method-04-deep** | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | **design-thinking/dt-method-05-concepts** | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | **design-thinking/dt-method-05-deep** | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | **design-thinking/dt-method-06-deep** | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | | **design-thinking/dt-method-06-lofi-prototypes** | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | | **design-thinking/dt-method-07-deep** | Deep expertise for Method 7: High-Fidelity Prototypes; fidelity translation, architecture, and specification writing | | **design-thinking/dt-method-07-hifi-prototypes** | Design Thinking Method 7: High-Fidelity Prototypes; technical translation, functional prototypes, and specifications | -| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate — advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| **design-thinking/dt-method-08-deep** | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | | **design-thinking/dt-method-08-testing** | Design Thinking Method 8: User Testing - evidence-based evaluation, test protocols, and non-linear iteration support | -| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale — change management, scaling, and adoption measurement | -| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale — systematic refinement, scaling patterns, and organizational deployment | +| **design-thinking/dt-method-09-deep** | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | +| **design-thinking/dt-method-09-iteration** | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | | **design-thinking/dt-method-sequencing** | Method transition rules, nine-method sequence, space boundaries, and non-linear iteration support for Design Thinking coaching | | **design-thinking/dt-quality-constraints** | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | **design-thinking/dt-rpi-handoff-contract** | DT-to-RPI handoff contract defining exit points, artifact schemas, and per-agent input requirements for lateral transitions from Design Thinking to RPI workflow | @@ -249,7 +254,7 @@ Use this edition when you want access to everything without choosing a focused c | **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. | | **shared/story-quality** | Shared story quality conventions for work item creation and evaluation across agents and workflows | -### Skills +## Skills | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/hve-core/README.md b/plugins/hve-core/README.md index eb2dca76d..e78053cf4 100644 --- a/plugins/hve-core/README.md +++ b/plugins/hve-core/README.md @@ -5,11 +5,13 @@ HVE Core RPI (Research, Plan, Implement, Review) workflow with Git commit, merge ## Overview +# HVE Core Workflow + HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow for completing complex tasks through a structured four-phase process. The RPI workflow dispatches specialized agents that collaborate autonomously to deliver well-researched, planned, and validated implementations. This collection also includes Git workflow prompts for commit messages, merge operations, repository setup, and pull request management. -### Chat Agents +## Chat Agents | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -31,7 +33,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **task-researcher** | Task research specialist for comprehensive project analysis | | **task-reviewer** | Reviews completed implementation work for accuracy, completeness, and convention compliance | -### Prompts +## Prompts | Name | Description | |------------------------|--------------------------------------------------------------------------------------------------------------------------| @@ -51,7 +53,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **task-research** | Initiates research for implementation planning based on user requirements | | **task-review** | Initiates implementation review based on user context or automatic artifact discovery | -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -63,7 +65,7 @@ HVE Core provides the flagship RPI (Research, Plan, Implement, Review) workflow | **hve-core/writing-style** | Required writing style conventions for voice, tone, and language in all markdown content | | **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 +## Skills | Name | Description | |------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/installer/README.md b/plugins/installer/README.md index bdb6c7ebe..df1e96e65 100644 --- a/plugins/installer/README.md +++ b/plugins/installer/README.md @@ -5,17 +5,19 @@ Decision-driven installer skill for deploying HVE Core artifacts across workspac ## Overview +# HVE Core Installer + Deploy HVE Core artifacts across workspace configurations with the hve-core-installer skill. This collection provides decision-driven setup for selecting and installing collections, agents, prompts, and instructions via the VS Code extension or clone-based methods. -### Instructions +## Instructions | Name | Description | |------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **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 +## Skills | Name | Description | |------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/jira/README.md b/plugins/jira/README.md index cad583e67..6d469f8b2 100644 --- a/plugins/jira/README.md +++ b/plugins/jira/README.md @@ -5,18 +5,20 @@ Jira backlog management, PRD issue planning, and issue operations through agents ## Overview +# Jira Integration + Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This collection adds dedicated Jira agents, prompts, and instructions on top of the Jira skill so discovery, triage, execution, and planning workflows use the same tracking and handoff patterns as the rest of HVE Core. -### Chat Agents +## Chat Agents | Name | Description | |--------------------------|---------------------------------------------------------------------------------------------------------------------------| | **jira-backlog-manager** | Orchestrator agent for Jira backlog management workflows including discovery, triage, execution, and single-issue actions | | **jira-prd-to-wit** | Product Manager expert for analyzing PRDs and planning Jira issue hierarchies without mutating Jira | -### Prompts +## Prompts | Name | Description | |--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| @@ -25,7 +27,7 @@ Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This c | **jira-prd-to-wit** | Analyze PRD artifacts and plan Jira issue hierarchies without mutating Jira | | **jira-triage-issues** | Triage Jira issues with bounded JQL, field recommendations, duplicate detection, and optional execution of confirmed updates | -### Instructions +## Instructions | Name | Description | |---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -36,7 +38,7 @@ Manage Jira backlog workflows and PRD-driven issue planning from VS Code. This c | **jira/jira-wit-planning** | Reference specification for Jira PRD work item planning files, hierarchy mapping, field validation, and handoff contracts | | **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 +## Skills | Name | Description | |----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/project-planning/README.md b/plugins/project-planning/README.md index d0295f124..fa7e0195d 100644 --- a/plugins/project-planning/README.md +++ b/plugins/project-planning/README.md @@ -5,11 +5,13 @@ PRDs, BRDs, ADRs, and architecture diagrams ## Overview -Create architecture decision records, requirements documents, and diagrams — all through guided AI workflows. Evaluate AI-powered systems against Responsible AI standards and conduct STRIDE-based security model analysis with automated backlog generation. +# Project Planning + +Create architecture decision records, requirements documents, and diagrams - all through guided AI workflows. Evaluate AI-powered systems against Responsible AI standards and conduct STRIDE-based security model analysis with automated backlog generation. -### Chat Agents +## Chat Agents | Name | Description | |----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -32,7 +34,7 @@ Create architecture decision records, requirements documents, and diagrams — a | **system-architecture-reviewer** | System architecture reviewer for design trade-offs, ADR creation, and well-architected alignment | | **ux-ui-designer** | UX research specialist for Jobs-to-be-Done analysis, user journey mapping, and accessibility requirements | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -48,7 +50,7 @@ Create architecture decision records, requirements documents, and diagrams — a | **sssc-from-prd** | Start an SSSC assessment from existing PRD artifacts using the SSSC Planner agent | | **sssc-from-security-plan** | Extend a Security Planner assessment with supply chain coverage using the SSSC Planner agent | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/rai-planning/README.md b/plugins/rai-planning/README.md index 5677d5c1b..0985c0b4b 100644 --- a/plugins/rai-planning/README.md +++ b/plugins/rai-planning/README.md @@ -10,6 +10,8 @@ Responsible AI assessment and standards-aligned impact analysis ## Overview +# RAI Planning + Assess AI systems for responsible AI risks using structured standards-aligned analysis and impact assessment. > [!CAUTION] @@ -17,14 +19,14 @@ Assess AI systems for responsible AI risks using structured standards-aligned an -### Chat Agents +## Chat Agents | Name | Description | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **rai-planner** | Responsible AI assessment agent with 5-phase conversational workflow. Evaluates AI systems against Microsoft RAI Standard v2 and NIST AI RMF 1.0. Produces RAI security model, impact assessment, control surface catalog, and dual-format backlog handoff. | | **researcher-subagent** | Research subagent using search tools, read tools, fetch web page, github repo, and mcp tools | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -32,7 +34,7 @@ Assess AI systems for responsible AI risks using structured standards-aligned an | **rai-plan-from-prd** | Initiate a responsible AI assessment from PRD/BRD artifacts using the RAI Planner agent in from-prd mode | | **rai-plan-from-security-plan** | Initiate a responsible AI assessment from a completed Security Plan using the RAI Planner agent in from-security-plan mode (recommended) | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/plugins/security/README.md b/plugins/security/README.md index 5e2d7c64d..b006fd8a0 100644 --- a/plugins/security/README.md +++ b/plugins/security/README.md @@ -8,6 +8,8 @@ Security review, planning, incident response, risk assessment, and vulnerability ## Overview +# Security + Security review, planning, incident response, risk assessment, vulnerability analysis, supply chain security, and responsible AI assessment for cloud and hybrid environments. > [!CAUTION] @@ -15,7 +17,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana -### Chat Agents +## Chat Agents | Name | Description | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -29,7 +31,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **skill-assessor** | Assesses a single security knowledge skill against the codebase, reading vulnerability references and returning structured findings | | **sssc-planner** | Guides users through a six-phase assessment of their repository's supply chain security posture against OpenSSF Scorecard, SLSA, Sigstore, and SBOM standards, producing a prioritized backlog referencing reusable workflows from hve-core and microsoft/physical-ai-toolchain. | -### Prompts +## Prompts | Name | Description | |---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| @@ -49,7 +51,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **sssc-from-prd** | Start an SSSC assessment from existing PRD artifacts using the SSSC Planner agent | | **sssc-from-security-plan** | Extend a Security Planner assessment with supply chain coverage using the SSSC Planner agent | -### Instructions +## Instructions | Name | Description | |----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -72,7 +74,7 @@ Security review, planning, incident response, risk assessment, vulnerability ana | **security/standards-mapping** | Embedded OWASP and NIST security standards with researcher subagent delegation for CIS, WAF, CAF, and other runtime lookups | | **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 +## Skills | Name | Description | |-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/scripts/linting/Validate-MarkdownFrontmatter.ps1 b/scripts/linting/Validate-MarkdownFrontmatter.ps1 index 3649d545a..d0ab93fe9 100644 --- a/scripts/linting/Validate-MarkdownFrontmatter.ps1 +++ b/scripts/linting/Validate-MarkdownFrontmatter.ps1 @@ -33,6 +33,7 @@ param( 'extension/README.md', 'extension/README.*.md', 'extension/templates/README.template.md', + # Generated collection markdown files intentionally omit frontmatter. 'collections/*.collection.md', 'pr.md', '.github/PULL_REQUEST_TEMPLATE.md', diff --git a/scripts/plugins/Generate-Plugins.ps1 b/scripts/plugins/Generate-Plugins.ps1 index 3aacb3b6e..0c0f965d8 100644 --- a/scripts/plugins/Generate-Plugins.ps1 +++ b/scripts/plugins/Generate-Plugins.ps1 @@ -333,6 +333,7 @@ function Invoke-PluginGeneration { $resolvedPath = Join-Path $resolvedPath 'SKILL.md' } $artifactDesc = Get-ArtifactDescription -FilePath $resolvedPath + $artifactDesc = $artifactDesc -replace '\s*—\s*', ' - ' $entry = @{ Name = $artifactName; Description = $artifactDesc } switch ($kind) { @@ -353,7 +354,7 @@ function Invoke-PluginGeneration { )) { if ($section.Items.Count -eq 0) { continue } - $null = $artifactSections.AppendLine("### $($section.Title)") + $null = $artifactSections.AppendLine("## $($section.Title)") $null = $artifactSections.AppendLine() $null = $artifactSections.AppendLine('| Name | Description |') $null = $artifactSections.AppendLine('|------|-------------|')