Structured Workflow MCP

Instructions

Implementation Reference

• src/tools/phaseGuidance.ts:37-41 (schema)

  Defines the tool schema (name, description, inputSchema) for 'iterate_guidance' as part of createPhaseGuidanceTools().

  {
    name: 'iterate_guidance',
    description: 'Get guidance for the ITERATE phase - fixing issues',
    inputSchema: { type: 'object', properties: {} }
  },

• src/index.ts:145-147 (registration)

  Registers the phase guidance tools, including 'iterate_guidance', by spreading the array from createPhaseGuidanceTools().

  // Phase guidance tools
  ...createPhaseGuidanceTools(),                // Handles both suggestive and directive modes
  createTestGuidanceTool(),                     // TEST phase guidance

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

  Switch case dispatcher that handles 'iterate_guidance' tool calls by invoking the shared handlePhaseGuidance function.

  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)

  Core handler function for all phase guidance tools, including 'iterate_guidance'. Determines mode (directive/suggestive) and delegates to appropriate guidance generator.

  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:301-326 (helper)

  Suggestive mode guidance configuration for ITERATE phase, providing instructions, approach, expected output, and next steps.

  iterate_guidance: {
    phase: 'ITERATE',
    objective: 'Fix issues discovered during the LINT phase',
    instructions: [
      'Address errors first, then warnings',
      'Fix one issue at a time',
      'Re-run linters after each fix',
      'Don\'t introduce new issues while fixing',
      'Document what you changed and why'
    ],
    suggestedApproach: [
      'Start with syntax/type errors',
      'Then fix logical errors',
      'Address style issues last',
      'Test after each significant fix',
      'Consider if the fix reveals a design issue'
    ],
    expectedOutput: {
      fixesApplied: 'List of all fixes made',
      fixDescription: 'What each fix addressed',
      remainingIssues: 'Any issues you couldn\'t fix',
      verificationStatus: 'Results after fixes',
      lessonsLearned: 'Insights from the issues found'
    },
    nextPhase: 'Re-run lint_guidance or proceed to present_guidance when clean'
  },