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

66 commits

Author SHA1 Message Date
Florian BRUNIAUX
c3da456d3a release: v3.27.6 - Sonnet 4.6 default + 200K vs 1M context guide 
- Pricing table: Sonnet 4.6 now default (Feb 2026)
- New section: 200K vs 1M context decision guide (MRCR bench, cost table, use cases)
- threat-db.yaml v2.1.0: CVE-2026-23744, Slopsquatting T009, OWASP Agentic AI Top 10

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-18 09:33:55 +01:00
Florian BRUNIAUX
4b15bdb137 release: v3.27.5 - Claude Code v2.1.45 tracking 
- Bump guide: v3.27.4 → v3.27.5
- Update Claude Code releases: v2.1.44 → v2.1.45
  - Sonnet 4.6 model support
  - spinnerTipsOverride setting
  - SDK SDKRateLimitInfo/SDKRateLimitEvent types
  - Agent Teams fix on Bedrock/Vertex/Foundry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-17 21:12:53 +01:00
Florian BRUNIAUX
1f720f7d74 release: v3.27.4 - template count update + worktree docs 
- Templates 113 → 116 (review-plan, git-worktree-status/remove/clean, rules)
- Commands 23 → 26 (worktree lifecycle suite)
- Git worktree section expanded with lifecycle commands table
- Version sync across all docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-17 11:15:32 +01:00
Florian BRUNIAUX
4cf1bf3cec docs: v3.27.3 — track Claude Code v2.1.42 + Google Antigravity section 
- Claude Code releases: v2.1.41 → v2.1.42 (startup perf, prompt cache, Opus 4.6 effort callout)
- New AI ecosystem section: Google Antigravity agent-first IDE comparison
- Version sync across all docs (3.27.2 → 3.27.3)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 09:38:31 +01:00
Florian BRUNIAUX
0f4b1837c5 docs: v3.27.2 — YAML frontmatter on 90 markdown files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:24:07 +01:00
Florian BRUNIAUX
d1182af4cf docs: v3.27.1 — fact-check corrections, grepai docs, RTK overhaul 
Fact-check (README positioning):
- Template count: 120/123 → 108 (ground truth recount)
- Ratio: 14× → 24× (19,000 ÷ 784 = 24.2×)
- everything-cc stars: 31.9k → 45k+ (verified Feb 15)
- Commands count: 20 → 23, hooks: 30 → 31

Added:
- Grepai MCP documentation (semantic search, call graphs)
- 3 hook templates (rtk-baseline, session-summary, session-summary-config)
- 2 resource evaluations (system-prompts update, qmd token savings)

Changed:
- RTK documentation overhaul (v0.7.0 → v0.16.0, rtk-ai org)
- Exports deprecated (kimi.pdf, notebooklm.pdf → deprecated/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 18:41:45 +01:00
Florian BRUNIAUX
d72905e9ba docs: integrate Entire CLI across guide (v3.27.0) 
Major integration of Entire CLI, an agent-native platform launched
Feb 2026 by Thomas Dohmke (ex-GitHub CEO) with $60M funding. Provides
rewindable checkpoints, approval gates, and audit trails for AI sessions.

## Added (7 guide files + 3 meta files)

- **ai-traceability.md**: Replace git-ai 404 with Entire CLI (section 5.1)
- **third-party-tools.md**: Fill "Session replay" gap + add tool section
- **observability.md**: Add session portability alternative
- **ai-ecosystem.md**: Add governance-first orchestration (section 8.1.5)
- **ultimate-guide.md**: Enrich multi-instance section 9.17
- **security-hardening.md**: Add compliance audit trails (section 3.4)
- **cheatsheet.md**: Add Community Tools quick reference
- **README.md**: Update structure tree with third-party-tools mention
- **CHANGELOG.md**: Document v3.27.0 release
- **docs/resource-evaluations/entire-cli.md**: Formal evaluation (5/5)

## Fixed

- git-ai references (404 repo) replaced with working alternative
- "Session replay" Known Gap now marked as ✅ FILLED

## Key Features Documented

- Rewindable checkpoints (prompts + reasoning + tool usage)
- Governance layer (approval gates, permissions, audit trails)
- Multi-agent handoffs (Claude → Gemini with context)
- Compliance-ready (SOC2, HIPAA, FedRAMP)
- Session portability (path-agnostic vs native --resume)

## Positioning

- vs git-ai: Replaces non-existent tool (404)
- vs claude-code-viewer: Active replay vs read-only history
- vs Gas Town: Governance sequential vs parallel coordination

Files modified: 10 (7 content + 3 meta)
Words added: ~2,500
Version: 3.26.0 → 3.27.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-12 23:33:16 +01:00
Florian BRUNIAUX
971a297db3 feat(security): add threat intelligence DB, security commands, and cheatsheet audit fixes (v3.26.0) 
- Add threat-db.yaml v2.0.0 with 63 malicious skills, 22 CVEs, 4 campaigns
- Add /security-check, /security-audit, /update-threat-db slash commands
- Add Snyk ToxicSkills evaluation (58th resource evaluation)
- Fix cheatsheet: add Alt+T to keyboard shortcuts table, add /fast and /debug commands
- Update Features Meconnues table with Agent Teams and Auto-Memories
- Clean up cheatsheet.md.bak
- Bump version to 3.26.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-11 16:12:36 +01:00
Florian BRUNIAUX
ef7cdd899e release: v3.24.0 - Agent Evaluation Framework 
Major addition: Complete agent evaluation framework with production-ready template.

## Added

- **Resource Evaluation**: nao framework (score 3/5)
  - Identified critical gap: agent evaluation not documented
  - Technical challenge adjusted score 2/5 → 3/5
  - All claims fact-checked (TypeScript 58.9%, Python 38.5%)

- **Guide Section**: Agent Evaluation (guide/agent-evaluation.md, ~3K tokens)
  - Metrics: response quality, tool usage, performance, satisfaction
  - Patterns: logging hooks, unit tests, A/B testing, feedback loops
  - Example: analytics agent with built-in metrics
  - Tools: nao framework reference, Claude Code hooks integration

- **AI Ecosystem**: Section 8.2 Domain-Specific Agent Frameworks
  - nao (Analytics Agents): Database-agnostic, built-in evaluation
  - Transposable patterns: context builder, evaluation hooks, DB integrations

- **Template**: Analytics Agent with Evaluation (5 files, ~1K lines)
  - README: setup, usage, troubleshooting
  - Agent: SQL generator with evaluation criteria, safety rules
  - Hook: automated metrics logging (safety, performance, errors)
  - Script: analysis with stats, safety reports, recommendations
  - Report template: monthly evaluation format

## Changed

- Agent Evaluation Guide: updated template references, verified links
- Landing Site: templates count 110 → 114
- Version: 3.23.5 → 3.24.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 11:52:13 +01:00
Florian BRUNIAUX
1fb783ebb8 release: v3.23.5 - Aristote claude-mem analysis prompt 
Added comprehensive 6-phase analysis framework for claude-mem integration
targeting the Aristote project (EdTech, Next.js/tRPC/Prisma).

Key features:
- Audit current memory stack (Serena, grepai, 9 hooks)
- Cost/ROI estimation ($3.75/month API, 50-100x ROI factor)
- Integration plan with hooks synergy (activity-logger, serena-sync)
- Go/No-Go decision criteria
- Self-contained prompt template in claudedocs/prompts/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 11:03:52 +01:00
Florian BRUNIAUX
191ff42741 release: v3.23.4 - Agent Anti-Patterns & Scope-Focused Refactoring 
Major conceptual refactoring based on Dex Horty's principle:
"Subagents are not for anthropomorphizing roles, they are for controlling context"

### Added (1 new section)
- Agent Anti-Patterns section (§9.17, line 3662)
  - Wrong vs Right table (anthropomorphizing vs context control)
  - When to use agents (context isolation, parallel processing, scope limitation)
  - When NOT to use agents (fake teams, roleplaying, mimicking org structure)

### Changed (18 files, 200+ lines)
- Section rename: "Split-Role Sub-Agents" → "Scope-Focused Agents"
- Agent definitions: "Specialized role" → "Context isolation tool"
- 8 custom agent examples refactored (guide + examples/agents/)
- 10+ prompt examples with explicit scope boundaries
- 4 workflow files updated (agent-teams, TDD, iterative refinement)
- Terminology replacements:
  * "Specialized agents" → "Scope-focused agents"
  * "Expert personas" → "Context boundaries"
  * "Multi-domain expertise" → "Multi-scope analysis"

### Fixed
- Methodologies: Clarification note for BMAD role-based naming

Breaking change: Conceptual shift from role-based to scope-based agent usage.
All examples now demonstrate context isolation instead of persona simulation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:29:59 +01:00
Florian BRUNIAUX
a68a1bd52b docs: add Agent Teams Quick Start Guide (v3.23.2) 
Added practical 8-10 min guide for using agent teams in real projects.

Added:
- guide/workflows/agent-teams-quick-start.md (580 lines)
  - 5-minute setup walkthrough
  - 4 copy-paste patterns (Guide + RTK projects)
  - Decision matrix (10+ scenarios)
  - Success metrics framework
  - Red flags section

Updated:
- guide/workflows/agent-teams.md: Link to quick start
- guide/ultimate-guide.md: Section 9.20 with quick start link
- machine-readable/reference.yaml: agent_teams_quick_start entry
- CHANGELOG.md: Release v3.23.2
- VERSION: 3.23.1 → 3.23.2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-08 11:47:40 +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
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
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
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
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
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
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
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
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
97c4c7e5ae release: v3.18.0 - Known Issues Tracker & RTK Integration 
MAJOR ADDITIONS:

1. Known Issues Tracker (guide/known-issues.md, 285 lines)
   - GitHub issue auto-creation bug (Issue #13797, v2.0.65+, ACTIVE)
   - Excessive token consumption (Issue #16856, v2.1.1+, Jan 2026)
   - Model quality degradation (Aug-Sep 2025, RESOLVED)
   - Verified: 17+ accidental public disclosures, 20+ token reports
   - Fact-checked: Perplexity Pro + GitHub API direct queries
   - Impact: Critical security awareness, actionable workarounds

2. RTK (Rust Token Killer) Integration
   - 72.6% average token reduction for git operations
   - Benchmarks: git log (92.3%), git status (76.0%), find (76.3%)
   - Templates: CLAUDE.md, skill, PreToolUse hook
   - Limitations documented: grep broken, ls worse, early-stage

FIXES:
- Corrected "mgrep" misattribution in Everything Claude Code evaluation

VERSION UPDATES:
- VERSION: 3.17.1 → 3.18.0
- Synced across README.md, cheatsheet.md, ultimate-guide.md, reference.yaml

FILES MODIFIED: 6 (CHANGELOG, VERSION, README, cheatsheet, guide, reference)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-28 18:20:05 +01:00
Florian BRUNIAUX
7957dda29c release: version 3.17.1 - README V3 with Repository Structure diagram 
### Added
- Repository Structure diagram (Mermaid + ASCII collapsible)
- 4 missing guides in Core Documentation table
- Quiz online link (landing site)

### Changed
- README V3: merged best of both versions (WHY/HOW positioning + complete sections)
- Ecosystem positioning: complementary instead of competitive
- Core Documentation: added AI Ecosystem, AI Traceability, Search Tools, Learning with AI

### Removed
- README-new.md (merged into README.md)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 18:30:18 +01:00
Florian BRUNIAUX
9055c31ee7 release: version 3.17.0 - Tasks API limitations documentation 
Version bump from 3.16.0 to 3.17.0 with Tasks API field visibility
limitations integration.

Changes:
- VERSION: 3.16.0 → 3.17.0
- CHANGELOG.md: Moved [Unreleased] to [3.17.0] - 2026-01-27
- README.md: Updated version footer, resource evaluations count (22)
- guide/cheatsheet.md: Updated version headers
- guide/ultimate-guide.md: Updated version
- machine-readable/reference.yaml: Updated version + date

Release highlights:
- 🚨 CRITICAL: Tasks API limitations documented (Gang Rui analysis)
  * TaskList field visibility constraints
  * 11x-51x cost overhead for N tasks
  * 3 workaround patterns provided
  * Prevents user frustration, maintains guide credibility

- 📊 Stats: 22 resource evaluations, 493 lines added
- 🎯 Impact: All Tasks API users (v2.1.16+) benefit from transparency

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:21:05 +01:00
Florian BRUNIAUX
87423c5546 release: version 3.16.0 - TeammateTool + Myths vs Reality 
- TeammateTool: Experimental multi-agent coordination docs
- Appendix D: Myths vs Reality (debunk misinformation)
- Cheatsheet: Features Méconnues section
- Resource evaluation: Rejected social media post (score 1/5)
- Version bump: 3.15.0 → 3.16.0
- Landing sync: 15,400+ lines (vs 14,900+)
 2026-01-27 10:15:39 +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
893c125fa7 release: version 3.14.0 - NotebookLM MCP integration 
Bump version from 3.13.0 to 3.14.0 with complete NotebookLM MCP documentation.

## Version Updates

- VERSION: 3.13.0 → 3.14.0
- Synced across: README.md, guide/cheatsheet.md, guide/ultimate-guide.md, machine-readable/reference.yaml

## CHANGELOG.md

- Added comprehensive v3.14.0 entry with NotebookLM MCP documentation details
- Moved previous [Unreleased] items to v3.14.0
- Updated templates count: 86 → 83 (accurate count)

## Documentation Changes

Already committed in ff3458a:
- guide/ai-ecosystem.md: +603 lines (§ 4.1-4.5)
- guide/ultimate-guide.md: +3 lines (MCP integration mention)
- Complete coverage of 16 MCP tools across 3 profiles

## Landing Site Sync

- Landing site updated: 3.13.0 → 3.14.0
- All checks passing (version, templates, quiz, guide lines)
- Verified with ./scripts/check-landing-sync.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 15:06:46 +01:00
Florian BRUNIAUX
6f6cd90bc1 release: version 3.13.0 - Boris Cherny mental models integration 
Major additions:
- CLAUDE.md as Compounding Memory philosophy (never correct Claude twice)
- Plan-First Discipline methodology (foundational pattern)
- Verification Loops architectural pattern (8 domains)
- Advanced Worktree Tooling section (3 independent tools validated)
- Anthropic governance resources (Constitution, Petri v2)
- Search tools mastery workflow (grep, grepai, ast-grep, Serena)

Updates:
- Boris Cherny case study enhanced with direct quotes
- Templates count: 83 → 86
- Reference YAML: new architecture diagram, search tools comparison

Resource evaluations:
- Boris Cowork video (3/5 - pertinent)
- Wooldridge productivity stack (3/5 - remote-first workflows)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 13:32:54 +01:00
Florian BRUNIAUX
96da6ebd7e feat: add bridge script for Claude Code → LM Studio execution (v3.12.1) 
Bridge script enables local execution of Claude Code plans via LM Studio:
- Python CLI with 5 components (DoobidooReader, LMStudioClient, Validator, StepExecutor, PlanExecutor)
- JSON Schema for plan validation (bridge-plan-schema.json)
- Cost optimization: Plan with Opus (~$0.50-2), execute free locally (80-90% savings)
- 4 validation types: json, syntax_check, contains_keys, non_empty
- CLI: --health, --list, --plan ID, -v verbose mode

Documentation:
- New section "Local Execution Bridge" in ultimate-guide.md §11.2
- scripts/README.md with full usage documentation
- machine-readable/reference.yaml entries for discoverability

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 18:43:05 +01:00
Florian BRUNIAUX
7330eacb2b chore: bump version to 3.12.0 
- Update VERSION file (3.11.7 → 3.12.0)
- Sync cheatsheet.md version references

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:31:15 +01:00
Florian BRUNIAUX
caf302107f docs: add ClawdBot vs Claude Code FAQ (v3.11.7) 
- Add Appendix B: FAQ section addressing ClawdBot confusion
- Comprehensive comparison table (9 dimensions)
- Early warning note in 'Before You Start' section
- New README section with quick explanation
- Update all version references to 3.11.7
- Index FAQ in reference.yaml

Context: Jan 2026 community buzz created confusion between
ClawdBot (chatbot for messaging apps) and Claude Code (CLI dev tool)

Total: +86 lines across 5 files

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 11:38:19 +01:00
Florian BRUNIAUX
ee5791668a docs: add SE-CoVe plugin example + resource evaluation workflow (v3.11.6) 
- First plugin example: SE-CoVe (Chain-of-Verification, Meta AI ACL 2024)
- Academic approach: cite paper metrics, not marketing claims
- Performance table: +23-112% accuracy (task-dependent, trade-offs disclosed)
- Resource evaluation template established (Perplexity fact-check workflow)
- Curation policy: Academic validation + Claims verified + Costs transparent
- Templates count: 82 → 83
- Architecture diagram added (visual overview of Claude Code internals)

Files:
- examples/plugins/se-cove.md (new plugin documentation)
- claudedocs/resource-evaluations/2026-01-24-se-cove-plugin.md (evaluation report)
- README.md, CHANGELOG.md, VERSION, reference.yaml (version bump 3.11.5 → 3.11.6)
- guide/architecture.md + image (visual overview)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 17:40:54 +01:00
Florian BRUNIAUX
89eefea8ac docs: add skills.sh marketplace documentation (v3.11.5) 
Added comprehensive documentation for skills.sh (Vercel Labs) marketplace:

Section 5.5 (Skills Marketplace):
- Installation instructions (npx add-skill <owner/repo>)
- Top skills by category (Frontend, Database, Auth, Testing)
- Format compatibility (100% compatible with .claude/skills/)
- Status & trade-offs (community project, early stage)

Section 11.3 (Skills Distribution Platforms):
- Comparison: skills.sh vs claude-code-templates vs SkillsMP
- When to use each platform (discovery, installation, team-specific)

Updated files:
- guide/ultimate-guide.md: New subsection Skills Marketplace (~line 5172)
- guide/ai-ecosystem.md: New section 11.3 Skills Distribution Platforms
- machine-readable/reference.yaml: Added 7 skills_marketplace_* entries
- README.md: Added skills.sh to Complementary Resources table
- CHANGELOG.md: Detailed entry for v3.11.5
- VERSION: Bumped to 3.11.5
- guide/cheatsheet.md: Version sync

Marketplace stats (Jan 23, 2026):
- 200+ skills available
- Top skill: vercel-react-best-practices (35K+ installs)
- 20+ agents supported (Claude Code, Cursor, Copilot, etc.)
- Launched: January 21, 2026 by Vercel Labs

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-23 18:21:15 +01:00
Florian BRUNIAUX
ba4b916742 docs: update Claude Code releases (v2.1.15-v2.1.17) 
- Add v2.1.17: Fix AVX crash
- Add v2.1.16: Task management system, VSCode plugins
- Add v2.1.15: npm deprecation, React Compiler perf
- Bump guide version to 3.11.4
- New milestone: v2.1.16 (task management)
- New breaking: npm installations deprecated

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 10:08:15 +01:00
Florian BRUNIAUX
0e5343f6b0 chore: bump version to 3.11.3 
- VERSION: 3.11.2 → 3.11.3
- CHANGELOG: Add 3.11.3 entry with verification loops, eval harness, ecosystem update
- Sync version across README, cheatsheet, ultimate-guide, reference.yaml

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 09:00:00 +01:00
Florian BRUNIAUX
ace62f2f84 docs: add MCP Tool Search documentation (v3.11.2) 
Add comprehensive documentation for MCP Tool Search (lazy loading):
- New section in guide/architecture.md with ASCII flow diagram
- Documents 85% token reduction and accuracy improvements
- Configuration guide for ENABLE_TOOL_SEARCH=auto:N syntax
- Simon Willison quote on context pollution resolution

Enriched release notes:
- v2.1.7: Added stats and Anthropic blog link
- v2.1.9: Added auto:N examples and cross-reference

Fixed template count: 83 → 82 (actual count)

Sources: Anthropic Engineering blog, Scott Spence, Perplexity verification

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 21:56:20 +01:00
Florian BRUNIAUX
5fbea061d5 docs: add Agent Vibes TTS integration documentation (v3.11.1) 
Added comprehensive documentation for text-to-speech integration via Agent Vibes MCP server.

New files (8):
- examples/integrations/agent-vibes/README.md - Quick start guide
- examples/integrations/agent-vibes/installation.md - 18-minute setup procedure
- examples/integrations/agent-vibes/voice-catalog.md - 15 voices (4 FR models, 128 speakers)
- examples/integrations/agent-vibes/troubleshooting.md - 7 common issues solved
- guide/workflows/tts-setup.md - Step-by-step workflow
- examples/hooks/bash/tts-selective.sh - Custom selective TTS hook
- examples/claude-md/tts-enabled.md - Project template

Documentation:
- guide/ai-ecosystem.md (section 5.1) - TTS tools overview
- guide/README.md - Added TTS workflow reference
- machine-readable/reference.yaml - 8 TTS entries

Version updates:
- VERSION: 3.11.0 → 3.11.1
- README.md: Template count 71 → 83
- CHANGELOG.md: Added v3.11.1 entry
- Synced version across all docs (cheatsheet, ultimate-guide, reference.yaml)

Other:
- .gitignore: Added audio file exclusions (*.wav, *.mp3, *.onnx)

Context: Tested Agent Vibes v3.0.0 + Piper TTS with French voices. Works offline, no cloud dependency.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 16:08:32 +01:00
Florian BRUNIAUX
bcc0b59dd8 chore: release v3.11.0 - Design Patterns Analyzer skill 2026-01-21 14:04:12 +01:00
Florian BRUNIAUX
936f8dd564 feat(guide): add Section 9.18 - Codebase Design for Agent Productivity 
Based on Agent Experience Best Practices by François Zaninotto (Marmelab).
Covers domain knowledge, code discoverability, testing for agents, guardrails.

- Add ~1809 lines to Section 9 (10 subsections)
- Enrich Section 3.1 with domain knowledge patterns
- Add Codebase Pitfalls to Section 9.11
- Bump version 3.9.11 → 3.10.0
- Guide grew from 11,560 to 13,425 lines (+16.1%)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:37:35 +01:00
Florian BRUNIAUX
868d3513b2 feat(guide): add Production Safety Rules (v3.9.11) 
Add comprehensive production safety guide for teams deploying Claude Code in production environments with 6 critical rules:

- Port Stability: Prevent accidental port changes breaking configs
- Database Safety: Backup enforcement via PreToolUse hooks
- Feature Completeness: No TODOs for core functionality
- Infrastructure Lock: Protect docker-compose, Dockerfile, terraform
- Dependency Safety: Block unapproved npm packages
- Pattern Following: Enforce codebase conventions

Adapted from community "10 non-negotiable CLAUDE.md rules" (6/10 integrated, 4/10 already covered). Verified gaps using grepai searches. Target audience: 20% production teams.

Cross-references added in ultimate-guide.md (section 3.1) and adoption-approaches.md (Medium/Large teams).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:23:50 +01:00