Claude Code Audits 80-Component React Library Docs: Real Bugs Found, New Bug Introduced

A staff engineer maintaining a large React component library used Claude Code to audit documentation for 80 components in a single session. The AI caught real bugs—outdated props, missing edge cases, and incorrect usage examples—but also introduced new errors that required a manual review pass.

What Worked

• Identified props that were documented but no longer existed in the source code
• Flagged missing documentation for new props added in recent commits
• Caught inconsistent type definitions between JSDoc and actual TypeScript types

What Went Wrong

• Claude invented props that never existed (hallucinations)
• Incorrectly updated default values for some props
• Removed valid documentation sections it considered redundant
• Generated example code that didn't compile

The full write-up includes the exact prompts used, session structure, and a breakdown of each false positive and hallucination. The author recommends always running a diff review before committing AI-generated doc changes.