claude-code-ultimate-guide/guide
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
..
workflows docs: add AI productivity research, trust calibration, and exploration workflow 2026-01-19 19:16:33 +01:00
adoption-approaches.md feat(guide): add Production Safety Rules (v3.9.11) 2026-01-21 11:23:50 +01:00
ai-ecosystem.md feat: integrate AI Coding Agents Matrix (v3.9.8) 2026-01-20 21:03:12 +01:00
architecture.md docs: add AI productivity research, trust calibration, and exploration workflow 2026-01-19 19:16:33 +01:00
cheatsheet.md feat(guide): add Production Safety Rules (v3.9.11) 2026-01-21 11:23:50 +01:00
claude-code-releases.md feat: add Claude Code releases tracking 2026-01-18 11:33:21 +01:00
cowork.md chore: remove cowork folder after migration to dedicated repo 2026-01-20 12:16:32 +01:00
data-privacy.md docs(data-privacy): add Intellectual Property Considerations section 2026-01-15 10:41:03 +01:00
devops-sre.md feat: add DevOps & SRE Guide with FIRE Framework (v3.9.9) 2026-01-20 22:09:31 +01:00
learning-with-ai.md docs: v3.9.6 - Trust Calibration, Vibe Coding Trap, reference.yaml sync 2026-01-20 08:36:35 +01:00
methodologies.md docs: sync stats (57 templates, 9800+ lines) 2026-01-17 15:50:22 +01:00
observability.md feat(scripts): session-search v2.0 with advanced filtering 2026-01-15 09:52:54 +01:00
production-safety.md feat(guide): add Production Safety Rules (v3.9.11) 2026-01-21 11:23:50 +01:00
README.md feat: add DevOps & SRE Guide with FIRE Framework (v3.9.9) 2026-01-20 22:09:31 +01:00
security-hardening.md fix(docs): critical factual corrections v3.6.1 2026-01-15 09:16:53 +01:00
ultimate-guide.md feat(guide): add Production Safety Rules (v3.9.11) 2026-01-21 11:23:50 +01:00

Guide Documentation

Core documentation for mastering Claude Code.

Contents

File Description Time
ultimate-guide.md Complete reference covering all Claude Code features ~3 hours
claude-code-releases.md Official release history (condensed) 10 min
cheatsheet.md 1-page printable quick reference 5 min
architecture.md How Claude Code works internally (master loop, tools, context) 25 min
learning-with-ai.md Guide for juniors on using AI without losing skills 15 min
adoption-approaches.md Implementation strategies for teams 15 min
data-privacy.md Data retention and privacy guide 10 min
observability.md Session monitoring and cost tracking 15 min
methodologies.md 15 development methodologies reference (TDD, SDD, BDD, etc.) 20 min
security-hardening.md Security threats, MCP vetting, injection defense 25 min
devops-sre.md FIRE framework for infrastructure diagnosis and incident response 30 min
ai-ecosystem.md Complementary AI tools (Perplexity, Gemini, Kimi, NotebookLM) 25 min
cowork.md Claude Cowork: Summary (see dedicated repo for full docs) 5 min
workflows/ Practical workflow guides for Claude Code 30 min

Cowork Documentation

For knowledge workers using Claude Cowork (agentic desktop):

Resource Description
Cowork Hub Complete Cowork documentation
Getting Started Setup and first workflow
Capabilities What Cowork can/cannot do
Security Guide Safe usage practices
Prompt Library 50+ ready-to-use prompts
Cheatsheet 1-page quick reference

Workflows

Hands-on guides for effective development patterns:

File Description
workflows/tdd-with-claude.md Test-Driven Development with Claude
workflows/spec-first.md Spec-First Development (SDD)
workflows/plan-driven.md Using /plan mode effectively
workflows/iterative-refinement.md Iterative improvement loops
  1. New users: Start with Quick Start section in ultimate-guide.md
  2. Daily reference: Print cheatsheet.md
  3. Team leads: Read adoption-approaches.md for rollout strategies

Back to main README