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

159 commits

This branch
This branch
All branches
Author SHA1 Message Date
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
ca83f5a56d docs: add MCP Memory Stack complementarity patterns 
- Add 4-layer knowledge stack diagram (doobidoo → Serena → grepai → Context7)
- Document 5 combined workflows: feature understanding, onboarding, ADR, debug persistence, multi-IDE
- Add comparison matrix (cross-session, cross-IDE, cross-device, graphs, fuzzy search)
- Add usage patterns table with examples
- Document current limitations with workarounds
- Update reference.yaml with new entries

Experimental section - patterns need validation in production workflows.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 15:10:50 +01:00
Florian BRUNIAUX
09ac9d381d docs: add doobidoo/mcp-memory-service documentation (semantic memory) 
- Add comprehensive section in ultimate-guide.md (L.6385-6523)
- Document 3 backends: sqlite_vec, cloudflare, hybrid
- List 12 MCP tools with descriptions
- Add environment variables reference
- Include multi-client sync patterns (same machine vs multi-device)
- Add disclaimer: under testing, not yet validated in production
- Update reference.yaml with 8 new entries
- Add to cheatsheet.md and mcp.json template

Complements Serena (key-value) with semantic search capabilities.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 14:25:35 +01:00
Florian BRUNIAUX
8fe99ca515 docs: add Matteo Collina practitioner insight (bottleneck shift thesis) 
Add Node.js TSC Chair's perspective on human judgment in AI-assisted development:
- Full entry in ai-ecosystem.md Practitioner Insights section
- Reference in learning-with-ai.md Practitioner Perspectives
- YAML index entries in reference.yaml

Key concepts integrated:
- Bottleneck shift from coding to reviewing
- "The human in the loop isn't a limitation. It's the point."
- Cultural warning against "AI wrote it" as excuse
- Data: Review time +91%, 96% developers don't trust AI code

Context: Response to Arnaldi's "Death of Software Development" (Jan 2026)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 11:26:50 +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
377f5dbce1 docs: add OCTO Technology reference to learning-with-ai.md 
Added organizational perspective on AI-augmented development to
Practitioner Perspectives section. Key insights: pairs as minimal
team unit (bus factor), bottleneck shifts to functional requirements.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 10:00:35 +01:00
Florian BRUNIAUX
162bab94e0 docs: add Practitioner Insights section with Dave Van Veen reference 
- New section 11.2 Practitioner Insights (guide/ai-ecosystem.md:1209)
- Dave Van Veen (PhD Stanford, Principal AI Scientist @ HOPPR)
- Validates guide patterns: TDD, worktrees, manual commits, planning
- Academic credential: Co-author "Agentic Systems in Radiology" (ArXiv 2025)
- Clarification: "English is new programming language" = Karpathy/Reddy
- Updated reference.yaml with deep_dive + ecosystem entries
- Updated CHANGELOG.md

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 09:17:34 +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
0ec02b0fa5 docs: add subscription token limits & Goose comparison 
Enrichir la section subscription limits (ultimate-guide.md):
- Tableau des budgets tokens par plan (Pro 44K, Max 88-220K)
- Ratio Opus/Sonnet 8-10× documenté explicitement
- Clarification "heures" = temps de traitement, pas tokens
- Lien vers ccusage (outil communautaire de monitoring)
- Note historique sur réductions non annoncées (Oct 2025)

Nouvelle section Goose dans ai-ecosystem.md:
- Comparaison technique Claude Code vs Goose (7 critères)
- Stats GitHub (15K+ stars, 350+ contributors)
- Use cases et trade-offs honnêtes
- Hardware requirements selon LLM
- Quick start avec commandes d'installation

Sources: Perplexity research (Jan 2026), official Anthropic docs,
community reports (Reddit, GitHub issues, HN).

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 08:58:21 +01:00
Florian BRUNIAUX
73e371e237 docs: add everything-claude-code to ecosystem + verification loops pattern 
- Add affaan-m/everything-claude-code to ecosystem (16k+ stars)
  - Note: author hackathon win was for Zenith project, not this repo
  - Caveat: Node.js hooks not officially recommended by Anthropic
- Document "Verification Loops" pattern in methodologies.md
  - Official Anthropic guidance: iterate until tests pass
- Document "Eval Harness" concept with source link
  - Reference: anthropic.com/engineering/demystifying-evals-for-ai-agents
- Add deep_dive index entries for quick lookup

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-23 08:55:36 +01:00
Florian BRUNIAUX
2a63230c95 docs: add context packing tools section and Osmani workflow reference 
- New section "12. Context Packing Tools" in ai-ecosystem.md
  documenting gitingest, repo2txt usage patterns
- Added Addy Osmani "My AI Coding Workflow in 2026" to methodologies.md
  sources (validates spec-first, TDD, git checkpoints)
- Updated reference.yaml with ai_ecosystem_context_packing entry

Source: https://addyosmani.com/blog/ai-coding-workflow/

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 21:59:28 +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
89f81562b5 docs: document Serena indexation commands and options 
Add comprehensive documentation for Serena project indexation:

- guide/ultimate-guide.md: Complete setup section with all indexation options
  - Basic, force-full, incremental, parallel, verbose commands
  - Options table with use cases and performance notes
  - Cache location (.serena/cache/typescript/)
  - Deprecated command warning (index-project → project index)
  - Sources: Serena docs, GitHub issues, optimization guide

- guide/cheatsheet.md: Quick reference for 3 essential commands
  - Initial index, force rebuild, incremental update with parallel

- machine-readable/reference.yaml: Update line numbers and add entries
  - Fix mcp_servers line number (5821 → 5984)
  - Add serena_indexation: 6078 (detailed section)
  - Add serena_mcp: 6037 (section start)
  - Add serena_indexation and serena_cache to mcp section
  - Update all subsequent line numbers (+34 lines)

Resolves user request for forcing Serena codebase indexation documentation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 11:30:10 +01:00
Florian BRUNIAUX
be91799dcf feat: add cc-copilot-bridge reference in examples 
- Created multi-provider/ directory with redirect to dedicated repo
- Added cc-copilot-bridge in examples index table
- Added Multi-Provider Bridge section with link to github.com/FlorianBruniaux/cc-copilot-bridge

Related: github.com/FlorianBruniaux/cc-copilot-bridge v1.2.0

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 11:25:40 +01:00
Florian BRUNIAUX
222a2ed39c feat(guide): add Pencil (IDE-native canvas) to Product Designer workflow 
Add comprehensive documentation for Pencil, a new IDE-native design canvas tool launched January 2026.

Changes:
- guide/ultimate-guide.md (Wireframing Tools section):
  - Added Pencil to tools comparison table (after tldraw)
  - Added detailed description with features, founder info, disclaimer
  - Note: Launched Jan 2026, strong traction (1M+ views, a16z funded) but still maturing

- guide/workflows/design-to-code.md:
  - NEW section "Alternative: Pencil (IDE-Native Canvas)" (~115 lines)
  - Architecture explanation (WebGL + AI agents + Git-native)
  - Comparison table: Pencil vs Figma MCP
  - When to use (good fit / consider carefully)
  - Setup instructions + example prompt
  - Founder & backing details (Tom Krcha, ex-Adobe XD, a16z Speedrun)
  - Maturity note with recommendations

- machine-readable/reference.yaml:
  - Added 3 entries: pencil_canvas, pencil_workflow, pencil_vs_figma

Positioning:
- Pencil complements Figma MCP (not replaces)
- Target: Engineer-designers, code-centric teams on Cursor/VSCode/Claude Code
- Format: .pen JSON (open, git-versionnable)
- AI agents: Multiplayer parallel (unique feature)
- MCP: Bi-directional read+write (vs Figma read-only)

Status: Early but promising (score 3.5/5)
- Strong founder (Adobe XD co-creator, 2 exits)
- Solid funding (a16z + KAYA VC)
- Viral traction (1M+ views, FAANG signups)
- Currently FREE, pricing TBD

Disclaimers included for maturity/pricing uncertainty.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 10:16:20 +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
53d5d92c72 docs: update CHANGELOG and reference.yaml for design-patterns skill 
- CHANGELOG.md: Added detailed entry in [Unreleased] section
  - 9 files, 5,690 lines comprehensive GoF analyzer
  - 3 operating modes, 23 patterns, 8 stacks support
  - Template count 65 → 66
  - Tested on Méthode Aristote codebase results

- machine-readable/reference.yaml: Added design_patterns_skill entries
  - Line number reference (4799)
  - Location, modes, patterns count, supported stacks
  - Updated community_skills line numbers (4788→4947, 4871→5030)

Completes design-patterns skill documentation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:50:51 +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
16d484a50f feat: add maintenance slash commands for release management 
Commands added:
- /update-infos-release [bump-type]: Automate CC releases tracking + version bump
- /version: Display guide & CC versions with content stats
- /changelog [count]: View recent CHANGELOG entries
- /sync: Check guide/landing synchronization status

Workflow automation:
- Claude Code releases tracking (YAML + MD + Landing badge)
- Guide version management (VERSION + sync all docs)
- CHANGELOG updates
- Landing site sync verification
- Git commit/push to both repositories

Files:
- .claude/commands/update-infos-release.md: Full release workflow
- .claude/commands/version.md: Version info display
- .claude/commands/changelog.md: CHANGELOG viewer
- .claude/commands/sync.md: Sync check with actionable fixes
- .gitignore: Allow .claude/commands/ while ignoring other .claude/ config
- CLAUDE.md: Document new maintenance commands

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:41:24 +01:00
Florian BRUNIAUX
788493402f docs: update Claude Code releases to v2.1.14 
- Update latest tracked version: v2.1.12 → v2.1.14
- Add v2.1.14 highlights: history-based autocomplete, plugin search, SHA pinning
- Fix context window blocking limit and memory leak fixes
- Update dates: 2026-01-21

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:35:34 +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
95eca423a2 feat(cheatsheet): add printable PDF version (2-column layout) 
- 2-column A4 layout optimized for print
- Light theme with indigo accent (print-safe colors)
- Visual components matching web design:
  * Context bar (4 zones: green/yellow/orange/red)
  * Do-dont grid comparison boxes
  * Golden rules with numbered badges
- Anti-orphan corrections (titles stick with content)
- Generated from Quarto/Typst template in whitepapers/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:05:34 +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
207a018da5 docs: update CHANGELOG for AI Coding Agents Matrix addition 2026-01-20 15:08:43 +01:00
Florian BRUNIAUX
eee6a5a20a docs: add AI Coding Agents Matrix reference to ecosystem section 
Add link to coding-agents-matrix.dev in ai-ecosystem.md and reference.yaml.

This external resource provides a technical comparison of Claude Code vs 22+
alternatives across MCP support, Skills, Commands, Subagents, and Plan Mode.

Minimal integration (1-line note) to acknowledge the ecosystem without
diluting our focus on Claude Code mastery.
 2026-01-20 15:00:39 +01:00
Florian BRUNIAUX
ffe8d782fd fix: sync CLAUDE.md version reference with VERSION file 
- Update version reference from 3.8.2 to 3.9.7 in CLAUDE.md
- Aligns with VERSION file which was already at 3.9.7
- Removes accidental marketing document from version control

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 14:01:53 +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
43252306e4 docs: v3.9.7 - OpusPlan workflow documentation 
- CHANGELOG: Add 3.9.7 entry for CLAUDE.md Model Configuration
- Sync version numbers across cheatsheet and ultimate-guide
- OpusPlan hybrid workflow (Opus plan → Sonnet execute)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:56:12 +01:00
Florian BRUNIAUX
84112237e8 docs(claude): add model configuration recommendations 
- Add recommended /model opusplan configuration
- Document hybrid planning workflow (Opus plan + Sonnet execute)
- Include task breakdown table with model justifications
- Add cost optimization rationale

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:52:21 +01:00
Florian BRUNIAUX
014b4ad0b3 docs(cowork): prepare for standalone repository (Option C) 
Phase 2: Improvements + migration preparation completed

## README.md Enhanced
- Add badges (Stars, Prompts 60+, Workflows 5, Version 1.0.0)
- Add 3 Learning Paths (Knowledge Worker, PM/Executive, Power User)
- Add 7 Golden Rules (Cowork-specific safety practices)
- Add 6 collapsible sections (reduce visual density)
- Add About section (Origins, Privacy, Limitations, Future Roadmap)
- Harmonize footer (version + date + attribution)

## Independence Files Created
- VERSION: 1.0.0 source of truth
- CHANGELOG.md: Complete v1.0.0 history
- CONTRIBUTING.md: Contribution guidelines for Cowork

## Interactive Onboarding
- tools/cowork-onboarding.md: Personalized learning experience
- Command: Fetch and follow from GitHub raw URL
- Features: 3-question profiling, loads cowork-reference.yaml
- 5 goals: organize_files, create_documents, extract_data, research, learn_everything
- Depth control: deeper/next/skip/reset
- Multilingual: EN/FR/ES support

## Maintenance Scripts (3 executable)
- scripts/check-version-sync.sh: Verify VERSION synchronized
- scripts/sync-version.sh: Auto-sync VERSION across files
- scripts/update-stats.sh: Update prompts/workflows counts

## GitHub Templates Structure
- .github/ISSUE_TEMPLATE/bug_report.md
- .github/ISSUE_TEMPLATE/feature_request.md
- .github/ISSUE_TEMPLATE/workflow_contribution.md
- .github/ISSUE_TEMPLATE/config.yml
- .github/PULL_REQUEST_TEMPLATE.md
- .github/README.md: Contributor guide

## Updated MANIFEST.yaml
- Add root, tools, scripts, github sections
- Update metadata: total_files: 34, total_prompts: 67, total_workflows: 5
- License: CC-BY-SA-4.0
- Last updated: 2026-01-20

## Statistics
- Total files: 34 markdown + 3 scripts + YAML files
- Total documentation: ~15K lines
- 67 prompts, 5 workflows, 6 guides
- Version: 1.0.0

Ready for:
- Immediate use in current repo
- Future migration to claude-cowork-guide repository
- Community contributions (GitHub templates)
- Autonomous maintenance (scripts)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:46:56 +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
360e5203f6 feat: add Voice-to-Text section and voice-refine skill 
- Add section 5 "Voice-to-Text Tools" to ai-ecosystem.md
  - Tool comparison (Wispr Flow, Superwhisper, MacWhisper)
  - Vibe Coding workflow and trade-offs
  - Recommendations by user profile
- Create voice-refine skill in examples/skills/
  - Transforms verbose voice input into structured prompts
  - 4-step pipeline: Dedupe → Extract → Structure → Compress
  - Before/after examples with ~3.3x compression ratio
- Update reference.yaml with new entries and corrected line numbers
  - ai_ecosystem_voice_to_text: line 449
  - voice_refine_skill: new skill reference
  - cowork_section: 701 → 760
  - alternative_providers: 902 → 959

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 10:11:03 +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
fd17414abb docs: add AI productivity research, trust calibration, and exploration workflow 
## New Content

### Trust & Verification (ultimate-guide.md)
- Section 1.7 "Trust Calibration: When and How Much to Verify" (~155 lines)
  - Research-backed stats (ACM, Veracode, CodeRabbit, Cortex.io)
  - Verification spectrum by code type
  - Solo vs Team strategies with workflow diagrams
  - "Prove It Works" checklist
- New pitfall: "Trust AI output without proportional verification"
- CLAUDE.md size guideline: 4-8KB optimal, >16K degrades coherence

### AI Productivity (learning-with-ai.md)
- Section "The Reality of AI Productivity" (~55 lines)
  - Productivity curve phases (Wow Effect → Targeted Gains → Plateau)
  - High-gain vs low/negative-gain task categorization
  - Team success factors
- Productivity trajectory table by pattern (Dependent/Avoidant/Augmented)
- 5 new sources (GitHub, McKinsey, Stack Overflow, Uplevel, DORA)

### Session Limits (architecture.md)
- "Session Degradation Limits" section
  - Turn limits (15-25), token thresholds (80-100K)
  - Success rates by scope (1-3 files: ~85%, 8+ files: ~40%)

### Exploration Workflow
- NEW: guide/workflows/exploration-workflow.md
  - Anti-anchoring prompts, 3-5 approaches pattern
- iterative-refinement.md: Script Generation Workflow (3-7 iteration pattern)
- anchor-catalog.md: Anti-Anchoring Techniques, Exploration/Iteration Prompts

### Reference Updates
- adoption-approaches.md: Empirical data section
- reference.yaml: New deep_dive entries, updated line numbers

Sources: MetalBear engineering blog, arXiv studies, Addy Osmani (Jan 2026)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 19:16:33 +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
db322b8370 chore: ignore .mcp.json (local MCP config) 2026-01-19 16:44:46 +01:00