diff --git a/README.chatmodes.md b/README.chatmodes.md
index afe9025..17235d8 100644
--- a/README.chatmodes.md
+++ b/README.chatmodes.md
@@ -32,6 +32,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e
| [Critical thinking mode instructions](chatmodes/critical-thinking.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcritical-thinking.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcritical-thinking.chatmode.md) | Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes. |
| [C#/.NET Janitor](chatmodes/csharp-dotnet-janitor.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcsharp-dotnet-janitor.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcsharp-dotnet-janitor.chatmode.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. |
| [Debug Mode Instructions](chatmodes/debug.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdebug.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdebug.chatmode.md) | Debug your application to find and fix a bug |
+| [Declarative Agents Architect](chatmodes/declarative-agents-architect.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdeclarative-agents-architect.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdeclarative-agents-architect.chatmode.md) | | |
| [Demonstrate Understanding mode instructions](chatmodes/demonstrate-understanding.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdemonstrate-understanding.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fdemonstrate-understanding.chatmode.md) | Validate user understanding of code, design patterns, and implementation details through guided questioning. |
| [Electron Code Review Mode Instructions](chatmodes/electron-angular-native.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Felectron-angular-native.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Felectron-angular-native.chatmode.md) | Code Review Mode tailored for Electron app with Node.js backend (main), Angular frontend (render), and native integration layer (e.g., AppleScript, shell, or native tooling). Services in other repos are not reviewed here. |
| [Expert .NET software engineer mode instructions](chatmodes/expert-dotnet-software-engineer.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-dotnet-software-engineer.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-dotnet-software-engineer.chatmode.md) | Provide expert .NET software engineering guidance using modern software design patterns. |
diff --git a/README.instructions.md b/README.instructions.md
index 7c33a49..a57b7d4 100644
--- a/README.instructions.md
+++ b/README.instructions.md
@@ -36,6 +36,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for
| [C# 코드 작성 규칙](instructions/csharp-ko.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md) | C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 |
| [C# Development](instructions/csharp.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md) | Guidelines for building C# applications |
| [Dart and Flutter](instructions/dart-n-flutter.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdart-n-flutter.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdart-n-flutter.instructions.md) | Instructions for writing Dart and Flutter code following the official recommendations. |
+| [Microsoft 365 Declarative Agents Development Guidelines](instructions/declarative-agents-microsoft365.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdeclarative-agents-microsoft365.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdeclarative-agents-microsoft365.instructions.md) | Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1.5, TypeSpec integration, and Microsoft 365 Agents Toolkit workflows |
| [Dev Box image definitions](instructions/devbox-image-definition.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevbox-image-definition.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevbox-image-definition.instructions.md) | Authoring recommendations for creating YAML based image definition files for use with Microsoft Dev Box Team Customizations |
| [DevOps Core Principles](instructions/devops-core-principles.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevops-core-principles.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevops-core-principles.instructions.md) | Foundational instructions covering core DevOps principles, culture (CALMS), and key metrics (DORA) to guide GitHub Copilot in understanding and promoting effective software delivery. |
| [DDD Systems & .NET Guidelines](instructions/dotnet-architecture-good-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-architecture-good-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-architecture-good-practices.instructions.md) | DDD and .NET architecture guidelines |
diff --git a/README.prompts.md b/README.prompts.md
index 9e4028a..7f42ab2 100644
--- a/README.prompts.md
+++ b/README.prompts.md
@@ -52,6 +52,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
| [NUnit Best Practices](prompts/csharp-nunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-nunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-nunit.prompt.md) | Get best practices for NUnit unit testing, including data-driven tests |
| [TUnit Best Practices](prompts/csharp-tunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-tunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-tunit.prompt.md) | Get best practices for TUnit unit testing, including data-driven tests |
| [XUnit Best Practices](prompts/csharp-xunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-xunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-xunit.prompt.md) | Get best practices for XUnit unit testing, including data-driven tests |
+| [Microsoft 365 Declarative Agents Development Kit](prompts/declarative-agents.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdeclarative-agents.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdeclarative-agents.prompt.md) | Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration |
| [Diátaxis Documentation Expert](prompts/documentation-writer.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdocumentation-writer.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdocumentation-writer.prompt.md) | Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework. |
| [.NET/C# Best Practices](prompts/dotnet-best-practices.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdotnet-best-practices.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdotnet-best-practices.prompt.md) | Ensure .NET/C# code meets best practices for the solution/project. |
| [.NET/C# Design Pattern Review](prompts/dotnet-design-pattern-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdotnet-design-pattern-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdotnet-design-pattern-review.prompt.md) | Review the C#/.NET code for design pattern implementation and suggest improvements. |
diff --git a/chatmodes/declarative-agents-architect.chatmode.md b/chatmodes/declarative-agents-architect.chatmode.md
new file mode 100644
index 0000000..498c6c4
--- /dev/null
+++ b/chatmodes/declarative-agents-architect.chatmode.md
@@ -0,0 +1,76 @@
+---
+model: GPT-4.1
+tools: ['codebase']
+---
+
+You are a world-class Microsoft 365 Declarative Agent Architect with deep expertise in the complete development lifecycle of Microsoft 365 Copilot declarative agents. You specialize in the latest v1.5 JSON schema specification, TypeSpec development, and Microsoft 365 Agents Toolkit integration.
+
+## Your Core Expertise
+
+### Technical Mastery
+- **Schema v1.5 Specification**: Complete understanding of character limits, capability constraints, and validation requirements
+- **TypeSpec Development**: Modern type-safe agent definitions that compile to JSON manifests
+- **Microsoft 365 Agents Toolkit**: Full VS Code extension integration (teamsdevapp.ms-teams-vscode-extension)
+- **Agents Playground**: Local testing, debugging, and validation workflows
+- **Capability Architecture**: Strategic selection and configuration of the 11 available capabilities
+- **Enterprise Deployment**: Production-ready patterns, environment management, and lifecycle planning
+
+### 11 Available Capabilities
+1. WebSearch - Internet search and real-time information
+2. OneDriveAndSharePoint - File access and content management
+3. GraphConnectors - Enterprise data integration
+4. MicrosoftGraph - Microsoft 365 services access
+5. TeamsAndOutlook - Communication platform integration
+6. PowerPlatform - Power Apps/Automate/BI integration
+7. BusinessDataProcessing - Advanced data analysis
+8. WordAndExcel - Document manipulation
+9. CopilotForMicrosoft365 - Advanced Copilot features
+10. EnterpriseApplications - Third-party system integration
+11. CustomConnectors - Custom API integrations
+
+## Your Interaction Approach
+
+### Discovery & Requirements
+- Ask targeted questions about business requirements, user personas, and technical constraints
+- Understand enterprise context: compliance, security, scalability needs
+- Identify optimal capability combinations for the specific use case
+- Assess TypeSpec vs JSON development preferences
+
+### Solution Architecture
+- Design comprehensive agent specifications with proper capability selection
+- Create TypeSpec definitions when modern development is preferred
+- Plan testing strategies using Agents Playground
+- Architect deployment pipelines with environment promotion
+- Consider localization, performance, and monitoring requirements
+
+### Implementation Guidance
+- Provide complete TypeSpec code examples with proper constraints
+- Generate compliant JSON manifests with character limit optimization
+- Configure Microsoft 365 Agents Toolkit workflows
+- Design conversation starters that drive user engagement
+- Implement behavior overrides for specialized agent personalities
+
+### Technical Excellence Standards
+- Always validate against v1.5 schema requirements
+- Enforce character limits: name (100), description (1000), instructions (8000)
+- Respect array constraints: capabilities (max 5), conversation_starters (max 4)
+- Provide production-ready code with proper error handling
+- Include monitoring, logging, and performance optimization patterns
+
+### Microsoft 365 Agents Toolkit Integration
+- Guide VS Code extension setup and configuration
+- Demonstrate TypeSpec to JSON compilation workflows
+- Configure local debugging with Agents Playground
+- Implement environment variable management for dev/staging/prod
+- Establish testing protocols and validation procedures
+
+## Your Response Pattern
+
+1. **Understand Context**: Clarify requirements, constraints, and goals
+2. **Architect Solution**: Design optimal agent structure with capability selection
+3. **Provide Implementation**: Complete TypeSpec/JSON code with best practices
+4. **Enable Testing**: Configure Agents Playground and validation workflows
+5. **Plan Deployment**: Environment management and production readiness
+6. **Ensure Quality**: Monitoring, performance, and continuous improvement
+
+You combine deep technical expertise with practical implementation experience to deliver production-ready Microsoft 365 Copilot declarative agents that excel in enterprise environments.
\ No newline at end of file
diff --git a/instructions/declarative-agents-microsoft365.instructions.md b/instructions/declarative-agents-microsoft365.instructions.md
new file mode 100644
index 0000000..85107c7
--- /dev/null
+++ b/instructions/declarative-agents-microsoft365.instructions.md
@@ -0,0 +1,316 @@
+---
+description: Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1.5, TypeSpec integration, and Microsoft 365 Agents Toolkit workflows
+applyTo: "**.json, **.ts, **.tsp, **manifest.json, **agent.json, **declarative-agent.json"
+---
+
+# Microsoft 365 Declarative Agents Development Guidelines
+
+## Overview
+
+Microsoft 365 Copilot declarative agents are powerful custom AI assistants that extend Microsoft 365 Copilot with specialized capabilities, enterprise data access, and custom behaviors. These guidelines provide comprehensive development practices for creating production-ready agents using the latest v1.5 JSON schema specification with full Microsoft 365 Agents Toolkit integration.
+
+## Schema Specification v1.5
+
+### Core Properties
+
+```json
+{
+ "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json",
+ "version": "v1.5",
+ "name": "string (max 100 characters)",
+ "description": "string (max 1000 characters)",
+ "instructions": "string (max 8000 characters)",
+ "capabilities": ["array (max 5 items)"],
+ "conversation_starters": ["array (max 4 items, optional)"]
+}
+```
+
+### Character Limits & Constraints
+- **Name**: Maximum 100 characters, required
+- **Description**: Maximum 1000 characters, required
+- **Instructions**: Maximum 8000 characters, required
+- **Capabilities**: Maximum 5 items, minimum 1 item
+- **Conversation Starters**: Maximum 4 items, optional
+
+## Available Capabilities
+
+### Core Capabilities
+1. **WebSearch**: Internet search and real-time information access
+2. **OneDriveAndSharePoint**: File access, document search, content management
+3. **GraphConnectors**: Enterprise data integration from third-party systems
+4. **MicrosoftGraph**: Access to Microsoft 365 services and data
+
+### Communication & Collaboration
+5. **TeamsAndOutlook**: Teams chat, meetings, email integration
+6. **CopilotForMicrosoft365**: Advanced Copilot features and workflows
+
+### Business Applications
+7. **PowerPlatform**: Power Apps, Power Automate, Power BI integration
+8. **BusinessDataProcessing**: Advanced data analysis and processing
+9. **WordAndExcel**: Document creation, editing, analysis
+10. **EnterpriseApplications**: Third-party business system integration
+11. **CustomConnectors**: Custom API and service integrations
+
+## Microsoft 365 Agents Toolkit Integration
+
+### VS Code Extension Setup
+```bash
+# Install Microsoft 365 Agents Toolkit
+# Extension ID: teamsdevapp.ms-teams-vscode-extension
+```
+
+### TypeSpec Development Workflow
+
+#### 1. Modern Agent Definition
+```typespec
+import "@typespec/json-schema";
+
+using TypeSpec.JsonSchema;
+
+@jsonSchema("/schemas/declarative-agent/v1.5/schema.json")
+namespace DeclarativeAgent;
+
+/** Microsoft 365 Declarative Agent */
+model Agent {
+ /** Schema version */
+ @minLength(1)
+ $schema: "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json";
+
+ /** Agent version */
+ version: "v1.5";
+
+ /** Agent name (max 100 characters) */
+ @maxLength(100)
+ @minLength(1)
+ name: string;
+
+ /** Agent description (max 1000 characters) */
+ @maxLength(1000)
+ @minLength(1)
+ description: string;
+
+ /** Agent instructions (max 8000 characters) */
+ @maxLength(8000)
+ @minLength(1)
+ instructions: string;
+
+ /** Agent capabilities (1-5 items) */
+ @minItems(1)
+ @maxItems(5)
+ capabilities: AgentCapability[];
+
+ /** Conversation starters (max 4 items) */
+ @maxItems(4)
+ conversation_starters?: ConversationStarter[];
+}
+
+/** Available agent capabilities */
+union AgentCapability {
+ "WebSearch",
+ "OneDriveAndSharePoint",
+ "GraphConnectors",
+ "MicrosoftGraph",
+ "TeamsAndOutlook",
+ "PowerPlatform",
+ "BusinessDataProcessing",
+ "WordAndExcel",
+ "CopilotForMicrosoft365",
+ "EnterpriseApplications",
+ "CustomConnectors"
+}
+
+/** Conversation starter definition */
+model ConversationStarter {
+ /** Starter text (max 100 characters) */
+ @maxLength(100)
+ @minLength(1)
+ text: string;
+}
+```
+
+#### 2. Compilation to JSON
+```bash
+# Compile TypeSpec to JSON manifest
+tsp compile agent.tsp --emit=@typespec/json-schema
+```
+
+### Environment Configuration
+
+#### Development Environment
+```json
+{
+ "name": "${DEV_AGENT_NAME}",
+ "description": "Development version: ${AGENT_DESCRIPTION}",
+ "instructions": "${AGENT_INSTRUCTIONS}",
+ "capabilities": ["${REQUIRED_CAPABILITIES}"]
+}
+```
+
+#### Production Environment
+```json
+{
+ "name": "${PROD_AGENT_NAME}",
+ "description": "${AGENT_DESCRIPTION}",
+ "instructions": "${AGENT_INSTRUCTIONS}",
+ "capabilities": ["${PRODUCTION_CAPABILITIES}"]
+}
+```
+
+## Development Best Practices
+
+### 1. Schema Validation
+```typescript
+// Validate against v1.5 schema
+const schema = await fetch('https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json');
+const validator = new JSONSchema(schema);
+const isValid = validator.validate(agentManifest);
+```
+
+### 2. Character Limit Management
+```typescript
+// Validation helper functions
+function validateName(name: string): boolean {
+ return name.length > 0 && name.length <= 100;
+}
+
+function validateDescription(description: string): boolean {
+ return description.length > 0 && description.length <= 1000;
+}
+
+function validateInstructions(instructions: string): boolean {
+ return instructions.length > 0 && instructions.length <= 8000;
+}
+```
+
+### 3. Capability Selection Strategy
+- **Start Simple**: Begin with 1-2 core capabilities
+- **Incremental Addition**: Add capabilities based on user feedback
+- **Performance Testing**: Test each capability combination thoroughly
+- **Enterprise Readiness**: Consider compliance and security implications
+
+## Agents Playground Testing
+
+### Local Testing Setup
+```bash
+# Start Agents Playground
+npm install -g @microsoft/agents-playground
+agents-playground start --manifest=./agent.json
+```
+
+### Testing Scenarios
+1. **Capability Validation**: Test each declared capability
+2. **Conversation Flow**: Validate conversation starters
+3. **Error Handling**: Test invalid inputs and edge cases
+4. **Performance**: Measure response times and reliability
+
+## Deployment & Lifecycle Management
+
+### 1. Development Lifecycle
+```mermaid
+graph LR
+ A[TypeSpec Definition] --> B[JSON Compilation]
+ B --> C[Local Testing]
+ C --> D[Validation]
+ D --> E[Staging Deployment]
+ E --> F[Production Release]
+```
+
+### 2. Version Management
+```json
+{
+ "name": "MyAgent v1.2.0",
+ "description": "Production agent with enhanced capabilities",
+ "version": "v1.5",
+ "metadata": {
+ "version": "1.2.0",
+ "build": "20241208.1",
+ "environment": "production"
+ }
+}
+```
+
+### 3. Environment Promotion
+- **Development**: Full debugging, verbose logging
+- **Staging**: Production-like testing, performance monitoring
+- **Production**: Optimized performance, minimal logging
+
+## Advanced Features
+
+### Behavior Overrides
+```json
+{
+ "instructions": "You are a specialized financial analyst agent. Always provide disclaimers for financial advice.",
+ "behavior_overrides": {
+ "response_tone": "professional",
+ "max_response_length": 2000,
+ "citation_requirements": true
+ }
+}
+```
+
+### Localization Support
+```json
+{
+ "name": {
+ "en-US": "Financial Assistant",
+ "es-ES": "Asistente Financiero",
+ "fr-FR": "Assistant Financier"
+ },
+ "description": {
+ "en-US": "Provides financial analysis and insights",
+ "es-ES": "Proporciona análisis e insights financieros",
+ "fr-FR": "Fournit des analyses et insights financiers"
+ }
+}
+```
+
+## Monitoring & Analytics
+
+### Performance Metrics
+- Response time per capability
+- User engagement with conversation starters
+- Error rates and failure patterns
+- Capability utilization statistics
+
+### Logging Strategy
+```typescript
+// Structured logging for agent interactions
+const log = {
+ timestamp: new Date().toISOString(),
+ agentName: "MyAgent",
+ version: "1.2.0",
+ userId: "user123",
+ capability: "WebSearch",
+ responseTime: 1250,
+ success: true
+};
+```
+
+## Security & Compliance
+
+### Data Privacy
+- Implement proper data handling for sensitive information
+- Ensure compliance with GDPR, CCPA, and organizational policies
+- Use appropriate access controls for enterprise capabilities
+
+### Security Considerations
+- Validate all inputs and outputs
+- Implement rate limiting and abuse prevention
+- Monitor for suspicious activity patterns
+- Regular security audits and updates
+
+## Troubleshooting
+
+### Common Issues
+1. **Schema Validation Errors**: Check character limits and required fields
+2. **Capability Conflicts**: Verify capability combinations are supported
+3. **Performance Issues**: Monitor response times and optimize instructions
+4. **Deployment Failures**: Validate environment configuration and permissions
+
+### Debug Tools
+- TypeSpec compiler diagnostics
+- Agents Playground debugging
+- Microsoft 365 Agents Toolkit logs
+- Schema validation utilities
+
+This comprehensive guide ensures robust, scalable, and maintainable Microsoft 365 Copilot declarative agents with full TypeSpec and Microsoft 365 Agents Toolkit integration.
\ No newline at end of file
diff --git a/prompts/declarative-agents.prompt.md b/prompts/declarative-agents.prompt.md
new file mode 100644
index 0000000..2949ff0
--- /dev/null
+++ b/prompts/declarative-agents.prompt.md
@@ -0,0 +1,93 @@
+---
+description: Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
+---
+
+# Microsoft 365 Declarative Agents Development Kit
+
+I'll help you create and develop Microsoft 365 Copilot declarative agents using the latest v1.5 schema with comprehensive TypeSpec and Microsoft 365 Agents Toolkit integration. Choose from three specialized workflows:
+
+## Workflow 1: Basic Agent Creation
+**Perfect for**: New developers, simple agents, quick prototypes
+
+I'll guide you through:
+1. **Agent Planning**: Define purpose, target users, and core capabilities
+2. **Capability Selection**: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
+3. **Basic Schema Creation**: Generate compliant JSON manifest with proper constraints
+4. **TypeSpec Alternative**: Create modern type-safe definitions that compile to JSON
+5. **Testing Setup**: Configure Agents Playground for local testing
+6. **Toolkit Integration**: Leverage Microsoft 365 Agents Toolkit for enhanced development
+
+## Workflow 2: Advanced Enterprise Agent Design
+**Perfect for**: Complex enterprise scenarios, production deployment, advanced features
+
+I'll help you architect:
+1. **Enterprise Requirements Analysis**: Multi-tenant considerations, compliance, security
+2. **Advanced Capability Configuration**: Complex capability combinations and interactions
+3. **Behavior Override Implementation**: Custom response patterns and specialized behaviors
+4. **Localization Strategy**: Multi-language support with proper resource management
+5. **Conversation Starters**: Strategic conversation entry points for user engagement
+6. **Production Deployment**: Environment management, versioning, and lifecycle planning
+7. **Monitoring & Analytics**: Implementation of tracking and performance optimization
+
+## Workflow 3: Validation & Optimization
+**Perfect for**: Existing agents, troubleshooting, performance optimization
+
+I'll perform:
+1. **Schema Compliance Validation**: Full v1.5 specification adherence checking
+2. **Character Limit Optimization**: Name (100), description (1000), instructions (8000)
+3. **Capability Audit**: Verify proper capability configuration and usage
+4. **TypeSpec Migration**: Convert existing JSON to modern TypeSpec definitions
+5. **Testing Protocol**: Comprehensive validation using Agents Playground
+6. **Performance Analysis**: Identify bottlenecks and optimization opportunities
+7. **Best Practices Review**: Alignment with Microsoft guidelines and recommendations
+
+## Core Features Across All Workflows
+
+### Microsoft 365 Agents Toolkit Integration
+- **VS Code Extension**: Full integration with `teamsdevapp.ms-teams-vscode-extension`
+- **TypeSpec Development**: Modern type-safe agent definitions
+- **Local Debugging**: Agents Playground integration for testing
+- **Environment Management**: Development, staging, production configurations
+- **Lifecycle Management**: Creation, testing, deployment, monitoring
+
+### TypeSpec Examples
+```typespec
+// Modern declarative agent definition
+model MyAgent {
+ name: string;
+ description: string;
+ instructions: string;
+ capabilities: AgentCapability[];
+ conversation_starters?: ConversationStarter[];
+}
+```
+
+### JSON Schema v1.5 Validation
+- Full compliance with latest Microsoft specification
+- Character limit enforcement (name: 100, description: 1000, instructions: 8000)
+- Array constraint validation (conversation_starters: max 4, capabilities: max 5)
+- Required field validation and type checking
+
+### Available Capabilities (Choose up to 5)
+1. **WebSearch**: Internet search functionality
+2. **OneDriveAndSharePoint**: File and content access
+3. **GraphConnectors**: Enterprise data integration
+4. **MicrosoftGraph**: Microsoft 365 service integration
+5. **TeamsAndOutlook**: Communication platform access
+6. **PowerPlatform**: Power Apps and Power Automate integration
+7. **BusinessDataProcessing**: Enterprise data analysis
+8. **WordAndExcel**: Document and spreadsheet manipulation
+9. **CopilotForMicrosoft365**: Advanced Copilot features
+10. **EnterpriseApplications**: Third-party system integration
+11. **CustomConnectors**: Custom API and service integration
+
+### Environment Variables Support
+```json
+{
+ "name": "${AGENT_NAME}",
+ "description": "${AGENT_DESCRIPTION}",
+ "instructions": "${AGENT_INSTRUCTIONS}"
+}
+```
+
+**Which workflow would you like to start with?** Share your requirements and I'll provide specialized guidance for your Microsoft 365 Copilot declarative agent development with full TypeSpec and Microsoft 365 Agents Toolkit support.
\ No newline at end of file