iterate_guidance
Provides structured guidance for fixing issues during the ITERATE phase of development workflows, helping enforce disciplined programming practices through verified outputs.
Instructions
Get guidance for the ITERATE phase - fixing issues
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/phaseGuidance.ts:37-41 (schema)Defines the tool schema (name, description, inputSchema) for 'iterate_guidance' as part of createPhaseGuidanceTools().
{ name: 'iterate_guidance', description: 'Get guidance for the ITERATE phase - fixing issues', inputSchema: { type: 'object', properties: {} } }, - src/index.ts:145-147 (registration)Registers the phase guidance tools, including 'iterate_guidance', by spreading the array from createPhaseGuidanceTools().
// Phase guidance tools ...createPhaseGuidanceTools(), // Handles both suggestive and directive modes createTestGuidanceTool(), // TEST phase guidance - src/index.ts:210-223 (handler)Switch case dispatcher that handles 'iterate_guidance' tool calls by invoking the 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) }] }; - src/tools/phaseGuidance.ts:52-65 (handler)Core handler function for all phase guidance tools, including 'iterate_guidance'. Determines mode (directive/suggestive) and delegates to appropriate guidance generator.
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:301-326 (helper)Suggestive mode guidance configuration for ITERATE phase, providing instructions, approach, expected output, and next steps.
iterate_guidance: { phase: 'ITERATE', objective: 'Fix issues discovered during the LINT phase', instructions: [ 'Address errors first, then warnings', 'Fix one issue at a time', 'Re-run linters after each fix', 'Don\'t introduce new issues while fixing', 'Document what you changed and why' ], suggestedApproach: [ 'Start with syntax/type errors', 'Then fix logical errors', 'Address style issues last', 'Test after each significant fix', 'Consider if the fix reveals a design issue' ], expectedOutput: { fixesApplied: 'List of all fixes made', fixDescription: 'What each fix addressed', remainingIssues: 'Any issues you couldn\'t fix', verificationStatus: 'Results after fixes', lessonsLearned: 'Insights from the issues found' }, nextPhase: 'Re-run lint_guidance or proceed to present_guidance when clean' },