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>
This commit is contained in:
Florian BRUNIAUX 2026-03-10 16:02:16 +01:00
parent 3ba824942f
commit 2332ddcacf
6 changed files with 36 additions and 34 deletions

View file

@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
## [3.33.0] - 2026-03-10
### Fixed
- **`guide/security/enterprise-governance.md` — Accuracy review pass** — 6 correctness issues fixed after adversarial critique: (1) Non-existent hooks removed from all tier `settings.json` configs (`dependency-guard.sh`, `compliance-pre-check.sh`, `pii-detector.sh`, `compliance-session-init.sh` were referenced but never existed in `examples/hooks/bash/`); (2) `compliance-audit-logger.sh` in Regulated tier replaced with real `session-logger.sh`; (3) Fabricated Claude Code API removed — `CLAUDE_SETTINGS` env var and `claude run-headless` subcommand don't exist; replaced with an honest CI pipeline validation pattern; (4) `date -d '30 days ago'` (GNU coreutils only) fixed to cross-platform with macOS/Linux `$OSTYPE` check; (5) Customer PII reclassified from CONFIDENTIAL to RESTRICTED — Enterprise plan (ZDR) alone doesn't satisfy GDPR/CCPA; (6) All `// comment` lines inside JSON code blocks removed (invalid JSON, breaks copy-paste).

View file

@ -6,9 +6,9 @@
<p align="center">
<a href="https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers"><img src="https://img.shields.io/github/stars/FlorianBruniaux/claude-code-ultimate-guide?style=for-the-badge" alt="Stars"/></a>
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_9,_2026_·_v3.32.2-brightgreen?style=for-the-badge" alt="Last Update"/></a>
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_10,_2026_·_v3.33.0-brightgreen?style=for-the-badge" alt="Last Update"/></a>
<a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-271_questions-orange?style=for-the-badge" alt="Quiz"/></a>
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-222-green?style=for-the-badge" alt="Templates"/></a>
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-204-green?style=for-the-badge" alt="Templates"/></a>
<a href="./guide/security/security-hardening.md"><img src="https://img.shields.io/badge/🛡_Threat_DB-15_vulnerabilities_·_655_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
<a href="./mcp-server/"><img src="https://img.shields.io/badge/MCP_Server-npx_ready-blueviolet?style=for-the-badge" alt="MCP Server"/></a>
</p>
@ -48,7 +48,7 @@
- ✅ **Visualize concepts** — 41 Mermaid diagrams covering model selection, master loop, memory hierarchy, multi-agent patterns, security threats, AI fluency paths
- ✅ **Master methodologies** — TDD, SDD, BDD with AI collaboration (not just templates)
- ✅ **Security mindset** — Threat modeling for AI systems (only guide with 24 CVEs + 655 malicious skills database)
- ✅ **Test your knowledge** — 274-question quiz to validate understanding (no other resource offers this)
- ✅ **Test your knowledge** — 271-question quiz to validate understanding (no other resource offers this)
**Outcome**: Go from copy-pasting configs to designing your own agentic workflows with confidence.
@ -64,9 +64,9 @@ Both guides serve different needs. Choose based on your priority.
| **Quick setup** for projects | Available but not the priority | Battle-tested production configs |
| **Learn trade-offs** (agents vs skills) | Decision frameworks + comparisons | Lists patterns, no trade-off analysis |
| **Security hardening** | Only threat database (24 CVEs) | Basic patterns only |
| **Test understanding** | 274-question quiz | Not available |
| **Test understanding** | 271-question quiz | Not available |
| **Methodologies** (TDD/SDD/BDD) | Full workflow guides | Not covered |
| **Copy-paste ready** templates | 176 templates | 200+ templates |
| **Copy-paste ready** templates | 204 templates | 200+ templates |
### Ecosystem Positioning
@ -75,7 +75,7 @@ Both guides serve different needs. Choose based on your priority.
│ ★ This Guide
│ Security + Methodologies + 20K lines
│ Security + Methodologies + 22K lines
│ [Everything-You-Need-to-Know]
│ SDLC/BMAD beginner
@ -92,8 +92,8 @@ Both guides serve different needs. Choose based on your priority.
**4 unique gaps no competitor covers:**
1. **Security-First** — 24 CVEs + 655 malicious skills tracked (no competitor has this depth)
2. **Methodology Workflows** — TDD/SDD/BDD comparison + step-by-step guides
3. **Comprehensive Reference** — 20K lines across 16 specialized guides (24× more reference material than everything-cc)
4. **Educational Progression** — 274-question quiz, beginner → expert path
3. **Comprehensive Reference** — 22K lines across 16 specialized guides (24× more reference material than everything-cc)
4. **Educational Progression** — 271-question quiz, beginner → expert path
**Recommended workflow:**
1. Learn concepts here (mental models, trade-offs, security)
@ -150,9 +150,9 @@ claude "Use the claude-code-guide MCP server. Activate the claude-code-expert pr
graph LR
root[📦 Repository<br/>Root]
root --> guide[📖 guide/<br/>20K lines]
root --> examples[📋 examples/<br/>176 templates]
root --> quiz[🧠 quiz/<br/>274 questions]
root --> guide[📖 guide/<br/>22K lines]
root --> examples[📋 examples/<br/>204 templates]
root --> quiz[🧠 quiz/<br/>271 questions]
root --> tools[🔧 tools/<br/>utils]
root --> machine[🤖 machine-readable/<br/>AI index]
root --> docs[📚 docs/<br/>115 evaluations]
@ -172,7 +172,7 @@ graph LR
```
📦 claude-code-ultimate-guide/
├─ 📖 guide/ Core Documentation (20K+ lines)
├─ 📖 guide/ Core Documentation (22K+ lines)
│ ├─ ultimate-guide.md Complete reference, 10 sections
│ ├─ cheatsheet.md 1-page printable
│ ├─ architecture.md How Claude Code works internally
@ -182,14 +182,14 @@ graph LR
│ ├─ mcp-servers-ecosystem.md Official & community MCP servers
│ └─ workflows/ Step-by-step guides
├─ 📋 examples/ 176 Production Templates
├─ 📋 examples/ 204 Production Templates
│ ├─ agents/ 9 custom AI personas
│ ├─ commands/ 26 slash commands
│ ├─ hooks/ 31 hooks (bash + PowerShell)
│ ├─ skills/ 14 skills (9 on SkillHub)
│ └─ scripts/ Utility scripts (audit, search)
├─ 🧠 quiz/ 274 Questions
├─ 🧠 quiz/ 271 Questions
│ ├─ 9 categories Setup, Agents, MCP, Trust, Advanced...
│ ├─ 4 profiles Junior, Senior, Power User, PM
│ └─ Instant feedback Doc links + score tracking
@ -240,7 +240,7 @@ graph LR
[Browse all 41 diagrams →](./guide/diagrams/)
**What this means for you**: Understand the master loop before reading 20K lines, see multi-agent topologies at a glance, share visual security threat models with your team.
**What this means for you**: Understand the master loop before reading 22K lines, see multi-agent topologies at a glance, share visual security threat models with your team.
---
@ -259,7 +259,7 @@ graph LR
---
### 📝 274-Question Knowledge Validation (Unique in Ecosystem)
### 📝 271-Question Knowledge Validation (Unique in Ecosystem)
**Outcome**: Verify your understanding + identify knowledge gaps.
@ -303,7 +303,7 @@ Complete guides with rationale and examples:
---
### 📚 176 Annotated Templates
### 📚 204 Annotated Templates
**Outcome**: Learn patterns, not just configs.
@ -747,7 +747,7 @@ Use this guide critically. Experiment. Share what works for you.
| **[Claude Code Releases](./guide/core/claude-code-releases.md)** | Official release history | 10 min |
<details>
<summary><strong>Examples Library</strong> (176 templates)</summary>
<summary><strong>Examples Library</strong> (204 templates)</summary>
**Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) ⭐
@ -770,7 +770,7 @@ Use this guide critically. Experiment. Share what works for you.
</details>
<details>
<summary><strong>Knowledge Quiz</strong> (274 questions)</summary>
<summary><strong>Knowledge Quiz</strong> (271 questions)</summary>
Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.
@ -867,12 +867,12 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
### Tools
- [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide
- [Interactive Quiz](./quiz/) — 274 questions
- [Interactive Quiz](./quiz/) — 271 questions
- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation
---
*Version 3.32.2 | Updated daily · Mar 9, 2026 | Crafted with Claude*
*Version 3.33.0 | Updated daily · Mar 10, 2026 | Crafted with Claude*
<!-- SEO Keywords -->
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,

View file

@ -1 +1 @@
3.32.2
3.33.0

View file

@ -12,7 +12,7 @@ tags: [cheatsheet, reference]
**Written with**: Claude (Anthropic)
**Version**: 3.32.2 | **Last Updated**: February 2026
**Version**: 3.33.0 | **Last Updated**: February 2026
---
@ -638,4 +638,4 @@ Speed: `rg` (~20ms) → Serena (~100ms) → ast-grep (~200ms) → grepai (~500ms
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
*Last updated: February 2026 | Version 3.32.2*
*Last updated: February 2026 | Version 3.33.0*

View file

@ -16,7 +16,7 @@ tags: [guide, reference, workflows, agents, hooks, mcp, security]
**Last updated**: January 2026
**Version**: 3.32.2
**Version**: 3.33.0
---
@ -5034,7 +5034,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin
| Personal preferences | `CLAUDE.md` | ❌ Gitignore |
| Personal permissions | `settings.local.json` | ❌ Gitignore |
### 3.32.2 Version Control & Backup
### 3.33.0 Version Control & Backup
**Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers.
@ -22810,4 +22810,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
**Contributions**: Issues and PRs welcome.
**Last updated**: January 2026 | **Version**: 3.32.2
**Last updated**: January 2026 | **Version**: 3.33.0

View file

@ -3,7 +3,7 @@
# Source: guide/ultimate-guide.md
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
version: "3.32.2"
version: "3.33.0"
updated: "2026-03-03"
# ════════════════════════════════════════════════════════════════
@ -1510,7 +1510,7 @@ ecosystem:
- "Cross-links modified → Update all 4 repos"
history:
- date: "2026-01-20"
event: "Code Landing sync v3.32.2, 66 templates, cross-links"
event: "Code Landing sync v3.33.0, 66 templates, cross-links"
commit: "5b5ce62"
- date: "2026-01-20"
event: "Cowork Landing fix (paths, README, UI badges)"
@ -1522,7 +1522,7 @@ ecosystem:
onboarding_matrix_meta:
version: "2.1.0"
last_updated: "2026-03-09"
aligned_with_guide: "3.32.2"
aligned_with_guide: "3.33.0"
changelog:
- version: "2.1.0"
date: "2026-03-09"
@ -1553,7 +1553,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, commands]
time_budget: "5 min"
topics_max: 3
note: "SECURITY FIRST - sandbox before commands (v3.32.2 critical fix)"
note: "SECURITY FIRST - sandbox before commands (v3.33.0 critical fix)"
beginner_15min:
core: [rules, sandbox_native_guide, workflow, essential_commands]
@ -1642,7 +1642,7 @@ onboarding_matrix:
- default: agent_validation_checklist
time_budget: "60 min"
topics_max: 6
note: "Dual-instance pattern for quality workflows (v3.32.2)"
note: "Dual-instance pattern for quality workflows (v3.33.0)"
learn_security:
intermediate_30min:
@ -1653,7 +1653,7 @@ onboarding_matrix:
- default: permission_modes
time_budget: "30 min"
topics_max: 4
note: "NEW goal (v3.32.2) - Security-focused learning path"
note: "NEW goal (v3.33.0) - Security-focused learning path"
power_60min:
core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@ -1678,7 +1678,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
time_budget: "60 min"
topics_max: 6
note: "Security foundation + core workflow (v3.32.2 sandbox added)"
note: "Security foundation + core workflow (v3.33.0 sandbox added)"
intermediate_120min:
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]