Commit graph

97 commits

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
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
Florian BRUNIAUX
e822452000 feat(guide): add AI Ecosystem section for complementary tools (v3.9.1)
New Section 11 documenting tool complementarity with Claude Code:
- guide/ai-ecosystem.md (752 lines): detailed guide covering Perplexity,
  Gemini, Kimi, NotebookLM, IDE tools, and UI prototypers
- Section 11 in ultimate-guide.md (~250 lines): condensed version with
  practical workflows and integration patterns
- 4 workflow pipelines: Research→Code, Visual→Code, Documentation, Presentation
- Ready-to-use prompts and cost optimization strategies

Also includes: mobile-access.md enhancements from [Unreleased]

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 11:25:36 +01:00
Florian BRUNIAUX
43d2aeae22 fix: correct templates count 62→63 and lines badge 10,300→10,500
- README.md: badges updated to reflect actual counts
- CHANGELOG.md: v3.9.0 stats corrected
- anchor-catalog.md was the 63rd template (already documented in CHANGELOG)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 09:22:29 +01:00
Florian BRUNIAUX
7a6d369512 docs: add subscription plans section & semantic anchors
- Add "Subscription Plans & Limits" section (line 1750)
  - Concepts: message windows, hybrid counting, weekly caps
  - Tier-specific strategies (no volatile numbers)
  - Links to official pricing page
- Add Semantic Anchors section (2.7) with anchor catalog
- Fix drifted line numbers in reference.yaml
- Add 6 new slash commands (catchup, security, refactor, etc.)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 09:06:39 +01:00
Florian BRUNIAUX
a5f441bcea feat: add ecosystem positioning, install script & new commands
Ecosystem & Positioning:
- Add README section with competitive positioning (davila7, awesome-claude-code, wesammustafa)
- Add comparison table highlighting unique features (architecture, TDD/SDD, quiz, YAML index)
- Add ecosystem section to reference.yaml

Template Installation:
- Add scripts/install-templates.sh for one-liner template installation
- Support for agents, hooks, commands, skills, memory templates

New Commands:
- catchup, explain, optimize, refactor, security, ship

New Content:
- Semantic anchors catalog and documentation
- Extended guide content (+470 lines)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 08:42:33 +01:00
Florian BRUNIAUX
0348f08288 feat: add Claude Code releases tracking
Add condensed release history for Claude Code product (v2.0.24 → v2.1.12)

New files:
- machine-readable/claude-code-releases.yaml: Source of truth (YAML)
- guide/claude-code-releases.md: Human-readable changelog
- scripts/update-cc-releases.sh: Check for new releases from GitHub

Modified:
- reference.yaml: Add deep_dive entries for releases
- check-landing-sync.sh: Add CC version check (#5)
- README.md, guide/README.md: Add navigation links
- CLAUDE.md: Document update workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 11:33:21 +01:00
Florian BRUNIAUX
741acd0fa3 feat(quiz): add 58 new questions (159→217) in 4 new categories
New categories:
- 11-learning-with-ai.yaml (15 questions): UVAL protocol, 70/30 rule, dependency patterns
- 12-architecture.yaml (12 questions): master loop, 8 tools, context budget, sub-agents
- 13-security.yaml (10 questions): MCP Rug Pull, CVEs, defense-in-depth
- 14-privacy-observability.yaml (10 questions): retention tiers, session search

Additions to existing:
- 08-mcp-servers.yaml: +3 Figma MCP questions (token efficiency, tools, setup)
- 09-advanced-patterns.yaml: +5 methodology questions (SDD, BDD, TDD)
- 01-quick-start.yaml: +3 image optimization questions

README updated: 217 questions, 56 templates, 14 categories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 22:48:57 +01:00
Florian BRUNIAUX
7fd4048d5e feat: add learning guide & website badge
- Add "Visit Website" badge to README.md (prominent, top position)
- Add learning-with-ai.md guide for junior developers (~900 lines)
  - UVAL Protocol, dependency patterns, 30-day progression plan
- Add 3 learning templates (55 total):
  - examples/claude-md/learning-mode.md
  - examples/commands/quiz.md
  - examples/hooks/bash/learning-capture.sh
- Fix template count: 52 → 55 (was incorrectly showing 56)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 18:42:34 +01:00
Florian BRUNIAUX
b814c568d1 fix: correct template count to 53 (validated by sync script)
- Update sync script to include .json files in count
- Fix README.md and CLAUDE.md with accurate count

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:56:24 +01:00
Florian BRUNIAUX
fb9689fed3 docs: sync stats (57 templates, 9800+ lines)
- Update CLAUDE.md with current values
- Update README.md badges and line counts
- Add Fresh Context Pattern reference in methodologies.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:50:22 +01:00
Florian BRUNIAUX
15475197ab feat(sync): add landing site synchronization system
- Add scripts/check-landing-sync.sh verifying 4 metrics:
  - Version (VERSION vs landing index.html)
  - Templates count (find examples/ vs landing badges)
  - Quiz questions (questions.json vs index.html + quiz.html)
  - Guide lines (with ±500 tolerance)
- Update CLAUDE.md with sync documentation and expected output
- Fix templates count: 87 → 49 in README.md badges and text

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 12:21:09 +01:00
Florian BRUNIAUX
bc9b3fda3a chore(version): bump to 3.8.1
- Add PDF generation documentation to CHANGELOG
- Sync version across all docs (README, cheatsheet, ultimate-guide, reference.yaml)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:34:12 +01:00
Florian BRUNIAUX
174192f583 feat(seo): add CITATION.cff and improve AI discoverability
- Add CITATION.cff for academic citations and GitHub citation button
- Add "For AI Assistants" section in README with llms.txt reference
- Update machine-readable/llms.txt stats (4700+ → 9600+ lines)
- Bump version display to 3.8.0 in README footer

Improves discoverability in GitHub search, Google Scholar, and AI assistants

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:21:58 +01:00
Florian BRUNIAUX
4640e4e3e0 feat(visibility): add TTFV optimization, CONTRIBUTING rewrite, and distribution playbooks
Phase 0 - Foundation work for visibility campaign:

- Add TL;DR Quick Start section in README with CLAUDE.md template
- Rewrite CONTRIBUTING.md with welcome message, contribution types, PR process
- Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- Document French whitepapers series (8 docs, ~185 pages) in README
- Add distribution playbooks in claudedocs/ (gitignored)
- Add prominent badges (version, license, Claude Code support)

TTFV (Time-to-First-Value) optimized from ~10min to < 5min.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 09:27:28 +01:00
Florian BRUNIAUX
3f246644a7 docs(readme): add prominent badges and rewrite Why This Guide section
- Add for-the-badge style badges (Stars, Lines 9600+, Templates 87, Quiz 159)
- Rewrite "Why This Guide" with problem-focused hook (awesome-lists, docs, tutorials pain points)
- Fix line count from 9500 to 9600
- Reorganize badge layout with centered alignment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:59:17 +01:00
Florian BRUNIAUX
395308de5e docs(readme): add Dev With AI community reference
- French-speaking community for developers (~1500 on Slack)
- Meetups in Paris, Bordeaux, Lyon
- Placed near top of README for visibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 19:38:42 +01:00
Florian BRUNIAUX
8fc9fb5568 docs(data-privacy): add Intellectual Property Considerations section
- Add new section 8 with IP disclaimer and key considerations table
- Cover: ownership, license contamination, vendor indemnification, sector compliance
- Bump version to 3.7.1
- Update .gitignore to exclude .grepai/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:41:03 +01:00
Florian BRUNIAUX
30cbe57d1e docs(readme): add onboarding screenshots preview
- Add 4 screenshots showing interactive onboarding flow
- Collapsible gallery (2x2 grid) under one-liner command
- Images in assets/screenshots/ with descriptive names

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:34:31 +01:00
Florian BRUNIAUX
46c5862c4e fix(docs): critical factual corrections v3.6.1
Major audit correcting misleading documentation about Claude Code behavior:

### Fixed
- `--add-dir`: permissions (not context loading)
- `excludePatterns` → `permissions.deny` (never existed)
- `.claudeignore` removed (not an official feature)
- "selective loading" myth → lazy loading reality
- Invented CLI flags (`--think`, `--headless`, `--learn`) → prompt keywords
- `@` file reference: "loads automatically" → "reads on-demand"

### Added
- Session Search Tool (`cs`) - zero-dep bash script for finding sessions
- Security section: Known limitations of permissions.deny

15 files modified, 516 insertions, 200 deletions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:16:53 +01:00
Florian BRUNIAUX
81a5caa5db feat(docs): add security-hardening navigation + onboarding matrix
README.md:
- Added security-hardening.md to Core Documentation table
- Added to "Not Sure Where to Start?" section
- Added to Power User learning path

machine-readable/reference.yaml:
- Added onboarding_matrix for personalized learning paths
- Added onboarding_questions structure for interactive profiling

tools/onboarding-prompt.md:
- Restructured for goal-based profiling (2 questions → tailored content)
- Simplified from assessment-heavy to action-oriented flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:20:50 +01:00
Florian BRUNIAUX
34b2ca7200 feat(security): add security hardening guide and hooks v3.6.0
- Add guide/security-hardening.md (~10K) covering:
  - MCP vetting workflow with CVE-2025-53109/53110, 54135, 54136
  - Prompt injection evasion techniques (Unicode, ANSI, null bytes)
  - Secret detection tool comparison (Gitleaks, TruffleHog, GitGuardian)
  - Incident response procedures

- Add 3 new security hooks:
  - unicode-injection-scanner.sh: zero-width, RTL, ANSI escape detection
  - repo-integrity-scanner.sh: scan README/package.json for injection
  - mcp-config-integrity.sh: verify MCP config hash

- Update existing hooks:
  - prompt-injection-detector.sh: +ANSI, +null bytes, +nested cmd
  - output-secrets-scanner.sh: +env leakage, +generic tokens

- Update cross-references in ultimate-guide.md (§7.4, §8.6)
- Move MCP Security Hardening to Done in IDEAS.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:39:53 +01:00
Florian BRUNIAUX
55a9fa34cf docs: add missing security-hardening.md to navigation
- README.md: add to Core Documentation, Not Sure Where to Start?, Power User path
- guide/README.md: add to Contents table
- CHANGELOG.md: update Unreleased section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:18:56 +01:00