marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/machine-readable/reference.yaml
Florian BRUNIAUX 2195622b50 release: v3.29.2 - /simplify + /batch commands documentation 
Added dedicated sections for the two bundled slash commands
introduced in Claude Code v2.1.63: /simplify (over-engineering
detection) and /batch (batch processing). Built-in Commands
table updated in §1.3 and §6.1.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-02 17:30:58 +01:00

1655 lines
96 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# claude-code-reference.yaml
# Quick lookup for Claude Code - comprehensive index
# Source: guide/ultimate-guide.md
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
version: "3.29.2"
updated: "2026-02-26"
# ════════════════════════════════════════════════════════════════
# DEEP DIVE - Line numbers in guide/ultimate-guide.md
# Usage: Read file at line N for detailed documentation on topic
# For architecture internals, see guide/architecture.md
# ════════════════════════════════════════════════════════════════
deep_dive:
# Visual Diagrams Series (40 Mermaid diagrams)
mermaid_diagrams:
path: "guide/diagrams/"
description: "41 interactive Mermaid diagrams: model selection, agent lifecycle, memory hierarchy, security threats, multi-agent patterns, AI fluency paths"
files: 10
total_diagrams: 40
# AI-Assisted Development Workflows (from MetalBear/arXiv research)
exploration_workflow: "guide/workflows/exploration-workflow.md"
script_generation: "guide/workflows/iterative-refinement.md:200"
anti_anchoring_prompts: "examples/semantic-anchors/anchor-catalog.md:248"
session_limits: "guide/architecture.md:442"
claudemd_sizing: 3054
scope_success_rates: "guide/adoption-approaches.md:26"
# Claude Code Releases
claude_code_releases: "guide/claude-code-releases.md"
claude_code_releases_yaml: "machine-readable/claude-code-releases.yaml"
# Code Review Automation (Pat Cullen, Jan 2026)
review_pr_advanced: "examples/commands/review-pr.md:81"
review_anti_hallucination: "examples/agents/code-reviewer.md:77"
review_auto_fix_loop: "guide/workflows/iterative-refinement.md:353"
# Review Plan Command (Garry Tan-inspired, Feb 2026)
review_plan_command: "examples/commands/review-plan.md"
# GitHub Actions: Prompt-Based Code Review (Feb 2026)
github_actions_code_review_workflow: "examples/github-actions/claude-code-review.yml"
github_actions_code_review_prompt: "examples/github-actions/prompts/code-review.md"
github_actions_code_review_pattern: "externalized prompt + anti-hallucination protocol + /claude-review on-demand trigger"
github_actions_code_review_tools: "Read, Glob, Grep + GitHub PR inspection (read-only)"
github_actions_code_review_auth: "OAuth token (Claude Max plan, 0$ API) or ANTHROPIC_API_KEY"
github_actions_cost_per_review: "0$ with OAuth/Max plan; ~0.05-0.15$ with API key (Sonnet, ~5K tokens diff)"
# Rules Templates (auto-loaded .claude/rules/)
rules_templates_directory: "examples/rules/"
rules_architecture_review: "examples/rules/architecture-review.md"
rules_code_quality_review: "examples/rules/code-quality-review.md"
rules_test_review: "examples/rules/test-review.md"
rules_performance_review: "examples/rules/performance-review.md"
# Team Configuration at Scale (Profile-Based Module Assembly)
team_ai_instructions_section: "guide/ultimate-guide.md#35-team-configuration-at-scale"
team_ai_instructions_workflow: "guide/workflows/team-ai-instructions.md"
team_ai_instructions_profile_template: "examples/team-config/profile-template.yaml"
team_ai_instructions_skeleton: "examples/team-config/claude-skeleton.md"
team_ai_instructions_sync_script: "examples/team-config/sync-script.ts"
team_ai_instructions_pattern: "profiles YAML + shared modules + skeleton + assembler script"
team_ai_instructions_problem: "N devs × M tools × P OS = fragmented AI instructions"
team_ai_instructions_token_savings: "59% context token reduction (measured, 5-dev team)"
team_ai_instructions_threshold: "Team 5+ devs with multiple AI tools"
# Known Issues & Critical Bugs (verified community reports)
known_issues: "guide/known-issues.md"
known_issues_github_bug: "guide/known-issues.md:7" # GitHub auto-creation bug
known_issues_token_consumption: "guide/known-issues.md:105" # Excessive token usage
known_issues_model_quality_aug2025: "guide/known-issues.md:197" # Resolved: Aug 2025 degradation
# Template Installation
install_templates_script: "scripts/install-templates.sh"
# Session management
session_search: "guide/observability.md:38"
session_search_script: "examples/scripts/session-search.sh"
cc_sessions_script: "examples/scripts/cc-sessions.py"
session_resume_limitations: "guide/observability.md:126"
session_cross_folder_migration: "guide/observability.md:126"
session_migration_manual: "guide/observability.md:126"
session_migration_risks: "guide/observability.md:126"
session_migration_community_tool: "guide/observability.md:52"
session_migration_issue: "https://github.com/anthropics/claude-code/issues/1516"
session_migration_weller_skill: "https://github.com/jimweller/dotfiles/tree/main/dotfiles/claude-code/skills/claude-migrate-session"
# Activity monitoring
activity_monitoring: "guide/observability.md:467" # Tool call audit via JSONL
activity_monitoring_queries: "guide/observability.md:467" # jq queries for audit
activity_monitoring_alerts: "guide/observability.md:467" # Sensitive pattern detection
external_monitoring_tools: "guide/observability.md:527" # ccusage, claude-code-otel, Akto, MLflow, ccboard
proxying_claude_code: "guide/observability.md:699" # Proxyman, mitmproxy, ANTHROPIC_API_URL
ccboard_activity_plan: "docs/resource-evaluations/ccboard-activity-module-plan.md"
# Cost optimization - Local execution bridge
bridge_script: "examples/scripts/bridge.py"
bridge_schema: "examples/scripts/bridge-plan-schema.json"
bridge_guide: "guide/ultimate-guide.md:20003"
# Cost optimization - RTK (Rust Token Killer)
rtk_upstream: "https://github.com/rtk-ai/rtk"
rtk_website: "https://www.rtk-ai.app/"
rtk_evaluation: "docs/resource-evaluations/rtk-evaluation.md"
rtk_guide: "guide/ultimate-guide.md:14553"
rtk_third_party: "guide/third-party-tools.md:7"
rtk_claude_md: "examples/claude-md/rtk-optimized.md"
rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh"
rtk_purpose: "Command output filtering before LLM context (60-90% avg reduction)"
rtk_version_tested: "v0.16.0"
rtk_score: "5/5"
rtk_installation: "cargo install rtk or brew install rtk-ai/tap/rtk"
# Google Antigravity (Agent-First IDE)
antigravity_guide: "guide/ai-ecosystem.md:1366"
antigravity_evaluation: "docs/resource-evaluations/google-antigravity-evaluation.md"
antigravity_proxy: "https://www.npmjs.com/package/antigravity-claude-proxy"
antigravity_codelabs: "https://codelabs.developers.google.com/getting-started-google-antigravity"
antigravity_vs_claude: "Claude Code = terminal-first predictability; Antigravity = agent-first autonomy"
# PDF Generation
pdf_generation: "guide/workflows/pdf-generation.md"
pdf_generator_skill: "examples/skills/pdf-generator.md"
# Talk Preparation Pipeline (6-stage: extract → research → concepts → position → script → revision)
talk_pipeline_workflow: "guide/workflows/talk-pipeline.md"
talk_pipeline_skills: "examples/skills/talk-pipeline/"
talk_pipeline_orchestrator: "examples/skills/talk-pipeline/orchestrator/SKILL.md"
talk_pipeline_stage1: "examples/skills/talk-pipeline/stage-1-extract/SKILL.md"
talk_pipeline_stage2: "examples/skills/talk-pipeline/stage-2-research/SKILL.md"
talk_pipeline_stage3: "examples/skills/talk-pipeline/stage-3-concepts/SKILL.md"
talk_pipeline_stage4: "examples/skills/talk-pipeline/stage-4-position/SKILL.md"
talk_pipeline_stage5: "examples/skills/talk-pipeline/stage-5-script/SKILL.md"
talk_pipeline_stage6: "examples/skills/talk-pipeline/stage-6-revision/SKILL.md"
talk_pipeline_kimi_template: "examples/skills/talk-pipeline/stage-5-script/templates/kimi-prompt-template.md"
talk_pipeline_feedback_template: "examples/skills/talk-pipeline/stage-4-position/templates/feedback-draft.md"
talk_pipeline_modes: "REX (git archaeology) | Concept (skip stage 2)"
talk_pipeline_outputs: "13-14 files REX mode, 10 files Concept mode"
talk_pipeline_patterns: "skill chaining + file-based state + tool permission scoping + human-in-the-loop gate + AI-to-AI handoff (Claude → Kimi)"
talk_pipeline_checkpoint: "Stage 4 CHECKPOINT: user selects angle + title before script starts"
talk_pipeline_kimi: "kimi.com (free) — copy-paste Stage 5 prompt for AI slide generation"
# reMarkable 2 + AI (guide/remarkable-ai.md)
remarkable_ai_guide: "guide/remarkable-ai.md"
remarkable_mcp_server: "guide/remarkable-ai.md#1-remarkable-mcp--le-game-changer"
remarkable_mcp_repo: "https://github.com/SamMorrowDrums/remarkable-mcp"
remarkable_ghostwriter: "guide/remarkable-ai.md#2-ghostwriter--interface-vision-llm"
remarkable_obsidian_sync: "guide/remarkable-ai.md#3-sync-remarkable--obsidian"
remarkable_ocr_pipeline: "guide/remarkable-ai.md#4-ocr--ai-pipeline-custom"
remarkable_ssh_tools: "guide/remarkable-ai.md#5-accès-ssh-et-outils-communautaires"
remarkable_meeting_workflow: "guide/remarkable-ai.md#10-meeting-notes--ai-summary"
remarkable_workflows_to_build: "guide/remarkable-ai.md#14-workflows-ai-augmentés-à-construire"
remarkable_getting_started: "guide/remarkable-ai.md#15-par-où-commencer"
remarkable_community: "https://github.com/reHackable/awesome-reMarkable"
# Whitepapers (FR + EN) — 9 focused whitepapers on Claude Code
whitepapers_url: "https://www.florian.bruniaux.com/guides"
whitepapers_fr: "whitepapers/fr/" # FR sources (Quarto .qmd)
whitepapers_en: "whitepapers/en/" # EN sources (Quarto .qmd)
whitepapers_topics: "foundations, prompting, customization, security, architecture, team, privacy, reference, agent-teams"
# Learning with AI (guide/learning-with-ai.md)
learning_quick_check: "guide/learning-with-ai.md:38"
learning_uval_protocol: "guide/learning-with-ai.md:218"
learning_claude_config: "guide/learning-with-ai.md:458"
learning_breaking_dependency: "guide/learning-with-ai.md:575"
learning_embracing_ai: "guide/learning-with-ai.md:623"
learning_30day_plan: "guide/learning-with-ai.md:815"
learning_red_flags: "guide/learning-with-ai.md:612"
# Productivity Research RCTs
productivity_rct_metr: "guide/learning-with-ai.md:925" # METR 2025: experienced devs 19% slower on large codebases despite perceiving 20% faster
productivity_rct_echoes: "guide/learning-with-ai.md:926" # Borg 2025: 30.7% faster (median), ~55.9% habitual users, no maintainability impact downstream
productivity_maintainability_empirical: "guide/learning-with-ai.md:926" # Empirical data on "AI code is unmaintainable" claim — blind RCT shows no significant difference
trust_calibration_maintainability_nuance: "guide/ultimate-guide.md:1097" # Nuance: defect rates ≠ maintenance burden (Borg et al. 2025)
learning_mode_template: "examples/claude-md/learning-mode.md"
learn_quiz_command: "examples/commands/learn/quiz.md"
learn_teach_command: "examples/commands/learn/teach.md"
learn_alternatives_command: "examples/commands/learn/alternatives.md"
learning_capture_hook: "examples/hooks/bash/learning-capture.sh"
# Anti-patterns
vibe_coding_trap: "guide/learning-with-ai.md:87"
vibe_coding_context_overload: 13097
vibe_coding_context_overload_source: "Jens Rusitschka, 'Vibe Coding, Level 2' (Jan 2026)"
vibe_coding_phased_strategy: 13097
# AI Traceability & Attribution (guide/ai-traceability.md) - Added 2026-01-24
ai_traceability_guide: "guide/ai-traceability.md"
ai_traceability_why: "guide/ai-traceability.md:29"
ai_traceability_disclosure_spectrum: "guide/ai-traceability.md:64"
ai_traceability_co_authored_by: "guide/ai-traceability.md:98"
ai_traceability_assisted_by: "guide/ai-traceability.md:120"
ai_traceability_git_ai: "guide/ai-traceability.md:170"
ai_traceability_llvm_policy: "guide/ai-traceability.md:201"
ai_traceability_ghostty_policy: "guide/ai-traceability.md:236"
ai_traceability_fedora_policy: "guide/ai-traceability.md:261"
ai_traceability_promptpwnd: "guide/ai-traceability.md:501"
ai_traceability_implementation: "guide/ai-traceability.md:566"
ai_traceability_templates: "guide/ai-traceability.md:648"
# AI Disclosure Templates
ai_disclosure_contributing: "examples/config/CONTRIBUTING-ai-disclosure.md"
ai_disclosure_pr_template: "examples/config/PULL_REQUEST_TEMPLATE-ai.md"
# TTS Integration (Agent Vibes) - Added 2026-01-22
tts_integration_guide: "examples/integrations/agent-vibes/README.md"
tts_installation: "examples/integrations/agent-vibes/installation.md"
tts_voice_catalog: "examples/integrations/agent-vibes/voice-catalog.md"
tts_troubleshooting: "examples/integrations/agent-vibes/troubleshooting.md"
tts_workflow: "guide/workflows/tts-setup.md"
tts_ai_ecosystem: "guide/ai-ecosystem.md:1124"
tts_hook_example: "examples/hooks/bash/tts-selective.sh"
tts_claude_md_template: "examples/claude-md/tts-enabled.md"
# Sandbox Isolation for Coding Agents (guide/sandbox-isolation.md) - Added 2026-01-31
sandbox_isolation_guide: "guide/sandbox-isolation.md"
sandbox_isolation_decision_tree: "guide/sandbox-isolation.md:7"
sandbox_docker_sandboxes: "guide/sandbox-isolation.md:67"
sandbox_docker_network: "guide/sandbox-isolation.md:121"
sandbox_docker_templates: "guide/sandbox-isolation.md:165"
sandbox_docker_docs: "https://docs.docker.com/ai/sandboxes/"
sandbox_docker_claude_config: "https://docs.docker.com/ai/sandboxes/claude-code/"
sandbox_docker_network_docs: "https://docs.docker.com/ai/sandboxes/network-policies/"
sandbox_docker_templates_docs: "https://docs.docker.com/ai/sandboxes/templates/"
sandbox_flyio_sprites: "https://sprites.dev"
sandbox_cloudflare_sdk: "https://developers.cloudflare.com/sandbox/tutorials/claude-code/"
sandbox_vercel: "https://vercel.com/docs/vercel-sandbox/"
sandbox_e2b: "https://e2b.dev"
sandbox_native_cc: "guide/architecture.md:606"
# Native Claude Code Sandbox (Official docs, v2.1.0+) - Added 2026-02-02
sandbox_native_guide: "guide/sandbox-native.md"
sandbox_native_why: "guide/sandbox-native.md:47" # Why Native Sandboxing
sandbox_native_os_primitives: "guide/sandbox-native.md:68" # Seatbelt vs bubblewrap
sandbox_native_filesystem: "guide/sandbox-native.md:178" # Filesystem isolation
sandbox_native_network: "guide/sandbox-native.md:221" # Network proxy architecture
sandbox_native_modes: "guide/sandbox-native.md:7" # Auto-allow vs Regular
sandbox_native_escape_hatch: "guide/sandbox-native.md:341" # dangerouslyDisableSandbox
sandbox_native_security_limits: "guide/sandbox-native.md:396" # Domain fronting, Unix sockets
sandbox_native_opensource: "guide/sandbox-native.md:481" # Open-source runtime
sandbox_native_platforms: "guide/sandbox-native.md:505" # Platform support
sandbox_native_decision_tree: "guide/sandbox-native.md:517" # Native vs Docker
sandbox_native_config_examples: "guide/sandbox-native.md:564" # Configuration examples
sandbox_native_best_practices: "guide/sandbox-native.md:637" # Best practices
sandbox_native_troubleshooting: "guide/sandbox-native.md:650" # Troubleshooting
sandbox_runtime_oss: "https://github.com/anthropic-experimental/sandbox-runtime"
sandbox_runtime_npm: "https://www.npmjs.com/package/@anthropic-ai/sandbox-runtime"
sandbox_official_docs: "https://code.claude.com/docs/en/sandboxing"
sandbox_comparison_native_docker: "guide/sandbox-isolation.md:238" # Section 4 Native CC
sandbox_native_evaluation: "docs/resource-evaluations/native-sandbox-official-docs.md"
sandbox_native_score: "5/5"
# Templates (Added 2026-02-02)
sandbox_native_config_template: "examples/config/sandbox-native.json"
sandbox_status_command: "examples/commands/sandbox-status.md"
sandbox_validation_hook: "examples/hooks/bash/sandbox-validation.sh"
# Docker Sandboxes (existing)
sandbox_evaluation: "docs/resource-evaluations/docker-sandboxes-isolation.md"
sandbox_safe_autonomy: "guide/sandbox-isolation.md:496" # Safe Autonomy Workflows
sandbox_anti_patterns: "guide/sandbox-isolation.md:546" # Anti-Patterns
sandbox_comparison_matrix: "guide/sandbox-isolation.md:477" # Comparison Matrix
sandbox_score: "4/5"
# Third-Party Tools (guide/third-party-tools.md) - Added 2026-02-01
third_party_tools_guide: "guide/third-party-tools.md"
third_party_tools_cost_tracking: "guide/third-party-tools.md:42"
third_party_tools_rtk: "guide/third-party-tools.md:7"
third_party_tools_session_mgmt: "guide/third-party-tools.md:126"
third_party_tools_config_mgmt: "guide/third-party-tools.md:214"
third_party_tools_alternative_uis: "guide/third-party-tools.md:259"
third_party_tools_known_gaps: "guide/third-party-tools.md:375"
third_party_tools_recommendations: "guide/third-party-tools.md:391"
third_party_ccusage: "https://www.npmjs.com/package/ccusage"
third_party_ccusage_site: "https://ccusage.com"
third_party_ccburn: "https://github.com/JuanjoFuchs/ccburn"
third_party_claude_code_viewer: "https://www.npmjs.com/package/@kimuson/claude-code-viewer"
third_party_claude_code_config: "https://github.com/joeyism/claude-code-config"
third_party_aiblueprint: "https://github.com/Melvynx/aiblueprint"
third_party_claude_chic: "https://pypi.org/project/claudechic/"
third_party_toad: "https://github.com/batrachianai/toad"
third_party_conductor: "https://docs.conductor.build"
# Configuration Management & Backup (Added 2026-02-02)
config_management_guide: "guide/ultimate-guide.md:4217" # Section 3.1 Memory Files
config_hierarchy: "guide/ultimate-guide.md:4336" # Global → Project → Local precedence
config_git_strategy_project: "guide/ultimate-guide.md:4634" # What Goes Where
config_git_strategy_global: "guide/ultimate-guide.md:4634" # Version control ~/.claude/
config_backup_strategies: "guide/ultimate-guide.md:4634" # Git, cloud sync, cron
config_multi_machine_sync: "guide/ultimate-guide.md:4634" # Laptop + desktop workflows
config_security_considerations: "guide/ultimate-guide.md:4419" # CLAUDE.md Injection warning
config_disaster_recovery: "guide/ultimate-guide.md:4634" # Restore from backup
config_community_solutions: "guide/ultimate-guide.md:4634" # brianlovin + Ratinaud
config_github_issue: "https://github.com/anthropics/claude-code/issues/16204" # Migration guidance request
config_brianlovin_repo: "https://github.com/brianlovin/claude-config" # Community example with sync.sh
config_ratinaud_approach: "https://www.linkedin.com/posts/martinratinaud_claudecode-devtools-buildinpublic-activity-7424055660247629824-hBsL" # 504 sessions tested
config_ratinaud_evaluation: "docs/resource-evaluations/ratinaud-config-management-evaluation.md" # Full evaluation
# MCP Secrets Management (Added 2026-02-02)
mcp_secrets_management: "guide/ultimate-guide.md:10589" # Section 8.3.1
mcp_secrets_principles: "guide/ultimate-guide.md:10589" # Security principles
mcp_secrets_os_keychain: "guide/ultimate-guide.md:10589" # Approach 1: OS Keychain
mcp_secrets_env_file: "guide/ultimate-guide.md:10589" # Approach 2: .env + .gitignore
mcp_secrets_vaults: "guide/ultimate-guide.md:10589" # Approach 3: HashiCorp Vault, AWS, 1Password
mcp_secrets_rotation: "guide/ultimate-guide.md:10589" # Rotation workflow
mcp_secrets_pre_commit: "guide/ultimate-guide.md:8417" # Security Hooks section
mcp_secrets_verification: "guide/ultimate-guide.md:10589" # Verification checklist
mcp_secrets_best_practices: "guide/ultimate-guide.md:10589" # Summary table
# Templates & Scripts (Configuration Management)
sync_claude_config_script: "examples/scripts/sync-claude-config.sh" # Full automation script
pre_commit_secrets_hook: "examples/hooks/bash/pre-commit-secrets.sh" # Git hook for secret detection
settings_local_example: "examples/config/settings.local.json.example" # Machine-specific overrides template
# Tool-qualified deny format (Added 2026-02-26)
permissions_deny_tool_qualified: "guide/ultimate-guide.md:5008" # Permission Patterns table + full example
# Terminal personalization (Added 2026-02-27)
spinner_personalization: "guide/ultimate-guide.md:4978" # spinnerVerbs + spinnerTipsOverride settings
permissions_deny_tool_qualified_syntax: "Read(file_path:*.env*) | Edit(file_path:*.pem) | Write(file_path:*.key) | Bash(command:*rm -rf*)"
permissions_deny_tool_qualified_vs_simple: "file_path: glob matches full path arg; simple '*.env' matches filename only"
permissions_deny_known_limitation: "background indexing may expose via system reminders before checks — GitHub #4160"
permissions_deny_defense_in_depth: "store secrets outside project dir for guaranteed protection"
# Visual Reference (ASCII diagrams)
visual_reference: "guide/visual-reference.md"
# Architecture internals (guide/architecture.md)
architecture_visual_overview: "guide/architecture.md:51"
architecture_visual_source: "https://www.linkedin.com/posts/mohamed-ali-ben-salem-2b777b9a_en-ce-moment-je-vois-passer-des-posts-du-activity-7420592149110362112-eY5a"
architecture_master_loop: "guide/architecture.md:82"
architecture_tools: "guide/architecture.md:219"
architecture_context: "guide/architecture.md:312"
architecture_subagents: "guide/architecture.md:471"
architecture_permissions: "guide/architecture.md:541"
architecture_mcp: "guide/architecture.md:746"
architecture_mcp_visual: "guide/images/mcp-architecture-diagram.svg"
architecture_philosophy: "guide/architecture.md:1205"
# Official LLM-Optimized Documentation - Added 2026-02-25
official_llms_index: "https://code.claude.com/docs/llms.txt" # Index ~65 pages, ~15-20K tokens — use first for discovery
official_llms_full: "https://code.claude.com/docs/llms-full.txt" # Full doc ~98KB, ~25-30K tokens — source de vérité officielle
# System Prompts (Official Sources) - Added 2026-01-26
system_prompts_official: "https://platform.claude.com/docs/en/release-notes/system-prompts"
system_prompts_willison_analysis: "https://simonwillison.net/2025/May/25/claude-4-system-prompt/"
system_prompts_prompthub: "https://www.prompthub.us/blog/an-analysis-of-the-claude-4-system-prompt"
system_prompts_architecture: "guide/architecture.md:360"
# MCP Apps Extension (SEP-1865) - Added 2026-01-27
mcp_apps_architecture: "guide/architecture.md:753"
mcp_apps_evolution: "guide/ultimate-guide.md:9252"
mcp_apps_spec: "https://github.com/modelcontextprotocol/ext-apps"
mcp_apps_blog_mcp: "https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/"
mcp_apps_blog_claude: "https://claude.com/blog/interactive-tools-in-claude"
mcp_apps_sdk: "https://www.npmjs.com/package/@modelcontextprotocol/ext-apps"
mcp_apps_announcement_date: "2026-01-26"
mcp_apps_cli_relevance: "Indirect (ecosystem understanding, MCP server dev, hybrid workflows)"
# Main guide (guide/ultimate-guide.md) - Updated 2026-01-27
installation: 221
first_workflow: 305
essential_commands: 47
trust_calibration: 1039
working_with_images: 450
wireframing_tools: 520
figma_mcp: 569
image_optimization: 594
permission_modes: 818
interaction_loop: 1364
context_management: 1335
context_triage: 1520
session_vs_memory: 1553
fresh_context_pattern: 1597
subscription_limits: 1933
subscription_token_budgets: 1948
subscription_opus_ratio: 1946
subscription_monitoring: 2113
plan_mode: 576
rewind: 2566
mental_model: 2815
xml_prompting: 3016
prompting_provocation: 3469
prompting_provocation_source: "https://paddo.dev/blog/claude-code-team-tips/"
semantic_anchors: 3503
semantic_anchors_catalog: "examples/semantic-anchors/anchor-catalog.md"
memory_files: 4205
# Auto-Memories (v2.1.32+) - Added 2026-02-09
auto_memories: 4439
auto_memories_vs_claudemd: 4439
# Fast Mode (v2.1.36+) - Added 2026-02-09
fast_mode_command: 720 # /fast in commands table
fast_mode_api: 720 # API breaking changes section
fast_mode_pricing: 1788 # Pricing table
fast_mode_behavior: "2.5x faster, 6x price, same Opus 4.6 model"
# Sonnet 4.6 + 1M Context (Feb 2026) - Added 2026-02-18
sonnet_4_6_default: 1887 # Pricing table, Sonnet 4.6 now default
context_200k_vs_1m: 1793 # Decision guide: 200K vs 1M context window
context_200k_vs_1m_perf: "Opus 4.6: 93% @ 256K, 76% @ 1M (MRCR v2). Sonnet 4.6 scores not yet published."
context_200k_vs_1m_cost: "Sonnet 4.6: ~$0.23 bug fix, ~$0.75 module refactor, ~$2.25 full 1M session"
context_1m_beta_requirement: "API only, requires anthropic-beta header. Opus: pricing doubles >200K."
# Debug Command (v2.1.30+) - Added 2026-02-09
debug_command: 47 # Essential Commands table
debug_purpose: "Systematic troubleshooting and error investigation"
# Model Selection & Thinking Guide (Section 2.5) - Added 2026-02-21
model_selection_guide: 2704 # Section 2.5 — canonical table, effort levels, agent patterns
model_selection_anchor: "#25-model-selection--thinking-guide"
# Configuration Decision Guide (Section 2.7) - Added 2026-02-22
configuration_decision_guide: 2872 # Section 2.7 — mechanism comparison, decision tree, 56% warning
configuration_decision_guide_anchor: "#27-configuration-decision-guide"
mechanism_comparison_table: 2960 # Semantic roles + mechanism comparison tables
fifty_six_percent_warning: 2955 # Section 2.7 Configuration Decision Guide
planner_agent: "examples/agents/planner.md"
implementer_agent: "examples/agents/implementer.md"
architecture_reviewer_agent: "examples/agents/architecture-reviewer.md"
# Opus 4.6 Features (Feb 2026) - Added 2026-02-09, line numbers updated 2026-02-21
opus_4_6_adaptive_thinking: 11622
opus_4_6_effort_parameter: 11636
opus_4_6_pricing: 1788
opus_4_6_api_breaking_changes: 11734
opus_4_6_assistant_prefill_removed: 11737
# Summarize from Here (v2.1.32+) - Added 2026-02-09
summarize_from_here: 1506 # Context Recovery Strategies section
# Agent Teams Hook Events (v2.1.32+) - Added 2026-02-09
hook_teammate_idle: 7934
hook_task_completed: 7935
# Agent Memory Field (v2.1.32+) - Added 2026-02-09
agent_memory_frontmatter: 5636 # Agent Template section (memory field in frontmatter)
# Xcode Integration (Feb 2026) - Added 2026-02-09
xcode_integration: 12556
claude_agent_sdk: 12558
# Task Management System (v2.1.16+) - Added 2026-01-26
task_management_system: 3726
task_management_comparison: 3732
tasks_api_overview: 973
tasks_api_tools: 3746
tasks_api_capabilities: 3752
tasks_api_configuration: 3759
tasks_api_schema: 3773
tasks_api_when_to_use: 3790
tasks_api_limitations: 3796
tasks_api_field_visibility: "TaskList: id/subject/status/owner/blockedBy only. TaskGet: all fields."
tasks_api_cost_overhead: "Reviewing N task descriptions = 1 + N API calls"
tasks_api_workarounds: 3819
todowrite_legacy: 3837
todowrite_when_to_use: 3846
todowrite_migration_flag: 3855
task_best_practices: 3862
task_hierarchy_design: 3726
task_dependency_management: 3726
task_status_transitions: 3756
task_metadata_conventions: 3757
task_complete_workflow: 3947
task_sources: 3835
# Task Management Workflow (guide/workflows/task-management.md)
workflows_task_management: "guide/workflows/task-management.md"
task_workflow_overview: "guide/workflows/task-management.md:15"
task_workflow_planning: "guide/workflows/task-management.md:52"
task_workflow_execution: "guide/workflows/task-management.md:137"
task_workflow_session_mgmt: "guide/workflows/task-management.md:215"
task_workflow_tdd_integration: "guide/workflows/task-management.md:312"
task_workflow_plan_integration: "guide/workflows/task-management.md:367"
task_workflow_migration: "guide/workflows/task-management.md:439"
task_workflow_patterns: "guide/workflows/task-management.md:525"
task_workflow_troubleshooting: "guide/workflows/task-management.md:667"
task_workflow_advanced: "guide/workflows/task-management.md:741"
claude_folder: 4595
settings: 4879
precedence_rules: 5103
agents: 5546
agent_template: 5636
agent_examples: 5836
skills: 6246
skill_template: 6384
skill_examples: 6452
design_patterns_skill: 6630
design_patterns_skill_location: "examples/skills/design-patterns/"
design_patterns_skill_modes: "Detection, Suggestion, Evaluation"
design_patterns_skill_patterns: "23 GoF patterns (Creational 5, Structural 7, Behavioral 11)"
design_patterns_skill_stacks: "React, Angular, NestJS, Vue, Express, RxJS, Redux, ORMs"
community_skills_cybersec: 6780
community_skills_iac: 6863
# Automatic skill generation (meta-skill)
claudeception: "https://github.com/blader/Claudeception"
claudeception_guide: 6915
# Skill Lifecycle: Automatic improvement (added 2026-01-24)
skill_lifecycle: 6246
claude_reflect_system: 6246
claude_reflect_system_repo: "https://github.com/haddock-development/claude-reflect-system"
claude_reflect_system_agent_skills: "https://agent-skills.md/skills/haddock-development/claude-reflect-system/reflect"
skill_improvement_pattern: 6630
skill_improvement_how_it_works: 6630
skill_improvement_safety: 6373
skill_improvement_security_warnings: 6373
skill_improvement_comparison: 6250
skill_improvement_workflow: 6328
# Design Intelligence Skill (added 2026-02-23)
ui_ux_pro_max: "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill"
ui_ux_pro_max_site: "https://ui-ux-pro-max-skill.nextlevelbuilder.io"
ui_ux_pro_max_guide: 7092
ui_ux_pro_max_stars: 33700
ui_ux_pro_max_styles: 67
ui_ux_pro_max_palettes: 96
# Agent Skills Open Standard (added 2026-02-01)
agentskills_spec: "https://agentskills.io"
agentskills_spec_repo: "https://github.com/agentskills/agentskills"
agentskills_spec_stars: "8.2K"
agentskills_platforms: "26+ (Claude Code, Cursor, VS Code, GitHub, Codex, Gemini CLI, Goose, Roo Code, Spring AI, Databricks...)"
agentskills_ref_cli: "https://github.com/agentskills/agentskills/tree/main/skills-ref"
agentskills_ref_cli_usage: "skills-ref validate <path> | skills-ref to-prompt <path>"
anthropics_skills_repo: "https://github.com/anthropics/skills"
anthropics_skills_stars: "60K+"
anthropics_skills_categories: "Documents (docx/pdf/pptx/xlsx), Creative & Design, Development, Enterprise"
anthropics_skills_install: "/plugin marketplace add anthropics/skills"
anthropics_plugins_official_repo: "https://github.com/anthropics/claude-plugins-official"
anthropics_plugins_official_installs: "3.1K"
anthropics_plugins_official_skills: "claude-md-improver, claude-automation-recommender, playground, plugin dev meta-skills"
anthropics_plugins_official_install: "npx add-skill anthropics/claude-plugins-official"
agentskills_threat_model: "https://safedep.io/agent-skills-threat-model"
agentskills_threat_model_finding: "8-14% of public skills have vulnerabilities (prompt injection, data exfiltration, privilege escalation)"
agentskills_blog: "https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills"
agentskills_guide_section: "guide/ultimate-guide.md:6383"
agentskills_evaluation: "docs/resource-evaluations/agentskills-io-specification.md"
agentskills_score: "4/5"
# claude-code-best-practice repo evaluations (Added 2026-02-26)
ccbp_repo_evaluation: "docs/resource-evaluations/069-claude-code-best-practice-repo-eval.md"
ccbp_repo_score: "4/5"
ccbp_repo_source: "https://github.com/shanraisshan/claude-code-best-practice"
ccbp_repo_critical_finding: "bug at guide/ultimate-guide.md:5646 — official agent fields misclassified as community patterns (fixed)"
ccbp_dotclaude_evaluation: "docs/resource-evaluations/070-claude-code-best-practice-dot-claude-eval.md"
ccbp_dotclaude_score: "4/5"
ccbp_dotclaude_patterns: "self-evolving agent, Command→Agent→Skills architecture, allowed-tools wildcard scoping"
# Skills Marketplace (added 2026-01-23)
skills_marketplace: 7212
skills_marketplace_url: "https://skills.sh/"
skills_marketplace_github: "https://github.com/vercel-labs/agent-skills"
skills_marketplace_install: "npx add-skill <owner/repo>"
skills_marketplace_top_skills:
- "vercel-react-best-practices: 35K+ installs"
- "web-design-guidelines: 26.6K installs"
- "supabase-postgres-best-practices: 1K+ installs"
- "better-auth-best-practices: 2K+ installs"
- "test-driven-development: 721 installs"
skills_marketplace_status: "Community (Vercel Labs), launched Jan 21, 2026"
skills_marketplace_changelog: "https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem"
# Plugin System & Community Marketplaces (updated 2026-01-24)
plugins_system: 11048
plugins_commands: 11062
plugins_marketplace: 11100
plugins_community_marketplaces: 11358 # New section with ecosystem stats
plugins_recommended: "examples/plugins/"
plugins_se_cove: "examples/plugins/se-cove.md"
plugins_official_docs: "https://code.claude.com/docs/en/plugins"
plugins_official_reference: "https://code.claude.com/docs/en/plugins-reference"
plugins_official_marketplaces: "https://code.claude.com/docs/en/plugin-marketplaces"
# Community plugin resources
plugins_wshobson_agents:
url: "https://github.com/wshobson/agents"
stats: "67 plugins, 99 agents, 107 skills"
updated: "2026-01-24"
plugins_registry_claude_plugins_dev:
url: "https://claude-plugins.dev"
stats: "11,989 plugins, 63,065 skills indexed"
plugins_registry_claudemarketplaces:
url: "https://claudemarketplaces.com"
purpose: "Auto-scan GitHub for .claude-plugin/marketplace.json"
plugins_popular:
- "Context7: ~72k installs (library docs lookup)"
- "Ralph Wiggum: ~57k installs (code review)"
- "Figma MCP: ~18k installs (design-to-code)"
- "Linear MCP: ~9.5k installs (issue tracking)"
plugins_awesome_list: "https://github.com/hesreallyhim/awesome-claude-code"
plugins_awesome_list_stars: "20k+"
chain_of_verification: "guide/methodologies.md:230"
chain_of_verification_paper: "https://arxiv.org/abs/2309.11495"
chain_of_verification_acl: "https://aclanthology.org/2024.findings-acl.212/"
# Verification Loops & Eval Harness (added 2026-01-23)
verification_loops: "guide/methodologies.md:245"
verification_loops_source: "https://www.anthropic.com/engineering/claude-code-best-practices"
eval_harness: "guide/methodologies.md:289"
eval_harness_source: "https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents"
# GSD (Get Shit Done) methodology (added 2026-01-25)
gsd_methodology: "guide/methodologies.md:53"
gsd_evaluation: "docs/resource-evaluations/gsd-evaluation.md"
gsd_source: "https://github.com/glittercowboy/get-shit-done"
gsd_note: "Overlap with existing patterns (Ralph Loop, Gas Town, BMAD)"
# Resource Evaluations (added 2026-01-26, updated 2026-02-07)
resource_evaluations_directory: "docs/resource-evaluations/"
resource_evaluations_count: 84
resource_evaluations_methodology: "docs/resource-evaluations/README.md"
resource_evaluations_watchlist: "docs/resource-evaluations/watch-list.md"
resource_evaluations_appendix: "guide/ultimate-guide.md:20886"
resource_evaluations_readme_section: "README.md:307"
resource_evaluations_git_mcp: "docs/resource-evaluations/git-mcp-server-evaluation.md"
resource_evaluations_anaconda_croce: "docs/resource-evaluations/anaconda-croce-evaluation.md"
resource_evaluations_grenier_quality: "docs/resource-evaluations/grenier-agent-skill-quality.md"
resource_evaluations_grenier_score: "3/5"
resource_evaluations_grenier_gap: "No automated quality checks for agents/skills (29.5% deploy without evaluation per LangChain 2026)"
resource_evaluations_grenier_integration: "Created /audit-agents-skills command + skill + criteria.yaml"
# Agent/Skill Quality Audit (added 2026-02-07)
audit_agents_skills_command: "examples/commands/audit-agents-skills.md"
audit_agents_skills_skill: "examples/skills/audit-agents-skills/SKILL.md"
audit_agents_skills_criteria: "examples/skills/audit-agents-skills/scoring/criteria.yaml"
audit_agents_skills_framework: "16 criteria (Identity 3x, Prompt 2x, Validation 1x, Design 2x)"
audit_agents_skills_scoring: "32 points max (agents/skills), 20 points (commands)"
audit_agents_skills_grades: "A-F scale, 80% production threshold"
audit_agents_skills_modes: "Quick (top-5), Full (all 16), Comparative (vs templates)"
audit_agents_skills_output: "Markdown + JSON for CI/CD integration"
audit_agents_skills_industry_context: "29.5% deploy without evaluation (LangChain 2026), 18% cite agent bugs as top challenge"
audit_agents_skills_guide_refs: "guide/ultimate-guide.md:4951 (after Agent Validation Checklist), guide/ultimate-guide.md:5495 (after Skill Validation)"
# Practitioner Insights (external validation)
practitioner_insights: "guide/ai-ecosystem.md:2170"
practitioner_dave_van_veen: "guide/ai-ecosystem.md:2174"
practitioner_matteo_collina: "guide/ai-ecosystem.md:2203"
# Outcome Engineering (o16g) - Emerging manifesto (2026-02-13)
outcome_engineering_o16g: "guide/ai-ecosystem.md:2366"
outcome_engineering_url: "https://o16g.com/"
outcome_engineering_author: "Cory Ondrejka (CTO Onebrief, co-creator Second Life, ex-VP Google/Meta)"
outcome_engineering_status: "Emerging - on watch list for community adoption"
practitioner_collina_source: "https://adventures.nodeland.dev/archive/the-human-in-the-loop/"
practitioner_steinberger: "guide/ai-ecosystem.md:2242"
practitioner_steinberger_source: "https://steipete.me/posts/2025/shipping-at-inference-speed"
practitioner_addy_osmani: "guide/ai-ecosystem.md:2269"
practitioner_osmani_source: "https://addyo.substack.com/p/the-80-problem-in-agentic-coding"
practitioner_alan: "guide/ai-ecosystem.md:2299"
practitioner_alan_source: "https://www.linkedin.com/pulse/le-principe-de-la-tour-eiffel-et-ralph-wiggum-maxime-le-bras-psmxe/"
verification_paradox: "guide/production-safety.md:639"
verification_paradox_source: "https://www.linkedin.com/pulse/le-principe-de-la-tour-eiffel-et-ralph-wiggum-maxime-le-bras-psmxe/"
eighty_percent_problem: "guide/ai-ecosystem.md:2269"
comprehension_debt_secondary: "guide/ai-ecosystem.md:2269" # See also: vibe_coding_trap (primary)
# DevOps/SRE Guide (guide/devops-sre.md)
devops_sre_guide: "guide/devops-sre.md"
devops_fire_framework: "guide/devops-sre.md:46"
devops_k8s_troubleshooting: "guide/devops-sre.md:129"
devops_k8s_prompts: "guide/devops-sre.md:151"
devops_incident_response: "guide/devops-sre.md:333"
devops_iac_patterns: "guide/devops-sre.md:504"
devops_guardrails: "guide/devops-sre.md:687"
devops_limitations: "guide/devops-sre.md:297"
devops_quick_reference: "guide/devops-sre.md:794"
devops_agent: "examples/agents/devops-sre.md"
devops_claude_md: "examples/claude-md/devops-sre.md"
# Product Designer (design-to-code workflow)
product_designer_workflow: "guide/workflows/design-to-code.md"
product_designer_claudemd: "examples/claude-md/product-designer.md"
design_system_handoff: "guide/workflows/design-to-code.md:263"
figma_make_integration: "guide/workflows/design-to-code.md:85"
pencil_canvas: "guide/ultimate-guide.md:528"
pencil_workflow: "guide/workflows/design-to-code.md:453"
pencil_vs_figma: "guide/workflows/design-to-code.md:476"
commands: 47
command_template: 7592
hooks: 8077
hook_templates: 8155
security_hooks: 8161
security_gate_hook_line: 8481
security_gate_hook_source: "https://paddo.dev/blog/claude-code-team-tips/"
mcp_servers: 9204
serena_indexation: 9373
serena_mcp: 9373
doobidoo_memory_mcp: 10142
mcp_memory_stack_patterns: 10325
mcp_config: 10556
mcp_security: 11402
cicd: 11827
ide_integration: 12528
feedback_loops: 12613
batch_operations: 13243
pitfalls: 13366
git_best_practices: 13831
cost_optimization: 1784
session_teleportation: 15178
remote_control: 18833
multi_instance_workflows: 15283
boris_cherny_case_study: 15332
boris_cherny_team_patterns: 5492
# Dual-Instance Planning Pattern (Jon Williams, Feb 2026)
dual_instance_planning: 15385
dual_instance_workflow: "guide/workflows/dual-instance-planning.md"
dual_instance_overview: 15385
dual_instance_setup: "guide/workflows/dual-instance-planning.md:71"
dual_instance_complete_workflow: "guide/workflows/dual-instance-planning.md:145"
dual_instance_plan_template: "guide/workflows/dual-instance-planning.md:522"
dual_instance_cost_analysis: "guide/workflows/dual-instance-planning.md:614"
dual_instance_comparison: 15385 # Boris vs Jon comparison table
dual_instance_source: "https://www.linkedin.com/posts/thatjonwilliams_ive-been-using-cursor-for-six-months-now-activity-7424481861802033153-k8bu"
dual_instance_author: "Jon Williams (Product Designer, UK)"
dual_instance_date: "2026-02-03"
dual_instance_pattern: "Vertical separation (planner vs implementer) - orthogonal to Boris horizontal scaling"
dual_instance_cost: "$100-200/month (vs $500-1K Boris pattern)"
dual_instance_audience: "Solo devs, spec-heavy work, quality > speed"
# Boris Tane Pattern (Annotation Cycle, Feb 2026)
annotation_cycle_pattern: "guide/workflows/plan-driven.md#the-annotation-cycle"
custom_markdown_plans: "guide/workflows/plan-driven.md#why-custom-plans-over-plan"
boris_tane_source: "https://boristane.com/blog/how-i-use-claude-code/"
boris_tane_author: "Boris Tane (Engineering Lead, Cloudflare)"
# External resource: Claude Code team tips (paddo.dev, Feb 2026)
team_tips_paddo: "https://paddo.dev/blog/claude-code-team-tips/"
team_tips_paddo_source: "Boris Cherny thread (x.com/bcherny/status/2017742741636321619)"
team_tips_paddo_evaluation: "docs/resource-evaluations/paddo-team-tips-eval.md"
team_tips_paddo_score: "4/5"
anthropic_study_metrics: 11555
# Contribution Metrics (Jan 2026 - platform feature, not CLI release)
contribution_metrics: 15970
contribution_metrics_source: "https://claude.com/blog/contribution-metrics"
contribution_metrics_date: "2026-01-29"
contribution_metrics_availability: "Public beta - Team and Enterprise plans"
contribution_metrics_stats: "+67% PRs merged/engineer/day, 70-90% AI-assisted code (Anthropic internal)"
# Git Worktree Commands (Feb 2026)
git_worktree_command: "examples/commands/git-worktree.md"
git_worktree_status_command: "examples/commands/git-worktree-status.md"
git_worktree_remove_command: "examples/commands/git-worktree-remove.md"
git_worktree_clean_command: "examples/commands/git-worktree-clean.md"
git_worktrees_multi_instance: 14013
advanced_worktree_tooling: 15763
worktree_tooling_self_assessment: 15763
anthropic_internal_study: 15934
multi_instance_costs: 15283
orchestration_frameworks: 16029
headless_pm_framework: 11841
multi_instance_implementation: 15283
multi_instance_monitoring: 15283
multi_instance_decision_matrix: 15283
# External orchestration systems
external_orchestrators:
gas_town:
repo: "https://github.com/steveyegge/gastown"
author: "Steve Yegge"
description: "Multi-agent workspace manager using Claude Code instances"
status: "Experimental (Jan 2026)"
guide_section: "guide/ai-ecosystem.md:850"
multiclaude:
repo: "https://github.com/dlorenc/multiclaude"
author: "dlorenc"
description: "Self-hosted multi-agent Claude Code spawner (tmux + git worktrees)"
status: "Active development (Jan 2026, 383 stars)"
guide_section: "guide/ai-ecosystem.md:850"
agent_chat:
repo: "https://github.com/justinabrahms/agent-chat"
author: "Justin Abrahms"
description: "Real-time monitoring UI for Gas Town and multiclaude (SSE + SQLite)"
status: "Early preview (Jan 2026, v0.2.0)"
guide_section: "guide/ai-ecosystem.md:850"
# External research & alignment tools
external_research:
claude_constitution:
url: "https://www.anthropic.com/constitution"
pdf: "https://www-cdn.anthropic.com/9214f02e82c4489fb6cf45441d448a1ecd1a3aca/claudes-constitution.pdf"
announcement: "https://www.anthropic.com/news/claude-new-constitution"
description: "Claude's Constitutional AI framework - value hierarchy (safety > ethics > compliance > utility)"
license: "CC0 1.0 (public domain)"
published: "2026-01-21"
guide_section: "guide/data-privacy.md:296"
petri_v2:
repo: "https://github.com/safety-research/petri"
blog: "https://alignment.anthropic.com/2026/petri-v2/"
description: "Open-source AI behavior audit tool (Anthropic Alignment Science)"
features:
- "70 scenarios: collusion, ethics conflicts, info sensitivity"
- "Eval-awareness mitigations"
- "Benchmarks: Claude Opus 4.5, GPT-5.2, Gemini 3 Pro, Grok 4"
published: "2026-01-21"
guide_section: "README.md:338"
# Section 9.18 - Codebase Design for Agent Productivity
codebase_design_agents: 16311
codebase_design_source: "https://marmelab.com/blog/2026/01/21/agent-experience.html"
codebase_design_author: "François Zaninotto (Marmelab)"
codebase_design_llms_txt: 16797 # llms.txt standard for AI-optimized documentation
codebase_design_llms_txt_spec: "https://llmstxt.org/"
codebase_design_llms_txt_example: "machine-readable/llms.txt"
# Section 9.19 - Permutation Frameworks
permutation_frameworks: 18314
# Section 9.20 - Agent Teams (v2.1.32+ experimental)
agent_teams: "guide/workflows/agent-teams.md"
agent_teams_quick_start: "guide/workflows/agent-teams-quick-start.md" # Practical 8-10 min guide with copy-paste patterns
agent_teams_overview: 18498 # Section 9.20 in ultimate-guide.md
agent_teams_architecture: "guide/workflows/agent-teams.md:137"
agent_teams_setup: "guide/workflows/agent-teams.md:250"
agent_teams_use_cases: "guide/workflows/agent-teams.md:346"
agent_teams_fountain_case_study: "guide/workflows/agent-teams.md:358"
agent_teams_cred_case_study: "guide/workflows/agent-teams.md:391"
agent_teams_c_compiler_case_study: "guide/workflows/agent-teams.md:308"
agent_teams_paul_rayner_workflows: "guide/workflows/agent-teams.md:450"
agent_teams_workflow_impact: "guide/workflows/agent-teams.md:552"
agent_teams_limitations: "guide/workflows/agent-teams.md:644"
agent_teams_decision_tree: "guide/workflows/agent-teams.md:804"
agent_teams_best_practices: "guide/workflows/agent-teams.md:928"
agent_teams_troubleshooting: "guide/workflows/agent-teams.md:1092"
agent_teams_experimental_flag: "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=true"
agent_teams_model_requirement: "Opus 4.6 minimum"
agent_teams_sources:
- "https://www.anthropic.com/news/claude-opus-4-6"
- "https://www.anthropic.com/engineering/building-c-compiler"
- "https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf"
- "https://dev.to/thegdsks/claude-opus-46-for-developers-agent-teams-1m-context-and-what-actually-matters-4h8c"
- "https://www.linkedin.com/posts/thepaulrayner_this-is-wild-i-just-upgraded-claude-code-activity-7425635159678414850-MNyv"
# Anthropic 2026 Trends (diffused across sections, not standalone)
agentic_trends_2026_report: "https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf"
agentic_trends_2026_evaluation: "docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md"
agentic_trends_integration_strategy: "Diffusion transversale (industry data in 9.17, 9.20, 9.11, 9 intro)"
agentic_trends_research_data:
ai_usage: "60% of work (Anthropic internal study)"
full_delegation: "0-20% tasks (collaboration > delegation)"
productivity_gain: "67% more PRs merged/engineer/day"
new_work: "27% tasks wouldn't be done without AI"
agentic_trends_case_studies:
fountain: "50% faster screening (hierarchical multi-agent)"
rakuten: "7h autonomous vLLM (12.5M lines, 99.9% accuracy)"
cred: "2x execution speed, quality maintained (fintech)"
telus: "500K hours saved, 13K solutions, 30% faster"
legora: "Legal platform, lawyers automate without coding"
zapier: "89% adoption, 800+ internal agents"
augment_code: "4-8 months project → 2 weeks"
agentic_trends_benchmarks:
multi_instance_cost: "$500-1K/month (Boris pattern validation)"
agent_teams_timeline: "3-6 months adoption (enterprise)"
productivity_multiplier: "3x (capabilities × orchestration × experience)"
timeline_compression: "weeks → days (feature implementation)"
onboarding_speedup: "2-4 weeks → 4-8 hours (new codebase)"
agentic_trends_anti_patterns:
over_delegation: ">5 agents = coordination overhead"
premature_automation: "Automate before mastering manual"
tool_sprawl: ">10 MCP servers = maintenance burden"
no_roi_tracking: "Can't optimize what you don't measure"
# AI Fluency Research (Anthropic, Feb 2026) - Added 2026-02-23
ai_fluency_index: "https://www.anthropic.com/research/AI-fluency-index"
ai_fluency_evaluation: "docs/resource-evaluations/2026-02-23-anthropic-ai-fluency-index.md"
ai_fluency_score: "4/5"
ai_fluency_sample: "9,830 conversations, 7-day window, January 2026"
ai_fluency_iteration_stat: "5.6× more likely to question reasoning (iterative vs non-iterative users)"
ai_fluency_fluency_ratio: "2.67 vs 1.33 behaviors (iterative vs non-iterative)"
ai_fluency_collaboration_terms: "Only 30% of users set collaboration terms explicitly"
ai_fluency_artifact_paradox: "Artifact production → −5.2pp missing context, −3.7pp fact-check, −3.1pp questioning reasoning"
ai_fluency_plan_review_section: "guide/ultimate-guide.md:2542" # Rev the Engine callout
ai_fluency_claudemd_section: "guide/ultimate-guide.md:4421" # CLAUDE.md Best Practices callout
ai_fluency_artifact_section: "guide/ultimate-guide.md:13485" # Artifact Paradox callout (Common Pitfalls)
ai_fluency_authors: "Swanson, Bent, Huang, Ludwig, Dakan, Feller (Anthropic)"
ai_fluency_published: "2026-02-23"
ai_fluency_future: "Claude Code platform analysis (mentioned in paper's future directions)"
ai_fluency_diagram: "guide/diagrams/06-development-workflows.md#ai-fluency--high-vs-low-fluency-paths"
ai_fluency_diagram_type: "flowchart — Artifact Paradox: 70% vs 30% user paths, behavioral drop data, iteration outcomes"
# Advanced Plan Mode Patterns
rev_the_engine: 2490
mechanic_stacking: 2538
# Sub-Agent Patterns (Refactored 2026-02-09)
agent_anti_patterns: 4032 # Critical: Roles vs Context Control (Dex Horty principle)
scope_focused_agents: 4079 # Formerly "Split-Role Sub-Agents", refactored for context isolation
teammatetool_experimental: 3976 # Multi-agent orchestration parent section
# Task Management Diagnostic
task_lists_diagnostic: 3884
# Mental Model
main_thread_orchestrator: 2886
# CLAUDE.md Patterns
continuous_context_update: 4297
# Hook Patterns
smart_hook_dispatching: 8689
# Workflows
skeleton_projects_workflow: "guide/workflows/skeleton-projects.md"
# Spec-First Development (Addy Osmani, Jan 2026)
spec_first_workflow: "guide/workflows/spec-first.md"
spec_modular_design: "guide/workflows/spec-first.md:363"
spec_operational_boundaries: "guide/workflows/spec-first.md:461"
spec_command_template: "guide/workflows/spec-first.md:573"
spec_anti_monolithic: "guide/workflows/spec-first.md:717"
spec_osmani_source: "https://addyosmani.com/blog/good-spec/"
spec_osmani_evaluation: "docs/resource-evaluations/addy-osmani-good-spec.md"
spec_osmani_score: "4/5"
spec_task_granularity: "guide/workflows/spec-first.md:62" # Vertical slices + PRD checklist (Allan Hill, Feb 2026)
spec_prd_checklist: "guide/workflows/spec-first.md:68" # 6-dimension PRD quality checklist
atdd_with_agents: "guide/methodologies.md:161" # ATDD + Gherkin for agentic workflows
commands_table: 47
shortcuts_table: 368
troubleshooting: 11311
cheatsheet: 19597
daily_workflow: 19673
# AI Ecosystem (Section 11, ~line 10525)
ai_ecosystem: 20004
ai_ecosystem_complementarity: 20004
ai_ecosystem_tool_matrix: 20031
ai_ecosystem_workflows: 20166
ai_ecosystem_integration: 20294
ai_ecosystem_detailed: "guide/ai-ecosystem.md"
ai_ecosystem_goose: "guide/ai-ecosystem.md:2074"
ai_ecosystem_goose_comparison: "guide/ai-ecosystem.md:2090"
ai_ecosystem_context_packing: "guide/ai-ecosystem.md:2533"
ai_ecosystem_multi_ide_sync: "guide/ai-ecosystem.md:1282"
agents_md_support_status: "guide/ai-ecosystem.md:1348"
ai_ecosystem_build_vs_use: "guide/ai-ecosystem.md:2399" # Section 11.3 - When to Build vs Use (ADK, LangChain, Vercel AI SDK)
# Architecture Diagrams as Context (advanced pattern) - Added 2026-01-25
architecture_diagrams_input: "guide/ai-ecosystem.md:2567"
architecture_diagrams_mcp_tools:
- "Archy MCP: https://www.pulsemcp.com/servers/phxdev1-archy"
- "Mermaid MCP: 61.4K users"
- "Blueprint MCP (ArcadeAI)"
llm_oop_research: "https://dl.acm.org/doi/10.1145/3639474.3640052"
architecture_diagrams_source: "https://www.linkedin.com/posts/tigraff_uml-claude-wibecoding-activity-7420595633826258944-gGO5"
ai_ecosystem_voice_to_text: "guide/ai-ecosystem.md:1066"
ai_ecosystem_alternative_providers: "guide/ai-ecosystem.md:2639"
voice_refine_skill: "examples/skills/voice-refine/SKILL.md"
# Cowork documentation (v1.0 - migrated to dedicated repo)
cowork_reference: "machine-readable/cowork-reference.yaml" # Dedicated YAML index (kept local)
cowork_hub: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/README.md"
cowork_summary: "guide/cowork.md" # Summary remains in this repo
cowork_overview: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/00-overview.md"
cowork_getting_started: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/01-getting-started.md"
cowork_capabilities: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/02-capabilities.md"
cowork_security: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/03-security.md"
cowork_troubleshooting: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/04-troubleshooting.md"
cowork_cheatsheet: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md"
cowork_comparison: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/comparison.md"
cowork_faq: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/faq.md"
cowork_prompts: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/prompts"
cowork_workflows: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/workflows"
cowork_section: "guide/ai-ecosystem.md:1809"
cowork_ultimate_guide: 20348
# Experimental Features
teammatetool: 3976
teammatetool_status: "Experimental, progressive rollout, feature-flagged"
teammatetool_capabilities: "Multi-agent coordination, team messaging, swarm patterns"
teammatetool_sources:
- "https://gist.github.com/kieranklaassen/4f2aba89594a4aea4ad64d753984b2ea"
- "https://github.com/anthropics/claude-code/issues/3013"
- "https://github.com/mikekelly/claude-sneakpeek"
# Appendix
appendix_a_file_locations: 20574
appendix_b_faq: 20750
faq_clawdbot_vs_claudecode: 20764
faq_product_managers: 20821
appendix_c_resource_evaluation: 20886
appendix_d_myths_vs_reality: 20929
myths_hidden_features: 20933
myths_tasks_api_autonomous: 20965
myths_100x_faster: 20997
myths_reliable_sources: 20983
# Quiz System (264 questions, 15 categories)
quiz_overview: "quiz/README.md"
quiz_file: "quiz/questions.json"
quiz_count: 264
quiz_categories: 15
quiz_beginner: "quiz/categories/basics,commands,shortcuts,reference"
quiz_beginner_count: 60
quiz_intermediate: "quiz/categories/workflows,context,agents,hooks"
quiz_intermediate_count: 100
quiz_advanced: "quiz/categories/mcp,production,advanced,learning,ecosystem"
quiz_advanced_count: 97
quiz_estimated_time_beginner: "15-20 min"
quiz_estimated_time_intermediate: "25-30 min"
quiz_estimated_time_advanced: "30-40 min"
# Onboarding matrix required keys (added for v2.0.0 adaptive architecture)
rules: 89 # Golden Rules section
workflow: 58 # Workflow (9 steps)
fix: 11948 # Troubleshooting section
architecture: 919 # Architecture internals
production_safety: "guide/production-safety.md" # Production safety rules
security_hardening: "guide/security-hardening.md" # Security best practices
security_cve_summary: "guide/security-hardening.md:15" # Decision Matrix + CVEs
security_supply_chain_stats: "guide/security-hardening.md:137" # Agent Skills Supply Chain Risks
security_mcp_scan_tool: "guide/security-hardening.md:32" # MCP Vetting Workflow
security_malicious_extensions: "guide/security-hardening.md:252" # .claude/ attack surface (§1.5)
security_kill_switch: "guide/security-hardening.md:630" # AI Kill Switch & Containment Architecture (§3.5)
security_claude_folder_audit: "guide/security-hardening.md:228" # Repository Pre-Scan (§1.4)
security_toxicskills_evaluation: "docs/resource-evaluations/snyk-toxicskills-evaluation.md"
security_check_command: "examples/commands/security-check.md" # Quick config check vs known threats
security_audit_command: "examples/commands/security-audit.md" # Full 6-phase security audit (score /100)
security_threat_db: "examples/commands/resources/threat-db.yaml" # Threat intelligence database (authors, skills, CVEs, patterns)
security_update_threat_db: "examples/commands/update-threat-db.md" # /update-threat-db — research & update threat database
security_cc_scanner: "guide/security-hardening.md:780" # Claude Code Security (research preview) — Anthropic native vuln scanner, adversarial validation, patch suggestions
security_patcher_agent: "examples/agents/security-patcher.md" # Agent: applies patches from security-auditor findings, human approval gate, Write/Edit tools
security_gate_hook: "examples/hooks/bash/security-gate.sh" # PreToolUse hook: blocks 7 vuln patterns at write time (SQLi, XSS, hardcoded secrets, eval, weak hash, cmd injection, path traversal)
security_pr_review_workflow: "guide/security-hardening.md:712" # PR security review workflow — 3-agent pipeline, git hook integration
agent_validation_checklist: 5744 # Agent validation section in ultimate-guide.md
git_mcp_guide: "guide/mcp-servers-ecosystem.md:113" # Git MCP server documentation
# ════════════════════════════════════════════════════════════════
# DECISION TREE (most important - en premier)
# ════════════════════════════════════════════════════════════════
decide:
simple_task: "just ask Claude"
complex_task: "/plan first, then use Tasks API (v2.1.16+) or TodoWrite"
complex_task_multi_session: "use Tasks API with CLAUDE_CODE_TASK_LIST_ID"
context_high: "/compact (>70%) or /clear (>90%)"
repeating: "create agent or command"
need_docs: "Context7 MCP"
deep_debug: "use Opus (thinking enabled by default) - Alt+T to toggle"
# ════════════════════════════════════════════════════════════════
# PROMPTING FORMULA (see deep_dive.xml_prompting for details)
# ════════════════════════════════════════════════════════════════
prompt_formula:
WHAT: "concrete deliverable"
WHERE: "file paths"
HOW: "constraints, approach"
VERIFY: "success criteria"
example: |
Add input validation to login form.
WHERE: src/components/LoginForm.tsx
HOW: Use Zod, inline errors
VERIFY: Empty email shows error
# ════════════════════════════════════════════════════════════════
# WORKFLOW (9 steps) - see deep_dive.first_workflow
# ════════════════════════════════════════════════════════════════
workflow:
1: "claude"
2: "/status"
3: "Shift+Tab×2 for plan mode (if risky)"
4: "describe task (WHAT/WHERE/HOW/VERIFY)"
5: "review diff"
6: "y/n"
7: "run tests"
8: "commit"
9: "/compact when >70%"
# ════════════════════════════════════════════════════════════════
# CRITICAL COMMANDS - see deep_dive.essential_commands
# ════════════════════════════════════════════════════════════════
commands:
/compact: "compress context - USE AT >70%"
/clear: "reset conversation - USE AT >90%"
/status: "show context % and cost"
/plan: "read-only mode (safe exploration)"
/execute: "exit plan mode"
/rewind: "undo changes"
/model: "switch: sonnet|opus|opusplan"
/mcp: "show MCP server status"
/context: "detailed token breakdown"
/teleport: "bring web session to local CLI"
/tasks: "monitor background tasks"
/remote-env: "configure cloud environment"
/remote-control: "start remote control session (Research Preview, Pro/Max only)"
/rc: "alias for /remote-control"
/mobile: "get Claude mobile app download links (iOS + Android)"
# ════════════════════════════════════════════════════════════════
# SHORTCUTS - see deep_dive.shortcuts_table
# ════════════════════════════════════════════════════════════════
shortcuts:
Shift+Tab: "cycle: default → auto-accept → plan"
Esc×2: "rewind/undo"
Ctrl+C: "interrupt"
Ctrl+R: "search command history"
Ctrl+B: "background all tasks"
"@file": "reference file"
"!cmd": "shell command"
# ════════════════════════════════════════════════════════════════
# CLI FLAGS - see deep_dive.commands_table
# ════════════════════════════════════════════════════════════════
cli:
"-c": "continue last session"
"-r <id>": "resume specific session"
"--teleport": "bring web session to local CLI"
"remote-control": "subcommand: start remote control session"
"-p": "non-interactive (pipe mode)"
"--model X": "select model"
"--dangerously-skip-permissions": "auto-accept ALL (danger)"
"--debug": "verbose output"
"--add-dir": "grant tool access to directories outside CWD"
# ════════════════════════════════════════════════════════════════
# CONTEXT MANAGEMENT - see deep_dive.context_management
# ════════════════════════════════════════════════════════════════
context:
zones:
green: "0-50% → work freely"
yellow: "50-70% → be selective"
orange: "70-90% → /compact NOW"
red: "90%+ → /clear required"
fresh_context: "Reset per task for long autonomous sessions - see Section 2.2 Fresh Context Pattern"
symptoms:
short_responses: "/compact"
forgetting_instructions: "/clear"
inconsistent: "context bleeding → /clear"
slow: "/compact or /clear"
# ════════════════════════════════════════════════════════════════
# MEMORY FILES - see deep_dive.memory_files
# ════════════════════════════════════════════════════════════════
memory:
global: "~/.claude/CLAUDE.md (not committed)"
project_team: "./CLAUDE.md (committed)"
project_personal: "./.claude/CLAUDE.md (not committed)"
priority: "project > global"
# ════════════════════════════════════════════════════════════════
# .claude/ STRUCTURE - see deep_dive.claude_folder
# ════════════════════════════════════════════════════════════════
folder_structure:
CLAUDE.md: "local instructions"
settings.json: "hooks config (committed)"
settings.local.json: "permissions (not committed)"
agents/: "custom AI personas"
commands/: "slash commands"
hooks/: "event scripts"
skills/: "knowledge modules"
rules/: "auto-loaded rules"
# ════════════════════════════════════════════════════════════════
# PERMISSION MODES - see deep_dive.permission_modes
# ════════════════════════════════════════════════════════════════
permissions:
default: "editing=ask, execution=ask"
auto_accept: "editing=auto, execution=ask"
plan_mode: "editing=blocked, execution=blocked"
switch: "Shift+Tab"
# ════════════════════════════════════════════════════════════════
# MCP SERVERS - see deep_dive.mcp_servers
# ════════════════════════════════════════════════════════════════
mcp:
serena: "symbol search + session memory (write_memory/read_memory) + project indexation"
claude_mem: "automatic session capture + AI compression + progressive disclosure + Web dashboard (localhost:37777)"
claude_mem_repo: "https://github.com/thedotmack/claude-mem"
claude_mem_guide: "guide/ultimate-guide.md:1585"
claude_mem_plugin: "examples/plugins/claude-mem.md"
claude_mem_installation: "/plugin marketplace add thedotmack/claude-mem"
claude_mem_stars: "26.5k"
claude_mem_license: "AGPL-3.0 + PolyForm Noncommercial"
claude_mem_cost: "$0.15 per 100 observations (API compression)"
claude_mem_storage: "10-20 MB/month (light), 100-200 MB/month (heavy)"
claude_mem_dashboard: "http://localhost:37777"
claude_mem_vs_serena: "claude-mem=auto capture, Serena=manual memory"
claude_mem_progressive_disclosure: "3-layer retrieval: search→timeline→observations (10x token reduction)"
claude_mem_evaluation: "docs/resource-evaluations/claude-mem-evaluation.md"
claude_mem_score: "4/5 (High Value)"
doobidoo_memory: "semantic memory search + Knowledge Graph dashboard + 13+ clients (⚠️ under testing)"
doobidoo_install: "pip install mcp-memory-service && python -m mcp_memory_service.scripts.installation.install --quick"
doobidoo_dashboard: "http://localhost:8000"
doobidoo_vs_serena: "Serena=key-value (requires known key), doobidoo=semantic search (finds by meaning)"
doobidoo_backends: "sqlite_vec (local), cloudflare (multi-device), hybrid (local+cloud sync)"
doobidoo_tools: "store_memory, retrieve_memory, search_by_tag, delete_memory, list_memories, check_database_health, memory_graph"
doobidoo_data_location: "~/.mcp-memory-service/memories.db"
mcp_memory_stack: "4 layers: doobidoo (decisions) → Serena (symbols) → grepai (code search) → Context7 (docs)"
mcp_complementarity_patterns: "onboarding, ADR, debug persistence, multi-IDE coordination"
serena_indexation: "uvx --from git+https://github.com/oraios/serena serena project index [--force-full|--incremental] [--parallel N]"
serena_cache: ".serena/cache/typescript/ (add to .gitignore)"
context7: "library docs lookup"
sequential: "structured multi-step reasoning"
playwright: "browser automation / E2E"
figma: "design file access, tokens, structure (official)"
git_mcp: "version control automation (official Anthropic) - 12 tools for commits, branches, diffs, logs"
git_mcp_guide: "guide/mcp-servers-ecosystem.md:102"
git_mcp_tools: "git_status, git_log, git_diff, git_commit, git_add, git_reset, git_branch, git_create_branch, git_checkout, git_show, git_diff_unstaged, git_diff_staged"
git_mcp_install: "uvx mcp-server-git --repository /path/to/repo"
git_mcp_decision_matrix: "guide/mcp-servers-ecosystem.md:212" # Git MCP vs GitHub MCP vs Bash tool
git_mcp_repo: "https://github.com/modelcontextprotocol/servers/tree/main/src/git"
git_mcp_score: "8.5/10"
git_mcp_status: "Early development (API subject to change)"
git_mcp_advanced_filtering: "ISO 8601 dates, relative dates (2 weeks ago), absolute dates"
git_mcp_use_cases: "automated commits, log analysis, branch management, token-efficient diffs, multi-repo"
ast_grep: "optional plugin for AST-based code search (explicit invocation required)"
ast_grep_guide: "guide/ultimate-guide.md:9845"
ast_grep_skill: "examples/skills/ast-grep-patterns.md"
ast_grep_install: "npx skills add ast-grep/agent-skill"
ast_grep_when: "structural patterns (>50k lines, migrations, AST rules)"
ast_grep_not_for: "simple string search, small projects (<10k lines)"
search_decision_tree: "grep (text) | ast-grep (structure) | Serena (symbols) | grepai (semantic)"
search_tools_comparison: "guide/ultimate-guide.md:9845"
search_tools_mastery_workflow: "guide/workflows/search-tools-mastery.md"
grep_vs_rag_history: "guide/architecture.md:232"
ripgrep_native: "Grep tool (Claude Code built-in, ~20ms)"
grepai_semantic: "Semantic search + call graph (Ollama-based, ~500ms)"
grepai_benchmark:
source: "https://yoandev.co/grepai-benchmark"
guide_section: "guide/workflows/search-tools-mastery.md:240"
date: "2026-01-20"
summary: "-55% tool calls, -97% tokens vs grep (Excalidraw 155k TS)"
caveat: "Benchmark by tool maintainer, single-project validation"
serena_symbols: "Symbol-aware + session memory (~100ms)"
astgrep_structural: "AST patterns for large refactoring (~200ms)"
search_combined_workflow: "guide/workflows/search-tools-mastery.md:205"
check: "/mcp"
config: "~/.claude.json (mcpServers field) or .mcp.json (project root)"
tool_search: "lazy loading MCP tools (v2.1.7+) - 85% token reduction - auto:N threshold config"
tool_search_config: "ENABLE_TOOL_SEARCH=auto|auto:N|true|false"
tool_search_deep_dive: "guide/architecture.md:284"
# ════════════════════════════════════════════════════════════════
# ARCHITECTURE INTERNALS - see guide/architecture.md
# ════════════════════════════════════════════════════════════════
architecture:
master_loop: "while(tool_call) - no DAG, no classifier, no RAG"
core_tools: "Bash, Read, Edit, Write, Grep, Glob, Task, TodoWrite"
context_budget: "~200K tokens, auto-compact at 75-92%"
subagents: "Task tool spawns isolated agents (depth=1 max)"
teammatetool: "Experimental multi-agent coordination (v3294)"
philosophy: "less scaffolding, more model - trust Claude's reasoning"
mcp_protocol: "JSON-RPC 2.0, treated as native tools"
permissions: "interactive prompts + allow/deny rules + hooks"
deep_dive: "guide/architecture.md"
# ════════════════════════════════════════════════════════════════
# COST OPTIMIZATION - see deep_dive.cost_optimization
# ════════════════════════════════════════════════════════════════
cost:
haiku: "simple fixes, reviews ($)"
sonnet: "most development ($$)"
opus: "architecture, complex bugs ($$$)"
opusplan: "plan=opus + execute=sonnet ($$)"
tip: "--add-dir grants tool access to additional directories (permissions, not context loading)"
rtk: "Command output filtering (72.6% avg reduction) - rtk git log/status/diff"
# ════════════════════════════════════════════════════════════════
# TOOL SELECTION
# ════════════════════════════════════════════════════════════════
tools:
file_search: "Glob (not find)"
content_search: "Grep (not grep bash)"
file_read: "Read (not cat)"
file_edit: "Edit (not sed)"
multi_file: "MultiEdit"
deep_analysis: "Sequential MCP"
library_docs: "Context7 MCP"
browser: "Playwright MCP"
# ════════════════════════════════════════════════════════════════
# ANTI-PATTERNS - see deep_dive.pitfalls
# ════════════════════════════════════════════════════════════════
dont:
- "vague prompts → be specific"
- "accept without reading → read every diff"
- "ignore >70% context → /compact"
- "skip permissions in prod → never"
- "bloated CLAUDE.md → keep concise (<200 lines)"
- "only negative constraints → provide alternatives"
# ════════════════════════════════════════════════════════════════
# TROUBLESHOOTING - see deep_dive.troubleshooting
# ════════════════════════════════════════════════════════════════
fix:
"command not found": "npm i -g @anthropic-ai/claude-code"
"context too high": "/compact or /clear"
"slow responses": "/compact"
"MCP not working": "claude mcp list, check config"
"permission denied": "check settings.local.json"
"hook blocking": "check exit code (0=ok, 2=block)"
# ════════════════════════════════════════════════════════════════
# DEBUG COMMANDS
# ════════════════════════════════════════════════════════════════
debug:
version: "claude --version"
update: "claude update"
diagnostic: "claude doctor"
verbose: "claude --debug"
mcp_debug: "claude --mcp-debug"
# ════════════════════════════════════════════════════════════════
# AGENT TEMPLATE - see deep_dive.agent_template
# ════════════════════════════════════════════════════════════════
agent_template: |
---
name: agent-name
description: Use when [trigger]
model: sonnet|opus|haiku
tools: Read, Write, Edit, Bash
---
# Instructions here
# Agent frontmatter — all official fields (verified 2026-02-26 against code.claude.com/docs/en/sub-agents)
agent_frontmatter_official_fields:
name: "display name + /slash-command trigger"
description: "trigger description (required for auto-discovery)"
model: "sonnet (default) | opus | haiku | inherit"
tools: "comma-separated list: Read, Write, Edit, Bash, Grep, Glob, Task(agent_type)..."
disallowedTools: "tools to block (array)"
permissionMode: "default | acceptEdits | dontAsk | bypassPermissions | plan"
maxTurns: "integer — limit agent turns"
skills: "skills to preload at startup (full content injected)"
mcpServers: "MCP server configs"
hooks: "lifecycle hooks (same format as settings.json hooks)"
memory: "user | project | local — persistent memory scope"
background: "true = always run as background task"
isolation: "worktree = temporary git worktree isolation"
color: "CLI output color"
agent_frontmatter_memory_scopes:
user: "~/.claude/memory/<agent-name>.md — cross-project"
project: ".claude/memory/<agent-name>.md — shared with team"
local: ".claude/memory/<agent-name>.local.md — gitignored"
agent_frontmatter_guide_line: 5639 # Official fields table in ultimate-guide.md
# ════════════════════════════════════════════════════════════════
# HOOK EVENTS - see deep_dive.hooks
# ════════════════════════════════════════════════════════════════
hook_events:
PreToolUse: "before tool (exit 2 to block)"
PostToolUse: "after tool"
UserPromptSubmit: "before prompt sent"
Notification: "alerts"
# Hook Execution Model (v2.1.0+)
hooks_execution_model: 7969 # Section in ultimate-guide.md
hooks_async_support: "v2.1.0+ - add 'async: true' for non-blocking execution"
hooks_async_use_cases: "logging, notifications, formatting, metrics (no feedback needed)"
hooks_sync_use_cases: "validation, type checking, security (feedback required)"
hooks_decision_matrix: 6091 # Decision matrix table
hooks_async_limitations: "no exit code feedback, no additionalContext, no blocking"
hooks_async_bug_fix: "v2.1.23 - fixed cancellation in headless streaming"
# ════════════════════════════════════════════════════════════════
# GOLDEN RULES
# ════════════════════════════════════════════════════════════════
rules:
1: "Always review diffs before accepting"
2: "Use /compact before >70%"
3: "Be specific (WHAT/WHERE/HOW/VERIFY)"
4: "Plan Mode first for complex/risky"
5: "Create CLAUDE.md for every project"
6: "Commit frequently after each task"
# ════════════════════════════════════════════════════════════════
# ECOSYSTEM - Related resources & positioning
# ════════════════════════════════════════════════════════════════
ecosystem:
this_guide:
focus: "Education - Learn & master"
unique: ["architecture docs", "TDD/SDD methodologies", "264-question quiz", "YAML index", "MCP server"]
mcp_server:
npm: "claude-code-ultimate-guide-mcp"
install: "npx -y claude-code-ultimate-guide-mcp"
guide_section: "guide/ultimate-guide.md:10602"
readme: "mcp-server/README.md"
tools:
- "search_guide(query, limit?) — search 882 indexed entries"
- "read_section(path, offset?, limit?) — read any guide file paginated"
- "list_topics() — browse 25 topic categories"
- "get_example(name) — fetch production templates"
- "list_examples(category?) — agents/commands/hooks/skills/scripts"
- "search_examples(query, limit?) — semantic search across all templates by intent"
- "get_changelog(count?) — last N guide CHANGELOG entries"
- "get_digest(period) — day/week/month combined digest"
- "get_release(version?) — Claude Code CLI releases"
- "compare_versions(from, to?) — diff two CC versions: aggregated highlights + breaking changes"
- "get_cheatsheet(section?) — cheatsheet full or filtered"
- "get_threat(id) — look up CVE or attack technique from threat database"
- "list_threats(category?) — browse threat-db: global summary or section list"
resources:
- "claude-code-guide://reference — 94KB YAML index (~900 entries)"
- "claude-code-guide://releases — CC releases history"
- "claude-code-guide://llms — llms.txt"
prompt: "claude-code-expert — activates expert mode with optimal search workflow"
slash_commands:
location: "~/.claude/commands/ccguide/"
commands: ["/ccguide:search", "/ccguide:cheatsheet", "/ccguide:digest", "/ccguide:example", "/ccguide:examples", "/ccguide:release", "/ccguide:changelog", "/ccguide:topics"]
agent: ".claude/agents/claude-code-guide.md — Haiku, read-only, searches before answering"
bundle_size: "132KB compressed (YAML indexes bundled, markdown lazy-fetched)"
cache: "~/.cache/claude-code-guide/{version}/ — 24h TTL"
complementary:
claude_code_templates:
url: "github.com/davila7/claude-code-templates"
focus: "Distribution - Install & use (CLI)"
stars: "17k+"
awesome_claude_code:
url: "github.com/hesreallyhim/awesome-claude-code"
focus: "Curation - Discover & link"
awesome_claude_skills:
url: "github.com/BehiSecc/awesome-claude-skills"
maintainer: "BehiSecc"
focus: "Skills taxonomy - 62 skills across 12 categories"
categories: ["Development", "Design", "Documentation", "Testing", "DevOps", "Security", "Data", "AI/ML", "Productivity", "Content", "Integration", "Fun"]
positioning: "Complementary to awesome-claude-code (skills-only vs full ecosystem)"
evaluation: "docs/resource-evaluations/awesome-claude-skills-github.md"
score: "3/5 (Moderate - Useful complement)"
note: "Distinct from ComposioHQ/awesome-claude-skills (different maintainer, taxonomy approach)"
claude_code_everything:
url: "github.com/wesammustafa/Claude-Code-Everything"
focus: "Visual walkthrough - Screenshots, BMAD method"
everything_claude_code:
url: "github.com/affaan-m/everything-claude-code"
author: "Affaan Mustafa (Anthropic hackathon winner - Zenith project)"
focus: "Production configs - Battle-tested from 10+ months intensive use"
stars: "45k+"
verified: "2026-02-15"
created: "2026-01-18"
unique: ["hookify (conversational hooks)", "pass@k metrics", "Plugin ecosystem", "Sandboxed subagents", "Strategic compaction skills"]
evaluation: "docs/resource-evaluations/015-everything-claude-code-github-repo.md"
score: "5/5 (CRITICAL)"
positioning: "Complementary to Ultimate Guide (production configs vs educational content)"
note: "Consolidates existing patterns; author hackathon win was for Zenith project, not this repo"
caveat: "Node.js hooks not officially recommended by Anthropic (shell preferred)"
coding_agents_matrix:
url: "coding-agents-matrix.dev"
github: "github.com/PackmindHub/coding-agents-matrix"
maintainer: "Packmind (Cédric Teyton, Arthur Magne)"
license: "Apache-2.0"
focus: "Interactive comparison of 23 AI coding agents across 11 criteria"
updated: "2026-01-19"
tech_stack: "React, Vite, Tailwind CSS"
features:
- "11 technical criteria (CLI, MCP, Skills, Commands, Subagents, Plan Mode, AGENTS.md, BYO LLM, Custom Rules, Dedicated IDE, IDE Extension)"
- "Sortable columns and multi-filter (AND logic)"
- "Community-driven updates (GitHub issue templates)"
- "Open source data structure (JSON-based)"
agents_snapshot: 23 # As of 2026-01-19 (evolves over time)
positioning: "Discovery tool - Use Matrix to find/compare agents, use this guide to master Claude Code"
note: "External resource - verify data freshness as agents/criteria evolve"
context_evaluator:
url: "context-evaluator.ai"
github: "github.com/PackmindHub/context-evaluator"
maintainer: "Packmind (Cédric Teyton)"
license: "Apache-2.0"
focus: "Scanner for CLAUDE.md/AGENTS.md/copilot-instructions.md — 17 evaluators (13 error detectors + 4 suggestion generators)"
updated: "2026-02-23"
tech_stack: "Bun, React, Tailwind CSS, TypeScript"
supports: ["Claude Code", "Cursor", "GitHub Copilot", "OpenCode", "OpenAI Codex"]
interface: ["CLI", "Web UI"]
guide_section: "ai-ecosystem.md#related-resources"
note: "v0.3.0, experimental (8 stars as of 2026-02-25) — mention only, no dedicated section"
practitioner_insights:
dave_van_veen:
url: "davevanveen.com/blog/agentic_coding/"
author: "Dave Van Veen (PhD Stanford, Principal AI Scientist @ HOPPR)"
focus: "Production-grade agentic coding guardrails (TDD, worktrees, manual commits)"
academic: "Co-author 'Agentic Systems in Radiology' (ArXiv 2025)"
alignment: "Validates patterns already documented in this guide"
guide_section: "guide/ai-ecosystem.md:1209"
install_templates: "scripts/install-templates.sh"
cowork:
description: "Claude Code for non-developers (desktop app)"
status: "Research preview - Max/macOS only (Jan 2026)"
blog: "https://claude.com/blog/cowork-research-preview"
github: "https://github.com/FlorianBruniaux/claude-cowork-guide"
guide_summary: "guide/cowork.md" # Summary in this repo
guide_full: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/README.md"
getting_started: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/01-getting-started.md"
capabilities: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/02-capabilities.md"
security: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/03-security.md"
troubleshooting: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/04-troubleshooting.md"
cheatsheet: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md"
comparison: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/comparison.md"
faq: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/faq.md"
prompts: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/prompts"
workflows: "https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/workflows"
landing_sites:
description: "Marketing sites for guide discovery and navigation"
architecture: "4-repo ecosystem: 2 sources (docs) + 2 landings (vitrine)"
code_landing:
local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/"
purpose: "Marketing site for Claude Code guide"
audience: "Developers discovering the guide"
features: ["badges (version, templates, lines)", "quiz (264 questions)", "FAQ", "cross-links to Cowork"]
sync_with: "Guide Code (version, templates count, guide lines)"
cowork_landing:
local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/"
purpose: "Marketing site for Cowork guide"
audience: "Knowledge workers discovering Cowork"
features: ["prompts showcase", "workflows preview", "cross-links to Code"]
sync_with: "Cowork guide (version, prompts count)"
sync_triggers:
- "Version bump → Update corresponding landing"
- "Templates/prompts added → Update counts"
- "Cross-links modified → Update all 4 repos"
history:
- date: "2026-01-20"
event: "Code Landing sync v3.29.2, 66 templates, cross-links"
commit: "5b5ce62"
- date: "2026-01-20"
event: "Cowork Landing fix (paths, README, UI badges)"
commits: "cab83f5, af497b7, 539912b"
# ════════════════════════════════════════════════════════════════
# ONBOARDING MATRIX METADATA
# ════════════════════════════════════════════════════════════════
onboarding_matrix_meta:
version: "2.0.0"
last_updated: "2026-02-05"
aligned_with_guide: "3.29.2"
changelog:
- version: "2.0.0"
date: "2026-02-05"
changes: "Adaptive architecture (core+adaptive topics), v3.21-3.22 coverage (git_mcp, sandbox_native, config_hierarchy, mcp_secrets, dual_instance), security-first (sandbox in beginner_5min), time budgets validated, learn_security goal added"
- version: "1.0.0"
date: "2025-12-01"
changes: "Initial static matrix"
maintenance:
review_trigger: "Every CRITICAL (5/5) or HIGH VALUE (4/5) feature addition in resource evaluations"
automation: "scripts/detect-new-onboarding-topics.sh (run monthly)"
responsible: "Guide maintainer (quarterly review)"
# ════════════════════════════════════════════════════════════════
# ONBOARDING MATRIX - Maps user profile → content sections
# Used by tools/onboarding-prompt.md for personalized learning paths
# Format: Each profile has core (always shown) + adaptive (context-based) topics
# ════════════════════════════════════════════════════════════════
onboarding_matrix:
# Adaptive architecture: Each profile has core (always) + adaptive (context-based) topics
# Adaptive triggers: keywords in user messages → relevant v3.21-3.22 topics
# Time budgets: Validated (6-8 min/topic average, respects topics_max limits)
get_started:
beginner_5min:
core: [rules, sandbox_native_guide, commands]
time_budget: "5 min"
topics_max: 3
note: "SECURITY FIRST - sandbox before commands (v3.29.2 critical fix)"
beginner_15min:
core: [rules, sandbox_native_guide, workflow, essential_commands]
time_budget: "15 min"
topics_max: 4
note: "Core workflow with security foundation"
beginner_30min:
core: [rules, sandbox_native_guide, workflow, context_management]
adaptive:
- trigger: "permission|allow|deny|mode"
topics: [permission_modes]
- default: essential_commands
time_budget: "30 min"
topics_max: 5
optimize:
intermediate_15min:
core: [context_management, context_triage, plan_mode]
time_budget: "15 min"
topics_max: 3
intermediate_30min:
core: [context_management, plan_mode, cost_optimization]
adaptive:
- trigger: "memory|persist|session|remember"
topics: [memory_files]
- default: batch_operations
time_budget: "30 min"
topics_max: 5
power_30min:
core: [context_triage, cost_optimization]
adaptive:
- trigger: "team|sync|backup|config|multi-machine|laptop|desktop"
topics: [config_hierarchy]
- trigger: "git|version control|commits|branches|repository"
topics: [git_mcp_guide]
- trigger: "secrets|API keys|credentials|env|tokens|password"
topics: [mcp_secrets_management]
- default: batch_operations
time_budget: "30 min"
topics_max: 4
note: "Adaptive: picks up to 2 from adaptive based on user context (v3.21-3.22)"
power_60min:
core: [context_triage, cost_optimization, config_hierarchy]
adaptive:
- trigger: "git"
topics: [git_mcp_guide]
- trigger: "secrets"
topics: [mcp_secrets_management]
- trigger: "security|sandbox|isolation"
topics: [sandbox_native_guide]
- default: [batch_operations, rtk_guide]
time_budget: "60 min"
topics_max: 7
note: "Comprehensive optimization with all v3.21-3.22 topics"
build_agents:
intermediate_30min:
core: [agents, agent_template, agent_examples]
time_budget: "30 min"
topics_max: 3
power_30min:
core: [agents, skills, commands]
adaptive:
- trigger: "template|structure|format"
topics: [skill_template]
- default: hooks
time_budget: "30 min"
topics_max: 4
power_60min:
core: [agents, skills, commands, hooks]
adaptive:
- trigger: "quality|review|planner|dual|two instances|spec"
topics: [dual_instance_planning]
- trigger: "validation|checklist|production|deploy"
topics: [agent_validation_checklist]
- default: agent_validation_checklist
time_budget: "60 min"
topics_max: 6
note: "Dual-instance pattern for quality workflows (v3.29.2)"
learn_security:
intermediate_30min:
core: [sandbox_native_guide, mcp_secrets_management]
adaptive:
- trigger: "production|deploy|hardening|best practices"
topics: [security_hardening]
- default: permission_modes
time_budget: "30 min"
topics_max: 4
note: "NEW goal (v3.29.2) - Security-focused learning path"
power_60min:
core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
adaptive:
- trigger: "production|safe|rules|reliability"
topics: [production_safety]
- trigger: "docker|isolation|microvm|container"
topics: [sandbox_isolation_guide]
- default: production_safety
time_budget: "60 min"
topics_max: 5
fix_problem:
any_any:
core: [troubleshooting, fix, context.symptoms]
time_budget: "N/A"
topics_max: 3
note: "Direct troubleshooting, no profiling"
learn_everything:
beginner_60min:
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.29.2 sandbox added)"
intermediate_120min:
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]
time_budget: "120 min"
topics_max: 7
note: "Agents + v3.21-3.22 topics (config/git)"
power_120min:
core: [architecture, dual_instance_planning, mcp_secrets_management, cost_optimization, cicd]
adaptive:
- trigger: "security"
topics: [security_hardening, sandbox_native_guide]
- default: [rtk_guide, bridge_guide]
time_budget: "120 min"
topics_max: 9
note: "Advanced patterns + all v3.21-3.22 features"
# ════════════════════════════════════════════════════════════════
# ONBOARDING QUESTIONS - Structure for interactive profiling
# ════════════════════════════════════════════════════════════════
onboarding_questions:
mandatory:
goal:
ask: "What's your goal right now?"
options:
get_started: "🚀 Get started quickly"
optimize: "📈 Optimize my workflow"
build_agents: "🏗️ Build custom agents/skills"
learn_security: "🛡️ Learn security best practices"
fix_problem: "🐛 Fix a problem"
learn_everything: "📚 Learn everything"
level:
ask: "Experience with Claude Code?"
options:
beginner: "🟢 Beginner (never used / just installed)"
intermediate: "🟡 Intermediate (daily use)"
power: "🔴 Power User (know basics, want advanced)"
tone:
ask: "How do you prefer me to communicate?"
options:
pedagogical: "🎓 Pedagogical - Detailed explanations, understand why"
direct: "⚡ Direct - Straight to the point"
coaching: "🧭 Coaching - Guide me with questions"
adaptive: "🔄 Adaptive - Mix based on complexity"
optional:
time:
ask: "How much time do you have?"
options:
5min: "⚡ 5-10 min"
15min: "⏱️ 15-30 min"
30min: "🎯 30-60 min"
60min: "📚 1+ hour"
120min: "📖 2+ hours"
default: "30min"
style:
ask: "How do you prefer to learn?"
options:
explain: "📖 Explanations (tell me why)"
examples: "💻 Examples (show me code)"
reference: "🎯 Quick reference (just the facts)"
handson: "🏋️ Hands-on (let me try)"
trigger: "Only ask if time >= 15min"
# Logic for progressive questioning
question_flow:
fix_problem: "goal only → skip to troubleshooting"
get_started: "goal → tone → level"
optimize: "goal → tone → level → time → style (if time >= 15min)"
build_agents: "goal → tone → level → time → style (if time >= 15min)"
learn_security: "goal → tone → level → time"
learn_everything: "goal → tone → level → time → style"
Reference in a new issue View git blame Copy permalink