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

118 commits

Author SHA1 Message Date
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
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
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
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
8aa1b0401c docs: update README metrics for accuracy and landing sync 
- Guide length: ~10K → ~15K lines (actual: 15,053)
- Reading time: ~3h → ~4h
- Security hooks: 15+ → 18
- Templates: maintained at 86 (sync script logic)
- Added Resource Evaluations section (14 assessments)
- Verified sync with check-landing-sync.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:56:58 +01:00
Florian BRUNIAUX
ff3458a67c docs: add complete NotebookLM MCP integration documentation 
Added comprehensive documentation for NotebookLM MCP server integration
in Claude Code, covering all 16 tools across 3 profiles (minimal/standard/full).

## Changes

### guide/ai-ecosystem.md (~330 new lines)

**§ 4.1 - Enhanced installation section**:
- Detailed tool breakdown table (16 tools × 3 profiles)
- Profile comparison with recommended defaults
- Multi-account authentication workflow
- Share links library building pattern

**§ 4.2 - Advanced Features (Full Profile)** (~110 lines):
- remove_notebook: Library cleanup
- re_auth: Google account switching
- cleanup_data: Complete MCP reset with preserve_library option
- Manual browser control (3 functions): state inspection, actions, element waiting

**§ 4.3 - Browser Options** (~70 lines):
- Complete options reference (headless, timeout, viewport, stealth)
- Stealth mode configuration (typing speed, delays, mouse movements)
- Usage examples: debug visually, custom timeouts, disable stealth

**§ 4.4 - Session Management** (~60 lines):
- Session lifecycle and properties (15min timeout, 10 max concurrent)
- Automatic vs manual session control
- List/resume/force new session workflows

**§ 4.5 - Library Management Best Practices** (~90 lines):
- Naming conventions and topics strategy
- Metadata refinement workflow (add → use → refine → archive)
- Search and discovery patterns
- Notebook lifecycle management

### guide/ultimate-guide.md

- Updated Complementary Tools table: Added "MCP integration" mention
- Added redirect note to ai-ecosystem.md § 4.1

### README.md

- Template count updated (86 → 83) to reflect current state

## Coverage

- ✅ All 16 MCP tools documented
- ✅ 3 profiles explained (minimal/standard/full)
- ✅ Installation, auth, queries, advanced features
- ✅ Browser options, session management, best practices
- ✅ Troubleshooting and examples

## Testing

- Installation: Verified (standard profile)
- Authentication: Tested with multi-account setup (authuser=1)
- Library: 4 notebooks added and queried successfully
- Advanced features: Documented from API spec (not yet tested in practice)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:40:17 +01:00
Florian BRUNIAUX
be79f6c09a docs: update CHANGELOG and README for recent additions 
- Add resource-evaluations and task-management entries to CHANGELOG [Unreleased]
- Update README workflows description (TDD, Plan-Driven, Task Management)
- Add docs/resource-evaluations/ to repository structure diagram
- Clarify documentation organization for contributors

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:08:59 +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
6ed7e92e64 docs: add Anthropic governance resources 
- Add Claude's Constitution (CC0) to data-privacy guide
- Add Petri 2.0 research tool to README
- Update reference.yaml with external research section

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 09:31:19 +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
29f778daf7 docs: update template count badge (82 → 83) 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:30:40 +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
d2362401b1 docs: update plugin system with community marketplaces and official docs 
Section 8.5 Plugin System:
- CRITICAL FIX: Correct structure (.claude-plugin/plugin.json not root)
- Add .mcp.json, .lsp.json, hooks/hooks.json to directory structure
- Add skill namespacing documentation (/plugin-name:skill)
- Add warning about common mistake (components outside .claude-plugin/)
- Link to official Anthropic docs: code.claude.com/docs/en/plugins

Community Marketplaces subsection (line 7246):
- wshobson/agents: 67 plugins, 99 agents, 107 skills
- claude-plugins.dev: 11,989 plugins, 63,065 skills indexed
- Popular plugins: Context7 (~72k), Ralph Wiggum (~57k)
- awesome-claude-code: 20k+ stars curated list

Resource evaluation: Nick Jensen article rejected (outdated stats)
- Primary sources integrated instead of blog post

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-24 18:32:37 +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
76762b5ab3 docs: add Claudeception meta-skill documentation 
Add documentation for blader/Claudeception - a meta-skill that
auto-generates skills from Claude Code session discoveries.

Changes:
- guide/ultimate-guide.md: New section 5.5 "Automatic Skill Generation"
- machine-readable/reference.yaml: claudeception + claudeception_guide entries
- README.md: Add Skills category with Claudeception reference
- CHANGELOG.md: Document addition in Unreleased

Source: Community contribution via Laurent Dosdat

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 20:46:19 +01:00
Florian BRUNIAUX
3841b9bfb8 docs: integrate cc-copilot-bridge for multi-provider setup 
Cross-reference cc-copilot-bridge as complementary tool for:
- Cost optimization (99%+ savings via Copilot Pro+ flat rate)
- Rate limit bypass (unlimited access)
- Offline development (Ollama integration)

Added in:
• README.md - Dedicated section after "Not a Developer?"
• Section 9.13 - Alternative flat-rate subsection
• Section 10.4 - Rate limit solution in troubleshooting table
• Section 11.1 - "Where Other Tools Add Value" table
• Section 11.2 - Full setup guide with cost comparison

Links to: https://github.com/FlorianBruniaux/cc-copilot-bridge

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 19:24:54 +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
f6c98851e9 chore: sync version to 3.11.0 across all docs 
- README.md: pre-v3.10.0 → pre-v3.11.0
- guide/cheatsheet.md: version references updated
- guide/ultimate-guide.md: version references updated
- machine-readable/reference.yaml: version updated

Run via: ./scripts/sync-version.sh
 2026-01-22 09:41:52 +01:00
Florian BRUNIAUX
8c93c31b90 feat(guide): add Product Designer learning path and design-to-code workflow 
Add comprehensive resources for Product Designers working with Claude Code via Figma MCP:

- New workflow: guide/workflows/design-to-code.md (700 lines)
  - Documented metrics: 62% reduction in design inconsistencies, 78% workflow efficiency improvement
  - 4 core workflows: Frame→Component, Design System Audit, Token Automation, Visual Iteration
  - 3-tier token hierarchy (base/composite/semantic)
  - Team adoption patterns for designers, developers, PMs
  - Implementation roadmap (Foundation → Scaling → Orchestration)
  - Sources: builder.io, parallelhq.com, composio.dev, vladimirsiedykh.com

- New template: examples/claude-md/product-designer.md (400 lines)
  - Complete CLAUDE.md configuration for design-to-code projects
  - Figma MCP commands reference
  - Design handoff checklist
  - Token conventions and implementation constraints

- Updated README.md: Added "Product Designer" learning path (5 steps)
  - Positioned after DevOps/SRE, before main content
  - Links to image analysis, wireframing, Figma MCP, new workflow, cheatsheet

- Updated machine-readable/reference.yaml: Added 4 new entries
  - product_designer_workflow, product_designer_claudemd
  - design_system_handoff, figma_make_integration

Templates count: 72 → 73 (examples/claude-md/product-designer.md)
Guide workflows: 6 → 7 (guide/workflows/design-to-code.md)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 09:15:16 +01:00
Florian BRUNIAUX
01f35bf8b7 docs: sync templates count to 74 (includes config templates) 2026-01-21 14:23:01 +01:00
Florian BRUNIAUX
bcc0b59dd8 chore: release v3.11.0 - Design Patterns Analyzer skill 2026-01-21 14:04:12 +01:00
Florian BRUNIAUX
fcc6f2dba3 feat(skills): add design-patterns analyzer skill 
Comprehensive GoF design patterns analyzer with stack-aware suggestions.

**Features**:
- Detects 23 GoF patterns (Creational, Structural, Behavioral)
- Stack detection (React, Angular, NestJS, Vue, Express, RxJS, Redux, ORMs)
- Code smell detection with pattern suggestions
- Quality evaluation (5 criteria scoring)
- Prefers stack-native alternatives (e.g., React Context over Singleton)

**Structure**:
- 9 files: SKILL.md + reference docs + detection rules + evaluation checklists
- 3 operating modes: Detection, Suggestion, Evaluation
- Pattern-specific documentation for all 23 GoF patterns

**Documentation**:
- Added comprehensive example in guide section 5.4
- Updated examples/README.md with skill entry
- Updated template count: 65 → 66

**Use cases**:
- Analyze existing patterns in codebase
- Suggest refactoring with stack-native patterns
- Evaluate pattern implementation quality

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:46:20 +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
Florian BRUNIAUX
5b15f25eb2 docs(guide): add Section 9.17 - Multi-Instance Workflows 
- Add comprehensive multi-instance orchestration guide (391 lines)
- Document Boris Cherny case study (259 PRs/30 days)
- Include Anthropic study metrics (132 engineers, +50% productivity)
- Add decision matrix, cost analysis, implementation phases
- Update reference.yaml with 10 new entries
- Fix table of contents (add 9.12-9.17)
- Bump version to 3.9.10

Sources:
- InfoQ: Claude Code Creator Workflow (2026-01-09)
- Anthropic Research: How AI is Transforming Work (2025-08)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 10:45:03 +01:00
Florian BRUNIAUX
6703e4b6a4 docs: update CHANGELOG and fix template count (69→65) 
Changes:
- CHANGELOG.md: Document cross-reference addition and template count fix
- README.md: Correct template count from 69 to 65 (badge, summary, table)
- CLAUDE.md: Update version reference (3.9.7 → 3.9.9)

Template count verification:
- Actual count: 65 templates in examples/ (excluding README.md files)
- Previous count of 69 was overcounted by 4 templates since v3.9.9

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 10:02:38 +01:00
Florian BRUNIAUX
00df38d318 feat: add DevOps & SRE Guide with FIRE Framework (v3.9.9) 
New files:
- guide/devops-sre.md: FIRE Framework for infrastructure diagnosis (~870 lines)
- examples/agents/devops-sre.md: DevOps/SRE agent persona
- examples/claude-md/devops-sre.md: CLAUDE.md template for infra projects

Guide includes:
- Kubernetes troubleshooting prompts by symptom
- Solo incident response workflow (3 AM design)
- IaC patterns (Terraform, Ansible, GitOps)
- Claude limitations table (transparency)
- Team adoption checklist

Updated:
- README.md: Added DevOps/SRE learning path, templates count → 69
- ultimate-guide.md: Added reference after Section 5.4
- reference.yaml: Added 11 DevOps/SRE entries
- examples/README.md: Added to indexes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 22:09:31 +01:00
Florian BRUNIAUX
83a62ffb5d feat: integrate AI Coding Agents Matrix (v3.9.8) 
- Add Section 11 in guide/ai-ecosystem.md (~60 lines)
  - Interactive comparison of 23 AI coding agents
  - Complementarity table (Discovery vs Mastery)
  - Interactive features, limitations, positioning
- Enhance machine-readable/reference.yaml
  - Add maintainers (Cédric Teyton, Arthur Magne)
  - Add license (Apache-2.0), tech stack, features
  - Add positioning note and freshness warning
- Update README.md ecosystem section
  - Convert to comparison table (4 projects)
  - Add dedicated paragraph for Matrix
- Bump version 3.9.7 → 3.9.8
- Sync versions across all files

Cross-promotion with coding-agents-matrix.dev (Packmind)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 21:03:12 +01:00
Florian BRUNIAUX
dc0a3e1f27 docs: add cross-reference to Claude Cowork Guide 
- Add 'Not a Developer?' section after author info
- Link to Claude Cowork Guide for non-technical users
- Improves ecosystem discovery and audience routing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 15:24:20 +01:00
Florian BRUNIAUX
af6f56d618 docs: document complete 4-repo ecosystem architecture 
- Add ecosystem section to CLAUDE.md with architecture diagram
- Add landing sites table to README.md ecosystem section
- Add landing_sites section to reference.yaml with sync history
- Document bidirectional cross-links and sync triggers
- Include migration history and commit references

Ecosystem:
- Claude Code Guide (this repo) → devs
- Claude Cowork Guide (dedicated) → knowledge workers
- Code Landing (vitrine) → discovery
- Cowork Landing (vitrine) → discovery

Architecture: 2 source repos + 2 landing sites, synchronized

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 12:57:48 +01:00
Florian BRUNIAUX
9a29ba4e8d chore: remove cowork folder after migration to dedicated repo 
- Update all internal links to point to GitHub repo
- Remove cowork/ directory (35 files migrated)
- Add migration notice to guide/cowork.md summary
- Update machine-readable/reference.yaml with GitHub URLs
- Keep machine-readable/cowork-reference.yaml as index (not in cowork/)

Dedicated repo: https://github.com/FlorianBruniaux/claude-cowork-guide
Refs: 9a743cd (README update), 7a686a8 (cowork v1.0.0)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 12:16:32 +01:00
Florian BRUNIAUX
9a743cd5ae docs: update Cowork section to point to dedicated repository 
- Replace detailed documentation table with prominent link
- Add quick access table to new repo
- Keep local copy note for cloned users
- New repo: https://github.com/FlorianBruniaux/claude-cowork-guide
 2026-01-20 12:02:20 +01:00
Florian BRUNIAUX
c2de35caba docs: complete Cowork documentation v1.0 (Phase 2) 
- Create comprehensive Cowork docs (23 files in cowork/)
  - 6 guides: overview, getting started, capabilities, security, troubleshooting
  - 60+ ready-to-use prompts across 4 categories
  - 5 step-by-step workflows
  - Reference materials: cheatsheet, FAQ, comparison, glossary

- Integrate Perplexity research (P0/P1/P2)
  - Exact error messages with solutions (VPN, Chrome host, context limits)
  - Competitive analysis (vs Copilot/Gemini/ChatGPT/Apple Intelligence)
  - Enterprise validation (TELUS, Rakuten, Zapier stats)
  - OCR accuracy benchmarks (97% field, 63% line-item)
  - Token budget planning per task type

- Document critical limitations
  - VPN incompatibility (#1 community issue)
  - Context limit reality (165K vs 200K theoretical)
  - Platform constraints (macOS only)
  - Usage limits and pricing (Pro $20, Max $100-200)

- Update central files
  - README.md: detailed Cowork section with tables
  - VERSION: 3.9.6 → 3.9.7
  - machine-readable/reference.yaml: add cowork_reference entry
  - machine-readable/cowork-reference.yaml: new LLM-optimized index (~1.5K tokens)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:23:43 +01:00
Florian BRUNIAUX
09eb141976 docs: v3.9.6 - Trust Calibration, Vibe Coding Trap, reference.yaml sync 
Added:
- ultimate-guide.md: Trust Calibration section (1.7) with research-backed verification strategies
- ultimate-guide.md: Infrastructure as Code Skills (Anton Babenko's terraform-skill)
- learning-with-ai.md: "The Vibe Coding Trap" anti-pattern (Karpathy, Feb 2025)
- learning-with-ai.md: "Reality of AI Productivity" section with research
- learning-with-ai.md: External resource link to leerob.com/ai (AI fundamentals)
- IDEAS.md: "Vibe Coding Discourse" watching entry

Changed:
- reference.yaml: Complete line number synchronization (~55 entries)
  Guide grew from ~9900 to 11154 lines; all deep_dive references updated
- Version bump: 3.9.5 → 3.9.6

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 08:36:35 +01:00
Florian BRUNIAUX
a9d302326c docs: refactor README for better scannability (761 → 326 lines) 
- Remove "Lines: 11,100+" badge (intimidating)
- Merge TL;DR + Get Started into Quick Start section
- Condense "Why This Guide" to 7 lines (remove comparison table)
- Move Learning Paths before What's Inside (user identifies first)
- Restructure What's Inside with 6 collapsibles
- Simplify Golden Rules to 5 bullets (move Context % table to cheatsheet)
- Consolidate About section into 4 collapsibles
- Remove redundant sections: Choose Your Path, Guide Navigation, What Makes Different

Context % thresholds table moved to guide/cheatsheet.md#context-thresholds

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 19:11:56 +01:00
Florian BRUNIAUX
3968c13aa2 docs: sync README badges + fix template count methodology 
- Update Lines badge: 10,900+ → 11,100+ (Trust Calibration section added)
- Update Templates badge: 65 → 61 (exclude README/index files)
- Update Commands: 15 → 18 (add /learn:teach, /learn:quiz, /learn:alternatives)
- Fix check-landing-sync.sh: exclude README.md and index.md from template count
- Restructure README: move Privacy/Community to bottom, remove newsletter callout

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 17:41:56 +01:00
Florian BRUNIAUX
9c2ce7ccce docs: add IDEAS.md Watching section + README restructure (v3.9.5) 
- Add "Watching (Waiting for Demand)" section to IDEAS.md
  - Track Multi-LLM Consultation Patterns research
  - Criteria: implement if 3+ requests
- Restructure README.md (~40% cognitive load reduction)
  - Collapsible ToC with 4 learning paths
  - Remove duplicate "5 Rules" section
- Version bump to 3.9.5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 16:43:20 +01:00
Florian BRUNIAUX
3bc38ef982 docs: add Session Teleportation documentation (v3.9.4) 
- Add Section 9.16 Session Teleportation in ultimate-guide.md (~105 lines)
  - Evolution timeline (2.0.24 → 2.1.0)
  - Commands: %, &, --teleport, /teleport, /tasks, /remote-env, Ctrl+B
  - Prerequisites, limitations, environment support matrix
- Update cheatsheet.md with new commands and shortcuts
- Update reference.yaml with new entries and line numbers
- Add cowork.md (collaboration guidance)
- Bump version to 3.9.4

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 15:35:24 +01:00
Florian BRUNIAUX
dd833bcc07 docs: reference ai-ecosystem.md everywhere + add quiz questions 
- Add AI Ecosystem to README.md Core Documentation table
- Create quiz/questions/15-ai-ecosystem.yaml (10 questions)
- Update question count: 217 → 227

Topics covered: Perplexity, Gemini, Kimi, NotebookLM, v0.dev,
workflow orchestration, cost optimization

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 13:04:07 +01:00