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' },