Commit graph

128 commits

Author SHA1 Message Date
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
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
001310bf67 docs: add Perplexity/Claude Code complementarity diagrams
- Add Mermaid diagram showing domain separation (research vs implementation)
- Add decision flow diagram for tool selection
- Key insight: Perplexity = "what to build", Claude Code = "how to build it"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 11:59:58 +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
dab11d260c feat: reorganize learning commands under /learn namespace
- Move quiz.md → learn/quiz.md (/learn:quiz)
- Add learn/teach.md (/learn:teach) for step-by-step concept explanations
- Add learn/alternatives.md (/learn:alternatives) for approach comparisons
- Update all references in guide, README, and reference.yaml

Follows Claude Code namespaced commands convention:
/namespace:command → .claude/commands/namespace/command.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 11:13:54 +01:00
Florian BRUNIAUX
e7e1de7ad5 docs: add Pattern Amplification callout to mental model section
Explains that Claude mirrors codebase patterns - good structure yields
good suggestions, messy code perpetuates mess. Bridges "What Claude
Doesn't Know" to "Communicating Effectively" with actionable guidance.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 11:03:33 +01:00
Florian BRUNIAUX
876f92fad5 docs: add behavior category to breaking_summary
ultrathink/think keywords now cosmetic only since v2.0.67
(thinking enabled by default with Opus 4.5)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 10:18:25 +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
b05ce81e66 docs: improve CLAUDE.md section structure & clarifications
- Restructure section 3.1: move MVP CLAUDE.md before Level 1/2/3 examples
- Replace unverified "90% of projects" claim with "most projects"
- Add Skills/Commands unification note to Section 6 (matching Section 5)
- Add cross-references between Memory Loading and Token Cost sections
- Clarify Monorepo CLAUDE.md merge/conflict resolution behavior
- Clarify Path-specific rules glob matching syntax

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 09:14:06 +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
77d6d8eeb6 docs: update Extended Thinking documentation (v2.0.67+ changes)
- Thinking mode now ON by default at max budget with Opus 4.5
- Keywords "think", "think hard", "ultrathink" are cosmetic only
- Control via Alt+T (session) or /config (permanent)
- Update Trinity pattern references
- Update quiz questions (09-001, 09-002, 04-014)
- Update cheatsheet thinking section
- Add note about cosmetic flags in modes README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 18:25:20 +01:00
Florian BRUNIAUX
d3f3db0d14 fix(sync): distinguish guide version from Claude Code version in check
The previous regex matched any 'vX.Y.Z' pattern, capturing 'Claude Code v2.1.12'
instead of the guide version. Now specifically looks for 'Version X.Y.Z' pattern.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 18:10:24 +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
6f968dbfc5 fix(sync): update landing sync script for new directory structure
- Change examples.html → examples/index.html
- Change quiz.html → quiz/index.html
- Add fresh-context-loop.sh script

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:42:03 +01:00
Florian BRUNIAUX
4a79455c4d docs(images): add wireframing tools & Figma MCP documentation
- Add Wireframing Tools section (Excalidraw, tldraw, Frame0, Paper+Photo)
- Add Figma MCP Integration with official setup and workflow
- Add Image Optimization for Claude Vision (resolution, tokens, formats)
- Create examples/mcp-configs/figma.json config template
- Update reference.yaml with new entries and shifted line numbers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:34:52 +01:00
Florian BRUNIAUX
d7c29f49c9 docs: prioritize grepai over mgrep as recommended semantic search
- Reorder sections in ultimate-guide.md (grepai first, mgrep second)
- Update cheatsheet.md MCP table (mgrep → grepai)
- Update quiz question 08-013 to reference grepai
- Sync versions to 3.8.2

Rationale: grepai is fully open-source, runs locally (privacy-first),
and offers call graph analysis that mgrep doesn't provide.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:29:33 +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
373b0c7ed1 docs(claude): sync version reference to 3.8.1
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:46:19 +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
36530c121c docs(changelog): document whitepaper template modernization
- New Slate + Indigo color palette (WCAG AA)
- Inter font + JetBrains Mono for code
- Cover redesign with Claude Code logo
- Fixed 42 nested markdown code blocks
- Added GitHub links for script references
2026-01-16 11:14:28 +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
792d46d4b8 docs(mcp): add grepai vs grep/rg benchmark comparison
- Add "Performance vs Traditional Tools" section with timing comparison
- Update decision tree with "Know exact pattern?" branch
- Update Server Comparison table with exact match recommendation
- Document key insight: grepai finds what pattern-based tools cannot

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