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>
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>
Add cross-references to newly created third-party-tools.md:
- guide/README.md: Add third-party-tools.md to contents table
- guide/observability.md: Add link to third-party-tools section
Related to RTK documentation integration (commit fdee330).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
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>
- 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>
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>
Add condensed release history for Claude Code product (v2.0.24 → v2.1.12)
New files:
- machine-readable/claude-code-releases.yaml: Source of truth (YAML)
- guide/claude-code-releases.md: Human-readable changelog
- scripts/update-cc-releases.sh: Check for new releases from GitHub
Modified:
- reference.yaml: Add deep_dive entries for releases
- check-landing-sync.sh: Add CC version check (#5)
- README.md, guide/README.md: Add navigation links
- CLAUDE.md: Document update workflow
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- 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>
- 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>
