smart-spec-kit-mcp 2.0.0

package/dist/prompts/agents.js

@@ -0,0 +1,236 @@
+/**
+ * Agent System Prompts
+ *
+ * Defines the system prompts for different AI agents used in the Spec-Kit platform.
+ * These prompts guide Copilot's behavior when executing specific workflow steps.
+ */
+/**
+ * SpecAgent - Specification Writer
+ * Specialized in creating detailed functional and technical specifications
+ */
+export const SpecAgent = {
+    name: "SpecAgent",
+    displayName: "Specification Agent",
+    description: "Expert in writing clear, comprehensive specifications from requirements",
+    capabilities: [
+        "Analyze requirements and acceptance criteria",
+        "Structure specifications following templates",
+        "Identify gaps and ambiguities in requirements",
+        "Generate user stories and acceptance criteria",
+        "Document functional and non-functional requirements",
+    ],
+    systemPrompt: `You are SpecAgent, an expert technical writer specialized in software specifications.
+
+## Your Role
+You transform raw requirements, user stories, and Azure DevOps work items into well-structured, comprehensive specification documents.
+
+## Core Principles
+1. **Clarity First**: Write for all stakeholders - developers, QA, product owners, and business users.
+2. **Traceability**: Always link requirements back to their source (ADO work items, user requests).
+3. **Completeness**: Cover functional requirements, edge cases, error handling, and non-functional aspects.
+4. **Structure**: Follow the provided templates strictly for consistency across projects.
+
+## Writing Guidelines
+- Use active voice and clear, concise language
+- Include concrete examples for complex requirements
+- Define all technical terms and acronyms
+- Use tables for structured data (requirements, test cases)
+- Mark uncertain or missing information with [TO FILL] placeholders
+
+## When Analyzing Requirements
+1. Identify the core user need and business value
+2. Extract explicit and implicit requirements
+3. List assumptions that need validation
+4. Note potential risks and dependencies
+5. Consider edge cases and error scenarios
+
+## Output Format
+Always structure your output according to the template provided. Include:
+- Clear section headers
+- Requirement IDs for traceability
+- Priority indicators (Must Have, Should Have, Could Have)
+- Acceptance criteria in Given/When/Then format when applicable`,
+};
+/**
+ * PlanAgent - Technical Planning Specialist
+ * Specialized in breaking down features into implementable tasks
+ */
+export const PlanAgent = {
+    name: "PlanAgent",
+    displayName: "Planning Agent",
+    description: "Expert in technical planning and task decomposition",
+    capabilities: [
+        "Break down features into technical tasks",
+        "Estimate effort and complexity",
+        "Identify dependencies between tasks",
+        "Suggest implementation approaches",
+        "Create sprint-ready work items",
+    ],
+    systemPrompt: `You are PlanAgent, an expert technical architect specialized in implementation planning.
+
+## Your Role
+You transform specifications and requirements into actionable, well-structured implementation plans with clear tasks, dependencies, and estimates.
+
+## Core Principles
+1. **Actionable Tasks**: Each task should be completable by a single developer in 1-3 days.
+2. **Clear Dependencies**: Explicitly identify what must be done before each task.
+3. **Risk-Aware**: Highlight technical risks and suggest mitigation strategies.
+4. **Pragmatic**: Balance ideal solutions with practical constraints (time, resources, tech debt).
+
+## Task Decomposition Guidelines
+- Start with the end-to-end happy path
+- Add error handling and edge cases as separate tasks
+- Include tasks for testing, documentation, and deployment
+- Consider database migrations, API changes, and breaking changes
+- Account for code review and QA time
+
+## Estimation Approach
+- Use relative sizing (S/M/L/XL) or story points
+- Factor in unknowns and learning curves
+- Include buffer for integration and testing
+- Be explicit about assumptions affecting estimates
+
+## Output Format
+For each task, provide:
+- Clear title (verb + object)
+- Description with acceptance criteria
+- Size/effort estimate
+- Dependencies (task IDs)
+- Technical notes and implementation hints
+- Risk flags if applicable`,
+};
+/**
+ * GovAgent - Governance & Quality Reviewer
+ * Specialized in reviewing documents for completeness and compliance
+ */
+export const GovAgent = {
+    name: "GovAgent",
+    displayName: "Governance Agent",
+    description: "Expert in quality assurance and compliance review",
+    capabilities: [
+        "Review specifications for completeness",
+        "Check compliance with standards",
+        "Identify inconsistencies and gaps",
+        "Validate traceability",
+        "Suggest improvements",
+    ],
+    systemPrompt: `You are GovAgent, an expert quality assurance specialist focused on documentation governance.
+
+## Your Role
+You review specifications, plans, and documentation to ensure they meet quality standards, are complete, consistent, and compliant with organizational guidelines.
+
+## Core Principles
+1. **Completeness**: Ensure all required sections are filled and adequate.
+2. **Consistency**: Check for contradictions between sections.
+3. **Clarity**: Verify content is understandable by target audience.
+4. **Compliance**: Validate adherence to templates and standards.
+5. **Traceability**: Confirm requirements link to sources and tests.
+
+## Review Checklist
+- [ ] All template sections are present and filled
+- [ ] Requirements have unique IDs and priorities
+- [ ] Acceptance criteria are testable (Given/When/Then)
+- [ ] Dependencies and risks are documented
+- [ ] Stakeholders and approvers are identified
+- [ ] Technical terms are defined or linked
+- [ ] No [TO FILL] placeholders in final versions
+
+## Feedback Guidelines
+- Be specific: reference exact sections and lines
+- Be constructive: suggest improvements, not just problems
+- Prioritize: distinguish critical issues from nice-to-haves
+- Be actionable: provide clear steps to resolve issues
+
+## Output Format
+Provide a structured review with:
+1. **Summary**: Overall assessment (Approved/Needs Work/Rejected)
+2. **Critical Issues**: Must fix before approval
+3. **Recommendations**: Suggested improvements
+4. **Questions**: Items needing clarification
+5. **Checklist Status**: Pass/Fail for each review criterion`,
+};
+/**
+ * TestAgent - Test Strategy Specialist
+ * Specialized in creating test plans and test cases
+ */
+export const TestAgent = {
+    name: "TestAgent",
+    displayName: "Testing Agent",
+    description: "Expert in test strategy and test case design",
+    capabilities: [
+        "Create test strategies from specifications",
+        "Design test cases and scenarios",
+        "Identify edge cases and boundary conditions",
+        "Define test data requirements",
+        "Suggest automation approaches",
+    ],
+    systemPrompt: `You are TestAgent, an expert QA engineer specialized in test strategy and design.
+
+## Your Role
+You analyze specifications and requirements to create comprehensive test strategies, test cases, and test data requirements.
+
+## Core Principles
+1. **Coverage**: Ensure all requirements have corresponding test cases.
+2. **Risk-Based**: Prioritize testing based on risk and business impact.
+3. **Practical**: Design tests that can be executed and automated.
+4. **Clear**: Write test cases that anyone can understand and execute.
+
+## Test Design Guidelines
+- Start with happy path scenarios
+- Add negative tests for error conditions
+- Include boundary value tests
+- Consider security and performance aspects
+- Design for both manual and automated execution
+
+## Test Case Format
+Each test case should include:
+- Unique ID linked to requirement
+- Clear preconditions
+- Step-by-step actions
+- Expected results for each step
+- Test data requirements
+- Priority and automation candidate flag
+
+## Output Format
+1. **Test Strategy**: Overall approach and scope
+2. **Test Scenarios**: High-level test scenarios
+3. **Test Cases**: Detailed test cases with steps
+4. **Test Data**: Required test data and setup
+5. **Automation Notes**: What to automate and how`,
+};
+/**
+ * Registry of all available agents
+ */
+export const AgentRegistry = {
+    SpecAgent,
+    PlanAgent,
+    GovAgent,
+    TestAgent,
+};
+/**
+ * Get an agent definition by name
+ */
+export function getAgent(name) {
+    const agent = AgentRegistry[name];
+    if (!agent) {
+        throw new Error(`Unknown agent: ${name}. Available: ${Object.keys(AgentRegistry).join(", ")}`);
+    }
+    return agent;
+}
+/**
+ * Get the system prompt for an agent
+ */
+export function getAgentPrompt(name) {
+    return getAgent(name).systemPrompt;
+}
+/**
+ * List all available agents with their descriptions
+ */
+export function listAgents() {
+    return Object.values(AgentRegistry).map(({ name, displayName, description }) => ({
+        name,
+        displayName,
+        description,
+    }));
+}
+//# sourceMappingURL=agents.js.map

package/dist/prompts/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/prompts/agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE,yEAAyE;IACtF,YAAY,EAAE;QACZ,8CAA8C;QAC9C,8CAA8C;QAC9C,+CAA+C;QAC/C,+CAA+C;QAC/C,qDAAqD;KACtD;IACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEA8BgD;CAC/D,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,qDAAqD;IAClE,YAAY,EAAE;QACZ,0CAA0C;QAC1C,gCAAgC;QAChC,qCAAqC;QACrC,mCAAmC;QACnC,gCAAgC;KACjC;IACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA+BW;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,mDAAmD;IAChE,YAAY,EAAE;QACZ,wCAAwC;QACxC,iCAAiC;QACjC,mCAAmC;QACnC,uBAAuB;QACvB,sBAAsB;KACvB;IACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAiC6C;CAC5D,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,8CAA8C;IAC3D,YAAY,EAAE;QACZ,4CAA4C;QAC5C,iCAAiC;QACjC,6CAA6C;QAC7C,+BAA+B;QAC/B,+BAA+B;KAChC;IACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAgCkC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuC;IAC/D,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,gBAAgB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,IAAI;QACJ,WAAW;QACX,WAAW;KACZ,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/schemas/workflowSchema.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Workflow Schema Definitions
+ *
+ * Zod schemas for validating workflow YAML files
+ */
+import { z } from "zod";
+/**
+ * Schema for a single workflow step
+ */
+export declare const WorkflowStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    action: z.ZodEnum<{
+        fetch_ado: "fetch_ado";
+        generate_content: "generate_content";
+        review: "review";
+        create_file: "create_file";
+        call_agent: "call_agent";
+    }>;
+    description: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    next: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for workflow metadata
+ */
+export declare const WorkflowMetadataSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for a complete workflow definition
+ */
+export declare const WorkflowSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    metadata: z.ZodOptional<z.ZodObject<{
+        version: z.ZodDefault<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    template: z.ZodString;
+    defaultAgent: z.ZodDefault<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        action: z.ZodEnum<{
+            fetch_ado: "fetch_ado";
+            generate_content: "generate_content";
+            review: "review";
+            create_file: "create_file";
+            call_agent: "call_agent";
+        }>;
+        description: z.ZodString;
+        agent: z.ZodOptional<z.ZodString>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        outputs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        next: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkflowStep = z.infer<typeof WorkflowStepSchema>;
+export type WorkflowMetadata = z.infer<typeof WorkflowMetadataSchema>;
+export type Workflow = z.infer<typeof WorkflowSchema>;
+//# sourceMappingURL=workflowSchema.d.ts.map

package/dist/schemas/workflowSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowSchema.d.ts","sourceRoot":"","sources":["../../src/schemas/workflowSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAU7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQzB,CAAC;AAGH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/workflowSchema.js

@@ -0,0 +1,42 @@
+/**
+ * Workflow Schema Definitions
+ *
+ * Zod schemas for validating workflow YAML files
+ */
+import { z } from "zod";
+/**
+ * Schema for a single workflow step
+ */
+export const WorkflowStepSchema = z.object({
+    id: z.string().describe("Unique identifier for the step"),
+    name: z.string().describe("Human-readable step name"),
+    action: z.enum(["fetch_ado", "generate_content", "review", "create_file", "call_agent"])
+        .describe("The type of action to perform"),
+    description: z.string().describe("Detailed description of what this step does"),
+    agent: z.string().optional().describe("Agent to use for this step (e.g., SpecAgent, PlanAgent)"),
+    inputs: z.record(z.string(), z.string()).optional().describe("Input parameters for the step"),
+    outputs: z.array(z.string()).optional().describe("Expected outputs from this step"),
+    next: z.string().optional().describe("Next step ID (if not sequential)"),
+});
+/**
+ * Schema for workflow metadata
+ */
+export const WorkflowMetadataSchema = z.object({
+    version: z.string().default("1.0"),
+    author: z.string().optional(),
+    created: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+});
+/**
+ * Schema for a complete workflow definition
+ */
+export const WorkflowSchema = z.object({
+    name: z.string().describe("Workflow identifier"),
+    displayName: z.string().describe("Human-readable workflow name"),
+    description: z.string().describe("What this workflow accomplishes"),
+    metadata: WorkflowMetadataSchema.optional(),
+    template: z.string().describe("Associated template file (e.g., functional-spec.md)"),
+    defaultAgent: z.string().default("SpecAgent").describe("Default agent for this workflow"),
+    steps: z.array(WorkflowStepSchema).min(1).describe("Ordered list of workflow steps"),
+});
+//# sourceMappingURL=workflowSchema.js.map

package/dist/schemas/workflowSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowSchema.js","sourceRoot":"","sources":["../../src/schemas/workflowSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;SACrF,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAChG,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC7F,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACnF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACzE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAChE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACnE,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IACpF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACzF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACrF,CAAC,CAAC"}

package/dist/tools/agentTools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Tools
+ *
+ * MCP tools for interacting with agent system prompts
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register agent-related tools on the MCP server
+ */
+export declare function registerAgentTools(server: McpServer): void;
+//# sourceMappingURL=agentTools.d.ts.map

package/dist/tools/agentTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTools.d.ts","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgI1D"}

package/dist/tools/agentTools.js

@@ -0,0 +1,119 @@
+/**
+ * Agent Tools
+ *
+ * MCP tools for interacting with agent system prompts
+ */
+import { z } from "zod";
+import { AgentRegistry, getAgent, listAgents } from "../prompts/agents.js";
+/**
+ * Register agent-related tools on the MCP server
+ */
+export function registerAgentTools(server) {
+    // Tool: list_agents - List all available agents
+    server.tool("list_agents", "List all available AI agents and their capabilities. Use this to understand which agent to use for a specific task.", {}, async () => {
+        const agents = listAgents();
+        const formatted = agents.map((agent) => {
+            const full = AgentRegistry[agent.name];
+            return {
+                name: agent.name,
+                displayName: agent.displayName,
+                description: agent.description,
+                capabilities: full.capabilities,
+            };
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ agents: formatted }, null, 2),
+                }],
+        };
+    });
+    // Tool: get_agent_prompt - Get system prompt for an agent
+    server.tool("get_agent_prompt", "Retrieve the full system prompt for a specific agent. Use this to understand how an agent behaves and its guidelines.", {
+        agent_name: z.enum(["SpecAgent", "PlanAgent", "GovAgent", "TestAgent"])
+            .describe("Name of the agent to get prompt for"),
+    }, async ({ agent_name }) => {
+        try {
+            const agent = getAgent(agent_name);
+            const response = `# Agent: ${agent.displayName}
+
+## Description
+${agent.description}
+
+## Capabilities
+${agent.capabilities.map((c) => `- ${c}`).join("\n")}
+
+## System Prompt
+\`\`\`
+${agent.systemPrompt}
+\`\`\`
+`;
+            return {
+                content: [{
+                        type: "text",
+                        text: response,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ Error: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // Tool: invoke_agent - Get agent context for a specific task
+    server.tool("invoke_agent", "Prepare an agent context for a specific task. Returns the agent's system prompt combined with task instructions.", {
+        agent_name: z.enum(["SpecAgent", "PlanAgent", "GovAgent", "TestAgent"])
+            .describe("Name of the agent to invoke"),
+        task_description: z.string()
+            .describe("Description of the task for the agent to perform"),
+        context: z.string().optional()
+            .describe("Additional context or data for the agent (e.g., work item details)"),
+    }, async ({ agent_name, task_description, context }) => {
+        try {
+            const agent = getAgent(agent_name);
+            const response = `# 🤖 ${agent.displayName} Activated
+
+## System Context
+${agent.systemPrompt}
+
+---
+
+## Task Assignment
+
+**Task:** ${task_description}
+
+${context ? `## Provided Context\n\n${context}\n\n---` : ""}
+
+## Instructions
+
+You are now operating as **${agent.displayName}**. Follow the system context above to complete the assigned task.
+
+Use your capabilities:
+${agent.capabilities.map((c) => `- ${c}`).join("\n")}
+
+Proceed with the task.
+`;
+            return {
+                content: [{
+                        type: "text",
+                        text: response,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ Error: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=agentTools.js.map

package/dist/tools/agentTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTools.js","sourceRoot":"","sources":["../../src/tools/agentTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/orchestrationTools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Orchestration Tools
+ *
+ * MCP tools for automated workflow orchestration.
+ * These tools drive the workflow engine and return instructions for Copilot.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register orchestration tools on the MCP server
+ */
+export declare function registerOrchestrationTools(server: McpServer): void;
+//# sourceMappingURL=orchestrationTools.d.ts.map

package/dist/tools/orchestrationTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrationTools.d.ts","sourceRoot":"","sources":["../../src/tools/orchestrationTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiDzE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkYlE"}