Create a git branch. Create virtual environment and install all dependencies. Do the modification step by step and make sure the unit/integration tests are passing after each step. Maintain low code complexity. Minimize the code modification.
Investigation Phase: Analyze current issues/errors/failures/warnings by examining code, documentation (@CLAUDE.md), and conducting web research for solutions. Ultrathink root causes and propose fix plans that minimize implementation complexity while maintaining core functionality.
Test Suite Optimization: Review entire test suite (unit/integration/e2e) for coverage, dependencies, and purpose. Standardize fixtures/mocks per framework conventions. Evaluate test criticality, correct errors/workarounds, remove excessive comments. Maintain simplicity, avoid over-engineering.
Full Test Suite Execution: Run complete test suite (unit, integration, e2e, evaluation, metrics, performance) to validate all fixes and ensure system reliability. Verify all quality gates pass before proceeding.
Comprehensive Documentation Sync: Update all documentation (CLAUDE.md, README.md, technical docs) to reflect current implementation state. Maintain consistent format, tone, and accuracy across all documentation while eliminating outdated information.
Multi-Agent Research Loop: Research → Ultrathink → Write → Review workflow with specialized agents to gather comprehensive information and continuously improve analysis.
Claude Code instructions for clchinkc/document-mcp, covering claude.md, critical architecture requirements, details field population, key architectural principle and 📢 phase 4 complete - v0.0.5 production ready.