docs: add "Do I Need Worktrunk?" self-assessment section

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>
This commit is contained in:
Florian BRUNIAUX 2026-01-25 18:33:57 +01:00
parent 24481ea9a7
commit ccf2b2a01e
3 changed files with 170 additions and 11 deletions

View file

@ -244,14 +244,15 @@ deep_dive:
boris_cherny_case_study: 9617
anthropic_study_metrics: 9721
git_worktrees_multi_instance: 10634
advanced_worktree_tooling: 10661
anthropic_internal_study: 10782
multi_instance_costs: 10816
orchestration_frameworks: 10853
headless_pm_framework: 10865
multi_instance_implementation: 10891
multi_instance_monitoring: 10964
multi_instance_decision_matrix: 11037
advanced_worktree_tooling: 10748
worktree_tooling_self_assessment: 10762
anthropic_internal_study: 10921
multi_instance_costs: 10955
orchestration_frameworks: 10992
headless_pm_framework: 11004
multi_instance_implementation: 11030
multi_instance_monitoring: 11103
multi_instance_decision_matrix: 11176
# External orchestration systems
external_orchestrators:
gas_town:
@ -479,7 +480,20 @@ mcp:
ast_grep_when: "structural patterns (>50k lines, migrations, AST rules)"
ast_grep_not_for: "simple string search, small projects (<10k lines)"
search_decision_tree: "grep (text) | ast-grep (structure) | Serena (symbols) | grepai (semantic)"
search_tools_comparison: "guide/ultimate-guide.md:6517"
search_tools_mastery_workflow: "guide/workflows/search-tools-mastery.md"
grep_vs_rag_history: "guide/architecture.md:33"
ripgrep_native: "Grep tool (Claude Code built-in, ~20ms)"
grepai_semantic: "Semantic search + call graph (Ollama-based, ~500ms)"
grepai_benchmark:
source: "https://yoandev.co/grepai-benchmark"
guide_section: "guide/workflows/search-tools-mastery.md:240"
date: "2026-01-20"
summary: "-55% tool calls, -97% tokens vs grep (Excalidraw 155k TS)"
caveat: "Benchmark by tool maintainer, single-project validation"
serena_symbols: "Symbol-aware + session memory (~100ms)"
astgrep_structural: "AST patterns for large refactoring (~200ms)"
search_combined_workflow: "guide/workflows/search-tools-mastery.md:205"
check: "/mcp"
config: ".claude/mcp.json or ~/.claude.json"
tool_search: "lazy loading MCP tools (v2.1.7+) - 85% token reduction - auto:N threshold config"