mcp-adr-analysis-server

Instructions

Implementation Reference

• src/tools/ce-mcp-tools.ts:815-906 (handler)

  The main handler function implementing 'generate_adrs_from_prd' as a CE-MCP StateMachineDirective. Orchestrates sandbox operations: read PRD, load ADR template, extract decisions, generate ADRs, and validate output.

  export function createGenerateAdrsFromPrdDirective(
    args: CEMCPGenerateAdrsFromPrdArgs
  ): StateMachineDirective {
    const { prdPath, outputDirectory = 'docs/adrs', maxAdrs = 10, focusAreas = [] } = args;
  
    return {
      type: 'state_machine_directive',
      version: '1.0',
      initial_state: {
        prdPath,
        outputDirectory,
        maxAdrs,
        focusAreas,
        generatedAdrs: [],
      },
      transitions: [
        {
          name: 'read_prd',
          from: 'initial',
          operation: {
            op: 'analyzeFiles',
            args: {
              patterns: [prdPath],
              maxFiles: 1,
            },
            store: 'prdContent',
          },
          next_state: 'prd_loaded',
        },
        {
          name: 'load_adr_template',
          from: 'prd_loaded',
          operation: {
            op: 'loadPrompt',
            args: {
              name: 'adr-suggestion',
              section: 'recommendation_template',
            },
            store: 'adrTemplate',
          },
          next_state: 'template_loaded',
        },
        {
          name: 'extract_decisions',
          from: 'template_loaded',
          operation: {
            op: 'generateContext',
            args: {
              type: 'prd-decision-extraction',
              maxAdrs,
              focusAreas,
            },
            inputs: ['prdContent', 'adrTemplate'],
            store: 'extractedDecisions',
          },
          next_state: 'decisions_extracted',
        },
        {
          name: 'generate_adrs',
          from: 'decisions_extracted',
          operation: {
            op: 'generateContext',
            args: {
              type: 'adr-generation',
              outputDirectory,
            },
            inputs: ['extractedDecisions', 'adrTemplate'],
            store: 'generatedAdrs',
          },
          next_state: 'adrs_generated',
        },
        {
          name: 'validate_adrs',
          from: 'adrs_generated',
          operation: {
            op: 'validateOutput',
            args: {
              schema: {
                type: 'array',
                items: { type: 'object' },
              },
            },
            input: 'generatedAdrs',
            store: 'validatedAdrs',
          },
          next_state: 'done',
          on_error: 'skip',
        },
      ],
      final_state: 'done',
    };
  }

• src/tools/ce-mcp-tools.ts:799-804 (schema)

  TypeScript interface defining the input arguments/schema for the generate_adrs_from_prd tool.

  export interface CEMCPGenerateAdrsFromPrdArgs {
    prdPath: string;
    outputDirectory?: string;
    maxAdrs?: number;
    focusAreas?: string[];
  }

• src/tools/ce-mcp-tools.ts:1403-1405 (registration)

  Registration in getCEMCPDirective switch statement that maps the tool name to its directive creator.

  case 'generate_adrs_from_prd':
    return createGenerateAdrsFromPrdDirective(args as unknown as CEMCPGenerateAdrsFromPrdArgs);

• src/tools/tool-catalog.ts:278-298 (registration)

  Central tool catalog registration including metadata, schema, category, and CE-MCP flag.

  TOOL_CATALOG.set('generate_adrs_from_prd', {
    name: 'generate_adrs_from_prd',
    shortDescription: 'Generate ADRs from PRD document',
    fullDescription:
      'Analyzes a Product Requirements Document and generates relevant Architecture Decision Records.',
    category: 'adr',
    complexity: 'complex',
    tokenCost: { min: 4000, max: 8000 },
    hasCEMCPDirective: true, // Phase 4.2: CE-MCP directive added
    relatedTools: ['suggest_adrs', 'generate_adr_from_decision'],
    keywords: ['adr', 'prd', 'requirements', 'generate'],
    requiresAI: true,
    inputSchema: {
      type: 'object',
      properties: {
        prdPath: { type: 'string', description: 'Path to PRD document' },
        outputDirectory: { type: 'string', description: 'Where to save ADRs' },
      },
      required: ['prdPath'],
    },
  });

• src/tools/ce-mcp-tools.ts:1356-1362 (helper)

  Listed in cemcpTools array for shouldUseCEMCPDirective check.

    'generate_adrs_from_prd',
    'interactive_adr_planning',
    'mcp_planning',
    'troubleshoot_guided_workflow',
    // Phase 5: OpenRouter Elimination
    'tool_chain_orchestrator',
  ];