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 Node.js TSC Chair's perspective on human judgment in AI-assisted development:
- Full entry in ai-ecosystem.md Practitioner Insights section
- Reference in learning-with-ai.md Practitioner Perspectives
- YAML index entries in reference.yaml
Key concepts integrated:
- Bottleneck shift from coding to reviewing
- "The human in the loop isn't a limitation. It's the point."
- Cultural warning against "AI wrote it" as excuse
- Data: Review time +91%, 96% developers don't trust AI code
Context: Response to Arnaldi's "Death of Software Development" (Jan 2026)
Co-Authored-By: Claude <noreply@anthropic.com>
Added organizational perspective on AI-augmented development to
Practitioner Perspectives section. Key insights: pairs as minimal
team unit (bus factor), bottleneck shifts to functional requirements.
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>
- README.md: badges updated to reflect actual counts
- CHANGELOG.md: v3.9.0 stats corrected
- anchor-catalog.md was the 63rd template (already documented in CHANGELOG)
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>
- New Slate + Indigo color palette (WCAG AA)
- Inter font + JetBrains Mono for code
- Cover redesign with Claude Code logo
- Fixed 42 nested markdown code blocks
- Added GitHub links for script references
Phase 0 - Foundation work for visibility campaign:
- Add TL;DR Quick Start section in README with CLAUDE.md template
- Rewrite CONTRIBUTING.md with welcome message, contribution types, PR process
- Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- Document French whitepapers series (8 docs, ~185 pages) in README
- Add distribution playbooks in claudedocs/ (gitignored)
- Add prominent badges (version, license, Claude Code support)
TTFV (Time-to-First-Value) optimized from ~10min to < 5min.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- French-speaking community for developers (~1500 on Slack)
- Meetups in Paris, Bordeaux, Lyon
- Placed near top of README for visibility
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>
