docs: add co-change analysis to README and backlog

[carlos-alm]

Summary

• Documents the git co-change analysis feature from PR feat: add git co-change analysis (backlog #9) #95 in README (commands section, features table, both comparison tables, MCP tool count 18 → 19)
• Marks BACKLOG item docs: mark Phase 1 sub-steps as completed in roadmap #9 (Git change coupling) as DONE with implementation details
• Verified competitor support: axon and CodeMCP have co-change analysis, others do not

Test plan

• Verify README renders correctly on GitHub
• Verify BACKLOG.md strikethrough and DONE tag render correctly

[claude]

Claude finished @carlos-alm's task —— View job

---

PR Review: Co-Change Analysis Documentation ✅

Reviewing this PR following the 4-phase process for codegraph PR reviews.

Todo List:

• Phase 1: Root cause analysis - understand what problem this solves
• Phase 2: Configuration change detection (HIGH SCRUTINY)
• Phase 3: Test integrity verification
• Phase 4: Code quality and documentation accuracy
• Final Assessment: Provide rating and recommendation

Phase 1: Root Cause Analysis ✅

Problem Being Solved: This PR documents an existing git co-change analysis feature that was implemented in PR #95. It's adding documentation for a feature that's already been built and shipped.

Why This Approach: The approach is to comprehensively document the new feature across README, mark the BACKLOG item as done, and update tool counts. This is appropriate follow-up work after feature implementation.

Risk Assessment: LOW - This is pure documentation work following feature implementation.

Phase 2: Configuration Change Detection ✅

Configuration Changes Found: Only one configuration file was added: .codegraphrc.json with a single embeddings model setting. This is NOT a high-risk relaxation of rules - it's setting a default configuration value.

{
  "embeddings": { "model": "bge-large" }
}

Assessment: This is a benign configuration addition that sets the default embedding model. No linting rules disabled, no test timeouts increased, no strict flags disabled. ✅

Phase 3: Test Integrity ✅

Test Files: No test files were modified in this PR. This is pure documentation work.

Test Coverage: Since this documents an existing feature (PR #95), the feature should already have test coverage. This documentation-only PR doesn't require additional tests. ✅

Phase 4: Code Quality & Documentation Accuracy ✅

Documentation Changes Analysis:

1. README.md (25 additions, 6 deletions):

   • ✅ Added co-change analysis to feature comparison tables (correctly shows codegraph vs competitors)
   • ✅ Updated MCP tool count from 18 → 19 tools (consistent across 5 locations)
   • ✅ Added comprehensive co-change commands section with proper examples
   • ✅ Updated "What makes codegraph different" section to mention co-change enrichment

2. BACKLOG.md (1 addition, 1 deletion):

   • ✅ Properly marked item docs: mark Phase 1 sub-steps as completed in roadmap #9 "Git change coupling" as DONE with detailed implementation notes
   • ✅ Includes correct technical details: src/cochange.js, DB migration v5, CLI commands, MCP integration

Quality Assessment:

• Documentation is accurate and comprehensive
• Tool count updates are consistent across all locations
• Implementation details match the described feature scope
• No exaggerated claims or inaccuracies found
• Follows existing documentation patterns and style

Critical Concerns

None. This is solid documentation work.

Root Cause Analysis

Problem Being Solved: Documenting an implemented co-change analysis feature to improve discoverability and usage.
Why This Approach: Systematic documentation update across user-facing docs, competitive comparison, and backlog tracking.
Risk Assessment: Minimal - pure documentation with no code changes.

Final Recommendation

• Rating: ⭐⭐⭐⭐☆ (4/5)
• Action: APPROVE
• Reasoning: High-quality documentation work that accurately reflects the implemented feature. Comprehensive updates across all relevant files with consistent tool count updates. Only minor point is the added .codegraphrc.json config file which, while harmless, wasn't explicitly mentioned in the PR description.

[greptile-apps]

Greptile Summary

This PR documents the git co-change analysis feature from PR #95 and includes related embedding model configuration improvements.

Documentation updates:

• Added comprehensive co-change analysis documentation to README (commands, features table, comparison tables)
• Updated MCP tool count from 18 to 19 across all mentions
• Marked BACKLOG item docs: mark Phase 1 sub-steps as completed in roadmap #9 as DONE with implementation details

Embedding model fixes:

• Changed DEFAULT_MODEL from minilm to nomic-v1.5 in src/embedder.js as single source of truth
• Fixed embed command to respect config.embeddings.model instead of hardcoding the default
• Added .codegraphrc.json to configure bge-large as the project-specific embedding model

The changes are well-coordinated and thoroughly documented. All references to tool counts have been updated consistently.

Confidence Score: 5/5

• Safe to merge - documentation-only changes with clean config improvements
• All changes are either documentation updates or configuration improvements. The embedding model changes fix a real bug where CLI ignored config files. Documentation is thorough and consistent across all references. No logical errors or breaking changes.
• No files require special attention

Important Files Changed

Filename	Overview
.codegraphrc.json	Added project-specific embedding model configuration for bge-large
README.md	Documented co-change analysis feature, updated MCP tool count 18→19, added feature comparison rows
docs/roadmap/BACKLOG.md	Marked backlog item #9 (Git change coupling) as DONE with implementation details
src/cli.js	Fixed embed command to respect config.embeddings.model and imported DEFAULT_MODEL for consistency
src/embedder.js	Changed DEFAULT_MODEL from minilm to nomic-v1.5 as single source of truth

_{Last reviewed commit: f977f9c}

[greptile-apps]

_{5 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}