Context Engineering: Verify Documentation

Check if documentation line numbers still match the actual code.

Purpose

After code changes, line numbers in documentation may drift. This skill:

1. Finds all file:line references in .claude/ documentation
2. Verifies the referenced lines exist and match described content
3. Reports accuracy and suggests fixes

Process

1. Scan Documentation

   • Find all patterns like file.py:123 or [file.py:123]
   • Extract file path and line number

2. Verify References

   • Check if file exists
   • Check if line number is within file bounds
   • Sample content to verify it matches description

3. Calculate Accuracy

   • Total references found
   • Valid references
   • Accuracy percentage

4. Generate Report

   Copy

   Documentation Accuracy Report
   =============================
   Total References: 156
   Valid: 142
   Invalid: 14
   Accuracy: 91%
   
   Invalid References:
   - context/workflows/auth.md:45 → src/auth.py:230 (line moved to 245)
   - context/workflows/api.md:12 → src/api.py:100 (file renamed)
   

Usage

Check specific file:

/context-eng:verify-docs path/to/changed/file.py

Check all documentation:

/context-eng:verify-docs

Auto-fix (update line numbers):

/context-eng:verify-docs --fix

Target Accuracy

When to Run

• After refactoring
• After adding/removing significant code
• Before creating a PR
• Weekly maintenance