Structured Workflow MCP

Instructions

Implementation Reference

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

  Dispatch handler in the MCP tool call request processor that specifically handles the 'setup_guidance' tool by calling handlePhaseGuidance with the phase name and session manager.

  // Phase guidance tools (automatically route based on session configuration)
  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:7-11 (schema)

  Tool schema definition including name, description, and empty input schema for setup_guidance.

  {
    name: 'setup_guidance',
    description: 'Get guidance for the SETUP phase - initialize workflow and establish patterns',
    inputSchema: { type: 'object', properties: {} }
  },

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

  Registration of phase guidance tools (including setup_guidance) into the main tools array provided to the MCP server.

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

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

  Primary handler function for phase guidance tools. For setup_guidance, determines if directive or suggestive mode and delegates to the appropriate guidance provider.

  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:77-110 (helper)

  Guidance data structure for setup_guidance in suggestive mode, containing phase objectives, instructions, suggested approach, notes, and expected outputs.

  setup_guidance: {
    phase: 'SETUP',
    objective: 'Initialize workflow environment and establish clear file organization patterns',
    instructions: [
      '--- ENVIRONMENT SETUP ---',
      'Verify your current working directory',
      'Understand the project structure and context',
      'Confirm available tools and capabilities',
      '--- FILE ORGANIZATION PATTERN ---',
      'Workflow outputs will be organized in: structured-workflow/{task-name}/',
      'This is the default location (customizable via --output-dir)',
      'All phase documents will use numbered prefixes: 00-setup, 01-audit, etc.',
      'Create your documentation content following this pattern'
    ],
    suggestedApproach: [
      'List your current working directory path',
      'Identify the main project files relevant to the task',
      'Document the default output pattern: structured-workflow/{task-name}/',
      'Confirm you understand where documentation will be created'
    ],
    importantNotes: [
      'This phase establishes the foundation for organized workflow execution',
      'The file pattern shown (structured-workflow/{task-name}/) is the expected location',
      'All subsequent phases will follow this numbered documentation pattern',
      'Understanding this pattern now prevents confusion later'
    ],
    expectedOutput: {
      workingDirectory: 'Current working directory path',
      projectContext: 'Brief description of the project',
      outputPattern: 'Confirmation of structured-workflow/{task-name}/ pattern',
      toolsAvailable: 'List of available analysis and file tools'
    },
    nextPhase: 'Use audit_inventory_guidance to begin analyzing the codebase'
  },