Structured Workflow MCP

Instructions

Implementation Reference

• src/tools/phaseGuidance.ts:42-46 (schema)

  Tool schema definition for 'present_guidance': name, description, and empty input schema

  {
    name: 'present_guidance',
    description: 'Get guidance for the PRESENT phase - summarizing work',
    inputSchema: { type: 'object', properties: {} }
  }

• src/index.ts:137-157 (registration)

  Registration of all tools including phase guidance tools via createPhaseGuidanceTools()

  const tools = [
    // Workflow entry points
    createRefactorWorkflowTool(),                 // Refactoring workflow
    createFeatureWorkflowTool(),                  // Feature creation workflow
    createTestWorkflowTool(),                     // Test writing workflow
    createTddWorkflowTool(),                      // TDD workflow
    createBuildCustomWorkflowTool(),              // Custom workflow builder
    
    // Phase guidance tools
    ...createPhaseGuidanceTools(),                // Handles both suggestive and directive modes
    createTestGuidanceTool(),                     // TEST phase guidance
    
    // Validation tools
    ...createValidationTools(),                   // Both validate_action and validate_phase_completion
    
    // Workflow management
    createUserInputRequiredTool(),                // Escalation handling
    createWorkflowStatusTool(),                   // Workflow status
    createPhaseOutputTool(),                      // Phase output recording
    createDiscoverWorkflowToolsTool()             // Tool discovery
  ];

• src/index.ts:210-223 (handler)

  Handler dispatch for present_guidance and other phase guidance tools, calling handlePhaseGuidance

  case 'setup_guidance':
  case 'audit_inventory_guidance':
  case 'compare_analyze_guidance':
  case 'question_determine_guidance':
  case 'refactor_guidance':
  case 'lint_guidance':
  case 'iterate_guidance':
  case 'present_guidance':
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(await handlePhaseGuidance(name, sessionManager), null, 2)
      }]
    };

• src/tools/phaseGuidance.ts:52-65 (handler)

  Main handler function for all phase guidance tools including present_guidance, routes to suggestive or directive mode

  export async function handlePhaseGuidance(
    phaseName: string,
    sessionManager: SessionManager
  ): Promise<PhaseGuidance> {
    const session = sessionManager.getSession();
    const isDirectiveMode = session?.workflowConfig !== undefined;
    
    // Route to appropriate guidance based on mode
    if (isDirectiveMode) {
      return getDirectiveGuidance(phaseName, sessionManager);
    } else {
      return getSuggestiveGuidance(phaseName, sessionManager);
    }
  }

• src/tools/phaseGuidance.ts:328-353 (handler)

  Specific execution logic for present_guidance in suggestive mode

  present_guidance: {
    phase: 'PRESENT',
    objective: 'Create a comprehensive summary of your refactoring work',
    instructions: [
      'Summarize what was refactored and why',
      'List all files that were modified',
      'Highlight key improvements made',
      'Document any remaining issues or future work',
      'Provide metrics on the refactoring'
    ],
    suggestedApproach: [
      'Start with a high-level summary',
      'Then provide specific details',
      'Include before/after comparisons if relevant',
      'Mention any challenges overcome',
      'Suggest next steps or future improvements'
    ],
    expectedOutput: {
      executiveSummary: 'Brief overview of the refactoring',
      detailedChanges: 'Comprehensive list of modifications',
      improvements: 'Benefits achieved by the refactoring',
      metrics: 'Quantifiable improvements (if any)',
      recommendations: 'Suggestions for future work'
    },
    nextPhase: 'Workflow complete! Use workflow_status to see final metrics'
  }

• src/tools/phaseGuidance.ts:809-855 (handler)

  Specific execution logic for present_guidance in directive mode (more detailed)

  present_guidance: {
    phase: 'PRESENT',
    objective: 'Summarize refactoring work - COMPLETION PHASE',
  
    directiveInstructions: [
      '🔴 MANDATORY: You MUST create comprehensive summary',
      '📊 REQUIRED: You MUST include before/after metrics',
      '🎯 CRITICAL: You MUST document all improvements made',
      '📋 ESSENTIAL: You MUST provide future recommendations',
      '📁 BLOCKING: You MUST create final presentation report'
    ],
  
    instructions: [
      'Create comprehensive executive summary of the refactoring work',
      'Document all changes made with before/after comparisons',
      'Quantify improvements achieved (code quality, maintainability, etc.)',
      'Provide metrics on files modified, tests updated, issues resolved',
      'Include recommendations for future improvements',
      'Create final summary presentation document'
    ],
  
    requiredOutputFiles: [
      {
        path: 'structured-workflow/{task-name}/08-final-summary.md',
        description: 'Final presentation summary of all work completed',
        required: true,
        format: 'markdown',
        validationRules: [
          'Must include executive summary',
          'Must list all changes made',
          'Must include metrics and improvements',
          'Must provide lessons learned and recommendations'
        ]
      }
    ],
  
    expectedOutput: {
      executiveSummary: 'High-level overview of refactoring',
      detailedChanges: 'Comprehensive list of modifications',
      improvements: 'Benefits achieved through refactoring',
      metrics: 'Quantifiable before/after comparisons',
      recommendations: 'Suggestions for future work',
      outputFiles: '1 required final summary file created'
    },
  
    nextPhase: 'Workflow complete! Check workflow_status for final metrics'
  },