fd17414abb
## New Content ### Trust & Verification (ultimate-guide.md) - Section 1.7 "Trust Calibration: When and How Much to Verify" (~155 lines) - Research-backed stats (ACM, Veracode, CodeRabbit, Cortex.io) - Verification spectrum by code type - Solo vs Team strategies with workflow diagrams - "Prove It Works" checklist - New pitfall: "Trust AI output without proportional verification" - CLAUDE.md size guideline: 4-8KB optimal, >16K degrades coherence ### AI Productivity (learning-with-ai.md) - Section "The Reality of AI Productivity" (~55 lines) - Productivity curve phases (Wow Effect → Targeted Gains → Plateau) - High-gain vs low/negative-gain task categorization - Team success factors - Productivity trajectory table by pattern (Dependent/Avoidant/Augmented) - 5 new sources (GitHub, McKinsey, Stack Overflow, Uplevel, DORA) ### Session Limits (architecture.md) - "Session Degradation Limits" section - Turn limits (15-25), token thresholds (80-100K) - Success rates by scope (1-3 files: ~85%, 8+ files: ~40%) ### Exploration Workflow - NEW: guide/workflows/exploration-workflow.md - Anti-anchoring prompts, 3-5 approaches pattern - iterative-refinement.md: Script Generation Workflow (3-7 iteration pattern) - anchor-catalog.md: Anti-Anchoring Techniques, Exploration/Iteration Prompts ### Reference Updates - adoption-approaches.md: Empirical data section - reference.yaml: New deep_dive entries, updated line numbers Sources: MetalBear engineering blog, arXiv studies, Addy Osmani (Jan 2026) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| workflows | ||
| adoption-approaches.md | ||
| ai-ecosystem.md | ||
| architecture.md | ||
| cheatsheet.md | ||
| claude-code-releases.md | ||
| cowork.md | ||
| data-privacy.md | ||
| learning-with-ai.md | ||
| methodologies.md | ||
| observability.md | ||
| README.md | ||
| security-hardening.md | ||
| ultimate-guide.md | ||
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 |
| ai-ecosystem.md | Complementary AI tools (Perplexity, Gemini, Kimi, NotebookLM) | 25 min |
| cowork.md | Claude Cowork: Agentic Desktop for Knowledge Workers | 15 min |
| workflows/ | Practical workflow guides for Claude Code | 30 min |
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 |
Recommended Reading Order
- New users: Start with Quick Start section in
ultimate-guide.md - Daily reference: Print
cheatsheet.md - Team leads: Read
adoption-approaches.mdfor rollout strategies
Back to main README