Commit graph

363 commits

Author SHA1 Message Date
Florian BRUNIAUX
4a0a0bf30e docs: complete factual audit pass 2 — 90+ corrections
Second 10-agent parallel audit covering all remaining sections:
ultimate-guide.md (ch1-ch11), workflows/ (17 files), quiz/ (12 files),
examples/agents+skills+commands. Source of truth: official Anthropic docs.

Key corrections:

Hook system (+8 missing events):
- Complete 17-event list: PermissionRequest, PostToolUseFailure, SubagentStart,
  TeammateIdle, TaskCompleted, WorktreeCreate, WorktreeRemove, SessionEnd
- SessionStart confirmed valid (previous audit wrongly doubted it)
- Hook output format: hookSpecificOutput.permissionDecision (not {"decision":"block"})
- Missing common input fields added: transcript_path, cwd, permission_mode

Agent YAML frontmatter (13 valid fields restored/added):
- Restored: disallowedTools, memory, background, isolation, skills, permissionMode, hooks
- Added new: maxTurns, mcpServers
- Fixed: tools format is comma-separated (not space-separated)

Plan Mode (12 occurrences fixed):
- Ctrl+G = "open plan in text editor" (NOT "enter plan mode")
- Plan Mode = Shift+Tab × 2 (Normal → acceptEdits → plan)

Commands table (10.1) + built-in commands (6.1):
- Added 18+ missing commands: /copy, /doctor, /hooks, /memory, /model,
  /config, /permissions, /remote-control, /rename, /resume, /sandbox, etc.

Workflow files:
- agent-teams.md: removed fake --experimental-agent-teams flag
- hooks.yaml + post_edit event → settings.json + PostToolUse (2 files)
- TodoWrite → TaskCreate/TaskUpdate (3 files)
- task-management.md: removed fake "failed" task status

Quiz / examples:
- 01-010: Esc stops mid-action (not Ctrl+C)
- refactoring-specialist.md: removed MultiEdit (not a valid tool)
- ast-grep-patterns.md: name field (not title)
- validate-changes.md, diagnose.md: field name fixes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-26 18:21:28 +01:00
Florian BRUNIAUX
8cb9f9efa6 docs: update Claude Code releases to v2.1.59
- v2.1.59: auto-memory (/memory), /copy command picker, smarter compound bash prefixes, MCP OAuth race condition fix, config corruption fix
- v2.1.58: Remote Control expanded to more users

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-26 12:10:25 +01:00
Florian BRUNIAUX
8e63d84b47 docs: factual audit + reference sync — 260 findings corrected
Parallel 6-agent audit against official Anthropic docs (llms-full.txt).
Key corrections applied across permissions, hooks, MCP, security, privacy, reference.yaml.

Highlights:
- Fix MCP config path (~/.claude.json), mcpServers key, variable substitution syntax
- Fix permission modes (5 not 3), :* syntax (×6), Stop event description
- Fix hook JSON field names (hook_event_name, tool_name, tool_input, session_id)
- Fix filesystem restriction docs (permission rules, not settings.json keys)
- Fix data-privacy: 4-tier retention, /bug 5yr warning, ZDR conditions, 5 telemetry opt-out vars
- Add official llms.txt/llms-full.txt references to CLAUDE.md + machine-readable/llms.txt
- Reference.yaml: 375 entries re-synced (92% had wrong line numbers — guide grew 15K→21K lines)
- New script: scripts/resync-reference-yaml.py for automated line number sync
- Quiz: corrected answers for hooks (07), memory settings (03), MCP servers (08)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-26 12:10:14 +01:00
Florian BRUNIAUX
ad735dfff4 docs(security): update threat-db v2.3.0 — CVE-2025-59536, CVE-2026-21852, +2 CVEs, T011
New CVEs (4):
- CVE-2025-59536: Claude Code RCE via enableAllProjectMcpServers config (fixed 1.0.111)
- CVE-2026-21852: Claude Code API key theft via ANTHROPIC_BASE_URL redirect (fixed 2.0.65)
- CVE-2026-26029: sf-mcp-server command injection via child_process.exec
- CVE-2026-27203: eBay API MCP Server env variable injection

New attack technique:
- T011: Project Configuration Hijacking (.claude/settings.json / .mcp.json as attack surface)

New defensive resources:
- GuardFive AI Agent Security Scanner
- Palo Alto AI Runtime Security MCP Threat Detection

New sources (7): Check Point Research, The Hacker News, Trend Micro, 1Password, Red Hat, NVD x2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 18:59:03 +01:00
Florian BRUNIAUX
9dc51b7033 docs: integrate Boris Cherny / Lenny's Newsletter insights (4/5)
3 contenus inédits issus de l'interview Boris Cherny (Head of Claude Code)
sur Lenny's Newsletter (19 fev 2026), vérifiés Perplexity :

- Ratio "80% Plan Mode" (empirique, inventeur du produit) → §2.3
- "Build for the Model 6 Months Out" (principe stratégique) → §3.2 CLAUDE.md
- 3 principes d'équipe : underfund / unlimited tokens / go faster → §3.5

+ Fichier d'évaluation (4/5, challenge technical-writer, fact-check)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 18:53:30 +01:00
Florian BRUNIAUX
5e893f3ccd docs: add Remote Control (§9.22) — mobile access feature documentation
- New section 9.22 in ultimate-guide.md with full Remote Control coverage
- Cheatsheet: dedicated section + Features Méconnues + slash commands
- security-hardening.md: Part 7 Remote Control Security threat model
- machine-readable/reference.yaml: /rc, /remote-control, /mobile, subcommand
- Resource evaluation: 2026-02-25 (score 4/5, community feedback included)

Key original content vs official Anthropic docs:
- Slash commands (/new, /compact) broken in remote UI — undocumented
- tmux multi-session workaround for 1-session limit
- Community security analysis (RCE surface, CISO implications)

Research Preview — Pro/Max plans only (v2.1.51+)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 18:45:41 +01:00
Florian BRUNIAUX
97f9167a61 docs: add Kairn memory MCP + resource evaluations + guide updates
- guide/ultimate-guide.md §10.2: Add Kairn (knowledge graph memory with biological decay)
  - Typed relationships (depends-on, resolves, causes), 18 MCP tools
  - Updated comparison table: Serena / grepai / doobidoo / Kairn
  - Added decision routing for long-term memory + causality tracking
- guide/ultimate-guide.md §5.1: Add real-world CLAUDE.md migration example (Avo, 600-line → 15 path-scoped files)
- guide/ai-ecosystem.md: Minor update
- machine-readable/reference.yaml: Add Kairn entries
- examples/config/mcp.json: Add Kairn MCP config
- docs/resource-evaluations/: Add 2 new evaluations (context-evaluator-packmind, kairn-memory-mcp)
- docs/resource-evaluations/agents-md-empirical-study: Add community reception section
- docs/resource-evaluations/2026-02-23-agentsview: Minor fix

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 17:39:20 +01:00
Florian BRUNIAUX
a6b0a0084a docs: update Claude Code releases to v2.1.56
- Updated tracking: v2.1.52 → v2.1.56
- v2.1.56: VSCode extension crash fix (Windows)
- v2.1.55: BashTool EINVAL fix on Windows
- v2.1.53: Stability release (Windows panics, WebAssembly crashes Linux/Windows, Remote Control shutdown fix)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 11:49:34 +01:00
Florian BRUNIAUX
79157ac077 release: v3.29.0
- Observability: MLflow Tracing section complète (CLI + SDK, LLM-as-judge)
- Skills §5.5: UI UX Pro Max (33.7k stars, design reasoning engine BM25)
- Diagram #41: AI Fluency High vs Low paths (Anthropic research)
- 3 callouts empiriques AI Fluency Index (Rev Engine 5.6×, CLAUDE.md 30%)
- Hooks docs v2.1.47-2.1.50: WorktreeCreate/Remove, ConfigChange, --from-pr
- CC releases tracking: v2.1.50 → v2.1.52
- 4 nouvelles évaluations ressources (AgentsView, AI Fluency, UX Pro Max)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-24 13:58:09 +01:00
Florian BRUNIAUX
939e33ab68 docs: update Claude Code releases to v2.1.52
- v2.1.51: claude remote-control subcommand, BashTool login shell perf,
  SDK account env vars (CLAUDE_CODE_ACCOUNT_UUID etc.),
  /model human-readable labels, custom npm registries for plugins
- v2.1.52: VSCode crash fix on Windows (openLast command)
- Updated latest: 2.1.50 → 2.1.52

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-24 13:55:06 +01:00
Florian BRUNIAUX
c05e4fa4fd docs: update stats to reflect actual counts (20K lines, 274 quiz, 175 templates)
- Guide lines: 19K → 20K+ (actual: 20,548)
- Quiz questions: 271 → 274 (actual file count)
- Templates section titles: 164 → 175 (consistent with badge)
- 19K CVEs in hero text: 18 → 24 (consistent with threat-db badge)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 15:40:43 +01:00
Florian BRUNIAUX
6117145837 docs: integrate veille hebdo Anthropic 17-23 fev 2026 (+177 lignes guide)
P1 - Prompt caching + env vars:
- Strategy 6 cost optimization: cache_control API, pricing (write 1.25x, read 0.1x), break-even 2 hits
- CLAUDE_CODE_DISABLE_1M_CONTEXT + CLAUDE_CODE_SIMPLE ajoutés à la table env vars principale

P2 - Model deprecations + agents:
- Warning claude-3-haiku-20240307 deprecated 19 fev / retirement 20 avril 2026
- Frontmatter fields: background: true (v2.1.49+) + isolation: worktree (v2.1.50+)
- Section Background Agents: comportement non-blocking, gestion (ctrl+f, double ESC)
- Section claude agents CLI: commande + output annoté

P3 - Worktree isolation native + security cross-ref:
- Native worktree features: --worktree flag, isolation declaratif, WorktreeCreate/WorktreeRemove hooks
- §7.4 Security Hooks: cross-ref Claude Code Security scanner (research preview)

Eval: docs/resource-evaluations/2026-02-22-veille-hebdo-anthropic-17-23-fev.md (score 3/5)
Stats: 19K → 20K lignes (20 440 total)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 12:59:28 +01:00
Florian BRUNIAUX
2874eee382 docs(diagrams): add budget modifier to model selection decision flow
Le diagramme assumait implicitement un budget illimité (Max/API).
Ajout d'un budget modifier table et community pattern basé sur le
feedback de Frédéric Camblor (Teams Standard $25/mo: Sonnet plan → Haiku impl).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 11:33:23 +01:00
Florian BRUNIAUX
ce9e8718df feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams
Each flowchart node now links to the specific guide section it represents
via Mermaid `click NodeId href "URL"` directives. sequenceDiagram blocks
(10 total) are skipped as Mermaid does not support click directives for them.

Files updated:
- 01-foundations.md through 10-adoption-and-learning.md
- All flowchart nodes linked to their respective guide anchors
- Architecture, MCP, security, workflows, multi-agent, cost, adoption sections

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 22:21:30 +01:00
Florian BRUNIAUX
33cf57b155 docs: document reference.yaml structure, deep_dive section, and CMD+K search index behavior 2026-02-22 20:20:04 +01:00
Florian BRUNIAUX
b6a1e63f94 fix: rename duplicate key security_gate_hook → security_gate_hook_line in reference.yaml 2026-02-22 19:24:53 +01:00
Florian BRUNIAUX
7c001da251 docs: update README + CHANGELOG for threat-db v2.2.0
README: CVE count 19→24, malicious skills 341→655 (consistent across all occurrences + badge)
CHANGELOG: security patch entry for threat-db v2.2.0 (CVE-2026-0755, mcp-run-python SSRF, 5 new scanners, T010)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 16:21:53 +01:00
Florian BRUNIAUX
24b464802e fix(diagrams): replace \n with <br/> in all Mermaid node labels
Mermaid does not support \n for line breaks — rendered literally.
Replaced all 276 occurrences with <br/> across 10 diagram files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 16:17:52 +01:00
Florian BRUNIAUX
92643c1a6b docs(security): update threat-db v2.2.0 — CVE-2026-0755, mcp-run-python SSRF, 5 new scanners
New CVEs:
- CVE-2026-0755 (gemini-mcp-tool, CVSS 9.8, RCE, no fix yet)
- SNYK-PYTHON-MCPRUNPYTHON-15250607 (mcp-run-python SSRF via Deno sandbox)

New entries:
- Attack technique T010: Agent-to-Agent Communication Injection
- 5 new scanning tools: Proximity, Enkrypt AI, Cisco MCP Scanner, NeuralTrust, MCPScan.ai
- 1 new defensive resource: Anthropic Claude Code Security (2026-02-21)
- 4 new sources (Lakera, Penligent AI, Snyk, THN)

Updated security-hardening.md: added CVE-2026-0755 and mcp-run-python SSRF to CVE table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 16:14:34 +01:00
Florian BRUNIAUX
8a75fd2fd2 fix(diagrams): add color:#333 to light-fill nodes for dark mode contrast
Nodes with fill:#F5E6D3 (beige), fill:#B8B8B8 (gray), fill:#7BC47F (green)
had no explicit text color — GitHub dark mode rendered white text on light
backgrounds, making them unreadable.

Added color:#333 to all 3 light fills across all 10 diagram files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:59:07 +01:00
Florian BRUNIAUX
dbb62306d7 release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams)
guide/diagrams/: new directory with 40 interactive Mermaid diagrams
- 10 thematic files: foundations, context/sessions, configuration,
  architecture, MCP ecosystem, dev workflows, multi-agent patterns,
  security/production, cost/optimization, adoption/learning
- Each diagram: Mermaid (GitHub-native) + ASCII fallback + source link
- Bold Guy palette (6-color system) consistent across all diagrams
- README with index, visual palette legend, navigation by use case

Also includes (backlog from v3.28.0→v3.28.1):
- guide/ultimate-guide.md: Managing Large MCP Server Sets, AI Code
  Disclosure Policy, claude-mem Gemini alternative, observability
- guide/workflows/plan-driven.md: Boris Tane custom markdown plans (+172L)
- guide/security-hardening.md: Part 4 PR security review workflow
- examples/agents/security-patcher.md: new security agent
- examples/hooks/bash/security-gate.sh: PreToolUse security hook
- guide/observability.md: activity monitoring, external tools, proxying
- docs/resource-evaluations/: 4 new evaluations (Boris Cherny, Moigneu,
  Boris Tane, Aristote AI instructions)
- README.md: Visual Diagrams section in "What Makes This Guide Unique"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:51:21 +01:00
Florian BRUNIAUX
9218ab37d6 feat: security scanning workflow (auditor + patcher + gate hook)
- security-hardening.md Part 4: PR security review workflow
  3-agent pipeline: scan → data flow trace → patch
  Tableau par type de changement (auth, DB, upload, deps)
  Hook pre-push git pour alerter sur fichiers sensibles
- security-patcher agent: applique les findings du security-auditor
  Propose avant d'écrire, jamais en autonomie (human approval gate)
  Séparation nette detect vs patch
- security-gate.sh hook: PreToolUse, 7 patterns vulnérables bloqués
  SQLi, XSS innerHTML, secrets hardcodés, eval() dynamique,
  hash faible (MD5/SHA1 password), command injection, path traversal
  Complément de dangerous-actions-blocker.sh (ops système)
- Claude Code Security (research preview) documentée dans security-hardening.md
  Comparaison Security Auditor Agent vs feature Anthropic
- reference.yaml: 4 nouvelles entrées indexées

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:21:35 +01:00
Florian BRUNIAUX
ac50ee7ad8 docs: add monitoring & activity audit sections to observability guide
- guide/observability.md: +3 sections (Activity Monitoring, External Tools, Proxying)
  - Activity Monitoring: JSONL tool_use audit, jq queries, sensitive pattern detection
  - External Tools: ccusage / claude-code-otel / Akto / MLflow / ccboard comparison
  - Proxying: NODE_EXTRA_CA_CERTS, ANTHROPIC_API_URL, mitmproxy, Python proxy
- docs: ccboard Activity module implementation plan (Tab 10, Rust models, SQLite cache)
- docs: Mergify cross-system support evaluation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 20:29:05 +01:00
Florian BRUNIAUX
6049bd99c2 release: v3.28.0 - Section 2.5 Model Selection & Thinking Guide
Section canonique consolidée pour le choix de modèle :
- Section 2.5 (decision table, effort levels avec prompts, model-per-agent patterns, thinking guide)
- 3 nouveaux agents : planner (Opus), implementer (Haiku), architecture-reviewer (Opus)
- 7 nouvelles questions quiz (09-037→09-043, intermediate→power)
- 3 tables redondantes remplacées par cross-refs vers Section 2.5

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 18:25:50 +01:00
Florian BRUNIAUX
31802b61b1 release: v3.27.9
- Update Claude Code releases tracking (v2.1.49 → v2.1.50)
- Cut versioned release for Talk Preparation Pipeline, AGENTS.md research,
  Profile-Based Module Assembly (Section 3.5), ATDD expansion,
  Spec-First Task Granularity, team-config templates, and Mergify case study

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 17:27:32 +01:00
Florian BRUNIAUX
520b8e6fdd docs: update Claude Code releases to v2.1.50
- WorktreeCreate/WorktreeRemove hook events for custom VCS setup/teardown
- isolation: worktree in agent definitions (declarative worktree isolation)
- claude agents CLI command to list configured agents
- Opus 4.6 fast mode now has full 1M context window
- CLAUDE_CODE_DISABLE_1M_CONTEXT env var
- Major memory leak fixes + headless startup performance improvements

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 15:32:55 +01:00
Florian BRUNIAUX
e110346d34 docs: update Claude Code releases to v2.1.49
- Updated latest tracked version: v2.1.47 → v2.1.49
- v2.1.49 highlights: --worktree/-w flag + subagent isolation:worktree,
  background:true for agents, ConfigChange hook event, simple mode file edit
- Updated CHANGELOG [Unreleased] with CC release tracking entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-20 17:51:33 +01:00
Florian BRUNIAUX
00cb973bdb docs: add Talk Preparation Pipeline workflow + skill templates
6-stage pipeline: raw material → conference talk → Kimi AI slides.

New files:
- guide/workflows/talk-pipeline.md — Full workflow guide (REX vs Concept
  modes, stage-by-stage breakdown, CHECKPOINT mechanics, Kimi handoff,
  real-world DevWithAI example, 5 design patterns documented)
- examples/skills/talk-pipeline/ — 7 SKILL.md files + orchestrator + 2
  templates (feedback-draft.md, kimi-prompt-template.md)

Updated:
- README.md — badges 164→172 templates, Feb 20 date, 13→14 skills
- guide/workflows/README.md — Talk Pipeline entry under Design & Content
- machine-readable/reference.yaml — 16 new entries for pipeline components
- CHANGELOG.md — [Unreleased] entry

Design patterns showcased: skill chaining + file-based state, tool
permission scoping (Bash only Stage 2), human-in-the-loop CHECKPOINT
(Stage 4), AI-to-AI handoff (Claude → Kimi), dual execution modes
(REX/Concept).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-20 15:51:29 +01:00
Florian BRUNIAUX
6d847d24de docs: add Profile-Based Module Assembly pattern (Section 3.5)
- Section 3.5 "Team Configuration at Scale" in ultimate-guide.md:
  profiles YAML + shared modules + skeleton + assembler script;
  59% context token reduction measured on 5-dev production team;
  includes CI drift detection, 5-step replication guide, trade-offs
- New workflow: guide/workflows/team-ai-instructions.md (6 phases,
  scaling thresholds, troubleshooting table)
- New templates: examples/team-config/ (profile-template.yaml,
  claude-skeleton.md, sync-script.ts)
- reference.yaml: 9 new entries for team_ai_instructions_*
- README: templates count 161 → 164, date Feb 19 → Feb 20
- CHANGELOG [Unreleased]: resource evaluations (AGENTS.md ETH Zürich
  4/5, Sylvain Chabaud 3/5), spec-first Task Granularity section,
  methodologies ATDD expansion

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-20 15:04:29 +01:00
Florian BRUNIAUX
146d15e958 docs: add guide reader rebuild instructions to CLAUDE.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 15:48:08 +01:00
Florian BRUNIAUX
46b5f39f52 docs: update examples README and reference.yaml for claude-code-review.yml
- examples/README.md: github-actions count 3→4, add new workflow row
- machine-readable/reference.yaml: 6 new entries (workflow, prompt, pattern, tools, auth, cost)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 14:58:27 +01:00
Florian BRUNIAUX
9b75b5125e release: v3.27.8 - prompt-based GitHub Actions code review workflow
New examples/github-actions/claude-code-review.yml with externalized prompt,
anti-hallucination protocol, /claude-review on-demand trigger. Templates 116→161.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 14:23:15 +01:00
Florian BRUNIAUX
373b50cf77 docs: add 4 resource evaluations + tasks/lessons.md pattern (v3.27.7+)
- Add tasks/lessons.md variant to Fresh Context Pattern section — lightweight
  self-improvement loop where Claude captures behavioral rules after corrections
- Resource evaluations (4 new, 67 → 78 total):
  - SKILLMIND/Boris Cherny workflow (2/5): self-improvement loop concept
  - Augment Context Engine MCP (3/5): cloud alternative to grepai
  - LinkedIn context engineering post (2/5): marginal relevance
  - LinkedIn activity-7428930570451083264 (inaccessible)
- README: update evaluations count 67 → 78, threat DB badge 18/341 → 19/655
- CLAUDE.md: add Whitepaper Generation section (PDF + EPUB commands)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 13:47:38 +01:00
Florian BRUNIAUX
895ace49f7 docs: add Borg et al. 2025 RCT on AI code maintainability (v3.27.7)
- Resource eval: arXiv:2507.00788 "Echoes of AI" (151 devs, 95% pros,
  2-phase blind RCT) — 30.7% faster median, ~55.9% habitual users,
  no significant downstream maintainability impact
- guide/learning-with-ai.md: citation + "On maintainability fear" note
- guide/ultimate-guide.md: nuance blockquote in §1.7 Trust Calibration
- machine-readable/reference.yaml: 4 new RCT/maintainability entries
- docs/resource-evaluations/: evaluation file with technical-writer audit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 09:59:50 +01:00
Florian BRUNIAUX
4c42151151 feat: add GitHub issue form templates
4 YAML form templates for structured feedback from the landing site FAB:
- bug_report.yml: page URL, browser, OS, steps, expected vs actual (update of existing)
- content_suggestion.yml: type, section, description, references
- quiz_error.yml: question ID, category, error type, suggested fix
- general_feedback.yml: type (UX/content/a11y/perf), message, page URL
- config.yml: blank_issues_enabled + Discussions link

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 09:52:33 +01:00
Florian BRUNIAUX
5083d80ed1 docs: update Claude Code releases to v2.1.47
- v2.1.47: VS Code plan preview auto-updates, ctrl+f kills background agents,
  last_assistant_message hook field, 70+ bug fixes (PDF compaction, Unicode
  curly quotes, parallel file edits, OSC 8 hyperlinks, Windows hooks, worktrees)
- v2.1.46: claude.ai MCP connectors support, orphaned process fix on macOS
- Update latest tracked: v2.1.45 → v2.1.47

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-19 08:37:31 +01:00
Florian BRUNIAUX
267ce0ba86 chore: update guide content and add new examples
- Update ultimate guide and cheatsheet
- Update llms.txt and reference YAML
- Add velocity-governor hook and cc-sessions script

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 18:48:19 +01:00
Florian BRUNIAUX
c08c2d6fcb docs: update CHANGELOG 3.27.6 with post-release fixes and community findings
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 10:47:47 +01:00
Florian BRUNIAUX
61d7bb5fad docs: enrich 200K vs 1M section with community findings
- Add community verdict: 1M is niche premium, not default
- Add Gemini 1.5 Pro comparison ($3.50/$10.50 vs Opus $10/$37.50)
- Expand decision table: full-repo audit vs RAG vs refacto
- Add Sonnet 4.6 community report on precision degradation at 1M
- Add "check context at 70%, open new session" workaround pattern (HN)
- Add links to HN validation test + independent MRCR analysis

Sources: Perplexity deep search Reddit/HN/blogs, Feb 18 2026

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 10:43:46 +01:00
Florian BRUNIAUX
8d6c50403d docs: restore 93% @ 256K with source + add HN community validation
- Restore Opus 4.6 MRCR 93% @ 256K (confirmed: independent analysis of Anthropic data)
- Add Harry Potter needle test reference (HN 46905735: 49/50 spells at 733K tokens)
- Source: Perplexity deep search cross-validation, Feb 18 2026

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 10:41:03 +01:00
Florian BRUNIAUX
78f4dc4b42 fix: correct 200K vs 1M context section after source verification
- Fix beta header: interleaved-thinking → context-1m-2025-08-07
- Add Sonnet 4.6 long-context premium ($3→$6 / $15→$22.50 above 200K)
- Correct cost estimates: Sonnet 1M ~$4.13 (was $2.25), Opus 1M ~$6.88 (was $8.75)
- Remove unverified 93% @ 256K MRCR figure
- Add usage tier 4 requirement
- Clarify "all tokens" billed at premium when input >200K

Sources: Anthropic pricing docs + context-windows docs (verified Feb 18 2026)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 10:06:21 +01:00
Florian BRUNIAUX
c3da456d3a release: v3.27.6 - Sonnet 4.6 default + 200K vs 1M context guide
- Pricing table: Sonnet 4.6 now default (Feb 2026)
- New section: 200K vs 1M context decision guide (MRCR bench, cost table, use cases)
- threat-db.yaml v2.1.0: CVE-2026-23744, Slopsquatting T009, OWASP Agentic AI Top 10

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-18 09:33:55 +01:00
Florian BRUNIAUX
4b15bdb137 release: v3.27.5 - Claude Code v2.1.45 tracking
- Bump guide: v3.27.4 → v3.27.5
- Update Claude Code releases: v2.1.44 → v2.1.45
  - Sonnet 4.6 model support
  - spinnerTipsOverride setting
  - SDK SDKRateLimitInfo/SDKRateLimitEvent types
  - Agent Teams fix on Bedrock/Vertex/Foundry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-17 21:12:53 +01:00
Florian BRUNIAUX
88c9f310a7 docs: update Claude Code releases to v2.1.45
- Updated latest tracked version: v2.1.44 → v2.1.45
- Highlights: Sonnet 4.6 support, spinnerTipsOverride setting,
  SDK SDKRateLimitInfo/SDKRateLimitEvent types,
  Agent Teams fix on Bedrock/Vertex/Foundry
- Updated CHANGELOG with release tracking note

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-17 20:57:57 +01:00
Florian BRUNIAUX
1f720f7d74 release: v3.27.4 - template count update + worktree docs
- Templates 113 → 116 (review-plan, git-worktree-status/remove/clean, rules)
- Commands 23 → 26 (worktree lifecycle suite)
- Git worktree section expanded with lifecycle commands table
- Version sync across all docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 11:15:32 +01:00
Florian BRUNIAUX
0d6a0c656e docs: add git-worktree suite, security kill switch, update reference.yaml + CC releases
- Git worktree commands: overhauled main + 3 new (status, remove, clean)
- Security hardening: AI Kill Switch & Containment Architecture (§3.5)
- DevOps SRE: cross-reference to security-hardening for AI incidents
- CC releases: v2.1.43-v2.1.44 tracking
- reference.yaml: 12 new entries, evaluations count 67 → 74

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 10:20:57 +01:00
Florian BRUNIAUX
70c6c34658 docs: update template count 108 → 113 (new rules + review-plan)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 20:49:05 +01:00
Florian BRUNIAUX
e4d9d9e825 fix: correct v2.1.39/v2.1.41 feature attributions + add claude auth CLI docs
3 features were incorrectly attributed to v2.1.39 instead of v2.1.41
(guard nested sessions, OTel speed attribute, Agent Teams model fix).
Verified against official CHANGELOG. Also adds claude auth login/status/logout
to the ultimate guide maintenance commands table.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 20:37:08 +01:00
Florian BRUNIAUX
75e93f79a4 docs: update CHANGELOG with review-plan templates
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 20:35:02 +01:00
Florian BRUNIAUX
7d43b67bcd docs: add review-plan command + rules templates (inspired by Garry Tan)
Structured plan review across 4 axes (architecture, code quality, tests,
performance) as a reusable custom command with separate rules files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 20:34:33 +01:00