claude-architect / claude-cookbooks-main
CLAUDE.md86 starsChanged 6 months agoMITView on GitHub
A collection of Jupyter notebooks and Python examples for building with the Claude API. Or directly with uv: Notebooks have relaxed rules for mid-file imports (E402), redefinitions (F811), and variable naming (N803, N806). Branch naming: <username>/<feature-description> Commit format (conventional commits): These commands are available in Claude Code and CI:
- Reads credentials
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Najeebullah3124/awesome-claude-universeword for word, first seen Apr 24, 2026
Other versions1 project uses a version of this.
Word for word · 1
- Najeebullah3124/awesome-claude-universe★ 2100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- cca-cert-buddy/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
The file
We split this CLAUDE.md into the rules it gives an agent
11 rules. About 0 are common, 6 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Very specific: line 60
API Keys: Never commit .env files. Use dotenv.load_dotenv() then access keys via os.environ or os.getenv()
- Very specific: line 62
Dependencies: Use uv add <package> or uv add --dev <package>.
- Distinctive: line 64
Models: Use current Claude models.
- Distinctive: line 69
Bedrock model IDs: follow a different format.
- Distinctive: line 77
Keep outputs in notebooks (intentional for demonstration)
- Distinctive: line 79
Test that notebooks run top-to-bottom without errors
- Very specific: line 81
Quality checks: Run make check before committing.
- Distinctive: line 107
Create notebook in the appropriate directory
- Very specific: line 108
Add entry to registry.yaml with title, description, path, authors, categories
- Very specific: line 109
Add author info to authors.yaml if new contributor
- Distinctive: line 110
Run quality checks and submit PR
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Claude Cookbooks
A collection of Jupyter notebooks and Python examples for building with the Claude API.
Quick Start
# Install dependencies
uv sync --all-extras
# Install pre-commit hooks
uv run pre-commit install
# Set up API key
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEYDevelopment Commands
make format # Format code with ruff
make lint # Run linting
make check # Run format-check + lint
make fix # Auto-fix issues + format
make test # Run pytestOr directly with uv:
uv run ruff format . # Format
uv run ruff check . # Lint
uv run ruff check --fix . # Auto-fix
uv run pre-commit run --all-filesCode Style
- Line length: 100 characters
- Quotes: Double quotes
- Formatter: Ruff
Notebooks have relaxed rules for mid-file imports (E402), redefinitions (F811), and variable naming (N803, N806).
Git Workflow
Branch naming: <username>/<feature-description>
Commit format (conventional commits):
feat(scope): add new feature
fix(scope): fix bug
docs(scope): update documentation
style: lint/formatKey Rules
- API Keys: Never commit
.envfiles. Usedotenv.load_dotenv()then access keys viaos.environoros.getenv() - Dependencies: Use
uv add <package>oruv add --dev <package>. Never edit pyproject.toml directly. - Models: Use current Claude models. Check docs.anthropic.com for latest versions.
- Sonnet:
claude-sonnet-4-6 - Haiku:
claude-haiku-4-5 - Opus:
claude-opus-4-6 - Never use dated model IDs (e.g.,
claude-sonnet-4-6-20250514). Always use the non-dated alias. - Bedrock model IDs follow a different format. Use the base Bedrock model ID from the docs:
- Opus 4.6:
anthropic.claude-opus-4-6-v1 - Sonnet 4.5:
anthropic.claude-sonnet-4-5-20250929-v1:0 - Haiku 4.5:
anthropic.claude-haiku-4-5-20251001-v1:0 - Prepend
global.for global endpoints (recommended):global.anthropic.claude-opus-4-6-v1 - Note: Bedrock models before Opus 4.6 require dated IDs in their Bedrock model ID.
- Opus 4.6:
- Sonnet:
- Notebooks:
- Keep outputs in notebooks (intentional for demonstration)
- One concept per notebook
- Test that notebooks run top-to-bottom without errors
- Quality checks: Run
make checkbefore committing. Pre-commit hooks validate formatting and notebook structure.
Slash Commands
These commands are available in Claude Code and CI:
/notebook-review- Review notebook quality/model-check- Validate Claude model references/link-review- Check links in changed files
Project Structure
capabilities/ # Core Claude capabilities (RAG, classification, etc.)
skills/ # Advanced skill-based notebooks
tool_use/ # Tool use and integration patterns
multimodal/ # Vision and image processing
misc/ # Batch processing, caching, utilities
third_party/ # Pinecone, Voyage, Wikipedia integrations
extended_thinking/ # Extended reasoning patterns
scripts/ # Validation scripts
.claude/ # Claude Code commands and skillsAdding a New Cookbook
- Create notebook in the appropriate directory
- Add entry to
registry.yamlwith title, description, path, authors, categories - Add author info to
authors.yamlif new contributor - Run quality checks and submit PR
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

