From c5b7982745cd3e1557de6347207fb271e8722f48 Mon Sep 17 00:00:00 2001 From: pratikwayase Date: Wed, 29 Apr 2026 19:06:18 -0700 Subject: [PATCH] fix(collections): enable markdownlint for collections/*.collection.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - remove collections/*.collection.md from .markdownlint-cli2.jsonc ignores - add H1 titles, Included Artifacts headings, and blockquote previews to all 13 collection manifests - replace em-dashes with hyphens in design-thinking instructions/prompts frontmatter and in-scope docs - update Prepare-Extension.ps1 generator to emit Included Artifacts header - regenerate plugins/**/README.md for all 13 collections Closes #1341 ๐Ÿงน - Generated by Copilot Co-authored-by: WilliamBerryiii --- .../dt-curriculum-01-scoping.instructions.md | 2 +- .../dt-curriculum-02-research.instructions.md | 2 +- ...dt-curriculum-03-synthesis.instructions.md | 2 +- ...urriculum-04-brainstorming.instructions.md | 2 +- .../dt-curriculum-05-concepts.instructions.md | 2 +- ...t-curriculum-06-prototypes.instructions.md | 2 +- .../dt-curriculum-07-testing.instructions.md | 2 +- ...dt-curriculum-08-iteration.instructions.md | 2 +- .../dt-curriculum-09-handoff.instructions.md | 2 +- ...lum-scenario-manufacturing.instructions.md | 2 +- .../dt-industry-energy.instructions.md | 2 +- .../dt-industry-healthcare.instructions.md | 2 +- .../dt-industry-manufacturing.instructions.md | 2 +- .../dt-method-03-deep.instructions.md | 2 +- .../dt-method-04-deep.instructions.md | 2 +- .../dt-method-08-deep.instructions.md | 2 +- .../dt-method-09-deep.instructions.md | 2 +- .../dt-method-09-iteration.instructions.md | 2 +- .../dt-handoff-problem-space.prompt.md | 2 +- .../dt-handoff-solution-space.prompt.md | 2 +- .../dt-resume-coaching.prompt.md | 2 +- .markdownlint-cli2.jsonc | 1 - collections/ado.collection.md | 6 +- collections/coding-standards.collection.md | 4 + collections/data-science.collection.md | 4 + collections/design-thinking.collection.md | 48 +++++----- collections/experimental.collection.md | 4 + collections/github.collection.md | 4 + collections/gitlab.collection.md | 4 + collections/hve-core-all.collection.md | 51 +++++----- collections/hve-core.collection.md | 4 + collections/installer.collection.md | 4 + collections/jira.collection.md | 4 + collections/project-planning.collection.md | 6 +- collections/security.collection.md | 4 + docs/agents/rai-planning/handoff-pipeline.md | 2 +- docs/agents/security/entry-modes.md | 4 +- docs/security/dependency-pinning.md | 4 +- docs/templates/rai-plan-template.md | 2 +- docs/templates/sssc-plan-template.md | 2 +- plugins/ado/README.md | 6 +- plugins/coding-standards/README.md | 4 + plugins/data-science/README.md | 4 + plugins/design-thinking/README.md | 90 +++++++++--------- plugins/experimental/README.md | 4 + plugins/github/README.md | 4 + plugins/gitlab/README.md | 4 + plugins/hve-core-all/README.md | 93 ++++++++++--------- plugins/hve-core/README.md | 4 + plugins/installer/README.md | 4 + plugins/jira/README.md | 4 + plugins/project-planning/README.md | 6 +- plugins/security/README.md | 4 + scripts/extension/Prepare-Extension.ps1 | 6 +- 54 files changed, 276 insertions(+), 165 deletions(-) diff --git a/.github/instructions/design-thinking/dt-curriculum-01-scoping.instructions.md b/.github/instructions/design-thinking/dt-curriculum-01-scoping.instructions.md index 4d2befd24..5bd413e73 100644 --- a/.github/instructions/design-thinking/dt-curriculum-01-scoping.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-01-scoping.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 1: Scope Conversations โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-01*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-02-research.instructions.md b/.github/instructions/design-thinking/dt-curriculum-02-research.instructions.md index 65da2f620..db8fb83ba 100644 --- a/.github/instructions/design-thinking/dt-curriculum-02-research.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-02-research.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 2: Design Research โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-02*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-03-synthesis.instructions.md b/.github/instructions/design-thinking/dt-curriculum-03-synthesis.instructions.md index f4adefe88..3a55ae1c2 100644 --- a/.github/instructions/design-thinking/dt-curriculum-03-synthesis.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-03-synthesis.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 3: Synthesis โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-03*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-04-brainstorming.instructions.md b/.github/instructions/design-thinking/dt-curriculum-04-brainstorming.instructions.md index eee71a7b7..ed349913d 100644 --- a/.github/instructions/design-thinking/dt-curriculum-04-brainstorming.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-04-brainstorming.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 4: Brainstorming โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-04*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-05-concepts.instructions.md b/.github/instructions/design-thinking/dt-curriculum-05-concepts.instructions.md index 0b285cd73..dea5e5eb2 100644 --- a/.github/instructions/design-thinking/dt-curriculum-05-concepts.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-05-concepts.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 5: User Concepts โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-05*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-06-prototypes.instructions.md b/.github/instructions/design-thinking/dt-curriculum-06-prototypes.instructions.md index 66ffdbcc1..4e91446ed 100644 --- a/.github/instructions/design-thinking/dt-curriculum-06-prototypes.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-06-prototypes.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 6: Low-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-06*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-07-testing.instructions.md b/.github/instructions/design-thinking/dt-curriculum-07-testing.instructions.md index abe07cdfa..f0cc97111 100644 --- a/.github/instructions/design-thinking/dt-curriculum-07-testing.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-07-testing.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 7: High-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-07*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-08-iteration.instructions.md b/.github/instructions/design-thinking/dt-curriculum-08-iteration.instructions.md index 137230cfc..7694008ce 100644 --- a/.github/instructions/design-thinking/dt-curriculum-08-iteration.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-08-iteration.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 8: User Testing โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-08*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-09-handoff.instructions.md b/.github/instructions/design-thinking/dt-curriculum-09-handoff.instructions.md index 97216888e..a0b39676c 100644 --- a/.github/instructions/design-thinking/dt-curriculum-09-handoff.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-09-handoff.instructions.md @@ -1,5 +1,5 @@ --- -description: 'DT Curriculum Module 9: Iteration at Scale โ€” concepts, techniques, checks, and exercises' +description: 'DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises' applyTo: '**/.copilot-tracking/dt/**/curriculum-09*' --- diff --git a/.github/instructions/design-thinking/dt-curriculum-scenario-manufacturing.instructions.md b/.github/instructions/design-thinking/dt-curriculum-scenario-manufacturing.instructions.md index a717df792..6e0c4fb38 100644 --- a/.github/instructions/design-thinking/dt-curriculum-scenario-manufacturing.instructions.md +++ b/.github/instructions/design-thinking/dt-curriculum-scenario-manufacturing.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Manufacturing reference scenario for DT learning โ€” factory floor improvement project used across all 9 curriculum modules' +description: 'Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules' applyTo: '**/.copilot-tracking/dt/**/curriculum-*' --- diff --git a/.github/instructions/design-thinking/dt-industry-energy.instructions.md b/.github/instructions/design-thinking/dt-industry-energy.instructions.md index fef744754..49a40bd8d 100644 --- a/.github/instructions/design-thinking/dt-industry-energy.instructions.md +++ b/.github/instructions/design-thinking/dt-industry-energy.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Energy industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios' +description: 'Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-industry-healthcare.instructions.md b/.github/instructions/design-thinking/dt-industry-healthcare.instructions.md index 926c6b118..560c34651 100644 --- a/.github/instructions/design-thinking/dt-industry-healthcare.instructions.md +++ b/.github/instructions/design-thinking/dt-industry-healthcare.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Healthcare industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios' +description: 'Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-industry-manufacturing.instructions.md b/.github/instructions/design-thinking/dt-industry-manufacturing.instructions.md index ebdd1828b..4f13643d4 100644 --- a/.github/instructions/design-thinking/dt-industry-manufacturing.instructions.md +++ b/.github/instructions/design-thinking/dt-industry-manufacturing.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Manufacturing industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios' +description: 'Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-method-03-deep.instructions.md b/.github/instructions/design-thinking/dt-method-03-deep.instructions.md index 3a77ebd2f..c5ea48810 100644 --- a/.github/instructions/design-thinking/dt-method-03-deep.instructions.md +++ b/.github/instructions/design-thinking/dt-method-03-deep.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Deep expertise for Method 3: Input Synthesis โ€” advanced affinity analysis, insight frameworks, and problem statement articulation' +description: 'Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-method-04-deep.instructions.md b/.github/instructions/design-thinking/dt-method-04-deep.instructions.md index 3213cf7dc..a396481ed 100644 --- a/.github/instructions/design-thinking/dt-method-04-deep.instructions.md +++ b/.github/instructions/design-thinking/dt-method-04-deep.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Deep expertise for Method 4: Brainstorming โ€” advanced facilitation techniques, creative block recovery, and convergence frameworks' +description: 'Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks' applyTo: '**/.copilot-tracking/dt/**/method-04*' --- diff --git a/.github/instructions/design-thinking/dt-method-08-deep.instructions.md b/.github/instructions/design-thinking/dt-method-08-deep.instructions.md index 0ea684a15..af8ea9af8 100644 --- a/.github/instructions/design-thinking/dt-method-08-deep.instructions.md +++ b/.github/instructions/design-thinking/dt-method-08-deep.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Deep expertise for Method 8: Test and Validate โ€” advanced test design, small-sample analysis, iteration triggers, and bias mitigation' +description: 'Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-method-09-deep.instructions.md b/.github/instructions/design-thinking/dt-method-09-deep.instructions.md index 22f5af58a..46c670a86 100644 --- a/.github/instructions/design-thinking/dt-method-09-deep.instructions.md +++ b/.github/instructions/design-thinking/dt-method-09-deep.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Deep expertise for Method 9: Iteration at Scale โ€” change management, scaling, and adoption measurement' +description: 'Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement' applyTo: '' --- diff --git a/.github/instructions/design-thinking/dt-method-09-iteration.instructions.md b/.github/instructions/design-thinking/dt-method-09-iteration.instructions.md index 267e00bc8..ec98e0410 100644 --- a/.github/instructions/design-thinking/dt-method-09-iteration.instructions.md +++ b/.github/instructions/design-thinking/dt-method-09-iteration.instructions.md @@ -1,5 +1,5 @@ --- -description: 'Design Thinking Method 9: Iteration at Scale โ€” systematic refinement, scaling patterns, and organizational deployment' +description: 'Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment' applyTo: '**/.copilot-tracking/dt/**/method-09*' --- diff --git a/.github/prompts/design-thinking/dt-handoff-problem-space.prompt.md b/.github/prompts/design-thinking/dt-handoff-problem-space.prompt.md index 621010208..79bb6b650 100644 --- a/.github/prompts/design-thinking/dt-handoff-problem-space.prompt.md +++ b/.github/prompts/design-thinking/dt-handoff-problem-space.prompt.md @@ -1,5 +1,5 @@ --- -description: 'Problem Space exit handoff โ€” compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher' +description: 'Problem Space exit handoff - compiles DT Methods 1-3 outputs into an RPI-ready artifact targeting Task Researcher' agent: 'agent' tools: ['read_file', 'create_file'] argument-hint: "project-slug=..." diff --git a/.github/prompts/design-thinking/dt-handoff-solution-space.prompt.md b/.github/prompts/design-thinking/dt-handoff-solution-space.prompt.md index a95cb4c30..d4394d004 100644 --- a/.github/prompts/design-thinking/dt-handoff-solution-space.prompt.md +++ b/.github/prompts/design-thinking/dt-handoff-solution-space.prompt.md @@ -1,5 +1,5 @@ --- -description: 'Solution Space exit handoff โ€” compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher' +description: 'Solution Space exit handoff - compiles DT Methods 4-6 outputs into an RPI-ready artifact targeting Task Researcher' agent: 'agent' tools: ['read_file', 'create_file'] argument-hint: "project-slug=..." diff --git a/.github/prompts/design-thinking/dt-resume-coaching.prompt.md b/.github/prompts/design-thinking/dt-resume-coaching.prompt.md index 2ed8d30c4..0d9dc53d4 100644 --- a/.github/prompts/design-thinking/dt-resume-coaching.prompt.md +++ b/.github/prompts/design-thinking/dt-resume-coaching.prompt.md @@ -1,5 +1,5 @@ --- -description: 'Resume a Design Thinking coaching session โ€” reads coaching state and re-establishes context - Brought to you by microsoft/hve-core' +description: 'Resume a Design Thinking coaching session - reads coaching state and re-establishes context - Brought to you by microsoft/hve-core' agent: DT Coach argument-hint: "project-slug=..." --- 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..dd060d455 100644 --- a/collections/ado.collection.md +++ b/collections/ado.collection.md @@ -1,4 +1,8 @@ -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. + +## Included Artifacts diff --git a/collections/coding-standards.collection.md b/collections/coding-standards.collection.md index 87d5b50e4..858a25924 100644 --- a/collections/coding-standards.collection.md +++ b/collections/coding-standards.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Chat Agents diff --git a/collections/data-science.collection.md b/collections/data-science.collection.md index 58f54c56d..fcad6dad0 100644 --- a/collections/data-science.collection.md +++ b/collections/data-science.collection.md @@ -1,8 +1,12 @@ +# 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] > The RAI agents and prompts in this collection are **assistive tools only**. They do not replace qualified human review, organizational RAI review boards, or regulatory compliance programs. All AI-generated RAI artifacts **must** be reviewed and validated by qualified professionals before use. AI outputs may contain inaccuracies, miss critical risks, or produce recommendations that are incomplete or inappropriate for your context. +## Included Artifacts + ### Chat Agents diff --git a/collections/design-thinking.collection.md b/collections/design-thinking.collection.md index fbc63e5d3..dca7f9028 100644 --- a/collections/design-thinking.collection.md +++ b/collections/design-thinking.collection.md @@ -1,6 +1,10 @@ +# 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. + +## Included Artifacts @@ -18,8 +22,8 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **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,7 +32,7 @@ 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 @@ -38,38 +42,38 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **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..b656695ff 100644 --- a/collections/experimental.collection.md +++ b/collections/experimental.collection.md @@ -1,5 +1,9 @@ +# Experimental + Experimental and preview artifacts not yet promoted to stable collections. Items in this collection may change or be removed without notice. +## Included Artifacts + ### Chat Agents diff --git a/collections/github.collection.md b/collections/github.collection.md index 0403f490f..f575c2ff9 100644 --- a/collections/github.collection.md +++ b/collections/github.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Chat Agents diff --git a/collections/gitlab.collection.md b/collections/gitlab.collection.md index ecd2da536..818844896 100644 --- a/collections/gitlab.collection.md +++ b/collections/gitlab.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Instructions diff --git a/collections/hve-core-all.collection.md b/collections/hve-core-all.collection.md index 0403a774a..5d95489f2 100644 --- a/collections/hve-core-all.collection.md +++ b/collections/hve-core-all.collection.md @@ -1,9 +1,16 @@ +# 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. + +## Included Artifacts @@ -86,8 +93,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 | @@ -96,7 +103,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 | @@ -168,38 +175,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 | diff --git a/collections/hve-core.collection.md b/collections/hve-core.collection.md index c2fac9a6b..6a339a6c9 100644 --- a/collections/hve-core.collection.md +++ b/collections/hve-core.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Chat Agents diff --git a/collections/installer.collection.md b/collections/installer.collection.md index f34c2fb43..e34327114 100644 --- a/collections/installer.collection.md +++ b/collections/installer.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Instructions diff --git a/collections/jira.collection.md b/collections/jira.collection.md index 12d1c1f82..43bb44d98 100644 --- a/collections/jira.collection.md +++ b/collections/jira.collection.md @@ -1,5 +1,9 @@ +# 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. +## Included Artifacts + ### Chat Agents diff --git a/collections/project-planning.collection.md b/collections/project-planning.collection.md index 292f67dba..e8101e894 100644 --- a/collections/project-planning.collection.md +++ b/collections/project-planning.collection.md @@ -1,4 +1,8 @@ -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. + +## Included Artifacts diff --git a/collections/security.collection.md b/collections/security.collection.md index 3f7f57a38..c79394f43 100644 --- a/collections/security.collection.md +++ b/collections/security.collection.md @@ -1,8 +1,12 @@ +# Security + Security review, planning, incident response, risk assessment, vulnerability analysis, supply chain security, and responsible AI assessment for cloud and hybrid environments. > [!CAUTION] > The security agents and prompts in this collection 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 artifacts **must** be reviewed and validated by qualified security professionals before use. AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. +## Included Artifacts + ### Chat Agents diff --git a/docs/agents/rai-planning/handoff-pipeline.md b/docs/agents/rai-planning/handoff-pipeline.md index 6556d1564..29c5c0433 100644 --- a/docs/agents/rai-planning/handoff-pipeline.md +++ b/docs/agents/rai-planning/handoff-pipeline.md @@ -147,7 +147,7 @@ Persisted RAI artifacts include transparency footers that communicate AI involve Every Phase 5 and Phase 6 artifact includes a transparency note at the end of the file: -> **Note** โ€” The author created this content with assistance from AI. All outputs should be reviewed and validated by a qualified human reviewer before use. +> **Note** - The author created this content with assistance from AI. All outputs should be reviewed and validated by a qualified human reviewer before use. ### Human Review Checkbox diff --git a/docs/agents/security/entry-modes.md b/docs/agents/security/entry-modes.md index a50bcca39..e319475cf 100644 --- a/docs/agents/security/entry-modes.md +++ b/docs/agents/security/entry-modes.md @@ -37,7 +37,7 @@ Activate From-PRD mode with the **Security Plan from PRD** prompt (`security-pla ```text Inputs: - project-slug (optional) โ€” Kebab-case project identifier + project-slug (optional) - Kebab-case project identifier ``` ### When to Choose From-PRD Mode @@ -66,7 +66,7 @@ Activate capture mode with the **Security Capture** prompt (`security-capture.pr ```text Inputs: - project-slug (optional) โ€” Kebab-case project identifier + project-slug (optional) - Kebab-case project identifier ``` If the user provides existing security notes or context in the initial message, the agent incorporates them into the interview rather than asking redundant questions. diff --git a/docs/security/dependency-pinning.md b/docs/security/dependency-pinning.md index 730f1c7a0..e335c9589 100644 --- a/docs/security/dependency-pinning.md +++ b/docs/security/dependency-pinning.md @@ -155,11 +155,11 @@ Any of these patterns within five lines of the download satisfies the check: ### Examples ```bash -# Accepted โ€” checksum verified immediately after download +# Accepted - checksum verified immediately after download curl -Lo tool.tar.gz https://example.com/tool-v1.0.tar.gz echo "abc123... tool.tar.gz" | sha256sum --check -# Rejected โ€” no checksum verification after download +# Rejected - no checksum verification after download wget https://example.com/tool-v1.0.tar.gz tar xzf tool-v1.0.tar.gz ``` diff --git a/docs/templates/rai-plan-template.md b/docs/templates/rai-plan-template.md index 43ee000b0..360f4e16e 100644 --- a/docs/templates/rai-plan-template.md +++ b/docs/templates/rai-plan-template.md @@ -195,7 +195,7 @@ Common tradeoff patterns: #### Description -[What needs to be done and why โ€” include the RAI benefit] +[What needs to be done and why - include the RAI benefit] #### Implementation Steps diff --git a/docs/templates/sssc-plan-template.md b/docs/templates/sssc-plan-template.md index 97fbf4f30..80c45c172 100644 --- a/docs/templates/sssc-plan-template.md +++ b/docs/templates/sssc-plan-template.md @@ -231,7 +231,7 @@ _Important to note:_ This supply chain security assessment cannot certify or att #### Description -[What needs to be done and why โ€” include the security benefit] +[What needs to be done and why - include the security benefit] #### Adoption Steps diff --git a/plugins/ado/README.md b/plugins/ado/README.md index 0872f25b7..64c6e8688 100644 --- a/plugins/ado/README.md +++ b/plugins/ado/README.md @@ -5,7 +5,11 @@ 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. + +## Included Artifacts diff --git a/plugins/coding-standards/README.md b/plugins/coding-standards/README.md index 5302b2343..e603e8690 100644 --- a/plugins/coding-standards/README.md +++ b/plugins/coding-standards/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Chat Agents diff --git a/plugins/data-science/README.md b/plugins/data-science/README.md index 5994e3dbc..6f9ec8bbf 100644 --- a/plugins/data-science/README.md +++ b/plugins/data-science/README.md @@ -8,11 +8,15 @@ Evaluation dataset creation, data specification generation, Jupyter notebooks, a ## 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] > The RAI agents and prompts in this collection are **assistive tools only**. They do not replace qualified human review, organizational RAI review boards, or regulatory compliance programs. All AI-generated RAI artifacts **must** be reviewed and validated by qualified professionals before use. AI outputs may contain inaccuracies, miss critical risks, or produce recommendations that are incomplete or inappropriate for your context. +## Included Artifacts + ### Chat Agents diff --git a/plugins/design-thinking/README.md b/plugins/design-thinking/README.md index 306e05081..7d40d71e0 100644 --- a/plugins/design-thinking/README.md +++ b/plugins/design-thinking/README.md @@ -7,9 +7,13 @@ 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. + +## Included Artifacts @@ -27,8 +31,8 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **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,7 +41,7 @@ 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 @@ -47,38 +51,38 @@ Coaching identity, quality constraints, and methodology instructions for AI-enha | **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 | @@ -109,11 +113,11 @@ copilot plugin install design-thinking@hve-core | Command | Description | |---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | dt-start-project | Start a new Design Thinking coaching project with state initialization and first coaching interaction - Brought to you by microsoft/hve-core | -| dt-resume-coaching | Resume a Design Thinking coaching session โ€” reads coaching state and re-establishes context - Brought to you by microsoft/hve-core | +| dt-resume-coaching | Resume a Design Thinking coaching session - reads coaching state and re-establishes context - Brought to you by microsoft/hve-core | | dt-method-next | Assess DT project state and recommend next method with sequencing validation - Brought to you by microsoft/hve-core | | 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-ideation | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation - Brought to you by microsoft/hve-core | | dt-method-04-convergence | Theme discovery for Design Thinking Method 4c through philosophy-based clustering - Brought to you by microsoft/hve-core | | dt-method-05-concepts | Concept articulation for Design Thinking Method 5b from brainstorming themes - Brought to you by microsoft/hve-core | @@ -136,7 +140,7 @@ copilot plugin install design-thinking@hve-core | dt-quality-constraints.instructions | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | dt-canonical-deck.instructions | Opt-in canonical deck and customer-card workflow for DT coaching | | dt-coaching-state.instructions | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| dt-industry-healthcare.instructions | Healthcare industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-healthcare.instructions | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | dt-rpi-handoff-contract.instructions | DT-to-RPI handoff contract defining exit points, artifact schemas, and per-agent input requirements for lateral transitions from Design Thinking to RPI workflow | | dt-subagent-handoff.instructions | DT subagent handoff workflow: readiness assessment, artifact compilation, and handoff validation via subagent dispatch | | dt-rpi-implement-context.instructions | DT-aware Task Implementor context: fidelity constraints, stakeholder validation, and iteration support | @@ -145,32 +149,32 @@ copilot plugin install design-thinking@hve-core | dt-rpi-review-context.instructions | DT-aware Task Reviewer context: quality criteria for Design Thinking artifacts | | dt-method-01-deep.instructions | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | dt-method-01-scope.instructions | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | -| dt-method-03-deep.instructions | Deep expertise for Method 3: Input Synthesis โ€” advanced affinity analysis, insight frameworks, and problem statement articulation | -| dt-method-04-deep.instructions | Deep expertise for Method 4: Brainstorming โ€” advanced facilitation techniques, creative block recovery, and convergence frameworks | +| dt-method-03-deep.instructions | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | +| dt-method-04-deep.instructions | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | dt-method-05-deep.instructions | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | dt-method-02-research.instructions | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | | dt-method-02-deep.instructions | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | dt-method-03-synthesis.instructions | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | -| dt-method-08-deep.instructions | Deep expertise for Method 8: Test and Validate โ€” advanced test design, small-sample analysis, iteration triggers, and bias mitigation | -| dt-method-09-iteration.instructions | Design Thinking Method 9: Iteration at Scale โ€” systematic refinement, scaling patterns, and organizational deployment | -| dt-method-09-deep.instructions | Deep expertise for Method 9: Iteration at Scale โ€” change management, scaling, and adoption measurement | +| dt-method-08-deep.instructions | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| dt-method-09-iteration.instructions | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | +| dt-method-09-deep.instructions | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | | dt-method-06-deep.instructions | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | -| dt-industry-manufacturing.instructions | Manufacturing industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | -| dt-industry-energy.instructions | Energy industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-manufacturing.instructions | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-energy.instructions | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | dt-image-prompt-generation.instructions | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | | dt-method-04-brainstorming.instructions | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | | dt-method-05-concepts.instructions | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | dt-method-06-lofi-prototypes.instructions | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | -| dt-curriculum-01-scoping.instructions | DT Curriculum Module 1: Scope Conversations โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-02-research.instructions | DT Curriculum Module 2: Design Research โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-03-synthesis.instructions | DT Curriculum Module 3: Synthesis โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-04-brainstorming.instructions | DT Curriculum Module 4: Brainstorming โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-05-concepts.instructions | DT Curriculum Module 5: User Concepts โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-06-prototypes.instructions | DT Curriculum Module 6: Low-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-07-testing.instructions | DT Curriculum Module 7: High-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-08-iteration.instructions | DT Curriculum Module 8: User Testing โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-09-handoff.instructions | DT Curriculum Module 9: Iteration at Scale โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-scenario-manufacturing.instructions | Manufacturing reference scenario for DT learning โ€” factory floor improvement project used across all 9 curriculum modules | +| dt-curriculum-01-scoping.instructions | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| dt-curriculum-02-research.instructions | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| dt-curriculum-03-synthesis.instructions | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| dt-curriculum-04-brainstorming.instructions | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| dt-curriculum-05-concepts.instructions | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| dt-curriculum-06-prototypes.instructions | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| dt-curriculum-07-testing.instructions | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| dt-curriculum-08-iteration.instructions | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| dt-curriculum-09-handoff.instructions | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| dt-curriculum-scenario-manufacturing.instructions | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | hve-core-location.instructions | 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. | --- diff --git a/plugins/experimental/README.md b/plugins/experimental/README.md index 42c50be35..72e66f84b 100644 --- a/plugins/experimental/README.md +++ b/plugins/experimental/README.md @@ -7,8 +7,12 @@ 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. +## Included Artifacts + ### Chat Agents diff --git a/plugins/github/README.md b/plugins/github/README.md index 3521c2417..49c888f14 100644 --- a/plugins/github/README.md +++ b/plugins/github/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Chat Agents diff --git a/plugins/gitlab/README.md b/plugins/gitlab/README.md index fd19126bf..a821a5b8b 100644 --- a/plugins/gitlab/README.md +++ b/plugins/gitlab/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Instructions diff --git a/plugins/hve-core-all/README.md b/plugins/hve-core-all/README.md index edab24775..9de6a6388 100644 --- a/plugins/hve-core-all/README.md +++ b/plugins/hve-core-all/README.md @@ -5,12 +5,19 @@ 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. + +## Included Artifacts @@ -93,8 +100,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 | @@ -103,7 +110,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 | @@ -175,38 +182,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 | @@ -363,8 +370,8 @@ copilot plugin install hve-core-all@hve-core | dt-canonical-deck | Unified canonical deck workflow for opt-in offer, snapshot generation/refresh, and optional customer-card PowerPoint build - Brought to you by microsoft/hve-core | | dt-figma-export | Export Design Thinking artifacts to a collaborative FigJam board or Figma Design file using the official Figma MCP server - Brought to you by microsoft/hve-core | | 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 - Brought to you by microsoft/hve-core | | dt-method-04-ideation | Divergent ideation for Design Thinking Method 4b with constraint-informed solution generation - Brought to you by microsoft/hve-core | | dt-method-05-concepts | Concept articulation for Design Thinking Method 5b from brainstorming themes - Brought to you by microsoft/hve-core | @@ -373,7 +380,7 @@ copilot plugin install hve-core-all@hve-core | dt-method-06-planning | Concept analysis and prototype approach design for Design Thinking Method 6a - Brought to you by microsoft/hve-core | | dt-method-06-testing | Hypothesis-driven testing and constraint validation for Design Thinking Method 6c - Brought to you by microsoft/hve-core | | dt-method-next | Assess DT project state and recommend next method with sequencing validation - Brought to you by microsoft/hve-core | -| dt-resume-coaching | Resume a Design Thinking coaching session โ€” reads coaching state and re-establishes context - Brought to you by microsoft/hve-core | +| dt-resume-coaching | Resume a Design Thinking coaching session - reads coaching state and re-establishes context - Brought to you by microsoft/hve-core | | dt-start-project | Start a new Design Thinking coaching project with state initialization and first coaching interaction - Brought to you by microsoft/hve-core | | github-add-issue | Create a GitHub issue using discovered repository templates and conversational field collection | | github-discover-issues | Discover GitHub issues through user-centric queries, artifact-driven analysis, or search-based exploration and produce planning files for review | @@ -446,38 +453,38 @@ copilot plugin install hve-core-all@hve-core | dt-canonical-deck.instructions | Opt-in canonical deck and customer-card workflow for DT coaching | | dt-coaching-identity.instructions | 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. | | dt-coaching-state.instructions | Coaching state schema for Design Thinking session persistence, method progress tracking, and session recovery | -| dt-curriculum-01-scoping.instructions | DT Curriculum Module 1: Scope Conversations โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-02-research.instructions | DT Curriculum Module 2: Design Research โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-03-synthesis.instructions | DT Curriculum Module 3: Synthesis โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-04-brainstorming.instructions | DT Curriculum Module 4: Brainstorming โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-05-concepts.instructions | DT Curriculum Module 5: User Concepts โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-06-prototypes.instructions | DT Curriculum Module 6: Low-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-07-testing.instructions | DT Curriculum Module 7: High-Fidelity Prototypes โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-08-iteration.instructions | DT Curriculum Module 8: User Testing โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-09-handoff.instructions | DT Curriculum Module 9: Iteration at Scale โ€” concepts, techniques, checks, and exercises | -| dt-curriculum-scenario-manufacturing.instructions | Manufacturing reference scenario for DT learning โ€” factory floor improvement project used across all 9 curriculum modules | +| dt-curriculum-01-scoping.instructions | DT Curriculum Module 1: Scope Conversations - concepts, techniques, checks, and exercises | +| dt-curriculum-02-research.instructions | DT Curriculum Module 2: Design Research - concepts, techniques, checks, and exercises | +| dt-curriculum-03-synthesis.instructions | DT Curriculum Module 3: Synthesis - concepts, techniques, checks, and exercises | +| dt-curriculum-04-brainstorming.instructions | DT Curriculum Module 4: Brainstorming - concepts, techniques, checks, and exercises | +| dt-curriculum-05-concepts.instructions | DT Curriculum Module 5: User Concepts - concepts, techniques, checks, and exercises | +| dt-curriculum-06-prototypes.instructions | DT Curriculum Module 6: Low-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| dt-curriculum-07-testing.instructions | DT Curriculum Module 7: High-Fidelity Prototypes - concepts, techniques, checks, and exercises | +| dt-curriculum-08-iteration.instructions | DT Curriculum Module 8: User Testing - concepts, techniques, checks, and exercises | +| dt-curriculum-09-handoff.instructions | DT Curriculum Module 9: Iteration at Scale - concepts, techniques, checks, and exercises | +| dt-curriculum-scenario-manufacturing.instructions | Manufacturing reference scenario for DT learning - factory floor improvement project used across all 9 curriculum modules | | dt-image-prompt-generation.instructions | M365 Copilot image prompt generation techniques for Design Thinking Method 5 concept visualization with lo-fi enforcement | -| dt-industry-energy.instructions | Energy industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | -| dt-industry-healthcare.instructions | Healthcare industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | -| dt-industry-manufacturing.instructions | Manufacturing industry context for DT coaching โ€” vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-energy.instructions | Energy industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-healthcare.instructions | Healthcare industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | +| dt-industry-manufacturing.instructions | Manufacturing industry context for DT coaching - vocabulary, constraints, empathy tools, and reference scenarios | | dt-method-01-deep.instructions | Deep expertise for Method 1: Scope Conversations, covering advanced stakeholder analysis, power dynamics, and scope negotiation | | dt-method-01-scope.instructions | Method 1 Scope Conversations coaching knowledge for Design Thinking: frozen vs fluid assessment, stakeholder discovery, constraint patterns, and conversation navigation | | dt-method-02-deep.instructions | Deep expertise for Method 2: Design Research, covering advanced interview techniques, ethnographic observation, and evidence triangulation | | dt-method-02-research.instructions | Method 2 Design Research coaching knowledge: interview techniques, research planning, environmental observation, and insight extraction patterns | -| dt-method-03-deep.instructions | Deep expertise for Method 3: Input Synthesis โ€” advanced affinity analysis, insight frameworks, and problem statement articulation | +| dt-method-03-deep.instructions | Deep expertise for Method 3: Input Synthesis - advanced affinity analysis, insight frameworks, and problem statement articulation | | dt-method-03-synthesis.instructions | Method 3 Input Synthesis coaching knowledge: pattern recognition, theme development, synthesis validation, and Problem-to-Solution Space transition readiness | | dt-method-04-brainstorming.instructions | Design Thinking Method 4: AI-assisted brainstorming with divergent ideation and convergent clustering for solution space entry | -| dt-method-04-deep.instructions | Deep expertise for Method 4: Brainstorming โ€” advanced facilitation techniques, creative block recovery, and convergence frameworks | +| dt-method-04-deep.instructions | Deep expertise for Method 4: Brainstorming - advanced facilitation techniques, creative block recovery, and convergence frameworks | | dt-method-05-concepts.instructions | Design Thinking Method 5: User Concepts coaching with concept articulation, three-lens evaluation, and stakeholder alignment for Solution Space development | | dt-method-05-deep.instructions | Deep expertise for Method 5: User Concepts, covering advanced D/F/V analysis, image prompt crafting, concept stress-testing, and portfolio management | | dt-method-06-deep.instructions | Deep expertise for Method 6: Low-Fidelity Prototypes; advanced paper prototyping, service blueprinting, and experience prototyping | | dt-method-06-lofi-prototypes.instructions | Design Thinking Method 6: Lo-fi prototyping techniques, scrappy enforcement, feedback planning, and constraint discovery for Solution Space exit | | dt-method-07-deep.instructions | Deep expertise for Method 7: High-Fidelity Prototypes; fidelity translation, architecture, and specification writing | | dt-method-07-hifi-prototypes.instructions | Design Thinking Method 7: High-Fidelity Prototypes; technical translation, functional prototypes, and specifications | -| dt-method-08-deep.instructions | Deep expertise for Method 8: Test and Validate โ€” advanced test design, small-sample analysis, iteration triggers, and bias mitigation | +| dt-method-08-deep.instructions | Deep expertise for Method 8: Test and Validate - advanced test design, small-sample analysis, iteration triggers, and bias mitigation | | dt-method-08-testing.instructions | Design Thinking Method 8: User Testing - evidence-based evaluation, test protocols, and non-linear iteration support | -| dt-method-09-deep.instructions | Deep expertise for Method 9: Iteration at Scale โ€” change management, scaling, and adoption measurement | -| dt-method-09-iteration.instructions | Design Thinking Method 9: Iteration at Scale โ€” systematic refinement, scaling patterns, and organizational deployment | +| dt-method-09-deep.instructions | Deep expertise for Method 9: Iteration at Scale - change management, scaling, and adoption measurement | +| dt-method-09-iteration.instructions | Design Thinking Method 9: Iteration at Scale - systematic refinement, scaling patterns, and organizational deployment | | dt-method-sequencing.instructions | Method transition rules, nine-method sequence, space boundaries, and non-linear iteration support for Design Thinking coaching | | dt-quality-constraints.instructions | Quality constraints, fidelity rules, and output standards for Design Thinking coaching across all nine methods | | dt-rpi-handoff-contract.instructions | 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/hve-core/README.md b/plugins/hve-core/README.md index a5168e197..f45e4f983 100644 --- a/plugins/hve-core/README.md +++ b/plugins/hve-core/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Chat Agents diff --git a/plugins/installer/README.md b/plugins/installer/README.md index bdb6c7ebe..999661f72 100644 --- a/plugins/installer/README.md +++ b/plugins/installer/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Instructions diff --git a/plugins/jira/README.md b/plugins/jira/README.md index cad583e67..9351f33d3 100644 --- a/plugins/jira/README.md +++ b/plugins/jira/README.md @@ -5,8 +5,12 @@ 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. +## Included Artifacts + ### Chat Agents diff --git a/plugins/project-planning/README.md b/plugins/project-planning/README.md index 0da6f2bc9..0787fd6dc 100644 --- a/plugins/project-planning/README.md +++ b/plugins/project-planning/README.md @@ -5,7 +5,11 @@ 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. + +## Included Artifacts diff --git a/plugins/security/README.md b/plugins/security/README.md index da25c742b..972f1496e 100644 --- a/plugins/security/README.md +++ b/plugins/security/README.md @@ -8,11 +8,15 @@ 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] > The security agents and prompts in this collection 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 artifacts **must** be reviewed and validated by qualified security professionals before use. AI outputs may contain inaccuracies, miss critical threats, or produce recommendations that are incomplete or inappropriate for your environment. +## Included Artifacts + ### Chat Agents diff --git a/scripts/extension/Prepare-Extension.ps1 b/scripts/extension/Prepare-Extension.ps1 index 74a5d46d9..08bf5be94 100644 --- a/scripts/extension/Prepare-Extension.ps1 +++ b/scripts/extension/Prepare-Extension.ps1 @@ -463,9 +463,11 @@ function New-CollectionReadme { $null = $artifactSections.AppendLine() } - # Write back updated artifact section into collection.md when markers are present + # Write back updated artifact section into collection.md when markers are present. + # Wrap the generated h3 sections under an h2 so collection.md stays compliant + # with MD001 heading-increment when the file begins with an h1 title. if ($parsed.HasMarkers) { - $generatedBlock = $artifactSections.ToString().TrimEnd() + $generatedBlock = "## Included Artifacts`n`n" + $artifactSections.ToString().TrimEnd() $updatedCollectionMd = "$($parsed.Intro)`n`n$($CollectionMdBeginMarker)`n`n$generatedBlock`n`n$($CollectionMdEndMarker)" if (-not [string]::IsNullOrWhiteSpace($parsed.Footer)) { $updatedCollectionMd += "`n`n$($parsed.Footer.TrimEnd())"