Hi-AI

Instructions

Implementation Reference

• src/tools/planning/featureRoadmap.ts:46-259 (handler)

  The main handler function that parses input features, categorizes them into phases, generates estimates, risks, and formats a comprehensive markdown roadmap.
  export async function featureRoadmap(args: { projectName: string; features: string; timeframe?: string; approach?: string; teamSize?: number; }): Promise<ToolResult> { const { projectName, features, timeframe = '6-months', approach = 'mvp-first', teamSize = 3 } = args; // Parse features const featureList = features.split(/[,\n]/).map(f => f.trim()).filter(f => f.length > 0); // Define phases based on approach let phaseNames: string[] = []; if (approach === 'mvp-first') { phaseNames = ['MVP Foundation', 'Core Features', 'Advanced Features', 'Optimization & Scaling']; } else if (approach === 'phased-rollout') { phaseNames = ['Phase 1: Core', 'Phase 2: Enhancement', 'Phase 3: Expansion', 'Phase 4: Innovation']; } else { phaseNames = ['Planning & Setup', 'Development Sprint', 'Integration & Testing', 'Launch & Monitoring']; } // Calculate phase durations const totalMonths = timeframe === '3-months' ? 3 : timeframe === '6-months' ? 6 : timeframe === '12-months' ? 12 : 6; const monthsPerPhase = Math.ceil(totalMonths / phaseNames.length); // Categorize features by priority and complexity const roadmapItems: RoadmapItem[] = featureList.map((feature, index) => { const itemId = `F-${String(index + 1).padStart(3, '0')}`; // Determine priority let priority: 'high' | 'medium' | 'low' = 'medium'; if (feature.toLowerCase().includes('critical') || feature.toLowerCase().includes('core') || feature.toLowerCase().includes('essential')) { priority = 'high'; } else if (feature.toLowerCase().includes('enhancement') || feature.toLowerCase().includes('nice') || feature.toLowerCase().includes('optional')) { priority = 'low'; } // Determine phase based on priority and approach let phase = phaseNames[1]; // Default to second phase if (priority === 'high' || feature.toLowerCase().includes('mvp') || feature.toLowerCase().includes('basic')) { phase = phaseNames[0]; } else if (priority === 'low' || feature.toLowerCase().includes('advanced') || feature.toLowerCase().includes('future')) { phase = phaseNames[Math.min(2, phaseNames.length - 1)]; } // Estimate duration let estimatedDuration = '2-3 weeks'; if (feature.length > 100 || feature.toLowerCase().includes('complex') || feature.toLowerCase().includes('integration')) { estimatedDuration = '4-6 weeks'; } else if (feature.length < 50 || feature.toLowerCase().includes('simple')) { estimatedDuration = '1-2 weeks'; } // Generate deliverables const deliverables = [ `${feature} implementation`, `Unit and integration tests`, `Documentation and user guides`, `Code review and quality assurance`, `Deployment scripts and configurations`, `User training materials`, `Post-launch support plan`, ]; // Generate success criteria const successCriteria = [ `Feature functions as specified`, `Meets performance requirements`, `Passes all test cases`, `User acceptance criteria met` ]; // Identify potential risks const risks = []; if (feature.toLowerCase().includes('external') || feature.toLowerCase().includes('third-party')) { risks.push('External dependency risk'); } if (feature.toLowerCase().includes('performance') || feature.toLowerCase().includes('scalability')) { risks.push('Performance optimization complexity'); } if (feature.toLowerCase().includes('security') || feature.toLowerCase().includes('authentication')) { risks.push('Security implementation complexity'); } if (risks.length === 0) { risks.push('Standard development risks'); } return { id: itemId, title: feature.length > 50 ? feature.substring(0, 47) + '...' : feature, description: feature, phase, priority, estimatedDuration, dependencies: [], deliverables, successCriteria, risks }; }); // Group features by phase const phases: RoadmapPhase[] = phaseNames.map((phaseName, index) => { const phaseFeatures = roadmapItems.filter(item => item.phase === phaseName); const phaseGoals = []; if (index === 0) { phaseGoals.push('Establish core functionality', 'Validate core assumptions', 'Build foundation for future features'); } else if (index === 1) { phaseGoals.push('Enhance user experience', 'Add key differentiating features', 'Improve system reliability'); } else if (index === 2) { phaseGoals.push('Scale system capabilities', 'Add advanced features', 'Optimize performance'); } else { phaseGoals.push('Continuous improvement', 'Innovation and experimentation', 'Long-term sustainability'); } const milestones = [ `${phaseName} features delivered`, `Quality assurance completed`, `User feedback incorporated`, `Metrics and KPIs reviewed` ]; return { name: phaseName, duration: `${monthsPerPhase} month${monthsPerPhase > 1 ? 's' : ''}`, goals: phaseGoals, features: phaseFeatures, milestones }; }); const roadmap = { action: 'feature_roadmap', project: projectName, timeframe, approach, teamSize, phases, summary: { totalFeatures: roadmapItems.length, totalDuration: `${totalMonths} months`, highPriorityFeatures: roadmapItems.filter(f => f.priority === 'high').length, mediumPriorityFeatures: roadmapItems.filter(f => f.priority === 'medium').length, lowPriorityFeatures: roadmapItems.filter(f => f.priority === 'low').length }, recommendations: [ 'Review and validate priorities with stakeholders', 'Set up regular milestone reviews and adjustments', 'Plan for buffer time between phases for testing', 'Consider team capacity and external dependencies', 'Establish clear success metrics for each phase' ], status: 'success' }; // Format output let formattedOutput = `# ${projectName} - Feature Roadmap\n\n`; formattedOutput += `**Timeframe:** ${timeframe} \n`; formattedOutput += `**Approach:** ${approach} \n`; formattedOutput += `**Team Size:** ${teamSize} developers \n`; formattedOutput += `**Total Features:** ${roadmap.summary.totalFeatures}\n\n`; formattedOutput += `## Overview\n`; formattedOutput += `- **High Priority:** ${roadmap.summary.highPriorityFeatures} features\n`; formattedOutput += `- **Medium Priority:** ${roadmap.summary.mediumPriorityFeatures} features\n`; formattedOutput += `- **Low Priority:** ${roadmap.summary.lowPriorityFeatures} features\n\n`; phases.forEach((phase, index) => { formattedOutput += `## ${phase.name}\n`; formattedOutput += `**Duration:** ${phase.duration} \n`; formattedOutput += `**Features:** ${phase.features.length}\n\n`; formattedOutput += `### Goals\n`; phase.goals.forEach(goal => { formattedOutput += `- ${goal}\n`; }); formattedOutput += '\n'; if (phase.features.length > 0) { formattedOutput += `### Features\n`; phase.features.forEach(feature => { formattedOutput += `**${feature.id}:** ${feature.title} (${feature.priority.toUpperCase()}) \n`; formattedOutput += `*Duration:* ${feature.estimatedDuration} \n`; formattedOutput += `*Key Risks:* ${feature.risks.join(', ')}\n\n`; }); } formattedOutput += `### Milestones\n`; phase.milestones.forEach(milestone => { formattedOutput += `- ${milestone}\n`; }); if (index < phases.length - 1) { formattedOutput += '\n---\n\n'; } }); formattedOutput += `\n## Recommendations\n`; roadmap.recommendations.forEach(rec => { formattedOutput += `- ${rec}\n`; }); return { content: [{ type: 'text', text: formattedOutput }] }; }
• src/tools/planning/featureRoadmap.ts:26-44 (schema)

  The ToolDefinition object defining the tool's name, description, input schema, and annotations for the feature_roadmap tool.
  export const featureRoadmapDefinition: ToolDefinition = { name: 'feature_roadmap', description: 'roadmap|schedule|timeline|roadmap|timeline|project plan|development schedule - Generate development roadmap', inputSchema: { type: 'object', properties: { projectName: { type: 'string', description: 'Name of the project' }, features: { type: 'string', description: 'List of features to include in roadmap' }, timeframe: { type: 'string', description: 'Project timeframe', enum: ['3-months', '6-months', '12-months', 'custom'] }, approach: { type: 'string', description: 'Development approach', enum: ['mvp-first', 'phased-rollout', 'big-bang'], default: 'mvp-first' }, teamSize: { type: 'number', description: 'Development team size' } }, required: ['projectName', 'features'] }, annotations: { title: 'Feature Roadmap', audience: ['user', 'assistant'] } };
• src/index.ts:104-160 (registration)

  Inclusion of featureRoadmapDefinition in the central tools array, which is used for listing available tools via ListToolsRequest.
  const tools: ToolDefinition[] = [ // Time Utility Tools getCurrentTimeDefinition, // Semantic Code Analysis Tools (Serena-inspired) findSymbolDefinition, findReferencesDefinition, // Sequential Thinking Tools createThinkingChainDefinition, analyzeProblemDefinition, stepByStepAnalysisDefinition, breakDownProblemDefinition, thinkAloudProcessDefinition, formatAsPlanDefinition, // Browser Development Tools monitorConsoleLogsDefinition, inspectNetworkRequestsDefinition, // Memory Management Tools saveMemoryDefinition, recallMemoryDefinition, listMemoriesDefinition, deleteMemoryDefinition, searchMemoriesDefinition, updateMemoryDefinition, autoSaveContextDefinition, restoreSessionContextDefinition, prioritizeMemoryDefinition, startSessionDefinition, // Convention Tools getCodingGuideDefinition, applyQualityRulesDefinition, validateCodeQualityDefinition, analyzeComplexityDefinition, checkCouplingCohesionDefinition, suggestImprovementsDefinition, // Planning Tools generatePrdDefinition, createUserStoriesDefinition, analyzeRequirementsDefinition, featureRoadmapDefinition, // Prompt Enhancement Tools enhancePromptDefinition, analyzePromptDefinition, enhancePromptGeminiDefinition, // Reasoning Tools applyReasoningFrameworkDefinition, // UI Preview Tools previewUiAsciiDefinition ];
• src/index.ts:678-679 (registration)

  Switch case in executeToolCall function that dispatches calls to the featureRoadmap handler.
  case 'feature_roadmap': return await featureRoadmap(args as any) as CallToolResult;