# Contributing to Claude's Hidden Toolkit

Thanks for your interest in contributing! This project documents Claude.ai's undocumented internal tools — every contribution helps the community understand what's really happening under the hood.

## How to Contribute

### Reporting New Tools or Changes

If you've discovered a new tool, a schema change, or platform-specific behavior not covered in the book:

1. **Open an Issue** with the label `discovery`
2. Include:
   - Tool name (exact internal name if known)
   - Platform tested on (browser / desktop app / mobile app / iOS / Android)
   - How you discovered it (e.g., `tool_search` query, system prompt extraction, behavioral observation)
   - Parameter schema if available (JSON)
   - Response format with a real example
   - Any gotchas or edge cases observed

### Correcting Existing Documentation

If something in the book is wrong or outdated:

1. **Open an Issue** with the label `correction`
2. Include:
   - Which tool card or chapter section is affected
   - What the book currently says
   - What you observed instead
   - Platform and date of observation

### Submitting a Pull Request

For direct content changes:

1. Fork the repo
2. Edit `Claude_Hidden_Toolkit.md` only — this is the source of truth
3. Follow the existing formatting conventions (see below)
4. Submit a PR with a clear description of what changed and how it was verified

## Formatting Conventions

- **Tool names** in backticks: `web_search`, `event_create_v0`
- **Platform availability** stated on every claim
- **Tool cards** follow the template in Appendix C — don't freestyle the structure
- **Figures** are numbered sequentially (fig_01 through fig_22+). Continue the sequence; never reuse or skip numbers
- **Response formats** marked as confirmed with real output. If you can't confirm, note it explicitly
- **Tables** for structured comparisons, not bullet lists

## Verification Standard

This project has a strict empirical standard. We don't document tools based on speculation, hearsay, or what "should" work. Every claim must be:

- **Tested** on at least one platform with a real Claude.ai session
- **Reproducible** — another user should be able to trigger the same behavior
- **Platform-tagged** — specifying exactly where it works and where it doesn't

If you've observed something but can't fully verify it, open an Issue rather than a PR. The community can help confirm.

## What We're Looking For

High-value contributions include:

- **iOS-specific tools** (Reminders suite, Siri integration) — we have limited iOS testing coverage
- **Screenshot captures** for the 22 figures currently marked [Upcoming]
- **Cross-platform verification** of existing tool cards on platforms we haven't tested
- **New deferred tools** discovered via `tool_search` sweeps
- **Schema changes** from Anthropic updates that break or modify existing tools
- **MCP Connector behavior** differences between Projects and standard chats

## Code of Conduct

Be respectful, constructive, and evidence-based. This is a technical documentation project — claims need proof, disagreements are settled by testing, and everyone's contributions are valued.

## License

By contributing, you agree that your contributions will be licensed under [CC BY 4.0](LICENSE), the same license as the rest of the project.