compare_adr_progress
Validate implementation progress by comparing TODO tasks against architectural decisions and current environment status to ensure alignment.
Instructions
Compare TODO.md progress against ADRs and current environment to validate implementation status
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| todoPath | No | Path to TODO.md file to analyze | TODO.md |
| adrDirectory | No | Directory containing ADR files | docs/adrs |
| projectPath | No | Path to project root for environment analysis | . |
| environment | No | Target environment context for validation (auto-detect will infer from project structure) | auto-detect |
| environmentConfig | No | Environment-specific configuration and requirements | |
| validationType | No | Type of validation to perform | full |
| includeFileChecks | No | Include file existence and implementation checks | |
| includeRuleValidation | No | Include architectural rule compliance validation | |
| deepCodeAnalysis | No | Perform deep code analysis to distinguish mock from production implementations | |
| functionalValidation | No | Validate that code actually functions according to ADR goals, not just exists | |
| strictMode | No | Enable strict validation mode with reality-check mechanisms against overconfident assessments | |
| environmentValidation | No | Enable environment-specific validation rules and checks |
Implementation Reference
- src/tools/tool-catalog.ts:381-398 (schema)Schema definition and metadata registration for the compare_adr_progress tool in the central TOOL_CATALOG. Includes inputSchema with adrIds parameter, category 'adr', requiresAI true, and CE-MCP directive support.TOOL_CATALOG.set('compare_adr_progress', { name: 'compare_adr_progress', shortDescription: 'Compare ADR implementation progress', fullDescription: 'Compares ADR decisions against actual implementation to measure progress.', category: 'adr', complexity: 'moderate', tokenCost: { min: 2000, max: 4000 }, hasCEMCPDirective: true, // Phase 4.3: Moderate tool - progress comparison relatedTools: ['analyze_adr_timeline', 'validate_all_adrs'], keywords: ['adr', 'compare', 'progress', 'implementation'], requiresAI: true, inputSchema: { type: 'object', properties: { adrIds: { type: 'array', items: { type: 'string' } }, }, }, });
- src/tools/tool-chain-orchestrator.ts:52-65 (registration)Registration of compare_adr_progress in AVAILABLE_TOOLS array used for AI planning and orchestration.const AVAILABLE_TOOLS = [ 'analyze_project_ecosystem', 'generate_adrs_from_prd', 'suggest_adrs', 'analyze_content_security', 'generate_rules', 'generate_adr_todo', 'compare_adr_progress', 'manage_todo', 'generate_deployment_guidance', 'smart_score', 'troubleshoot_guided_workflow', 'smart_git_push', 'generate_research_questions',
- src/tools/ce-mcp-tools.ts:1250-1265 (helper)Helper reference in planningTools array for CE-MCP tool chain orchestration directives.const planningTools = [ 'analyze_project_ecosystem', 'generate_adrs_from_prd', 'suggest_adrs', 'analyze_content_security', 'generate_rules', 'generate_adr_todo', 'compare_adr_progress', 'manage_todo', 'generate_deployment_guidance', 'smart_score', 'troubleshoot_guided_workflow', 'smart_git_push', 'perform_research', 'validate_rules', ];
- Helper reference in server context tools list for LLM awareness.name: 'compare_adr_progress', description: 'Compare ADR implementation progress against requirements', },
- src/tools/tool-chain-orchestrator.ts:89-89 (registration)Registration in TOOL_CAPABILITIES mapping with description for AI context in tool chain planning.compare_adr_progress: 'Validate TODO vs ADRs vs actual environment state',