Structured Workflow MCP

Instructions

Implementation Reference

• src/tools/phaseGuidance.ts:274-299 (handler)

  Primary handler implementation: Specific LINT phase guidance object returned for 'lint_guidance' tool call in suggestive mode, containing objectives, instructions, expected outputs, and next steps.

  lint_guidance: {
    phase: 'LINT',
    objective: 'Verify code quality and catch any issues',
    instructions: [
      'Run all relevant linters for your language/framework',
      'Run type checkers if using a typed language',
      'Execute any available test suites',
      'Check for common issues like unused imports',
      'Document all issues found'
    ],
    suggestedApproach: [
      'Start with syntax and type checking',
      'Then run style/formatting linters',
      'Run tests if available',
      'Check for security issues if relevant',
      'Prioritize errors over warnings'
    ],
    expectedOutput: {
      lintResults: 'Output from all linters run',
      errors: 'List of errors that must be fixed',
      warnings: 'List of warnings to consider',
      testResults: 'Results from any tests run',
      metrics: 'Code quality metrics if available'
    },
    nextPhase: 'If issues found, use iterate_guidance. Otherwise, use present_guidance'
  },

• src/tools/phaseGuidance.ts:718-761 (handler)

  Handler implementation for directive mode: Enhanced LINT phase guidance with mandatory instructions, required output files, and validation criteria for 'lint_guidance' tool.

  lint_guidance: {
    phase: 'LINT',
    objective: 'Verify code quality and catch issues - QUALITY ASSURANCE PHASE',
  
    directiveInstructions: [
      '🔴 MANDATORY: You MUST run all relevant linters and type checkers',
      '📊 REQUIRED: You MUST document all errors and warnings',
      '🎯 CRITICAL: You MUST prioritize errors over warnings',
      '📋 ESSENTIAL: You MUST prepare for ITERATE phase if issues found',
      '📁 BLOCKING: You MUST create comprehensive lint report'
    ],
  
    instructions: [
      'Identify and run all relevant code quality tools',
      'Execute linters, type checkers, and style checkers',
      'Document all errors with specific error messages',
      'Catalog warnings and assess their importance',
      'Prepare prioritized list for iteration if needed'
    ],
  
    requiredOutputFiles: [
      {
        path: 'structured-workflow/{task-name}/05-lint-results.md',
        description: 'Comprehensive linting and quality check results',
        required: true,
        format: 'markdown',
        validationRules: [
          'Must include all linter outputs',
          'Must separate errors from warnings',
          'Must include specific error messages'
        ]
      }
    ],
  
    expectedOutput: {
      lintResults: 'Complete output from all quality tools',
      errorCount: 'Number of errors that must be fixed',
      warningCount: 'Number of warnings to consider',
      toolsUsed: 'List of linters and checkers executed',
      outputFiles: '1 required documentation file created'
    },
  
    nextPhase: 'If errors found, use iterate_guidance. If clean, use present_guidance'
  },

• src/tools/phaseGuidance.ts:32-35 (schema)

  Tool schema definition: Specifies name, description, and empty input schema for lint_guidance.

  {
    name: 'lint_guidance',
    description: 'Get guidance for the LINT phase - verifying code quality',
    inputSchema: { type: 'object', properties: {} }

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

  Tool registration: Includes lint_guidance via spread of createPhaseGuidanceTools() into the main tools array.

  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 (registration)

  Dispatch registration: Switch case handling 'lint_guidance' tool calls by invoking 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)
      }]
    };