diff --git a/docs/getting-started/methods/extension.md b/docs/getting-started/methods/extension.md index 1699323..1d170ec 100644 --- a/docs/getting-started/methods/extension.md +++ b/docs/getting-started/methods/extension.md @@ -86,12 +86,12 @@ After installation, verify everything works: The extension provides all HVE-Core components: -| Component | Count | Examples | -|----------------|-------|-----------------------------------------------| -| Chat Agents | 16 | task-planner, pr-review, adr-creation | -| Prompts | 10 | git-commit, pull-request, ado-create-pr | -| Instructions | 16 | markdown, python-script, commit-message | -| Dev Tools | 2 | Generate-PrReference.ps1, pr-ref-gen.sh | +| Component | Examples | +|--------------|-----------------------------------------------| +| Chat Agents | task-planner, pr-review, adr-creation | +| Prompts | git-commit, pull-request, ado-create-pr | +| Instructions | markdown, python-script, commit-message | +| Dev Tools | Generate-PrReference.ps1, pr-ref-gen.sh | ## Updating diff --git a/extension/README.md b/extension/README.md index 7adbab0..f5949a4 100644 --- a/extension/README.md +++ b/extension/README.md @@ -1,10 +1,4 @@ ---- -title: HVE Core - AI-Powered Development Assistant -description: AI-powered chat agents, prompts, and instructions for hybrid virtual environments -author: Microsoft -ms.date: 2025-12-19 -ms.topic: overview ---- +# HVE Core - AI-Powered Development Assistant > AI-powered chat agents, prompts, and instructions for hybrid virtual environments @@ -18,6 +12,7 @@ Specialized AI assistants for specific development tasks: #### Development Workflow +- **rpi-agent** - Professional evidence-backed agent with structured subagent delegation for research, codebase discovery, and complex tasks - **task-researcher** - Research technical solutions and approaches - **task-planner** - Plan and break down complex tasks - **task-implementor** - Implement tasks from detailed plans @@ -67,7 +62,7 @@ Best practice guidelines for: After installing this extension, the chat agents will be available in GitHub Copilot Chat. You can: -1. **Use chat agents** by typing `@agent-name` in Copilot Chat +1. **Use custom agents** by selecting the custom agent from the agent picker drop-down list in Copilot Chat 2. **Apply prompts** through the Copilot Chat interface 3. **Reference instructions** - They're automatically applied based on file patterns @@ -76,9 +71,9 @@ After installing this extension, the chat agents will be available in GitHub Cop ### Using Chat Agents ```plaintext -@task-planner help me break down this feature into implementable tasks -@pr-review review this pull request for security issues -@adr-creation create an ADR for our new microservice architecture +task-planner help me break down this feature into implementable tasks +pr-review review this pull request for security issues +adr-creation create an ADR for our new microservice architecture ``` ### Applying Prompts diff --git a/extension/package.json b/extension/package.json index 1c35eb3..708c2b2 100644 --- a/extension/package.json +++ b/extension/package.json @@ -71,6 +71,11 @@ "path": "./.github/chatmodes/prompt-builder.chatmode.md", "description": "Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/hve-core" }, + { + "name": "rpi-agent", + "path": "./.github/chatmodes/rpi-agent.chatmode.md", + "description": "Professional evidence-backed agent with structured subagent delegation for research, codebase discovery, and complex tasks - Brought to you by microsoft/hve-core" + }, { "name": "security-plan-creator", "path": "./.github/chatmodes/security-plan-creator.chatmode.md", @@ -147,6 +152,16 @@ "name": "pull-request", "path": "./.github/prompts/pull-request.prompt.md", "description": "Provides prompt instructions for pull request (PR) generation - Brought to you by microsoft/edge-ai" + }, + { + "name": "task-plan", + "path": "./.github/prompts/task-plan.prompt.md", + "description": "Initiates planning for task implementation based on validated research documents - Brought to you by microsoft/hve-core" + }, + { + "name": "task-research", + "path": "./.github/prompts/task-research.prompt.md", + "description": "Initiates research for task implementation based on user requirements and conversation context - Brought to you by microsoft/hve-core" } ], "chatInstructions": [ @@ -229,6 +244,11 @@ "name": "uv-projects-instructions", "path": "./.github/instructions/uv-projects.instructions.md", "description": "Instructions for Uv Projects" + }, + { + "name": "writing-style-instructions", + "path": "./.github/instructions/writing-style.instructions.md", + "description": "Required writing style conventions for voice, tone, and language in all markdown content" } ] }, diff --git a/scripts/extension/Prepare-Extension.ps1 b/scripts/extension/Prepare-Extension.ps1 index 950999a..7468431 100644 --- a/scripts/extension/Prepare-Extension.ps1 +++ b/scripts/extension/Prepare-Extension.ps1 @@ -130,12 +130,15 @@ if ($version -notmatch '^\d+\.\d+\.\d+$') { Write-Host " Using version: $version" -ForegroundColor Green -# Discover chat agents +# Discover chat agents (excluding hve-core-installer which is for manual installation only) Write-Host "" Write-Host "🔍 Discovering chat agents..." -ForegroundColor Yellow $agentsDir = Join-Path $GitHubDir "agents" $chatAgents = @() +# Agents to exclude from extension packaging +$excludedAgents = @('hve-core-installer') + if (Test-Path $agentsDir) { $agentFiles = Get-ChildItem -Path $agentsDir -Filter "*.agent.md" | Sort-Object Name @@ -143,6 +146,12 @@ if (Test-Path $agentsDir) { # Extract agent name from filename (e.g., hve-core-installer.agent.md -> hve-core-installer) $agentName = $agentFile.BaseName -replace '\.agent$', '' + # Skip excluded agents + if ($excludedAgents -contains $agentName) { + Write-Host " ⏭️ $agentName (excluded)" -ForegroundColor DarkGray + continue + } + # Extract description from YAML frontmatter $description = Get-DescriptionFromYaml -FilePath $agentFile.FullName -FallbackDescription "AI agent for $agentName"