Added decision-making framework to help readers evaluate if they need
Worktrunk or should stick with vanilla git/aliases.
Key additions (guide/ultimate-guide.md:10762):
- 3 quick self-assessment questions (volume, multi-instance, team)
- Decision matrix: 4 user profiles (Beginner → Boris scale)
- Quick alias alternative for casual users (2 min setup, -79% typing)
- Bottom line: "80% should start with vanilla git or alias"
- YAGNI principle applied to tooling adoption
Philosophy: Prevents premature tool adoption by providing objective
criteria. Most readers (2-3 worktrees/week) don't need Worktrunk.
Updated:
- machine-readable/reference.yaml: Added worktree_tooling_self_assessment: 10762
- CHANGELOG.md: Updated Advanced Worktree Tooling entry with self-assessment details
- Total guide additions: +139 lines (self-assessment section)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add community adoption analysis link and stats to ClawdBot comparison section:
- Added link to Twitter/X community analysis (5,600+ social mentions)
- Updated final note with adoption metrics and use case examples
- Complements existing FAQ without replacing structured comparison
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- 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>
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>
