# feat(extension): update extension documentation and packaging

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
 

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

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"
       }
     ]
   },

scripts/extension/Prepare-Extension.ps1

@@ -130,19 +130,28 @@ 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
 
     foreach ($agentFile in $agentFiles) {
         # 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"