- Add comprehensive section in ultimate-guide.md (L.6385-6523)
- Document 3 backends: sqlite_vec, cloudflare, hybrid
- List 12 MCP tools with descriptions
- Add environment variables reference
- Include multi-client sync patterns (same machine vs multi-device)
- Add disclaimer: under testing, not yet validated in production
- Update reference.yaml with 8 new entries
- Add to cheatsheet.md and mcp.json template
Complements Serena (key-value) with semantic search capabilities.
Co-Authored-By: Claude <noreply@anthropic.com>
Enrichir la section subscription limits (ultimate-guide.md):
- Tableau des budgets tokens par plan (Pro 44K, Max 88-220K)
- Ratio Opus/Sonnet 8-10× documenté explicitement
- Clarification "heures" = temps de traitement, pas tokens
- Lien vers ccusage (outil communautaire de monitoring)
- Note historique sur réductions non annoncées (Oct 2025)
Nouvelle section Goose dans ai-ecosystem.md:
- Comparaison technique Claude Code vs Goose (7 critères)
- Stats GitHub (15K+ stars, 350+ contributors)
- Use cases et trade-offs honnêtes
- Hardware requirements selon LLM
- Quick start avec commandes d'installation
Sources: Perplexity research (Jan 2026), official Anthropic docs,
community reports (Reddit, GitHub issues, HN).
Co-Authored-By: Claude <noreply@anthropic.com>
Add documentation for blader/Claudeception - a meta-skill that
auto-generates skills from Claude Code session discoveries.
Changes:
- guide/ultimate-guide.md: New section 5.5 "Automatic Skill Generation"
- machine-readable/reference.yaml: claudeception + claudeception_guide entries
- README.md: Add Skills category with Claudeception reference
- CHANGELOG.md: Document addition in Unreleased
Source: Community contribution via Laurent Dosdat
Co-Authored-By: Claude <noreply@anthropic.com>
Based on Agent Experience Best Practices by François Zaninotto (Marmelab).
Covers domain knowledge, code discoverability, testing for agents, guardrails.
- Add ~1809 lines to Section 9 (10 subsections)
- Enrich Section 3.1 with domain knowledge patterns
- Add Codebase Pitfalls to Section 9.11
- Bump version 3.9.11 → 3.10.0
- Guide grew from 11,560 to 13,425 lines (+16.1%)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add comprehensive production safety guide for teams deploying Claude Code in production environments with 6 critical rules:
- Port Stability: Prevent accidental port changes breaking configs
- Database Safety: Backup enforcement via PreToolUse hooks
- Feature Completeness: No TODOs for core functionality
- Infrastructure Lock: Protect docker-compose, Dockerfile, terraform
- Dependency Safety: Block unapproved npm packages
- Pattern Following: Enforce codebase conventions
Adapted from community "10 non-negotiable CLAUDE.md rules" (6/10 integrated, 4/10 already covered). Verified gaps using grepai searches. Target audience: 20% production teams.
Cross-references added in ultimate-guide.md (section 3.1) and adoption-approaches.md (Medium/Large teams).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Add comprehensive multi-instance orchestration guide (391 lines)
- Document Boris Cherny case study (259 PRs/30 days)
- Include Anthropic study metrics (132 engineers, +50% productivity)
- Add decision matrix, cost analysis, implementation phases
- Update reference.yaml with 10 new entries
- Fix table of contents (add 9.12-9.17)
- Bump version to 3.9.10
Sources:
- InfoQ: Claude Code Creator Workflow (2026-01-09)
- Anthropic Research: How AI is Transforming Work (2025-08)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- CHANGELOG: Add 3.9.7 entry for CLAUDE.md Model Configuration
- Sync version numbers across cheatsheet and ultimate-guide
- OpusPlan hybrid workflow (Opus plan → Sonnet execute)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Added:
- ultimate-guide.md: Trust Calibration section (1.7) with research-backed verification strategies
- ultimate-guide.md: Infrastructure as Code Skills (Anton Babenko's terraform-skill)
- learning-with-ai.md: "The Vibe Coding Trap" anti-pattern (Karpathy, Feb 2025)
- learning-with-ai.md: "Reality of AI Productivity" section with research
- learning-with-ai.md: External resource link to leerob.com/ai (AI fundamentals)
- IDEAS.md: "Vibe Coding Discourse" watching entry
Changed:
- reference.yaml: Complete line number synchronization (~55 entries)
Guide grew from ~9900 to 11154 lines; all deep_dive references updated
- Version bump: 3.9.5 → 3.9.6
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Section 9.16 Session Teleportation in ultimate-guide.md (~105 lines)
- Evolution timeline (2.0.24 → 2.1.0)
- Commands: %, &, --teleport, /teleport, /tasks, /remote-env, Ctrl+B
- Prerequisites, limitations, environment support matrix
- Update cheatsheet.md with new commands and shortcuts
- Update reference.yaml with new entries and line numbers
- Add cowork.md (collaboration guidance)
- Bump version to 3.9.4
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New Section 11 documenting tool complementarity with Claude Code:
- guide/ai-ecosystem.md (752 lines): detailed guide covering Perplexity,
Gemini, Kimi, NotebookLM, IDE tools, and UI prototypers
- Section 11 in ultimate-guide.md (~250 lines): condensed version with
practical workflows and integration patterns
- 4 workflow pipelines: Research→Code, Visual→Code, Documentation, Presentation
- Ready-to-use prompts and cost optimization strategies
Also includes: mobile-access.md enhancements from [Unreleased]
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Explains that Claude mirrors codebase patterns - good structure yields
good suggestions, messy code perpetuates mess. Bridges "What Claude
Doesn't Know" to "Communicating Effectively" with actionable guidance.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Thinking mode now ON by default at max budget with Opus 4.5
- Keywords "think", "think hard", "ultrathink" are cosmetic only
- Control via Alt+T (session) or /config (permanent)
- Update Trinity pattern references
- Update quiz questions (09-001, 09-002, 04-014)
- Update cheatsheet thinking section
- Add note about cosmetic flags in modes README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Wireframing Tools section (Excalidraw, tldraw, Frame0, Paper+Photo)
- Add Figma MCP Integration with official setup and workflow
- Add Image Optimization for Claude Vision (resolution, tokens, formats)
- Create examples/mcp-configs/figma.json config template
- Update reference.yaml with new entries and shifted line numbers
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add PDF generation documentation to CHANGELOG
- Sync version across all docs (README, cheatsheet, ultimate-guide, reference.yaml)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add "Performance vs Traditional Tools" section with timing comparison
- Update decision tree with "Know exact pattern?" branch
- Update Server Comparison table with exact match recommendation
- Document key insight: grepai finds what pattern-based tools cannot
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add new section 8 with IP disclaimer and key considerations table
- Cover: ownership, license contamination, vendor indemnification, sector compliance
- Bump version to 3.7.1
- Update .gitignore to exclude .grepai/
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create VERSION file (3.6.0) as the canonical version source
- Add scripts/sync-version.sh for automated version synchronization
- Fix version inconsistencies in cheatsheet.md and ultimate-guide.md
- Script supports --check mode for CI validation
Usage: ./scripts/sync-version.sh [--check]
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add guide/methodologies.md: index of 15 methodologies with decision tree
- Add guide/workflows/: 4 practical workflow guides
- tdd-with-claude.md: TDD with Claude-specific patterns
- spec-first.md: SDD adapted for CLAUDE.md
- plan-driven.md: effective /plan mode usage
- iterative-refinement.md: prompt→feedback→reprompt loops
- Add Section 9.14 in ultimate-guide.md linking to workflows
- Update guide/README.md with new documentation
- Bump version 3.4.0 → 3.5.0 across all files
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- IDEAS.md: Reduce from 12 to 4 actionable research topics
- Unified "MCP Security Hardening" (merged 3 overlapping topics)
- Expanded Discarded section (3 → 16 entries with justifications)
- Technical writer agent validation against reference.yaml
- Version bump: 3.3.0 → 3.3.1 across all docs
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>