Skip to content

docs: replace stale CLAUDE.md with accurate tool reference#31

Merged
a-bonus merged 1 commit intoa-bonus:mainfrom
starfysh-tech:optimize-claude-md
Jan 11, 2026
Merged

docs: replace stale CLAUDE.md with accurate tool reference#31
a-bonus merged 1 commit intoa-bonus:mainfrom
starfysh-tech:optimize-claude-md

Conversation

@randynov
Copy link
Copy Markdown
Contributor

Summary

Replaces the outdated 51KB CLAUDE.md design document with a focused 45-line reference that accurately reflects the current implementation.

Problem

The existing CLAUDE.md was a design template from earlier development that:

  • Contains wrong enum values (LEFT/RIGHT instead of START/END for alignment)
  • Documents only 12 tools when 42 exist (missing Sheets, Drive, Comments, Tabs, Images)
  • Includes pseudo-code that doesn't match actual implementation
  • Actively misleads Claude about available capabilities

Solution

New CLAUDE.md provides:

  • Accurate tool categories with correct counts
  • Known API limitations (comment anchoring, resolved status persistence)
  • Correct parameter patterns (alignment uses START/END, not LEFT/RIGHT)
  • References to source files for implementation details

Changes

  • claude.md: 1,028 lines removed, 34 lines added

What's Preserved

All detailed patterns remain accessible in source files:

Content Location
Zod schemas src/types.ts
Helper functions src/googleDocsApiHelpers.ts
Tool definitions src/server.ts
Setup instructions README.md

Testing

  • ✅ No code changes - documentation only
  • npm run build succeeds
  • ✅ All 42 tools remain functional

Non-Breaking Changes

✅ Documentation update only - no behavior changes

@a-bonus a-bonus merged commit d1d169f into a-bonus:main Jan 11, 2026
@randynov randynov deleted the optimize-claude-md branch January 23, 2026 18:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants