Structured Workflow MCP

Instructions

Implementation Reference

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

  Handler dispatch for 'present_guidance' tool call, invokes shared handlePhaseGuidance function with the tool name
  case 'present_guidance': return { content: [{ type: 'text', text: JSON.stringify(await handlePhaseGuidance(name, sessionManager), null, 2) }] };
• src/tools/phaseGuidance.ts:43-46 (schema)

  Tool schema definition: name, description, and empty input schema for present_guidance
  name: 'present_guidance', description: 'Get guidance for the PRESENT phase - summarizing work', inputSchema: { type: 'object', properties: {} } }
• src/index.ts:146-146 (registration)

  Registration of phase guidance tools (including present_guidance) in the main tools array passed to MCP server
  ...createPhaseGuidanceTools(), // Handles both suggestive and directive modes
• src/tools/phaseGuidance.ts:328-353 (handler)

  Core guidance content returned by handlePhaseGuidance 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)

  Core guidance content returned by handlePhaseGuidance for 'present_guidance' in directive mode, including required outputs and validation
  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' },