docs: add Addy Osmani 80% problem to Practitioner Insights

Add Addy Osmani (Google Chrome Team) article "The 80% Problem in
Agentic Coding" to AI Ecosystem Practitioner Insights section.

Changes:
- guide/ai-ecosystem.md: Add 32-line entry after Steinberger (~line 2024)
  * "80% problem" framework and comprehension debt concept
  * Three new failure modes (overengineering, assumption propagation, sycophantic)
  * Productivity paradox data (+98% PRs, +91% review time)
  * Alignment table mapping to existing guide sections
  * Transparent note: "secondary synthesis, primary sources documented"

- machine-readable/reference.yaml: Add 4 new references
  * practitioner_addy_osmani, practitioner_osmani_source
  * eighty_percent_problem, comprehension_debt_secondary

- docs/resource-evaluations/024-addy-osmani-80-percent-problem.md: Complete evaluation
  * Score: 3/5 (Pertinent) - downgraded from initial 4/5 after technical-writer challenge
  * Minimal integration (32 lines vs rejected 250 lines)
  * Fact-check: 6 stats verified, 1 Stack Overflow stat incorrect
  * Rationale: 90% overlap with existing content (Vibe Coding Trap, Trust Calibration)

- CHANGELOG.md: Document addition in v3.19.0

Decision: Minimal integration approach chosen to avoid duplication while
recognizing value of synthesis from respected author. Article aggregates
existing research already cited in guide with primary sources.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-01-30 12:32:38 +01:00
parent 7df11b224f
commit 8b58f014e7
4 changed files with 254 additions and 3 deletions

View file

@ -3,8 +3,8 @@
# Source: guide/ultimate-guide.md
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
version: "3.18.2"
updated: "2026-01-27"
version: "3.19.0"
updated: "2026-01-30"
# ════════════════════════════════════════════════════════════════
# DEEP DIVE - Line numbers in guide/ultimate-guide.md
@ -279,6 +279,10 @@ deep_dive:
practitioner_collina_source: "https://adventures.nodeland.dev/archive/the-human-in-the-loop/"
practitioner_steinberger: "guide/ai-ecosystem.md:1997"
practitioner_steinberger_source: "https://steipete.me/posts/2025/shipping-at-inference-speed"
practitioner_addy_osmani: "guide/ai-ecosystem.md:2024"
practitioner_osmani_source: "https://addyo.substack.com/p/the-80-problem-in-agentic-coding"
eighty_percent_problem: "guide/ai-ecosystem.md:2024"
comprehension_debt_secondary: "guide/ai-ecosystem.md:2024" # See also: vibe_coding_trap (primary)
# DevOps/SRE Guide (guide/devops-sre.md)
devops_sre_guide: "guide/devops-sre.md"
devops_fire_framework: "guide/devops-sre.md:50"
@ -705,6 +709,15 @@ hook_events:
UserPromptSubmit: "before prompt sent"
Notification: "alerts"
# Hook Execution Model (v2.1.0+)
hooks_execution_model: 6075 # Section in ultimate-guide.md
hooks_async_support: "v2.1.0+ - add 'async: true' for non-blocking execution"
hooks_async_use_cases: "logging, notifications, formatting, metrics (no feedback needed)"
hooks_sync_use_cases: "validation, type checking, security (feedback required)"
hooks_decision_matrix: 6091 # Decision matrix table
hooks_async_limitations: "no exit code feedback, no additionalContext, no blocking"
hooks_async_bug_fix: "v2.1.23 - fixed cancellation in headless streaming"
# ════════════════════════════════════════════════════════════════
# GOLDEN RULES
# ════════════════════════════════════════════════════════════════
@ -809,7 +822,7 @@ ecosystem:
- "Cross-links modified → Update all 4 repos"
history:
- date: "2026-01-20"
event: "Code Landing sync v3.18.2, 66 templates, cross-links"
event: "Code Landing sync v3.19.0, 66 templates, cross-links"
commit: "5b5ce62"
- date: "2026-01-20"
event: "Cowork Landing fix (paths, README, UI badges)"