Commit graph

79 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
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
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
5fbea061d5 docs: add Agent Vibes TTS integration documentation (v3.11.1)
Added comprehensive documentation for text-to-speech integration via Agent Vibes MCP server.

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

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

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

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

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-22 16:08:32 +01:00
Florian BRUNIAUX
bcc0b59dd8 chore: release v3.11.0 - Design Patterns Analyzer skill 2026-01-21 14:04:12 +01:00
Florian BRUNIAUX
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
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
207a018da5 docs: update CHANGELOG for AI Coding Agents Matrix addition 2026-01-20 15:08:43 +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
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
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
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
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
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
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
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
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
Florian BRUNIAUX
1b5514e0e6 feat(onboarding): add adaptive pedagogy and multi-LLM compatibility
- Add communication tone preference (pedagogical/direct/coaching/adaptive)
- Extend style preference to all goals at 15min threshold
- Add "reset" option for mid-journey preference changes
- Add "skip" shows what's being skipped
- Add fallback roadmap when reference.yaml fetch fails
- Add multi-LLM compatibility footnote (works on ChatGPT, Gemini, etc.)
- Update reference.yaml with tone question and question_flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 14:28:28 +01:00
Florian BRUNIAUX
846e2e6a1b docs(mcp): add grepai semantic search and call graph documentation
- Add grepai section in ultimate-guide.md (Section 8.3)
  - Privacy-first semantic code search using Ollama embeddings
  - Call graph analysis: trace callers, callees, dependency graphs
  - Combined workflow with Serena for exploration + editing
  - Setup instructions and MCP tools reference
- Update decision tree and comparison table to include grepai
- Add grepai config to examples/config/mcp.json
- Document changes in CHANGELOG.md [Unreleased]

Source: https://github.com/yoanbernabeu/grepai

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:56:18 +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
71a08ca36a feat(scripts): session-search v2.1 - JSON encoding fix and clean previews
Bug fixes on top of v2.0:
- json_escape() function: proper backslash/quote escaping
- Preview cleanup: strip XML tags (<local-command-caveat>)
- Filter non-printable unicode characters

Quality score: 8/10 → 9.3/10

Tested with 239 sessions, all features validated.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:20:52 +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
7084c48cf8 docs(changelog): add version sync infrastructure entry
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:21:13 +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
Florian BRUNIAUX
89715680f6 docs: improve README.md navigation and structure alignment
- Repository Structure: add guide/workflows/, examples/modes/, config/, memory/
- Core Documentation: add methodologies.md, workflows/, data-privacy.md, observability.md
- Slash Commands: add generate-tests, review-pr, git-worktree, validate-changes
- Security Hooks: add 2 hooks + link to complete catalog
- Not Sure Where to Start?: add 5 navigation entries
- By Role Paths: enhance all 4 paths with new resources
- SEO Keywords: add 9 keywords for discoverability

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:07:45 +01:00
Florian BRUNIAUX
f7551037fe feat(docs): add development methodologies documentation v3.5.0
- Add guide/methodologies.md: index of 15 methodologies with decision tree
- Add guide/workflows/: 4 practical workflow guides
  - tdd-with-claude.md: TDD with Claude-specific patterns
  - spec-first.md: SDD adapted for CLAUDE.md
  - plan-driven.md: effective /plan mode usage
  - iterative-refinement.md: prompt→feedback→reprompt loops
- Add Section 9.14 in ultimate-guide.md linking to workflows
- Update guide/README.md with new documentation
- Bump version 3.4.0 → 3.5.0 across all files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 22:28:02 +01:00
Florian BRUNIAUX
f9044e2deb feat(docs): add architecture deep-dive documentation v3.4.0
Add comprehensive technical documentation explaining Claude Code internals:

- NEW: guide/architecture.md (~800 lines) - Complete architecture deep-dive
  - Master Loop (while tool_call), Tool Arsenal, Context Management
  - Sub-Agent Architecture, Permission System, MCP Integration
  - Edit Tool mechanics, Session persistence, Philosophy comparison
  - 5 ASCII diagrams, source confidence tiers (Tier 1/2/3)

- guide/ultimate-guide.md: Add Section 2.7 "Under the Hood" summary
- guide/cheatsheet.md: Add "Under the Hood (Quick Facts)" section
- machine-readable/reference.yaml: Add architecture index + deep_dive refs
- Update all navigation links across repository

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:29:46 +01:00
Florian BRUNIAUX
fb49152ee5 chore: consolidate IDEAS.md and bump version to 3.3.1
- IDEAS.md: Reduce from 12 to 4 actionable research topics
- Unified "MCP Security Hardening" (merged 3 overlapping topics)
- Expanded Discarded section (3 → 16 entries with justifications)
- Technical writer agent validation against reference.yaml
- Version bump: 3.3.0 → 3.3.1 across all docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:12:04 +01:00
Florian BRUNIAUX
8a4d116e2e feat(docs): add LLM Handbook + Google Whitepaper integration v3.3.0
Advanced Guardrails:
- prompt-injection-detector.sh (PreToolUse)
- output-validator.sh (PostToolUse heuristics)
- claudemd-scanner.sh (SessionStart injection detection)
- output-secrets-scanner.sh (PostToolUse secrets leak prevention)

Observability & Monitoring:
- session-logger.sh (JSONL activity logging)
- session-stats.sh (cost tracking & analysis)
- guide/observability.md (full documentation)

LLM-as-a-Judge Evaluation:
- output-evaluator.md agent (Haiku)
- /validate-changes command
- pre-commit-evaluator.sh (opt-in git hook)

Google Agent Whitepaper Integration:
- Context Triage Guide (Section 2.2.4)
- CLAUDE.md Injection Warning (Section 3.1.3)
- Agent Validation Checklist (Section 4.2.4)
- MCP Security: Tool Shadowing & Confused Deputy (Section 8.6)
- Session vs Memory patterns (Section 3.3.3)

Stats: 10 new files, 8 modified, 5 new guide sections

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:00:49 +01:00
Florian BRUNIAUX
19110eba22 feat(docs): add comprehensive data privacy documentation v3.2.0
- Create guide/data-privacy.md with retention policies (5y/30d/0)
- Add privacy notice to README.md
- Add section 2.6 "Data Flow & Privacy" to ultimate-guide.md
- Add Golden Rule #7 to cheatsheet.md (know what's sent)
- Add Phase 0.5 Privacy Awareness to onboarding-prompt.md
- Add privacy checks to audit-prompt.md
- Add PRIVACY CHECK section to audit-scan.sh (human + JSON)
- Add privacy reminder to check-claude.sh
- Create privacy-warning.sh SessionStart hook

Addresses user awareness of Anthropic data retention and opt-out options.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 20:42:19 +01:00