- Add Appendix B: FAQ section addressing ClawdBot confusion
- Comprehensive comparison table (9 dimensions)
- Early warning note in 'Before You Start' section
- New README section with quick explanation
- Update all version references to 3.11.7
- Index FAQ in reference.yaml
Context: Jan 2026 community buzz created confusion between
ClawdBot (chatbot for messaging apps) and Claude Code (CLI dev tool)
Total: +86 lines across 5 files
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- 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>
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>
- 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>
- Remove "Lines: 11,100+" badge (intimidating)
- Merge TL;DR + Get Started into Quick Start section
- Condense "Why This Guide" to 7 lines (remove comparison table)
- Move Learning Paths before What's Inside (user identifies first)
- Restructure What's Inside with 6 collapsibles
- Simplify Golden Rules to 5 bullets (move Context % table to cheatsheet)
- Consolidate About section into 4 collapsibles
- Remove redundant sections: Choose Your Path, Guide Navigation, What Makes Different
Context % thresholds table moved to guide/cheatsheet.md#context-thresholds
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>
- 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 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 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>
