Rebuild Claude Docs Index Command

Clear and immediately rebuild the docs-management search index. This is faster than /clear-claude-docs-cache + waiting for next search because it triggers the rebuild immediately.

When to Use

• After manually editing index.yaml or documentation files
• When search results seem stale or incorrect
• After a git pull with documentation changes
• When you need search working immediately (not on next query)

Difference from /clear-claude-docs-cache

Command	Action	Search Availability
/clear-claude-docs-cache	Clears cache only	Rebuild on next search (lazy)
/rebuild-claude-docs-index	Clears + rebuilds	Immediate (eager)

Arguments

• No arguments: Show plan and ask for confirmation
• --force: Skip confirmation and rebuild immediately

Instructions

This command clears the documentation search cache and immediately rebuilds the index.

Check Current Status

First, check the current cache state by running the cache manager info command. Report whether the cache exists, is valid, and when it was last built.

Request Confirmation

Unless the user passed --force, show a rebuild plan with the current cache state and ask for confirmation before proceeding. Explain that rebuilding takes a few seconds and search will be unavailable during the rebuild.

Clear and Rebuild

Once confirmed (or if --force was passed):

1. Clear the cache using the cache manager script
2. Trigger an immediate rebuild by running a search query through find_docs.py
3. Verify the rebuild succeeded by checking the new cache info

Report Results

Report the new index statistics including document count, terms indexed, and build time. Confirm that search is now available.

## Index Rebuilt

Successfully rebuilt Claude Code documentation search index.

**New index stats:**
- Size: 1.8 MB
- Terms indexed: 6,020
- Documents: 451
- Tags: 33
- Categories: 16
- Build time: 45ms

**Search is now available.**

Error Handling

• Plugin not installed: Report "claude-ecosystem plugin not found."
• Rebuild failed: Report error from script and suggest manual troubleshooting
• Permission denied: Report with remediation steps

Technical Notes

How the Index Works

The inverted index enables fast documentation search by:

1. Pre-computing term→document mappings
2. Extracting keywords, tags, and categories
3. Building a searchable index stored in JSON

Rebuild Triggers

The index automatically rebuilds when:

• --clear-cache flag is passed to find_docs.py
• cache_version.json is missing or invalid
• index.yaml content hash changes
• Plugin scripts change (plugin fingerprint hash)

Cache Validation

The cache_manager.py uses content hashes (not just mtime) to detect changes. This correctly handles git operations where mtime changes but content doesn't.