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

446 commits

This branch
This branch
All branches
Author SHA1 Message Date
Florian BRUNIAUX
44818a3f04 release: v3.37.1 - threat-db v2.8.0, CC releases v2.1.78, 19 skills update, doc fixes 
- threat-db v2.8.0: GhostClaw campaign, Fake OpenClaw Installer, CVE-2026-24910 (Bun),
  T017 Shadow MCP, T018 AI Search Poisoning, Jozu Agent Guard, MCP Sentinel
- Claude Code releases tracked to v2.1.78 (StopFailure hook, plugin state, security fixes)
- 19 skill descriptions improved (PR #9 selective merge, @popey/Tessl)
- MCP vs CLI token overhead corrected (lazy loading, 85% reduction benchmark)
- Agent Adoption Curve self-assessment (7-level maturity scale, Martignole framework)
- ctx7 CLI section §5.5 + resource evals #079 #080 #081

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-18 15:49:01 +01:00
Florian BRUNIAUX
eea5662a65 docs: update Claude Code releases to v2.1.78 
- Update latest tracked version: v2.1.77 → v2.1.78
- Add v2.1.78 highlights: StopFailure hook, ${CLAUDE_PLUGIN_DATA}
  persistent plugin state, streaming line-by-line, 3 security fixes
  (silent sandbox disable, MCP deny rules bypass, protected dirs in
  bypassPermissions mode)
- Update CHANGELOG with release tracking entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-18 15:08:33 +01:00
Florian BRUNIAUX
cf95de681e docs: update CHANGELOG for PR #9 selective skill description merge 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 21:59:21 +01:00
Florian BRUNIAUX
52f0e31305 Merge branch 'feat/pr-9-skill-improvements' 2026-03-17 21:40:57 +01:00
Florian BRUNIAUX
40213f0a7e feat: improve skill descriptions from PR #9 (selective merge) 
Cherry-pick description improvements and allowed-tools fixes from @popey's
PR #9, while preserving reference documentation in skills that serve as
templates (audit-agents-skills, ccboard, design-patterns).

Co-Authored-By: Alan Pope <alan@popey.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 21:37:06 +01:00
Florian BRUNIAUX
dacba17ea6 docs(eval): add Rippletide Code evaluation #081 + watch-list entry 
Score 3/5. Hook-native runtime rule enforcement via PreToolUse hooks and
Context Graph. Addresses CLAUDE.md degradation at scale (40+ rules) and
compaction-driven rule loss. Free beta (npx rippletide-code, no signup).

Distinct from eval 072 (Rippletide MCP/SaaS platform). Multiple performance
claims unverified (compaction-resistance, 5s build time, 50% stat). Privacy
surface unaddressed (external convention extraction). Watch trigger: public
GitHub >100 stars or independent practitioner write-up.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 21:29:54 +01:00
Florian BRUNIAUX
2ca340be22 feat(skills): add ctx7 CLI registry-based discovery section §5.5 
- New subsection in §5.5: ctx7 skills suggest/install/setup workflow
- Clarifies agentskills.io (spec) vs context7.com/skills (registry)
- Cross-reference note in mcp-servers-ecosystem.md Context7 entry
- Resource evaluation: 2026-03-17-context7-cli.md (score 4/5)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 20:42:32 +01:00
Alan Pope
be52e232b3
feat: improve skill scores across 19 skills 
Hullo @FlorianBruniaux 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| talk-pipeline/orchestrator | 0% | 93% | +93% |
| talk-pipeline/stage-3-concepts | 0% | 93% | +93% |
| talk-pipeline/stage-4-position | 0% | 93% | +93% |
| talk-pipeline/stage-1-extract | 0% | 85% | +85% |
| talk-pipeline/stage-2-research | 0% | 85% | +85% |
| talk-pipeline/stage-5-script | 0% | 85% | +85% |
| talk-pipeline/stage-6-revision | 0% | 79% | +79% |
| ccboard | 32% | 100% | +68% |
| audit-agents-skills | 34% | 95% | +61% |
| rtk-optimizer | 41% | 100% | +59% |
| skill-creator | 52% | 89% | +37% |
| voice-refine | 59% | 93% | +34% |
| design-patterns | 59% | 85% | +26% |
| cyber-defense-team | 76% | 100% | +24% |
| landing-page-generator | 70% | 93% | +23% |
| issue-triage | 73% | 89% | +16% |
| pr-triage | 73% | 89% | +16% |
| release-notes-generator | 78% | 85% | +7% |
| guide-recap | 93% | 100% | +7% |

**Average: 11% → 91% (+80%)**

<details>
<summary>Changes summary</summary>

### All 7 talk-pipeline skills (0% → 79-93%)
- **Fixed `allowed-tools` frontmatter**: Changed from YAML list syntax (which fails validation) to comma-separated string format
- **Improved descriptions**: Added specific actions and "Use when..." clauses to all pipeline stage descriptions

### ccboard (32% → 100%)
- Rewrote description with concrete actions and "Use when..." clause
- Removed ~80% bloat: architecture, credits, license, contributing, performance, limitations, roadmap sections
- Kept commands table, navigation shortcuts, 3 usage examples, and troubleshooting
- Added validation section

### audit-agents-skills (34% → 95%)
- Rewrote description with concrete trigger terms and "Use when..." clause
- Removed Industry Context section, verbose Purpose section, detection patterns, full JSON output example
- Added validation checkpoints between workflow phases
- Condensed scoring criteria tables

### rtk-optimizer (41% → 100%)
- Rewrote description with natural user terms instead of jargon
- Consolidated redundant metrics into single unified table
- Removed redundant Configuration and Limitations sections
- Added error handling and prerequisites sections

### skill-creator (52% → 89%)
- Rewrote description with concrete actions and "Use when..." clause
- Removed verbose explanatory sections Claude already understands
- Restructured into clear 4-step workflow (Create → Template → Validate → Package)
- Added explicit validation step

### voice-refine (59% → 93%)
- Added "Use when..." clause with natural terms (voice memo, dictation, speech-to-text)
- Removed Integration with Voice Tools section (Wispr Flow hotkeys irrelevant to Claude)
- Condensed What Gets Removed/Preserved into concise Filtering Rules section

### design-patterns (59% → 85%)
- Added "Use when..." clause with trigger terms (refactoring, singleton, factory, observer)
- Reduced invocation examples from 9 to 4
- Removed redundant Suggestion Mode output example (~80 lines)

### cyber-defense-team (76% → 100%)
- Added "Use when..." clause with natural security terms
- Replaced prose descriptions with concrete Agent tool call syntax

### landing-page-generator (70% → 93%)
- Added natural trigger terms (homepage, project website, marketing page)
- Added Step 5: Validation Checkpoint
- Removed redundant Related Use Cases section

### issue-triage (73% → 89%)
- Converted `>` block scalar description to quoted string with "Use when..." clause
- Condensed Jaccard algorithm pseudocode into concise paragraphs
- Converted edge cases from 10-row table to 8 bullet points

### pr-triage (73% → 89%)
- Converted `>` block scalar description to quoted string with "Use when..." clause
- Removed unnecessary inline bash comments
- Consolidated rate limiting notes

### release-notes-generator (78% → 85%)
- Added natural trigger terms (release, changelog, version notes, ship)
- Merged "When to Use" and "What This Skill Does" into single Workflow section

### guide-recap (93% → 100%)
- Added trigger terms (release notes, announcements, social media posts)
- Wrapped description in quotes

</details>

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@popey](https://github.com/popey) - if you hit any snags.

Thanks in advance 🙏
 2026-03-17 16:27:02 +00:00
Florian BRUNIAUX
f5d78e1004 release: v3.37.0 — MCP vs CLI landing page + guide section 
- New guide section: guide/ecosystem/mcp-vs-cli.md (4 decision dimensions,
  15-row guidance table, token cost analysis, practitioner quotes)
- New landing page: cc.bruniaux.com/ecosystem/mcp-vs-cli/ (4 decision cards,
  collapsible guidance table, zero JS, WCAG-compliant badges)
- ICM v0.5.0 setup guide corrections + icm-session-starter.md template
- 3 resource evaluations: mcp2cli, MCPorter, CircleCI MCP vs CLI blog
- WP10 v1.2.0 DAF/finance feedback corrections (FR+EN)
- Recap cards EN translations (57 cards) + FR version bump 3.32.1 → 3.36.0
- Whitepapers v2.2: 7 WPs synced with guide v3.27.6 → v3.36.0 delta
- check-landing-sync.sh: section 7 for MCP vs CLI sync tracking
- docs/for-cto.md: whitepapers links updated to florian.bruniaux.com/guides

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 15:55:44 +01:00
Florian BRUNIAUX
728431cd4d fix: dead link to Packmind in ultimate-guide.md §3.5 
../ecosystem/ from guide/ resolved outside the repo root.
Fixed to ecosystem/third-party-tools.md#packmind.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 10:47:35 +01:00
Florian BRUNIAUX
2c455d6867 fix(whitepapers): v2 corrections relecteurs — WP00/02/05/08/10 FR+EN 
8 phases of corrections based on reviewer feedback (Edouard, Mat,
Nicolas, Marc, Anthony, Emmanuel) across 10 whitepapers (WP00-WP10).

Key factual fixes:
- npm "deprecated" → "not recommended", native installer added (WP00)
- Context window 200K vs 1M clarified with agent teams distinction (WP00)
- Claude Max cost ratio corrected to range 1.5-3% FR / 1-1.6% EN (WP10)
- Sub-agents vs agent teams: difference = P2P messaging + coordination
  tools, NOT context isolation (WP08 EN)

Content improvements:
- ~200+ accent restorations in WP08 FR (977 lines)
- Anglicisms corrected in WP02 FR (on-demand, per-project, Memories)
- WP10 executive summary added with 5 key metrics
- WP10 learning curve duplication removed, BCG source improved
- WP10 "Beyond engineering teams" expanded with 3 concrete use cases
- WP08 tmux noted as external tool; meta-sentence removed; solo agent
  clarified as full autonomous agent, not chatbot
- WP05 Turnkey Quickstart explained; "Multiple Claude instances"
  rewritten as complete sentence

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 10:22:25 +01:00
Florian BRUNIAUX
19bdc910cc release: v3.36.0 — 3 AI roles + ContextOps + comprehension debt 
Added:
- guide/roles/ai-roles.md: §14 MLOps Engineer, §15 AI Developer Advocate,
  §16 AI Orchestration Engineer with full profiles (responsibilities, skills,
  entry paths, salary benchmarks, career matrix rows)
- 4 resource evaluations (Packmind ContextOps, comprehension debt,
  Addy Osmani agents.md anti-pattern, Claude Swarm Monitor)

Changed:
- guide/roles/ai-roles.md: ToC renumbered, Career Decision Matrix +3 rows,
  Salary Benchmarks +3 rows, removed "Orchestration Engineer" from What's Not a Role
- docs/for-cto.md, for-cio-ceo.md, for-tech-leads.md: updated docs positioning
- guide/ecosystem: mcp-servers-ecosystem.md + third-party-tools.md updates
- guide/roles/learning-with-ai.md: content updates

Bump: 3.35.0 → 3.36.0 (VERSION, README, cheatsheet, ultimate-guide, reference.yaml,
      llms.txt, llms-full.txt, machine-readable/llms.txt)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 09:14:26 +01:00
Florian BRUNIAUX
c2a642dabe feat(roles): add MLOps Engineer, AI Developer Advocate, AI Orchestration Engineer 
3 new full role profiles (§14-16) based on Perplexity market research (March 2026):
- MLOps Engineer: CI/CD for models, drift monitoring, operational lifecycle
- AI Developer Advocate: +35-40% YoY, $120K-$300K, active hiring at AI platforms
- AI Orchestration Engineer: real job postings confirmed (Vista Equity, Zapier, Heidi, Adobe)

Sections 14-17 renumbered to 17-20. Removed "Orchestration engineer" from
"What's Not a Role Yet" — now a real distinct category. Career Decision Matrix
and Salary Benchmarks updated with all 3 roles.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 09:02:46 +01:00
Florian BRUNIAUX
1bbf346687 docs: update Claude Code releases to v2.1.77 
- Opus 4.6 default max output raised to 64k tokens; upper bound 128k
- Security fix: PreToolUse hooks bypass of enterprise deny rules
- allowRead sandbox setting, /branch command, /copy N shorthand
- Breaking: Agent tool resume param removed (use SendMessage instead)
- Fixed auto-updater memory leak; fixed --resume history truncation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-17 08:42:20 +01:00
Florian BRUNIAUX
da8bc09f2d feat: smart-suggest ROI script + hook tuning + guide updates (Mar 16) 
- Add examples/scripts/smart-suggest-roi.py: stdlib-only analyzer correlating
  suggestion log with session JSONL files to measure command acceptance rate.
  4 acceptance signals, tier breakdown, daily trend, --json/--since/--no-sessions CLI.
- Tune Aristote smart-suggest hook: tighten 5 over-firing triggers (/tech:commit,
  /tech:sonarqube, /tech:dupes, /check-conventions a11y, /tech:worktree)
- Guide: identity re-injection hook, context engineering maturity grid, code review
  workflow, 1M context window GA update, Spring Break promo, security audit patterns
- Resource evaluations: Nick Tune hooks (3/5), VicKayro security audit (2/5),
  Karl Mazier CLAUDE.md templates, Paul Rayner ContextFlow, Siddhant agent trace,
  Andrew Yng context hub, JP Caparas 1M context window

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-16 12:20:40 +01:00
Florian BRUNIAUX
d9cff74d71 docs: add Spring Break 2x usage promo note + ICM evaluation 
- Guide: documented Anthropic March 13-27 2026 promotion (2x limits
  outside 5-11am PT / all weekends), with CET timezone conversion for
  European users
- Resource evaluation: ICM Infinite Context Memory MCP server (score 3/5)
- CHANGELOG: both entries under [Unreleased]

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-15 18:34:55 +01:00
Florian BRUNIAUX
30e3916eb3 docs: update Claude Code releases to v2.1.76 
- MCP elicitation: servers request structured input mid-task via interactive dialog
- New hooks: Elicitation, ElicitationResult, PostCompact
- -n/--name CLI flag for session display name at startup
- worktree.sparsePaths for monorepo sparse checkout; /effort slash command
- Fixed ToolSearch deferred tools losing input schemas after compaction
- Auto-compact circuit breaker (stops after 3 consecutive failures)
- Fixed Bash(cmd:*) rules not matching when quoted argument contains #

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-14 18:44:21 +01:00
Florian BRUNIAUX
0d31b8ff77 docs: update Claude Code releases to v2.1.75 
- Update latest tracked version: 2.1.74 → 2.1.75
- Highlights: 1M context Opus 4.6 default for Max/Team/Enterprise, session name on prompt bar, hook source in permission prompts, token estimation over-counting fix, Bash ! mangling fix
- Updated: 2026-03-13

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 19:32:04 +01:00
Florian BRUNIAUX
ca69a1a7fd release: v3.35.0 — workflows, hook, threat-db, GitHub Actions CI 
New workflow guides (RPI, changelog-fragments, github-actions), smart-suggest
UserPromptSubmit hook, LLM variance known-issue, threat-db v2.7.0, desloppify,
cc-sessions discover documentation, prompt-caching verification script.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 19:30:34 +01:00
Florian BRUNIAUX
b0698bfb39 docs: add GitHub Actions workflow guide + desloppify + threat-db v2.7.0 
- guide/workflows/github-actions.md (new): 5 production patterns with
  claude-code-action (on-demand @claude, auto push review, issue triage,
  security review, scheduled maintenance), auth alternatives, cost control
- guide/ultimate-guide.md: GitHub Actions cross-ref + desloppify tool
  (vibe code quality fix-loop, community tool, ~2K stars, Feb 2026)
- examples/commands/resources/threat-db.yaml: v2.7.0, +5 threat sources
  (Azure MCP SSRF CVE-2026-26118, OpenClaw, Taskflow, Codex Security,
  DryRun Security 87% vulnerability stat)
- CLAUDE.md: Behavioral Rules section (5 rules from observed friction)
- guide/workflows/README.md: github-actions entry + quick selection row
- IDEAS.md: CI/CD Workflows Gallery marked complete
- CHANGELOG.md: [Unreleased] entries for all items

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 17:19:18 +01:00
Florian BRUNIAUX
aafb412fa4 feat(examples): add prompt caching test script 
Standalone TypeScript script (zero deps, native fetch) to verify
Anthropic prompt caching is active. Documents 4 production gotchas
not in official docs: beta header required for Claude 4.x, effective
threshold ~2048+ tokens, cached tokens excluded from input_tokens,
new nested cache_creation response format.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 17:17:31 +01:00
Florian BRUNIAUX
b6ce1ef72f docs: add RPI workflow, changelog fragments, smart-suggest hook + LLM variance 
- guide/workflows/rpi.md (new): Research → Plan → Implement, 3-phase pattern
  with explicit GO gates, slash command templates, worked example
- guide/workflows/changelog-fragments.md (new): per-PR YAML fragment enforcement,
  3-layer system (CLAUDE.md rule + UserPromptSubmit hook + CI gate)
- examples/hooks/bash/smart-suggest.sh (new): UserPromptSubmit behavioral coach,
  3-tier priority (enforcement/discovery/contextual), ROI logging
- guide/core/known-issues.md: LLM Day-to-Day Performance Variance section,
  4 root causes (probabilistic inference, MoE routing, infra, context sensitivity)
- guide/workflows/README.md: added RPI entry + quick selection row
- machine-readable/reference.yaml: added entries for changelog_fragments, smart_suggest
- CHANGELOG.md: [Unreleased] entries for all 4 new items
- IDEAS.md: prompt-caching MCP plugin research note (testing in progress)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 16:22:57 +01:00
Florian BRUNIAUX
13efb5a774 docs: add cc-sessions discover + GitHub repo (v1.0.0) 
- New subsection "Session Pattern Discovery" in §2.x (Session Management):
  n-gram mode, --llm mode via claude --print, example output, 20% rule framework
- Cross-reference added after the 20% rule callout in §5.1 Skills
- examples/scripts/cc-sessions.py synced: 498 → 1225 lines (full discover subcommand)
- examples/scripts/README.md: discover examples + curl install + GitHub link
- machine-readable/reference.yaml: cc_sessions_github + cc_sessions_discover entries
- GitHub repo created: https://github.com/FlorianBruniaux/cc-sessions (v1.0.0 released)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 15:28:31 +01:00
Florian BRUNIAUX
1728b6de39 docs: add Cognitive Mode Switching workflow + gstack integration (v3.34.9) 
- guide/workflows/gstack-workflow.md (new): Cognitive Mode Switching
  pattern — 6 gears table, pre-implementation strategic gate concept,
  /browse non-MCP native Chromium daemon architecture (~100ms/cmd),
  full ship cycle demo. Reference impl: gstack by Garry Tan (YC CEO).
- examples/commands/plan-ceo-review.md (new): strategic product gate
  template with 3 modes (SCOPE EXPANSION / HOLD SCOPE / REDUCTION)
- examples/commands/plan-eng-review.md (new): engineering architecture
  gate template with Mermaid diagrams, failure modes, test matrix
- guide/workflows/README.md: add entry + 2 Quick Selection Guide rows
- guide/ecosystem/third-party-tools.md: gstack in Plugin Ecosystem
- machine-readable/reference.yaml: v3.34.9, 11 new gstack entries

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 10:34:51 +01:00
Florian BRUNIAUX
ded3a9858d docs: expand quiz 277 → 311 questions (+34), sync counters 
33 new questions covering recent CC releases and guide additions:
- Settings: modelOverrides, autoMemoryDirectory, tool-qualified deny, HTML comments, spinnerVerbs, team config
- Commands: /loop, /simplify, /batch, /stats, /rename
- Hooks: WorktreeCreate/Remove, TeammateIdle/TaskCompleted, auto-rename-session
- MCP: Git MCP vs GitHub MCP
- Advanced: Context 150% ceiling, ACE pipeline, Plan-Validate-Execute, dual-instance, isolation:worktree
- Reference: effort levels ○◐●, Fast mode, model param on Agent, /context v2.1.74
- Learning: METR RCT 2025, Borg RCT 2025, Contribution Metrics
- Security: enterprise governance tiers, MCP registry, native sandbox, dangerouslyDisableSandbox
- Ecosystem: RTK, Google Antigravity
1 correction: architecture-internals/002 (TodoWrite → Tasks API, v2.1.16+)
Counters: quiz_count 271 → 311 in reference.yaml + all llms.txt files

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 10:08:49 +01:00
Florian BRUNIAUX
a4a6c49cb5 docs(diagrams): audit, fix and expand Mermaid diagram suite (7 files → 9) 
Phase 1-2 — fixes on existing diagrams:
- 01-foundations: add Plan Mode + dontAsk subgraphs (3→5 permission modes)
- 04-architecture-internals: add Control Flow Tools category (5→6 tool categories)
- 05-mcp-ecosystem: clarify local+user scopes both live in ~/.claude.json
- 07-multi-agent-patterns: fix disconnected B2 node (now proper third branch)
- 09-cost-and-optimization: replace hardcoded prices with relative ratios + disclaimer

Phase 3 — new diagram files:
- 11-context-engineering.md: 4 diagrams (3-layer system, budget/adherence, monolithic vs modular, rule placement decision tree)
- 12-enterprise-governance.md: 3 diagrams (governance risk tiers, MCP approval workflow, data classification)

README.md updated: 41→48 diagrams, navigation table extended, 2 new use-case sections

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-13 10:08:49 +01:00
Florian BRUNIAUX
f9ae40d6a7
Merge pull request #8 from fdelbrayelle/fix_btw 2026-03-13 09:21:28 +01:00
François Delbrayelle
757cfe0220 fix: add missing / to btw 2026-03-12 16:06:11 +01:00
Florian BRUNIAUX
27352cc455 docs: update Claude Code releases to v2.1.74 
- v2.1.74: /context actionable suggestions, autoMemoryDirectory setting,
  streaming buffer memory leak fix, managed policy ask rules bypass fix,
  SessionEnd hook timeout now configurable
- v2.1.73: modelOverrides setting, skill hot-reload deadlock fix, subagent
  model downgrade fix on Bedrock/Vertex/Foundry, Opus 4.6 default on 3P,
  /output-style deprecated in favor of /config

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-12 10:28:54 +01:00
Florian BRUNIAUX
352e748b74 docs: update CHANGELOG + README for MCP v1.1.0 slash commands 
- CHANGELOG 3.34.3: add 5 new slash commands + /ccguide:daily description
- README: fix tool count (12 → 17) and slash command count (8 → 13)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 18:17:36 +01:00
Florian BRUNIAUX
ecaeb4cd9e docs: add official Anthropic docs tracker commands (MCP v1.1.0) 
- Add 5 new /ccguide commands to ultimate-guide.md slash commands section
  (init-docs, refresh-docs, diff-docs, search-docs, daily)
- Add .claude/commands/ccguide/ with 5 command files for project-level access
- Document typical daily workflow: init once, then /ccguide:daily every day

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 18:09:56 +01:00
Florian BRUNIAUX
4049d41276 release: v3.34.3 — MCP official docs tracker 
- MCP Server v1.1.0 published (npm: claude-code-ultimate-guide-mcp)
- 4 new tools: init_official_docs, refresh_official_docs, diff_official_docs, search_official_docs
- Local cache in ~/.cache/claude-code-guide/ (section-level diff, 0 network on diff/search)
- Bump guide version: 3.34.2 → 3.34.3

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 17:29:08 +01:00
Florian BRUNIAUX
5b713db6fd feat(mcp): add official Anthropic docs tracker — v1.1.0 
New tools (4):
- init_official_docs()    — fetch + store baseline + current snapshots locally
- refresh_official_docs() — update current without touching baseline
- diff_official_docs()    — compare baseline vs current, 0 network, section-level
- search_official_docs(query) — search official docs, loads only matching sections

Architecture:
- 4 local cache files in ~/.cache/claude-code-guide/ (index + content, baseline + current)
- Diff reads index files only (~50KB each), never the full 1.2MB content
- search loads only matched sections from content file (not entire doc)
- Atomic writes (.tmp + rename) prevent snapshot corruption
- schemaVersion: 1 for future-proof migrations

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 17:28:25 +01:00
Florian BRUNIAUX
4dd479161d docs: update Claude Code releases to v2.1.72 
- Update latest tracked version: 2.1.71 → 2.1.72 (2026-03-09)
- Agent model parameter restored on Agent tool for per-invocation overrides
- SDK query() prompt cache fix — up to 12x input token cost reduction
- CLAUDE.md HTML comments now hidden from Claude when auto-injected
- Simplified effort levels: low/medium/high, new symbols ○ ◐ ●
- ExitWorktree tool + CLAUDE_CODE_DISABLE_CRON env var + /plan optional desc
- Bump guide version: 3.34.1 → 3.34.2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 15:55:15 +01:00
Florian BRUNIAUX
ff11f7566b fix(mcp): correct releases GitHub URL (guide/core/ path) 
Wrong path guide/claude-code-releases.md → guide/core/claude-code-releases.md in 3 tools (changelog, releases, compare-versions). Was generating 404 links in get_digest output.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 14:49:47 +01:00
Florian BRUNIAUX
a0bd2c112f docs: document /btw side-question command 
Add /btw to cheatsheet and ultimate guide — ephemeral overlay agent for quick side questions mid-task, read-only, no tools, single response, no history pollution.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 13:57:34 +01:00
Florian BRUNIAUX
8dd202ed1c release: v3.34.1 - dynamic OG image generation workflow 
Add og-image-generation.md workflow guide and production-ready og-image-astro.ts
template. Update stats: 218 templates, 22,800+ guide lines. Bump VERSION to 3.34.1.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 12:09:50 +01:00
Florian BRUNIAUX
2f83320bc7 docs: add OG image generation workflow + Astro template 
New workflow guide covering Satori + resvg pattern for dynamic social
preview images. Includes production template, gotchas (font format,
static file shadowing), design variants, and testing approach.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 11:53:50 +01:00
Florian BRUNIAUX
fe28f89574 feat(context): Context Engineering Configurator + consolidated guide (v3.34.0) 
New: interactive configurator at cc.bruniaux.com/context/ that generates a
personalized CLAUDE.md starter kit based on team size, stack, and current setup.
Multi-step flow (profile, current state, stack, results) with maturity scoring
(Level 1-5), copy-to-clipboard artifacts, localStorage persistence.

Guide content:
- guide/core/context-engineering.md (1,188 lines, 8 sections): context budget,
  150-instruction ceiling, modular architecture, team assembly, ACE pipeline,
  quality measurement, context reduction techniques
- examples/context-engineering/ (10 templates): assembler.ts, profile-template.yaml,
  skeleton-template.md, canary-check.sh, ci-drift-check.yml, eval-questions.yaml,
  context-budget-calculator.sh, rules/knowledge-feeding.md, rules/update-loop-retro.md
- tools/context-audit-prompt.md (543 lines): 8-dimension scoring /100

Navigation: guide/README.md, machine-readable/reference.yaml (24 new entries)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 11:18:04 +01:00
Florian BRUNIAUX
318ba915de docs(rtk): update RTK coverage from v0.16.0 to v0.28.0 
New modules: docker compose, mypy, aws, psql, cargo nextest, Graphite CLI (gt), wc.
Major features: TOML Filter DSL (declarative filters, 33+ built-in, no Rust required),
rtk rewrite single source of truth (migration note: rtk init --global after upgrade),
rtk gain -p per-project savings, rtk init --global settings.json auto-patch,
exclude_commands config, SHA-256 hook integrity.

Updated: ultimate-guide.md, third-party-tools.md, reference.yaml (version_tested bump).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 19:06:11 +01:00
Florian BRUNIAUX
2332ddcacf release: v3.33.0 — enterprise AI governance + accuracy fixes 
- New: enterprise-governance.md (1100+ lines) — org-level governance
  for teams deploying Claude Code at scale (tiers, MCP workflow, charter)
- New: 3 templates (mcp-registry.yaml, governance-enforcement-hook.sh,
  ai-usage-charter-template.md)
- Fixed: 6 accuracy issues in enterprise-governance (fabricated API,
  non-existent hooks, GNU-only date syntax, PII classification, invalid JSON)
- Docs: enriched adoption-approaches, observability, ai-traceability,
  production-safety, security-hardening
- Updated: template count 176→204, guide lines 20K→22K, quiz 274→271

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 16:02:16 +01:00
Florian BRUNIAUX
3ba824942f docs(changelog): document enterprise-governance accuracy fixes 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 15:17:01 +01:00
Florian BRUNIAUX
3832bf3c86 fix(security): correct enterprise-governance accuracy issues 
- Remove non-existent hook references from tier configs
  (dependency-guard.sh, compliance-pre-check.sh, pii-detector.sh,
  compliance-session-init.sh never existed in examples/)
- Replace compliance-audit-logger.sh in Regulated tier with session-logger.sh
- Remove all invalid JSON // comments from settings.json code blocks
- Fix fabricated CLAUDE_SETTINGS env var + claude run-headless API
  (neither exist in Claude Code) — replaced with CI pipeline check pattern
- Fix date -d syntax (GNU-only, breaks macOS) → cross-platform with OS check
- Reclassify Customer PII from CONFIDENTIAL to RESTRICTED
  (GDPR/CCPA treat PII as protected — Enterprise plan alone insufficient)
- Clarify §3.3 governance-check.sh vs governance-enforcement-hook.sh templates
- Fix org config directory listing to use real hooks only

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 11:16:58 +01:00
Florian BRUNIAUX
77b48db01b docs(security): add enterprise AI governance guide + templates 
New section for org-level Claude Code governance — fills the gap
between individual dev security (security-hardening.md) and what
engineering managers actually need when deploying at scale.

New files:
- guide/security/enterprise-governance.md (1117 lines)
  6 sections: local/shared split, usage charter, MCP approval
  workflow, 4 guardrail tiers (Starter/Standard/Strict/Regulated),
  policy enforcement at scale, SOC2/ISO27001 compliance guide
- examples/scripts/mcp-registry-template.yaml
  Org-level MCP registry with approved/pending/denied tracking
- examples/hooks/bash/governance-enforcement-hook.sh
  SessionStart hook validating MCPs against approved registry
- examples/scripts/ai-usage-charter-template.md
  Full charter template with data classification, use case rules,
  compliance mapping (SOC2/ISO27001/HIPAA/PCI DSS/GDPR)

Enriched sections:
- adoption-approaches.md: enterprise rollout (50+ devs) with
  3-phase approach and common mistakes
- observability.md: manager audit checklist, compliance reporting
- ai-traceability.md: evidence collection table for auditors
- production-safety.md + security-hardening.md: cross-references
  with explicit scope boundaries

Integration: guide/README.md, reference.yaml (22 new entries),
CHANGELOG.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 11:05:21 +01:00
Florian BRUNIAUX
b65630641b refactor(guide): restructure guide/ into thematic subdirectories 
Reorganize 22 guide files from a flat directory into 5 thematic subdirs:
- core/ (architecture, methodologies, known-issues, claude-code-releases, visual-reference)
- security/ (security-hardening, sandbox-isolation, sandbox-native, production-safety, data-privacy)
- ecosystem/ (ai-ecosystem, mcp-servers-ecosystem, third-party-tools, remarkable-ai)
- roles/ (ai-roles, adoption-approaches, learning-with-ai, agent-evaluation)
- ops/ (devops-sre, observability, ai-traceability)

All internal links updated across ~50 files (ultimate-guide.md, workflows/,
diagrams/, README.md, docs/, tools/, examples/, machine-readable/).

Also: merge search-tools-cheatsheet.md into cheatsheet.md, rewrite guide/README.md
with H2 grouped sections, update CLAUDE.md repository structure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 08:35:13 +01:00
Florian BRUNIAUX
9e789117c3 docs(readme): recap cards available in EN too 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 17:36:39 +01:00
Florian BRUNIAUX
11dadc2815 docs(readme): restore full content + apply Choose Your Path + badge updates 
Restores 780 lines deleted by commit 0d70fd8 (GEO/SEO). Applies the 5
intended changes on top: Choose Your Path H2 heading, 2 new role rows
(Developer + Career pivot), badges updated (Quiz 271, Templates 222,
Threat DB 15 vulnerabilities), resource evaluations count 84 → 115.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 17:35:45 +01:00
Florian BRUNIAUX
8f1dcecfa2 docs: update guide content, examples, tools, and reference files 
- guide/ultimate-guide.md — content updates
- guide/workflows/README.md, guide/README.md — navigation improvements
- guide/diagrams/ — diagram updates (context/sessions, config, MCP ecosystem)
- guide/third-party-tools.md — additions
- examples/README.md, hooks/README.md, scripts/README.md — examples updates
- examples/skills/pr-triage/SKILL.md — expanded skill
- machine-readable/reference.yaml — reference sync
- tools/audit-prompt.md, tools/onboarding-prompt.md — tooling updates
- docs/for-cto.md, docs/for-tech-leads.md, docs/resource-evaluations/README.md — doc updates
- .gitignore — gitignore update

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 15:32:33 +01:00
Florian BRUNIAUX
9c02214bb8 docs(roles): strengthen salary disclaimer — indicative only, US-only baseline 
Add explicit warning that figures are US base salaries (2025-2026),
Europe -30-50%, other markets -40-60%, and should be used as orientation
not negotiation anchors.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 15:28:43 +01:00
Florian BRUNIAUX
91b33aa45c docs(changelog): add GEO/SEO optimization entry [Unreleased] 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 15:16:26 +01:00