marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
285 commits 1 branch 0 tags 20 MiB
Commit graph

47 commits

Author SHA1 Message Date
Florian BRUNIAUX
12568fbd61 docs: eval resource Rakesh Gohel / Aakash Gupta "Master Claude Code" infographic (score 2/5) 
Evaluation complète de l'infographie LinkedIn "Master Claude Code v1.0" (9 février 2026).
Score 2/5 (Marginal) - Ne pas intégrer.

Justifications:
- Aucune information technique nouvelle vs guide actuel
- Cheatsheet v3.23.4 strictement supérieur
- Erreur notable: recommandation Cursor comme "best experience" (red flag technique)
- Angle PM déjà couvert par Cowork Guide (repo dédié)
- 0/12 aspects apportent valeur nouvelle

Fichiers:
- docs/resource-evaluations/rakesh-gohel-aakash-gupta-master-claude-code.md (nouveau)
- docs/resource-evaluations/README.md (index mis à jour, 56→57 évaluations)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 10:42:11 +01:00
Florian BRUNIAUX
d5c3a82cac docs: add claude-mem plugin documentation (automatic session memory) 
Integrate claude-mem (thedotmack/claude-mem) into the guide as Section 8.2.5.
Score: 4/5 (High Value - automatic session capture fills documentation gap).

Added:
- Section 8.2.5: claude-mem plugin (automatic session memory)
  * Automatic capture via lifecycle hooks
  * AI compression + progressive disclosure (10x tokens)
  * Web dashboard at localhost:37777
  * Natural language search
  * Privacy controls (<private> tags)
  * Cost analysis ($0.15/100 obs)
  * AGPL-3.0 licensing considerations

- Memory Tools Decision Matrix (claude-mem vs Serena vs grepai)
  * 4-layer memory stack pattern
  * Integrated workflow examples
  * When to use automatic vs manual memory

- Plugin template: examples/plugins/claude-mem.md
  * Installation, configuration, troubleshooting
  * Advanced features (progressive disclosure, endless mode)
  * Export/import, cost optimization

- Resource evaluation: docs/resource-evaluations/claude-mem-evaluation.md
  * Technical analysis (fact-checked stats)
  * Comparison to existing tools
  * Integration recommendations

- reference.yaml: 14 new claude-mem entries

Changed:
- Updated search tools comparison (5 tools: rg, grepai, Serena, ast-grep, claude-mem)
- Extended feature matrix with "Auto capture" and "Web dashboard" rows

Stats (verified 2026-02-10):
- 26.5k GitHub stars, 1.8k forks
- 181 releases, 46 contributors
- Latest: v9.1.1 (Feb 7, 2026)
- License: AGPL-3.0 + PolyForm Noncommercial

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 08:47:17 +01:00
Florian BRUNIAUX
89084c89ec docs: integrate Anthropic 2026 Agentic Coding Trends Report 
Integration strategy: diffusion transversale (~450 lines across 5 files)
instead of monolithic Section 9.21 (rejected after technical-writer review).

Evaluation: 4/5 score (high value, but lacks concrete code examples)
Source: https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf

Changes:
1. Created evaluation report (docs/resource-evaluations/)
   - Summary, gap analysis, challenge results, fact-check
   - Justification: validation industrie, benchmarks, anti-patterns

2. Modified guide/ultimate-guide.md (3 insertions, ~270 lines)
   - Section 9 intro: Industry context encadré with adoption data
   - Section 9.17 Multi-Instance: ROI benchmarks ($500-1K/month validation)
   - Section 9.11: Enterprise Anti-Patterns section (5 detailed patterns)

3. Modified guide/workflows/agent-teams.md (~80 lines)
   - Industry adoption data with case studies
   - Timeline: 3-6 months, success rates by phase
   - Real-world performance metrics (Fountain 50%, Rakuten 7h, TELUS 500K hours)

4. Modified machine-readable/reference.yaml (~40 lines)
   - Added agentic_trends_2026_* metadata section
   - Research data, case studies, benchmarks, anti-patterns references

5. Modified README.md (~8 lines)
   - Added "Research & Industry Reports" section
   - Link to Anthropic report with evaluation details

Stats validated: 60% AI usage, 0-20% full delegation, 67% more PRs/day,
27% new work, 7 case studies (Fountain, Rakuten, CRED, TELUS, Legora, Zapier, Augment).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 17:18:52 +01:00
Florian BRUNIAUX
17846b1179 docs: complete Wasp fullstack essentials integration 
Complete all 4 action items from wasp-fullstack-essentials-eval.md resource
evaluation (score 3/5). Framework-agnostic insights only, promotional content
excluded.

Changes (3 sections):

1. Background tasks workflow (Section 9.5)
   - New subsection: "Background Tasks for Fullstack Development"
   - When to background tasks (5 scenarios table)
   - Fullstack workflow pattern with examples
   - Context rot prevention strategies
   - Limitations and workarounds
   - Integration with teleportation
   - /tasks monitoring guide
   - ~100 lines added to Section 9.5 "Tight Feedback Loops"

2. Chrome DevTools MCP (mcp-servers-ecosystem.md)
   - New server entry in "Browser Automation" section
   - Official Anthropic server (not community)
   - Comparison table vs Playwright MCP (debugging vs testing)
   - Setup and configuration
   - Use cases and limitations
   - Updated stats: 3 browser servers (was 2), 6 official servers (was 5)
   - ~60 lines added to Browser Automation section

3. Convention-over-config for AI (Section 9.18.1)
   - New subsection: "Convention-Over-Configuration for AI Agents"
   - Why opinionated frameworks reduce agent cognitive load
   - Comparison table: custom vs opinionated architectures
   - Examples: Next.js, Rails, Phoenix, Django
   - Real-world impact on agent productivity
   - Trade-offs analysis
   - Connection to CLAUDE.md sizing (token reduction)
   - ~60 lines added to Section 9.18.1

Total additions: ~220 lines (workflow patterns + MCP server + AX framework)

Source evaluation: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
Primary sources: llmstxt.org (llms.txt), official docs (background tasks, Chrome
DevTools MCP), existing Section 9.18 (Marmelab/AX framework)

Related commits:
- 783c43b: llms.txt conceptual documentation (completed earlier)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:00:53 +01:00
Florian BRUNIAUX
783c43baed docs: add llms.txt conceptual documentation to Section 9.18 
Add comprehensive llms.txt documentation based on Wasp fullstack essentials
resource evaluation (score 3/5). Sourced from llmstxt.org spec, not the
promotional article.

Changes:
- New section 9.18.4: Documentation Formats for Agents (llms.txt)
- Explains llms.txt standard, format, and use cases
- Clarifies complementarity with Context7 MCP (not opposition)
- Provides minimal and advanced examples with line numbers
- Integration patterns with CLAUDE.md
- References this repo's own llms.txt implementation
- Updated section numbering (9.18.4-9.18.11)
- Updated Section 9.18 TL;DR with new principle
- Added reference.yaml entries for llms.txt

Resource evaluation:
- File: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
- Source: Wasp DevRel blog (framework-agnostic insights extracted)
- Score: 3/5 (partial integration, promotional content excluded)
- Gap identified: Embarrassing to have llms.txt file without explaining concept
- Primary source: llmstxt.org specification

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 09:46:50 +01:00
Florian BRUNIAUX
9805b615c5 docs: correct Agent Teams architecture + add session handoff template 
## Agent Teams Architecture Corrections

Based on official sources (Addy Osmani blog, Feb 2026):

**Major changes**:
- Add mailbox system documentation (peer-to-peer messaging)
- Correct communication model: not only team lead synthesis
- Update diagrams to show peer-to-peer arrows
- Clarify context isolation vs message sharing
- Add 7 sections with source attribution
- Add documentation update note (2026-02-09)

**Key correction**: Agents communicate via mailbox system (direct
peer-to-peer + team lead synthesis), not only hierarchical reporting.

**Files modified**:
- guide/workflows/agent-teams.md (+72 -19): 7 major corrections
- CHANGELOG.md: Document session handoff template addition
- guide/architecture.md: Architecture clarifications
- guide/ultimate-guide.md: Cross-references updates

**Sources**:
- https://addyosmani.com/blog/claude-code-agent-teams/
- Perplexity research (sonar-reasoning-pro, Feb 2026)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 09:23:41 +01:00
Florian BRUNIAUX
b8eb937642 fix: correct evaluation count in README (25 → 55) 
The previous automatic update showed 25 evaluations instead of 55.
Verified with: find docs/resource-evaluations -type f -name '*.md' ! -name 'README.md' | wc -l

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 16:14:37 +01:00
Florian BRUNIAUX
4c0e4b6ac6 docs: integrate Gur Sannikov ADR workflow + native capabilities audit (4/5) 
- Add ADR-Driven Development pattern to methodologies.md (~60 lines)
  - Pattern: ADR → skill → native execution
  - Example ADR template (database migration)
  - Complete bash workflow with benefits
- Add Native Capabilities Audit checklist to architecture.md (~50 lines)
  - 11 native capabilities with internal links
  - Onboarding tip for comprehension audit
- Add Dynamic Model Switching pattern to cheatsheet.md (~40 lines)
  - Pattern: Sonnet → Opus → Sonnet
  - Cost comparison table and best practices
- Add Community Validation to architecture.md (~15 lines)
  - External validation of 'less scaffolding, more model' approach
  - Cursor power user adopting Agent Skills standard
- Track evaluation in docs/resource-evaluations/ (full methodology)
- Update evaluations count: 24 → 55 (README + reference.yaml)
- Update CHANGELOG.md with integration details

Source: https://www.linkedin.com/posts/gursannikov_claudecode-embeddedengineering-aiagents-activity-7423851983331328001-DrFb
Score: 4/5 (HIGH VALUE) - fills ADR workflow gap + onboarding checklist

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 16:12:53 +01:00
Florian BRUNIAUX
b48d95c024 feat: add agent/skill quality audit tooling + Grenier evaluation 
AUDIT TOOLING (3 templates):
- Command: /audit-agents-skills (quick project audits)
  - 16-criteria framework (Identity 3x, Prompt 2x, Validation 1x, Design 2x)
  - Weighted scoring: 32 pts (agents/skills), 20 pts (commands)
  - Production grading (A-F, 80% threshold)
  - Fix mode with actionable suggestions
- Skill: audit-agents-skills (advanced audits)
  - 3 modes: Quick (top-5), Full (all 16), Comparative (vs templates)
  - JSON + Markdown output for CI/CD
- Scoring grids: criteria.yaml (externalized for reuse)

EVALUATION:
- Grenier agent/skill quality (3/5 - Moderate Value)
  - Gap: 29.5% deploy without evaluation (LangChang 2026)
  - Integration: Created audit command + skill + criteria
  - Industry context: 18% cite agent bugs as top challenge

DOCUMENTATION:
- Guide refs: 2 strategic call-outs (after Agent/Skill validation)
- CHANGELOG: New "Added" section + evaluation details
- README: Templates 106→107, Evaluations 49→24 (count corrections)
- reference.yaml: 10 new audit entries + updated counts

SYNC:
- Landing index.html: Templates 107, Evals 24, Quiz 257
- Landing examples/index.html: Templates 107

FILES: 14 changed, 4148 insertions (+1250 lines new audit content)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 15:40:18 +01:00
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
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
1c27aa293d docs: add ShipTypes resource evaluation (score 2/5 - marginal) 2026-02-04 12:14:12 +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
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
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
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
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
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
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
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
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
940caf3f1e docs: add verified critical bugs tracker (known-issues.md) 
NEW: guide/known-issues.md (285 lines)
- GitHub issue auto-creation bug (Issue #13797, v2.0.65+, ACTIVE)
  * 17+ confirmed accidental public disclosures
  * Security/privacy risk documented
  * Workarounds: explicit repo, manual approval, pre-execution verification
- Excessive token consumption (Issue #16856, v2.1.1+, Jan 2026)
  * 20+ reports of 4x+ faster consumption
  * Anthropic: "Not officially confirmed as bug" (investigating)
  * Workarounds: /context monitoring, shorter sessions, disable auto-compact
- Model quality degradation (Aug-Sep 2025, RESOLVED)
  * Anthropic official postmortem: 3 infrastructure bugs
  * Community theories (quantization) debunked

FACT-CHECKED: Perplexity Pro + GitHub API direct queries
- Verified: 5,702 open issues (not 4,697), 527 invalid labels
- Corrected: v2.1.1 token bug (not non-existent v2.0.61)
- Sources: GitHub Issues, Anthropic postmortem, The Register

UPDATED:
- guide/README.md: Added known-issues.md to docs table
- machine-readable/reference.yaml: 4 new entries for issue tracking
- CHANGELOG.md: Documented integration process

NEW: docs/resource-evaluations/023-community-discussions-report-jan2026.md
- Full evaluation process documented
- Fact-check methodology: Perplexity + GitHub API
- Score: 2/5 (Marginal - partial integration only)
- Lesson: Always verify community reports with primary sources

Impact: Critical security awareness for users, actionable workarounds

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-28 17:59:16 +01:00
Florian BRUNIAUX
c28161dca8 docs: enrich RTK evaluation with T3 Stack production testing 
Real-World Testing Results (Méthode Aristote - T3 Stack):
- Project: Next.js 15 + tRPC + Prisma + pnpm
- Commands tested: 12 (git, pnpm, Vitest, TypeScript, Prisma)
- Git workflows validated: 85.6% avg reduction (up from 72.6%)

Critical Bug Discovered:
- git argument parsing broken (`--oneline`, `--graph` blocked)
- Workaround: `rtk git log -- -20` (works)
- Impact: CRITICAL - affects ALL git users

Modern Stack Gaps Identified:
- pnpm support MISSING (80-90% reduction possible, CRITICAL impact)
- Vitest support MISSING (90% reduction possible, HIGH impact)
- TypeScript support MISSING (70% reduction possible, MEDIUM impact)

ROI Analysis:
- Current v0.2.0: 40% command coverage, 55% token reduction
- Proposed v0.3.0 (pnpm + Vitest): 85% coverage, 80% reduction
- Dev effort: 1 week (7 days)

New Deliverables:
- Benchmark script: examples/scripts/rtk-benchmark.sh (reproductible tests)
- Test results: claudedocs/rtk-test-results-aristote.md (53KB, gitignored)
- Updated PR proposals: claudedocs/rtk-pr-proposals.md (P0-P2 ranking)
- GitHub issues: claudedocs/rtk-github-issue-template.md (ready for upstream)

Updated Evaluation:
- Score: Still 4/5 (GOOD) but clearer path to 5/5 (CRITICAL)
- Blockers: git args bug + pnpm/Vitest gaps
- Strength: 85.6% git reduction validated on production codebase

Full report: claudedocs/rtk-test-results-aristote.md (23K detailed analysis)
 2026-01-28 14:01:37 +01:00
Florian BRUNIAUX
1000cb6e85 docs: add RTK integration templates and evaluation 
- Evaluation: docs/resource-evaluations/rtk-evaluation.md (4/5 score, comprehensive benchmarks)
- CLAUDE.md template: examples/claude-md/rtk-optimized.md (manual usage instructions)
- Skill template: examples/skills/rtk-optimizer/SKILL.md (auto-suggestion)
- Hook template: examples/hooks/bash/rtk-auto-wrapper.sh (PreToolUse auto-wrapper)
- PR proposals: claudedocs/rtk-pr-proposals.md (7 upstream improvements)

These templates enable 3 RTK integration strategies referenced in guide:10478
 2026-01-28 13:03:10 +01:00
Florian BRUNIAUX
34b7376408 fix: correct mgrep misattribution in Everything Claude Code evaluation 
Issue:
- Incorrectly claimed Everything Claude Code contained "mgrep (50% token reduction)" tool
- No such tool exists in affaan-m/everything-claude-code (verified via WebFetch + repo search)
- Confused mgrep (mixedbread-ai semantic search) with non-existent token reduction tool

Files corrected:
- docs/resource-evaluations/015-everything-claude-code-github-repo.md (14 occurrences removed)
- machine-readable/reference.yaml:724 (unique patterns list updated)
- guide/ultimate-guide.md:14821 (replaced with verified patterns)
- CHANGELOG.md (v3.17.0 and v3.15.0 entries updated)

Verified patterns now documented:
- hookify (conversational hooks)
- pass@k metrics (formal verification)
- sandboxed subagents (tool restrictions)
- strategic compaction skills (context management)

Impact: Maintains guide accuracy, prevents user confusion

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-28 09:50:07 +01:00
Florian BRUNIAUX
11d2e4dfe3 docs: add everything-claude-code repository evaluation (5/5 CRITICAL) 
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:29:12 +01:00
Florian BRUNIAUX
3a5012eef7 docs: document Tasks API field visibility limitations (Gang Rui analysis) 
Integration of community practitioner feedback on Tasks API (v2.1.16+)
field visibility constraints discovered through real-world usage.

Changes:
- guide/ultimate-guide.md:
  * Added 3 rows to comparison table (field visibility, metadata, overhead)
  * New subsection "⚠️ Tasks API Limitations (Critical)" (~40 lines)
  * Field visibility constraint table, cost examples, 3 workaround patterns

- guide/workflows/task-management.md:
  * New subsection "⚠️ Field Visibility Limitations" (~35 lines)
  * Workflow adjustments, cost awareness, mitigation strategies

- guide/cheatsheet.md:
  * Added limitation note with actionable tip (~3 lines)

- machine-readable/reference.yaml:
  * 4 new entries: limitations, field_visibility, cost_overhead, workarounds
  * Updated resource_evaluations_count: 16 → 22

- docs/resource-evaluations/016-gang-rui-tasks-api-limitations.md:
  * New comprehensive evaluation (score 5/5 CRITICAL)
  * Fact-check, challenge phase, integration details

- README.md:
  * Updated resource evaluations count: 15 → 22 assessments

Score: 5/5 (CRITICAL) - Breaks recommended workflow, 11x-51x cost
overhead, prevents user frustration, maintains guide credibility.

Source: https://www.linkedin.com/posts/limgangrui_i-explored-the-new-claude-codes-task-system-activity-7420651412881268736-Hpd6
Date: 2026-01-24

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:16:49 +01:00
Florian BRUNIAUX
edf74b38c5 docs: add missing hook events from official CHANGELOG (v2.1.9-v2.1.10) 
- Add 3 missing events to Section 7.1: Setup, PermissionRequest, SubagentStop
- Document PreToolUse additionalContext feature (v2.1.9+)
- Create 3 production-ready hook templates (setup, permission, subagent)
- Add resource evaluation documenting rejection of secondary source

Source: Official Claude Code CHANGELOG, not external blog posts
Closes gap identified during resource evaluation process

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 12:45:47 +01:00
Florian BRUNIAUX
6e621806a4 docs: add Myths vs Reality appendix + TeammateTool documentation 
- Appendix D: Myths vs Reality
  - Myth: Hidden features with secret flags
  - Myth: Tasks API = autonomous agents
  - Myth: 100x faster claims
  - Reality: Documented strengths of Claude Code
  - How to spot reliable vs unreliable sources

- New: TeammateTool experimental feature documentation
  - Multi-agent orchestration capabilities
  - Execution backends (in-process, tmux, iTerm2)
  - Usage patterns (parallel specialists, swarm)
  - Clear warnings about experimental status
  - Community sources cited

- Cheatsheet: Features Méconnues (But Official!) section
  - Tasks API, Background Agents, TeammateTool
  - Session Forking, LSP Tool
  - Pro tip: Read the CHANGELOG

- Reference.yaml: Added line numbers for new sections

- Resource evaluation: Rejected low-quality social media post
  (docs/resource-evaluations/2026-01-27-claude-code-hidden-feature-social-post.md)

Addresses community misinformation while documenting real experimental features with proper sourcing.
 2026-01-27 09:45:06 +01:00
Florian BRUNIAUX
a8d0f0273d release: version 3.15.0 - MCP Apps integration 
Bump version to 3.15.0 with comprehensive MCP Apps documentation.

Version updates:
- VERSION: 3.14.0 → 3.15.0
- Synced across: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml
- Updated date: reference.yaml (2026-01-27)

CHANGELOG.md:
- Added MCP Apps (SEP-1865) documentation entry in [Unreleased]
- ~50 lines detailing all changes:
  - architecture.md section (~150 lines)
  - ultimate-guide.md section (~90 lines)
  - Table update (Plugin vs MCP vs MCP Apps)
  - machine-readable/reference.yaml (8 entries)
  - Resource evaluation (159 lines, score 4/5)
- Key facts: First official MCP extension, co-authored OpenAI+Anthropic
- 9 interactive tools at launch (Asana, Slack, Figma, etc.)
- Platform support: Claude Desktop, VS Code, ChatGPT, Goose
- CLI relevance: Indirect (ecosystem, dev, hybrid workflows)

README.md:
- Resource Evaluations: 14 → 15 assessments

docs/resource-evaluations/README.md:
- Added MCP Apps entry in index table
- Score: 3/5 → 4/5 (High Value)
- Updated date: 2026-01-27
- Confirmed count: 15 evaluations

Total changes:
- 2 commits (MCP Apps docs + version bump)
- ~240 lines documentation (architecture + guide)
- 15 resource evaluations tracked
- 4/5 integration score (ecosystem impact)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 08:24:25 +01:00
Florian BRUNIAUX
18ea240e12 docs: add MCP Apps (SEP-1865) documentation 
Integrate comprehensive documentation for MCP Apps, the first official
MCP extension enabling interactive UI delivery.

Changes:
- guide/architecture.md (656): New section "MCP Extensions: Apps"
  - Technical architecture (primitives, SDK, security)
  - Platform support (Claude Desktop, VS Code, ChatGPT, Goose)
  - Example implementations (9 production tools at launch)
  - Developer workflow and SDK usage
  - ~150 lines of technical documentation

- guide/ultimate-guide.md (6509): New section "MCP Evolution: Apps"
  - User context and use cases
  - Available interactive tools (Asana, Slack, Figma, etc.)
  - Platform support matrix
  - Hybrid workflow examples
  - ~90 lines of user-facing documentation

- guide/ultimate-guide.md (7522): Table update
  - Added "Interactive UI" row to Plugin vs. MCP Server comparison
  - Clarified MCP Apps = "What Claude can show"

- machine-readable/reference.yaml: 8 new entries
  - mcp_apps_architecture, mcp_apps_evolution
  - Links to spec, SDK, blog posts
  - CLI relevance note (indirect)

- docs/resource-evaluations/mcp-apps-announcement.md: New evaluation
  - Score: 4/5 (High Value - Integrate within 1 week)
  - Fact-checked with Perplexity searches
  - Technical review by agent

Resource evaluated:
- https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/
- https://claude.com/blog/interactive-tools-in-claude

Total documentation: ~240 lines across 3 files
Score: 4/5 (High Value)
CLI relevance: Indirect (ecosystem understanding, MCP server dev, hybrid workflows)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 08:14:49 +01:00
Florian BRUNIAUX
3a7671ac5e docs: update $ARGUMENTS syntax for v2.1.19 breaking change + evaluation 
Updated all documentation and examples to reflect Claude Code v2.1.19
breaking change: $ARGUMENTS.0 → $ARGUMENTS[0] (bracket syntax).

Changes:
- guide/ultimate-guide.md: 7 occurrences updated to bracket/shorthand syntax
- guide/cheatsheet.md: Command template updated
- Added migration note in § 6.2 Variable Interpolation
- Created migration scripts: migrate-arguments-syntax.{sh,ps1}
  • Automated detection + conversion with backups
  • Dry-run mode, cross-platform (macOS/Linux/Windows)
- Added formal evaluation: eval-claude-code-releases-jan2026.md
  • Score: 5/5 (Critical - Integrate Immediately)
  • Covers releases 2.1.0 to 2.1.19 (January 2026)
  • Technical accuracy verified against GitHub CHANGELOG

Files:
- guide/ultimate-guide.md (+23 lines, 7 occurrences fixed)
- guide/cheatsheet.md (+1 line)
- examples/scripts/migrate-arguments-syntax.sh (+152 lines)
- examples/scripts/migrate-arguments-syntax.ps1 (+143 lines)
- docs/resource-evaluations/eval-claude-code-releases-jan2026.md (+273 lines)
- CHANGELOG.md (+12 lines, Unreleased section)

Total: +605 lines

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 17:37:49 +01:00
Florian BRUNIAUX
08a2a4261f docs: add system prompts official sources (Anthropic + community analyses) 
- Add System Prompt Contents section in architecture.md (line 300-326)
  - Official Anthropic sources (Tier 1, 100% confidence)
  - Community analyses (Simon Willison, PromptHub)
  - Claude.ai vs API vs Code CLI distinctions

- Update reference.yaml with 4 new system prompts entries
  - system_prompts_official, willison_analysis, prompthub, architecture

- Create resource evaluation: system-prompts-official-vs-community.md
  - Score evolution: 4/5 → 3/5 → 2/5 (after Perplexity fact-check)
  - Decision: Do not integrate x1xhlol repository (redundant)
  - Use official Anthropic sources instead

- Create watchlist for non-integrated resources
  - claudedocs/resource-evaluations/watch-list.md (gitignored)
  - Re-evaluation triggers: Q2 2026 or if 10+ user requests

Related evaluation: docs/resource-evaluations/system-prompts-official-vs-community.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 17:03:42 +01:00
Florian BRUNIAUX
ab8bfcf782 docs: add Anaconda Croce evaluation (minimal integration) 
Resource evaluated: "What I Learned Challenging Claude to a Coding Competition"
by Steve Croce (Anaconda Field CTO, Jan 16, 2026)

Score: 2/5 (Marginal - Info secondaire)

Integration:
- Added "Community Experiences" section in guide/learning-with-ai.md
- 2-paragraph mention with strong caveats (N=1, non-representative context)
- Full evaluation in docs/resource-evaluations/anaconda-croce-evaluation.md
- Updated reference.yaml count (14 → 16 evaluations)

Rationale:
- Provides light empirical validation (90s vs 60min on Advent of Code)
- Highlights "collaboration cost" angle (decreased Slack engagement)
- Limitations prevent extensive integration (solo puzzles ≠ team dev)
- Commercial bias noted (Anaconda blog by Anaconda CTO)

Technical review challenged initial 4/5 score → adjusted to 2/5.
Maintains guide rigor through minimal integration + explicit caveats.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 16:53:48 +01:00
Florian BRUNIAUX
1136dc683f docs: add resource-evaluations to tracked docs 
- Create docs/resource-evaluations/ with 15 evaluation files
- Standardize filenames (remove date prefixes)
- Keep working docs and private audits in claudedocs/ (gitignored)
- Add resource evaluation workflow to CLAUDE.md

Files migrated:
- gsd, worktrunk, boris-cowork-video, wooldridge-productivity-stack
- remotion, nick-jensen, se-cove, self-improve-skill
- astgrep, clawdbot, prompt-repetition, uml-diagrams
- vibe-coding-rusitschka, anthropic-releases

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:02:05 +01:00