Florian BRUNIAUX
c5fad9f092
docs: add Context Engineering (Thoughtworks) + corporate marketplaces footnotes
...
- Add Context Engineering framework reference (Thoughtworks Tech Radar Vol 33)
- Add emerging corporate AI marketplaces concept (Hugo 2026)
- Document evaluation in docs/resource-evaluations/hugo-ai-impact-2026.md
- Score: 2/5 (marginal) - minimal integration via footnotes only
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 16:09:02 +01:00
Florian BRUNIAUX
bd01add3f6
docs: integrate /insights architecture from Zolkos deep dive (4/5)
...
1. Resource evaluation (docs/resource-evaluations/zolkos-insights-deep-dive.md):
- Score: 4/5 (High Value) - comprehensive technical architecture
- Content: 7-stage pipeline, facets classification (6 dimensions), technical specs
- Decision: Integrate architecture + facets (complementary with usage doc)
- Comparison: Zolkos (architecture interne) vs Guide (usage externe) = complet
- Why not 5/5: Missing user guidance, screenshots, prompt examples
- Updated index: 23 evaluations total
2. Architecture Overview added to guide (ultimate-guide.md L6460+):
- 7-stage pipeline: filtering, summarization, facet extraction, aggregation,
executive summary, report generation, facet caching
- Facets Classification System (6 dimensions):
* Goals (13 types): Debug, Implement, Fix Bug, Write Script, Refactor, etc.
* Friction (12): Misunderstood, wrong approach, buggy code, user rejection, etc.
* Satisfaction (6): Frustrated → Dissatisfied → Likely → Satisfied → Happy
* Outcomes (4): Not → Partially → Mostly → Fully Achieved
* Success (7): Fast search, correct edits, explanations, proactive, multi-file, etc.
* Session Types (5): Single, multi, iterative, exploration, quick question
- Performance: Caching system (facets/<session-id>.json) for incremental analysis
- Interpretation guidance: How facets help understand report recommendations
- Source attribution: Zolkos Technical Deep Dive (2026-02-04)
3. CHANGELOG [Unreleased]:
- Comprehensive /insights documentation with architecture deep dive
- Facets classification system (6 dimensions documented)
- Performance optimization explanation (caching)
- Resource evaluation: Zolkos deep dive (4/5, integrated)
Impact: Power users can now understand WHY /insights generates specific suggestions
(based on facets classification), optimize workflows for better analysis (avoid <2 msg
sessions), and interpret friction categories with context (12 types documented).
Complementarity proven: Usage documentation (existing) + Architecture (Zolkos) = complete.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 15:38:45 +01:00
Florian BRUNIAUX
669199e215
docs: add comprehensive /insights documentation + eval Kajan Siva post
...
1. Slash Commands documentation (ultimate-guide.md L6339+):
- What /insights analyzes: Project areas, interaction style, success/friction patterns
- Report structure: 8 sections (At a Glance, Work Areas, Usage Style, Wins, Friction, Features, Patterns, Horizon)
- Interactive elements: Copy buttons, checkboxes, charts, navigation TOC
- Technical details: Haiku, 50 sessions max, 8192 tokens, ~/.claude/usage-data/
- Typical insights: CLAUDE.md suggestions, feature recommendations, horizon workflows
- Integration examples: Monthly optimization, git cross-reference, ccboard combo
- Comparison table: /insights vs /status vs ccboard vs git history
2. Cheatsheet (cheatsheet.md L25):
- Added /insights to command table: "Usage analytics + optimization report"
3. Resource evaluation (docs/resource-evaluations/kajan-siva-insights-command.md):
- Score: 2/5 (Marginal) - no technical content, just surface mention
- Post confirms /insights exists + provides suggestions, but zero details
- Real value: HTML report with 18+ actionable suggestions (not documented in post)
- Recommendation: Do NOT integrate post, document command from actual usage
- Next: Evaluate Zolkos deep dive for technical architecture specs
4. CHANGELOG [Unreleased]:
- Comprehensive /insights documentation added to Section 6.1
- Interactive HTML report details, typical insights, integration examples
Impact: Users can now understand /insights output structure, actionable sections,
and integration workflows. Command properly documented with generic examples.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 15:21:19 +01:00
Florian BRUNIAUX
99cca4f498
docs: update Claude Code releases to v2.1.33 + guide v3.23.1
...
Claude Code v2.1.33 (2026-02-06):
- Agent teams fixes (tmux sessions, availability warnings)
- TeammateIdle and TaskCompleted hook events for multi-agent workflows
- Agent frontmatter: memory field (user/project/local), Task(agent_type) syntax
- Plugin name in skill descriptions and /skills menu
- VSCode: Remote sessions, branch/message count in session picker
- Multiple stability fixes and improved error messages
Guide v3.23.1:
- Updated Claude Code releases tracking (YAML + Markdown)
- Version synced across all documentation files
Files updated:
- machine-readable/claude-code-releases.yaml (latest: 2.1.33)
- guide/claude-code-releases.md (v2.1.33 section + footer date)
- CHANGELOG.md ([3.23.1] entry)
- VERSION (3.23.0 → 3.23.1)
- Auto-synced: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 11:07:52 +01:00
Florian BRUNIAUX
c81180aec7
feat: adaptive onboarding architecture v2.0.0 (v3.23.0)
...
Major overhaul of onboarding system with adaptive topic selection based on
user context and keywords. Addresses 8 critical gaps identified by technical-
writer agent challenge.
Core Changes:
- Adaptive matrix: core topics (always) + adaptive topics (keyword-triggered)
- Security-first: moved sandbox_native_guide to beginner_5min (before commands)
- Time budget validation: all 18 profiles validated at 6-8 min/topic
- Quiz integration: positioned as exit activity in Phase 4 wrap-up
- New learn_security goal with 2 profiles (beginner_15min, advanced_60min)
Technical Improvements:
- Added onboarding_matrix_meta for version tracking and maintenance triggers
- Created validation script (validate-onboarding.sh) with 6 automated checks
- Created automation script (detect-new-onboarding-topics.sh) for monthly reviews
- Fixed 8 missing deep_dive keys (rules, workflow, fix, architecture, etc.)
- Removed duplicate deep_dive section causing validation failures
Documentation:
- README.md: version 3.23.0, harmonized counts (106 templates, 49 evaluations)
- CHANGELOG.md: comprehensive v3.23.0 entry with all changes
- Onboarding-prompt.md: updated Phase 1.5, 2, 4 with adaptive logic
- Reference.yaml: 180+ lines added for adaptive architecture
Validation:
- All 18 profiles pass time budget constraints (30-50% buffer maintained)
- All deep_dive keys verified (no missing references)
- Version synchronized across 6 files via sync-version.sh
Challenge: technical-writer agent identified 8 gaps in initial analysis
Result: Full adaptive approach implemented, all gaps addressed
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-05 22:19:58 +01:00
Florian BRUNIAUX
de4b438a72
docs: update Claude Code releases to v2.1.32 + guide v3.22.1
...
Claude Code v2.1.32 (2026-02-05):
- ⭐ Opus 4.6 now available
- ⭐ Agent teams research preview (experimental, token-intensive)
- ⭐ Automatic memory recording and recall
- "Summarize from here" for partial conversation summaries
- Skills auto-load from .claude/skills/ in --add-dir directories
- Fixes: @ file completion paths, bash heredoc JS template literals
- [VSCode] Slash commands execution fix, conversation loading spinner
Guide updates:
- Bumped guide version: 3.22.0 → 3.22.1 (minor)
- Updated CHANGELOG with v2.1.32 highlights
- Synced version across all documentation files
- Updated machine-readable tracking (YAML + Markdown)
Synchronization:
- Landing version badge updated: v2.1.31 → v2.1.32
- Landing footer version: v3.21.1 → v3.22.1
- Landing releases timeline updated with Opus 4.6 features
- All sync checks passing (templates, quiz, lines, stars)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-05 21:04:55 +01:00
Florian BRUNIAUX
d986e25065
docs: quiz audit complete - 100% pass rate achieved (256/256)
...
Updated quality dashboard to reflect perfect completion:
- Pass rate: 93.8% → 100% (+6.2%)
- All 15 categories at 100%
- 0 critical, 0 warnings, 0 info issues
Journey:
- Baseline: 90.2% (231/256)
- After fixes: 92.6% → 93.8% → 97.8% → 100%
- Total issues resolved: 25 (9 critical, 16 warnings, 3 info)
All questions verified accurate against ultimate-guide.md.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 18:32:04 +01:00
Florian BRUNIAUX
e6a8f1746f
docs: add quiz quality dashboard
...
**Dashboard Overview:**
- Executive summary (93.8% pass rate, +3.6% improvement)
- Category performance (4 tiers: S/A/B/C/D)
- Issue breakdown by type (0 critical, 13 warnings, 3 info)
- Improvement roadmap (3 phases)
- Root cause analysis (40% guide context extraction issues)
- Historical trends & velocity tracking
- Best practices learned
**Key Insights:**
- Perfect categories: Q05, Q07, Q11, Q13 (100%)
- At-risk categories: Q09 (79.3%), Q10 (75.0%)
- Main issue: Guide context extraction (8/16 issues)
- Velocity: +3.6% in 1 day (9 fixes)
**Next Milestone:** 95%+ pass rate (12 fixes needed)
File: claudedocs/quiz-quality-dashboard.md (tracking quality over time)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 18:10:03 +01:00
Florian BRUNIAUX
69f493591e
docs: add quiz audit report (6 critical issues found)
...
**Audit Results (256 questions):**
- Pass: 231 (90.2%)
- Issues: 25 (9.8%)
- Critical: 6 (wrong answer/factual error)
- Warning: 16 (ambiguous/outdated)
- Info: 3 (minor wording)
**Critical issues fixed** (see landing repo commit 94bc3db):
- Q01-001: npm vs curl for universal install
- Q03-011: CLAUDE.md location confusion
- Q08-019: auto:N threshold misunderstanding
- Q09-003: --headless flag doesn't exist
- Q09-029: Boris Cherny attribution
- Q12-012: wrong sub-agent count
**Warnings to review** (Priority 2):
- 5 ambiguities (missing guide context)
- 7 factual accuracy issues (stats without sources)
- 2 outdated info (version changes)
**Healthiest categories:** Q05, Q07, Q11, Q13 (100% pass rate)
**Need attention:** Q09 (79.3%), Q10 (75.0%)
Audit system: extract-audit-context.py → generate-audit-batches.py → 16 parallel agents → generate-audit-report.py
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 17:20:35 +01:00
Florian BRUNIAUX
a55ff38143
feat(quiz): add complete audit system for 256 questions
...
Implements automated pipeline for quiz question quality control:
**Phase 1: Context Extraction**
- Script: extract-audit-context.py
- Resolves doc_reference anchors to guide sections (97.3% success)
- Multi-file support (ultimate-guide.md, learning-with-ai.md, etc.)
- Fuzzy matching + substring fallback
- Output: audit-context.json (256 questions + context)
**Phase 2: Batch Generation**
- Script: generate-audit-batches.py
- 16 prioritized review batches by category
- Advanced Patterns split into 2 batches (29 questions)
- Embedded review instructions in each batch
- Output: audit-batches/*.md (16,559 lines)
**Phase 3: Report Compilation**
- Script: generate-audit-report.py
- Parses agent review outputs (PASS/ISSUE format)
- Aggregates by severity (critical/warning/info)
- Output: audit-report.md
**Validation:**
- Q01-001 error found immediately (curl vs npm contradiction)
- System working as designed ✅
**Documentation:**
- AUDIT-WORKFLOW.md (complete 5-phase guide)
- AUDIT-SYSTEM-SUMMARY.md (architecture + metrics)
- IMPLEMENTATION-COMPLETE.md (status + validation)
- DEMO-REVIEW-OUTPUT.txt (example review)
**Next Steps:** Manual agent reviews (16 batches, ~2-3 hours)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 16:45:47 +01:00
Florian BRUNIAUX
1c27aa293d
docs: add ShipTypes resource evaluation (score 2/5 - marginal)
2026-02-04 12:14:12 +01:00
Florian BRUNIAUX
f830b1c836
chore: bump version to 3.22.0
...
Release dual-instance planning pattern (Jon Williams).
## Changes
- VERSION: 3.21.1 → 3.22.0
- CHANGELOG.md: Move [Unreleased] → [3.22.0] - 2026-02-04
- Dual-instance planning pattern entry (~15 bullet points)
- Documentation, Added section, full integration details
- Synced across: README.md, guide/cheatsheet.md, guide/ultimate-guide.md, reference.yaml
## Release Content
**Section 9.17.1**: Alternative Pattern: Dual-Instance Planning (~350 lines)
**Workflow**: guide/workflows/dual-instance-planning.md (~750 lines)
**Evaluation**: docs/resource-evaluations/jon-williams-dual-instance-pattern.md (~300 lines)
**References**: 15 new entries in reference.yaml
## Stats
- Total lines added: ~1,400
- Files modified: 10
- Evaluation score: 4/5 (High Value)
- Pattern: Vertical separation (planner ↔ implementer)
- Target audience: Solo devs, spec-heavy work, $100-200/month
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 10:41:55 +01:00
Florian BRUNIAUX
9c5d030b11
docs: add dual-instance planning pattern (Jon Williams)
...
Add vertical separation pattern (planner/implementer) as complement to horizontal scaling (Boris pattern).
## Changes
**Main guide (ultimate-guide.md)**:
- New Section 9.17.1: "Alternative Pattern: Dual-Instance Planning" (~350 lines)
- When to use (solo devs, spec-heavy, $100-200/month)
- Setup instructions (2 Claude instances, Plans/ directory)
- Complete workflow (5 phases: planning, review, implementation, verification, archive)
- Comparison table (Boris horizontal vs Jon vertical scaling)
- Cost analysis (2 instances vs correction loops)
- Agent-ready plan best practices
- Limitations and tips
**Workflow file (workflows/dual-instance-planning.md)**:
- Full workflow guide (~750 lines)
- Complete example (JWT auth implementation)
- Plan template (ready to copy-paste)
- Cost breakdown and decision matrix
- Troubleshooting and bash aliases
**References updated**:
- machine-readable/reference.yaml: 15 new entries
- dual_instance_planning, dual_instance_workflow, etc.
- Line numbers, source attribution, metadata
- guide/workflows/plan-driven.md: Link in See Also section
- README.md: Update evaluation count (46 → 47)
**Evaluation documented**:
- docs/resource-evaluations/jon-williams-dual-instance-pattern.md
- Full methodology (fetch, analyze, challenge, fact-check)
- Score progression (2-3/5 → 4/5 after technical-writer challenge)
- Gap analysis, comparison, integration rationale
## Source
LinkedIn post by Jon Williams (Product Designer, UK)
Date: 2026-02-03
URL: https://www.linkedin.com/posts/thatjonwilliams_ive-been-using-cursor-for-six-months-now-activity-7424481861802033153-k8bu
Context: Transition from Cursor (6 months) to Claude Code with Opus 4.5
Pattern: Vertical separation (Claude Zero: planning/review, Claude One: implementation)
Distinction: Orthogonal to Boris pattern (vertical vs horizontal scaling)
## Stats
- Lines added: ~1,400
- Files modified: 4
- Files created: 2 (workflow + evaluation)
- References added: 15 (reference.yaml)
- Evaluation score: 4/5 (High Value)
- Integration time: ~2.5 hours
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 10:38:10 +01:00
Florian BRUNIAUX
bc6b32ed3a
docs: update Claude Code releases to v2.1.31
...
- Update latest tracked version: v2.1.29 → v2.1.31
- Add v2.1.31 highlights: Session resume hint, PDF/bash/LSP fixes, system improvements
- Add v2.1.30 highlights: PDF pages support (pages parameter), OAuth pre-config (Slack), /debug command, git flags, task metrics
- Update dates: 2026-02-02 (v2.1.30), 2026-02-03 (v2.1.31)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 09:59:39 +01:00
Florian BRUNIAUX
47eee0cf48
docs(changelog): add Ctrl+R keybinding correction entry
...
- Document fix in 5 locations (cheatsheet + ultimate-guide)
- Add resource evaluation credit to Sankalp
- Link verification method and impact
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 17:28:40 +01:00
Florian BRUNIAUX
0a2e05f290
fix(keybindings): correct Ctrl+R from "Retry" to "Search history"
...
- Updated 5 locations in guide (cheatsheet + ultimate-guide)
- Verified against official keybindings: history:search action
- Added resource evaluation: Sankalp's Claude Code experience (2/5)
- Blog correctly identified guide error
Closes evaluation workflow for sankalp-claude-code-experience
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 17:27:54 +01:00
Florian BRUNIAUX
65ce82758f
docs: update README with Git MCP and evaluation count
...
Changes:
- Add mcp-servers-ecosystem.md to guide list
- Update resource evaluations count: 45 → 46 (3 locations)
Sync with git-mcp-server-evaluation.md integration
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 17:24:18 +01:00
Florian BRUNIAUX
b15647d57f
docs: add Git MCP Server (Official) comprehensive documentation
...
Integration:
- New section "Version Control (Official Servers)" in mcp-servers-ecosystem.md (~1600 words)
- Decision matrix: Git MCP vs GitHub MCP vs Bash tool (11 operations)
- 12 tools documented with setup, config, use cases, limitations
- Resource evaluation file created (git-mcp-server-evaluation.md)
- Machine-readable index updated (11 new entries)
- Evaluation count corrected: 36 → 46 (actual file count)
Score: 5/5 (CRITICAL) after technical-writer challenge
Gap filled: Official Git server 0% documented → 100% comprehensive
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 17:20:12 +01:00
Florian BRUNIAUX
975b8019ac
feat: add 4 ClaudeKit-inspired hooks (checkpoint, validation, file-guard)
...
- Add auto-checkpoint.sh (Stop event, git stash automation)
- Add typecheck-on-save.sh (PostToolUse, TypeScript validation)
- Add test-on-change.sh (PostToolUse, smart test detection)
- Add file-guard.sh (PreToolUse, unified file protection)
- Add ClaudeKit evaluation (3/5, patterns extracted)
- Version bump 3.21.0 → 3.21.1 (sync across all docs)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 21:50:48 +01:00
Florian BRUNIAUX
6910c06981
docs: add Native Sandboxing comprehensive documentation (v3.21.1)
...
Integration of official Anthropic sandboxing docs (5/5 CRITICAL):
Created (5 files):
- guide/sandbox-native.md (~3K words): Complete technical reference
* OS primitives (Seatbelt/bubblewrap), filesystem/network isolation
* Sandbox modes, escape hatch, security limitations
* Decision trees, config examples, troubleshooting
- docs/resource-evaluations/native-sandbox-official-docs.md (5/5 score)
- examples/config/sandbox-native.json (production config)
- examples/commands/sandbox-status.md (sandbox inspection)
- examples/hooks/bash/sandbox-validation.sh (prod validation)
Updated (5 files):
- guide/sandbox-isolation.md: Section 4 "Native Claude Code Sandbox"
* Comparison Native vs Docker (process-level vs microVM)
* Updated TL;DR, comparison matrix, decision tree
- guide/architecture.md: Native Sandbox sub-section in Security Model
- machine-readable/reference.yaml: +24 sandbox entries
- VERSION: 3.21.0 → 3.21.1
- README.md: Templates 100→103, Evaluations 44→45
- CHANGELOG.md: v3.21.1 entry
Closes critical security documentation gap (~1800 words missing).
Fact-checked 100%, agent-challenged (technical-writer), production-ready.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 20:24:17 +01:00
Florian BRUNIAUX
18cc838dcd
chore: bump version to 3.21.0 and update documentation
...
Version bump: 3.20.9 → 3.21.0
## Changes
- VERSION: Updated to 3.21.0
- CHANGELOG.md: Added [3.21.0] section with configuration management release notes
- README.md: Updated version footer and resource evaluations count (41 → 44)
- guide/cheatsheet.md: Updated version and date (January → February 2026)
- guide/ultimate-guide.md: Synced version references
- machine-readable/reference.yaml: Updated version and date
## Version Sync
All version references synchronized using ./scripts/sync-version.sh
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 18:25:09 +01:00
Florian BRUNIAUX
0630fcd883
feat: add configuration management and MCP secrets workflows ( closes #16204 )
...
Major additions to address critical gaps in Claude Code configuration:
## New Documentation Sections
1. Section 3.2.1 "Version Control & Backup" (guide/ultimate-guide.md:4085)
- Configuration hierarchy: global → project → local
- Git strategy for ~/.claude (symlinks approach)
- Backup strategies: Git remote, cloud sync, cron
- Multi-machine sync workflows
- Disaster recovery procedures
- Documented .claude/settings.local.json (previously undocumented)
2. Section 8.3.1 "MCP Secrets Management" (guide/ultimate-guide.md:8113)
- Three practical approaches: OS Keychain, .env, Secret Vaults
- Secrets rotation workflow
- Pre-commit secret detection
- Verification checklist
- Best practices summary
## New Templates
1. sync-claude-config.sh (examples/scripts/)
- Commands: setup, sync, backup, restore, validate
- .env parsing + envsubst for variable substitution
- Git repo creation with symlinks
- Validation checks (secrets not in Git)
2. pre-commit-secrets.sh (examples/hooks/bash/)
- Detects 10+ secret patterns (OpenAI, GitHub, AWS, etc.)
- Whitelist system for false positives
- Clear error messages with remediation steps
3. settings.local.json.example (examples/config/)
- Machine-specific overrides template
- Example use cases and patterns
## Resource Evaluation
- Added docs/resource-evaluations/ratinaud-config-management-evaluation.md
- Score: 5/5 (CRITICAL)
- Validated via 3 Perplexity searches + technical-writer agent challenge
- Community demand: GitHub #16204 + brianlovin/claude-config
## Updated References
- machine-readable/reference.yaml: 22 new entries
- Configuration management sections
- MCP secrets workflows
- Community resources (Ratinaud, brianlovin, GitHub issue)
## Impact
- Security: Pre-commit hook prevents secret leaks
- Productivity: Multi-machine sync reduces manual reconfig
- Team coordination: Onboarding workflow for ~/.claude setup
- Disaster recovery: Backup/restore strategies documented
Credits:
- Martin Ratinaud (504 sessions, LinkedIn post)
- brianlovin/claude-config (community example)
- GitHub Issue #16204 (community request)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 18:17:42 +01:00
Florian BRUNIAUX
5b69db64a9
docs: add Alan Tour Eiffel paradigm evaluation (5/5 CRITICAL)
...
Integration of Alan Engineering team's paradigm shift framework:
- Tour Eiffel Principle (transformation vs acceleration)
- Ralph Wiggum Programming (agentic loops)
- Verification Paradox (automated guardrails over human review)
Files added:
- docs/resource-evaluations/alan-tour-eiffel-paradigm.md (291 lines)
Files modified:
- guide/production-safety.md: New Rule 7 "Verification Paradox"
- guide/ai-ecosystem.md: Added practitioner insight (line 2133)
- machine-readable/reference.yaml: Added Alan + verification paradox entries
- README.md: Fixed evaluation counters (37/35/38 → 41)
Source: https://www.linkedin.com/pulse/le-principe-de-la-tour-eiffel-et-ralph-wiggum-maxime-le-bras-psmxe/
Authors: Charles Gorintin (CTO Alan), Maxime Le Bras (Talent Lead)
Published: 2026-02-02
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 14:21:51 +01:00
Florian BRUNIAUX
1ceba8b3fc
docs: add API Structured Outputs GA mention (2026-01-29)
...
Minimal mention in releases breaking changes summary.
Score 2/5 evaluation - indirect relevance to CLI users.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 11:07:59 +01:00
Florian BRUNIAUX
4d71fdc31d
docs: update Claude Code releases (v2.1.27 → v2.1.29)
...
Updates:
- Latest version: v2.1.29 (2026-01-31)
- Updated date: 2026-02-02
- Added v2.1.29: Performance fixes for session resumption
- Corrected v2.1.27 date: 2026-01-29 (was incorrectly 2026-01-31)
- Enhanced v2.1.27 highlights: Windows/VSCode fixes
Source: github.com/anthropics/claude-code/CHANGELOG.md
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 09:24:19 +01:00
Florian BRUNIAUX
0bb116cd2c
docs: add Multi-IDE Configuration Sync pattern (v3.20.9)
...
Added comprehensive documentation for maintaining consistent AI instructions
across multiple coding tools (Claude Code, Cursor, Copilot, etc.).
Changes:
- guide/ai-ecosystem.md: New "Multi-IDE Configuration Sync" section (L1256-1329)
- Problem statement with config file comparison table
- Solution 1: Native @import for Claude Code (recommended)
- Solution 2: Script-based generation for multi-IDE teams (bash example)
- AGENTS.md support status clarification + workaround (symlink)
- Compatibility matrix with external tool references
- machine-readable/reference.yaml: Added 2 index entries
- ai_ecosystem_multi_ide_sync: guide/ai-ecosystem.md:1256
- agents_md_support_status: guide/ai-ecosystem.md:1322
- CHANGELOG.md: Documented addition in [Unreleased] section
- VERSION: Bumped from 3.20.8 to 3.20.9 (patch)
- Auto-synced version across README, cheatsheet, ultimate-guide
Total: +91 insertions, -8 deletions (74 lines net content addition)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-02 09:04:00 +01:00
Florian BRUNIAUX
d5375e32a5
docs: add 2 resource evaluations (Osmani LinkedIn + Beyond Vibe Coding)
...
Added:
- Resource Evaluation: Addy Osmani LinkedIn Post (scored 2/5, Marginal)
- Post about Anthropic study (17% comprehension gap)
- 100% overlap with Shen & Tamkin 2026 already documented
- Decision: Tracking mention only (mainstream diffusion timeline)
- New criterion: "Influencer Amplification" pattern documented
- Resource Evaluation: "Beyond Vibe Coding" Book (scored 3/5, Pertinent)
- Comprehensive O'Reilly book by Addy Osmani
- 90% overlap analysis (10/14 topics covered 100%)
- Decision: Minimal integration (tracking mention + cross-refs)
- Cross-validation with 2 Osmani articles already integrated
Updated:
- CHANGELOG.md: [Unreleased] section with detailed entries
- README.md: Resource evaluations count (36 → 38 assessments)
Files created:
- docs/resource-evaluations/addy-osmani-linkedin-anthropic-study.md
- docs/resource-evaluations/beyond-vibe-coding.md
- docs/resource-evaluations/nick-tune-feedback-loops.md
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 23:30:03 +01:00
Florian BRUNIAUX
fb339b8575
docs: update RTK evaluation (v0.2.0 → v0.7.0)
...
BREAKING UPDATE: All gaps from initial evaluation resolved upstream.
## Version Evolution
- Initial eval: v0.2.0 (2026-01-28, score 4/5)
- Updated eval: v0.7.0 (2026-02-01, score 4.5/5)
- Development: 5 major releases in 9 days
## Critical Changes Resolved
✅ pnpm support (v0.6.0) - was MISSING
✅ npm/vitest support (v0.6.0) - was MISSING
✅ Git arg parsing (v0.7.0) - was BROKEN
✅ grep functionality (v0.7.0) - was BROKEN
✅ ls efficiency (v0.7.0+) - was BROKEN (-274% worse)
✅ Analytics (v0.4.0) - rtk gain temporal audit
✅ Opportunity scanner (v0.7.0) - rtk discover
✅ GitHub CLI (v0.6.0) - full gh support
✅ Cargo commands (v0.6.0) - build/test/clippy
✅ Auto-rewrite hook (v0.7.0) - PreToolUse integration
## Score Changes
| Criterion | v0.2.0 | v0.7.0 | Change |
|-----------|--------|--------|--------|
| Accuracy & Reliability | 3 | 4 | +1 |
| Depth & Comprehensiveness | 4 | 5 | +1 |
| Practical Value | 5 | 5 | 0 |
| Originality & Uniqueness | 5 | 5 | 0 |
| Production Readiness | 3 | 4 | +1 |
| Community Validation | 2 | 3 | +1 |
| **TOTAL** | 3.90 | 4.33 | +0.43 |
Rounded: 4/5 → **4.5/5**
## Community Growth
- Stars: 8 → 17 (+113%)
- Forks: 0 → 2 (+200%)
- PRs merged: 0 → 10+ (community contributions)
- Contributors: 1 → 2+
## Architecture Maturity
- 24 command modules (was 12)
- 9 filtering strategies (50-99% reduction)
- SQLite token tracking (~/.local/share/rtk/history.db)
- Configuration system (~/.config/rtk/config.toml)
## Recommendation Update
- OLD: "GOOD (4/5) - git-only, bugs, experimental"
- NEW: "EXCELLENT (4.5/5) - production-ready, full stack"
## Fork Status
- Fork (FlorianBruniaux) contributed 10+ PRs to upstream
- All features merged → fork no longer needed
- Recommendation: Use upstream v0.7.0 directly
## Impact
- Token reduction: 72.6% (git) → 89.4% (full stack)
- Command coverage: 40% → 85% (dev sessions)
- Maturity: experimental → production-ready (early adopters)
File changes: 633 lines (+69), 405 insertions, 335 deletions (major rewrite)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 23:07:12 +01:00
Florian BRUNIAUX
f1c6c47dc4
docs: add third-party-tools.md links to guide index and observability
...
Add cross-references to newly created third-party-tools.md:
- guide/README.md: Add third-party-tools.md to contents table
- guide/observability.md: Add link to third-party-tools section
Related to RTK documentation integration (commit fdee330 ).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 22:59:36 +01:00
Florian BRUNIAUX
60418f23a5
docs: update project description and stats
...
- Update README.md tagline:
- Old: "Master Claude Code with educational depth..."
- New: "Claude Code (Anthropic): the learning curve, solved."
- Stats: ~16K-line guide + 100 templates + 257 quiz + 22 hooks + 37 evaluations
- Update Templates badge: 86 → 100
Reflects current project state after RTK documentation integration.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 22:43:47 +01:00
Florian BRUNIAUX
fdee3305c5
docs: RTK documentation update - upstream + fork integration
...
- Update guide/ultimate-guide.md: RTK section (l.11084-11174)
- Two repositories: upstream (stable) + fork (extended features)
- Fork features: vitest, pnpm, prisma, gain, discover
- Bug fixes documented (grep/ls fixed in fork)
- Installation options: cargo, fork, binary
- Add guide/third-party-tools.md: RTK card (l.86)
- Comparison upstream vs fork
- Token savings: 70-90% depending on stack
- Cross-reference to ultimate-guide Section 9
- Update machine-readable/reference.yaml:
- rtk_upstream + rtk_fork_extended (two repos)
- third_party_tools_rtk entry added
- Line numbers updated
- Update docs/resource-evaluations/rtk-evaluation.md:
- UPDATE 2026-02-01 section with fork comparison
- Fork features table (JS/TS stack support)
- Installation instructions for fork
Total: 4 files, ~320 lines modified
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 22:20:43 +01:00
Florian BRUNIAUX
9f9f735436
release: v3.20.7 - Addy Osmani spec-writing integration
...
Version Bump:
- VERSION: 3.20.6 → 3.20.7
- CHANGELOG.md: New [3.20.7] section with Osmani integration details
- Synced across: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml
Release Highlights:
- Addy Osmani spec-writing evaluation (4/5, High Value)
- 4 new sections in spec-first.md (Modular Design, Operational Boundaries, Command Templates, Anti-Monolithic)
- 180 lines added to spec-first.md (327 → 507)
- 8 new reference.yaml entries
- 1 new resource evaluation (36 total)
Integration Details (see CHANGELOG.md):
- Modular spec design pattern (split >200 line CLAUDE.md files)
- Always/Ask First/Never operational boundaries framework
- Command spec templates with error handling
- Anti-pattern: monolithic CLAUDE.md context pollution
Landing Sync: Ready for deployment (version updated in separate commit)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 21:48:29 +01:00
Florian BRUNIAUX
a5942f1c53
docs: add Addy Osmani spec-writing evaluation (4/5) + spec-first.md sections
...
Integration of "How to write a good spec for AI agents" by Addy Osmani:
Evaluation (docs/resource-evaluations/addy-osmani-good-spec.md):
- Score: 4/5 (High Value - Integrate within 1 week)
- Fills gaps: modular design, operational boundaries, command specs
- Fact-checked: credentials verified via Perplexity, all claims sourced
- Challenge phase: technical-writer agent corrected initial 3/5 → 4/5
Spec-First Workflow Updates (guide/workflows/spec-first.md):
- NEW: "Modular Spec Design" section (~50 lines, line 322)
Pattern: Split large specs into focused files (CLAUDE-[domain].md)
- NEW: "Operational Boundaries" section (~60 lines, line 372)
Three-tier system: Always/Ask First/Never → maps to Claude Code modes
- NEW: "Command Spec Template" section (~40 lines, line 432)
Executable command specs with expected outputs & error handling
- NEW: "Anti-Pattern: Monolithic CLAUDE.md" section (~30 lines, line 472)
Explains cognitive load problem (>200 lines = context pollution)
Reference Index (machine-readable/reference.yaml):
- 8 new entries: spec_first_workflow → spec_osmani_score
- Links to new spec-first.md sections with line numbers
- Source attribution: https://addyosmani.com/blog/good-spec/
Public Facing (README.md):
- Incremented resource evaluations count: 35 → 36
File growth: spec-first.md 327 → 507 lines (+180)
Source: Addy Osmani (former Chrome team, 14y), published Jan 13, 2026
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-01 21:30:34 +01:00
Florian BRUNIAUX
bc86c8ed7f
release: v3.20.6 - agentskills.io integration + 4 resource evaluations
...
- agentskills.io open standard: frontmatter table, skills-ref CLI, portability section
- Agent Skills supply chain risks (security-hardening.md §1.2)
- anthropics/skills (60K+★) added to complementary resources
- 16 new reference.yaml entries
- Resource evaluations: agentskills.io (4/5), Skill Doctor (2/5), dclaude (new), paddo (new)
- Sandbox isolation + README updates
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 16:49:33 +01:00
Florian BRUNIAUX
23e0ac476d
docs: add /release command docs + visual-reference to guide index
...
- CLAUDE.md: document /release slash command with examples
- guide/README.md: add visual-reference.md to contents table
- scripts/compile-questions.sh: quiz compilation utility
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 23:20:01 +01:00
Florian BRUNIAUX
59ba1ae174
release: v3.20.5 - 4 new ASCII diagrams (visual-reference.md)
...
- Add visual-reference.md with 20 ASCII diagrams (16 existing + 4 new)
- #17 TDD Red-Green-Refactor Cycle
- #18 UVAL Protocol Flow
- #19 Security 3-Layer Defense
- #20 Secret Exposure Timeline
- Add Visual Reference to README Core Documentation table
- Version sync: 3.20.4 → 3.20.5
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 23:14:41 +01:00
Florian BRUNIAUX
a7962d5560
release: v3.20.4 - 30 new quiz questions (227 → 257)
...
Add 30 questions across 11 categories covering recent guide content:
Advanced Patterns (+8), MCP Servers (+3), Architecture (+3),
Reference (+3), Hooks (+2), Learning (+2), Security (+2),
AI Ecosystem (+3), Memory (+2), Agents (+1), Privacy (+1).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 22:17:32 +01:00
Florian BRUNIAUX
2fcc65e222
release: v3.20.3 - Competitive Analysis Gaps (claudelog.com)
...
9 gaps filled from claudelog.com competitive analysis (313 pages):
- Section 9.19: Permutation Frameworks (CLAUDE.md-driven variation testing)
- Skeleton Projects workflow (guide/workflows/skeleton-projects.md)
- Task Lists as Diagnostic Tool (instruction clarity mirror)
- Rev the Engine + Mechanic Stacking (multi-round planning patterns)
- Split-Role Sub-Agents (multi-perspective analysis)
- "You Are the Main Thread" mental model (CPU scheduler analogy)
- Continuous Context Update (proactive CLAUDE.md enrichment)
- Smart Hook Dispatching (single entry point routing to handlers)
Guide: 15,771 → 16,293 lines (+522)
New workflow: skeleton-projects.md (208 lines)
Reference: +17 new entries in reference.yaml
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 21:55:12 +01:00
Florian BRUNIAUX
950370e81b
release: v3.20.2 - Sandbox Isolation for Coding Agents
...
New guide file covering Docker Sandboxes (microVM isolation),
cloud alternatives (Fly.io Sprites, E2B, Vercel, Cloudflare),
safe autonomy workflows, and comparison matrix.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 19:08:25 +01:00
Florian BRUNIAUX
3ab6fe3ef5
docs: track Claude Code v2.1.27 release
...
--from-pr flag for PR-linked sessions, auto PR linking via gh pr create,
Bedrock/Vertex gateway fixes.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 16:19:51 +01:00
Florian BRUNIAUX
22f2b91b83
docs: integrate Contribution Metrics blog (4/5) - Anthropic Jan 2026 data
...
New subsection in ultimate-guide.md with +67% PRs merged and 70-90%
AI-assisted code metrics. Separate from Aug 2025 study (different
methodology: PR-based vs self-reported). ROI cross-reference added.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 23:34:15 +01:00
Florian BRUNIAUX
26ee4ef894
release: v3.20.1 - Vercel AGENTS.md vs Skills evaluation
...
- New resource evaluation (025): Vercel blog on eager context vs lazy
skill invocation (Gao, Jan 2026). Score 3/5, 13/13 fact-checked.
- Guide: added 8KB compression benchmark to CLAUDE.md sizing (line 3527)
- Guide: added 56% skill invocation warning to Memory Loading (line 4082)
- Guide: added invocation reliability caveat to skills.sh trade-offs
- Version sync 3.20.0 → 3.20.1
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 21:45:14 +01:00
Florian BRUNIAUX
fd4550cbd3
release: v3.20.0 - Multi-Agent Code Review Automation
...
Integration of production-grade PR review patterns from Pat Cullen + Méthode Aristote.
New Features:
- Resource evaluation: Pat Cullen Final Review (5/5 - Critical)
- Enhanced /review-pr: +150 lines with Advanced Multi-Agent Review section
- Enhanced code-reviewer agent: +219 lines with anti-hallucination rules
- New workflow: Review Auto-Correction Loop in iterative-refinement.md
- Production example: Multi-Agent Code Review in ultimate-guide.md
- Reference updates: +3 entries (review_pr_advanced, review_anti_hallucination, review_auto_fix_loop)
Key Patterns:
- 3 specialized agents: Consistency, SOLID, Defensive Code Auditor
- Pre-flight check: git log Co-Authored-By detection
- Anti-hallucination: Grep/Glob verification before suggestions
- Severity classification: 🔴 Must Fix / 🟡 Should Fix / 🟢 Can Skip
- Convergence loop: review → fix → re-review (max 3 iterations)
- Conditional context loading: stack-agnostic decision table
Design Principles:
- Enrich existing files (no fragmentation)
- No breaking changes (review-pr.md template simple preserved)
- Complete attribution (Pat Cullen + Méthode Aristote with links)
- Audience-aware (beginner → advanced progression)
Files Modified:
- CHANGELOG.md, VERSION: bumped to 3.20.0
- docs/resource-evaluations/017-pat-cullen-final-review.md: NEW (120 lines)
- examples/commands/review-pr.md: 80 → 230 lines (+150)
- examples/agents/code-reviewer.md: 72 → 291 lines (+219)
- guide/workflows/iterative-refinement.md: 389 → 522 lines (+133)
- guide/ultimate-guide.md: +28 lines (Production Example section)
- machine-readable/reference.yaml: +3 entries
- README.md, guide/cheatsheet.md: version sync
Total: +537 insertions, 0 deletions (no breaking changes)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 16:07:09 +01:00
Florian BRUNIAUX
97d41b8598
release: v3.19.0 - Hook Execution Model documentation
...
Adds comprehensive async hooks documentation filling critical gap.
Includes decision matrix, migration guide, and Aristote case study.
Changes:
- Added Hook Execution Model section to ultimate-guide.md (~97 lines)
- Documented sync vs async hooks (v2.1.0+) with configuration examples
- Added decision matrix for 15 use cases
- Updated reference.yaml with 7 new hook async entries
- Resource evaluation: Melvyn Malherbe LinkedIn post (score 1/5)
- Aristote case study: 7 hooks analyzed, 3 migrated async
- Version bump: 3.18.2 → 3.19.0
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 12:37:23 +01:00
Florian BRUNIAUX
8b58f014e7
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>
2026-01-30 12:32:38 +01:00
Florian BRUNIAUX
7df11b224f
release: v3.18.2 - Steinberger Practitioner Insight
...
Add Peter Steinberger (PSPDFKit Founder, Moltbot Creator) to Practitioner
Insights with model-agnostic workflow patterns.
Changes:
- Add Steinberger entry in guide/ai-ecosystem.md (stream monitoring,
multi-project juggling, fresh context validation, iterative exploration)
- Complete evaluation in docs/resource-evaluations/steinberger-inference-speed.md
(score 3/5, fact-checked GPT-5.2, validated credentials)
- Update docs/resource-evaluations/README.md (15→16 evaluations)
- Add practitioner_steinberger references in machine-readable/reference.yaml
- Version bump 3.18.1 → 3.18.2 (VERSION + sync all docs)
- Update CHANGELOG.md with detailed v3.18.2 entry
- Update README.md evaluations count (22→25)
Scope: Model-agnostic patterns only, zero model comparisons.
Source: https://steipete.me/posts/2025/shipping-at-inference-speed
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 09:49:55 +01:00
Florian BRUNIAUX
9ee0f9f5d5
release: v3.18.1 - Claude Code releases update
...
Bump guide version 3.18.0 → 3.18.1
Changes:
- Updated Claude Code releases tracking to v2.1.25
- Added v2.1.25: Beta header validation fix for Bedrock/Vertex
- Added v2.1.23: Spinner verbs, mTLS/proxy fixes, terminal perf
- Synchronized landing site version badge
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 08:59:24 +01:00
Florian BRUNIAUX
c844f74c8f
docs: update Claude Code releases to v2.1.25
...
- Add v2.1.25: Fixed beta header validation for Bedrock/Vertex
- Add v2.1.23: Customizable spinner verbs, mTLS/proxy fixes, terminal performance
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-30 08:48:25 +01:00
Florian BRUNIAUX
59b61dc849
docs: update CHANGELOG for MCP servers ecosystem documentation
...
- Added [Unreleased] section with MCP Servers Ecosystem Documentation entry
- Documents 8 validated community servers (Playwright, Semgrep, Kubernetes, etc.)
- Includes evaluation framework, quality scores, production deployment guide
- Fills critical gap: community MCP servers were previously undocumented
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-28 20:57:43 +01:00
Florian BRUNIAUX
8ca34da3ae
docs: add MCP servers ecosystem references
...
- guide/README.md: Added mcp-servers-ecosystem.md to docs table
- guide/ultimate-guide.md: Added Community MCP Servers section with 8 validated servers
* Playwright (Microsoft), Semgrep, Kubernetes (Red Hat), Context7, Linear, Vercel, Browserbase, MCP-Compose
* Quick start example, quality scores, production deployment guide reference
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-28 20:21:42 +01:00