# 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.41.0"
updated: "2026-05-21"

# ════════════════════════════════════════════════════════════════
# 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/core/architecture.md
# ════════════════════════════════════════════════════════════════
deep_dive:
  # Visual Diagrams Series (41 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: 41
  # 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/core/architecture.md:442"
  claudemd_sizing: 3054
  scope_success_rates: "guide/roles/adoption-approaches.md:26"
  # Claude Code Releases
  claude_code_releases: "guide/core/claude-code-releases.md"
  claude_code_releases_yaml: "machine-readable/claude-code-releases.yaml"
  # CC 2.1.3: Skills-Commands Merger
  skills_commands_merger_version: "2.1.3"
  skills_commands_merger_date: "2026-01-11"
  skills_commands_merger_summary: ".claude/commands/ merged into .claude/skills/. Add disable-model-invocation: true for user-only skills."
  skills_commands_merger_docs: "https://code.claude.com/docs/en/skills"
  skills_commands_merger_guide: "guide/ultimate-guide.md:8903"
  # Code Review Automation (Pat Cullen, Jan 2026)
  review_pr_advanced: "examples/skills/review-pr/SKILL.md"
  review_pr_advanced_note: "Since CC 2.1.3: equivalent skill uses disable-model-invocation: true in .claude/skills/"
  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/skills/review-plan/SKILL.md"
  review_plan_command_note: "Since CC 2.1.3: equivalent skill uses disable-model-invocation: true in .claude/skills/"
  # 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"
  rules_first_principles: "examples/rules/first-principles.md"  # Session invariants: Contract/Working Set/Noise model
  # Advanced Patterns (10 practitioner patterns, fact-checked March 2026)
  modular_context_architecture: "guide/ultimate-guide.md:4645"  # Pattern #1: CLAUDE.md-as-index + path-scoped rules
  adversarial_plan_review: "examples/agents/plan-challenger.md"  # Pattern #5: +52.8% security, +80% bug detection
  adr_auto_generation: "examples/agents/adr-writer.md"           # Pattern #3: criticality matrix C1/C2/C3
  codebase_audit_scoring: "examples/skills/audit-codebase/SKILL.md"  # Pattern #9: 7-category scoring (Variant Systems)
  codebase_audit_scoring_note: "Since CC 2.1.3: equivalent skill uses disable-model-invocation: true in .claude/skills/"
  event_driven_agents: "guide/workflows/event-driven-agents.md"  # Pattern #8: Linear/GitHub/Jira webhook→agent
  worktree_dependency_management: "guide/ultimate-guide.md:15180"  # Pattern #6: manual analysis, no auto-detection
  deployment_automation: "guide/ultimate-guide.md:13172"          # Pattern #10: Vercel + Infisical guardrails
  iterative_refinement_community: "guide/workflows/iterative-refinement.md:515"  # Pattern #7: Ralph Loop + Auto-Continue
  agent_teams_large_justified: "guide/workflows/agent-teams.md:120"  # Pattern #4: when >5 agents are justified
  # Settings Reference (comprehensive settings.json + env vars)
  settings_reference: "guide/core/settings-reference.md"
  settings_reference_description: "60+ settings.json keys organized into 13 sections (Core, Permissions, MCP, Sandbox, Plugins, Model, Display/UX, Auth, Attribution, Worktrees, AWS/Cloud) + 100+ environment variables across 13 categories. Unverified entries marked ⚠️; schema-only keys marked 📋."
  # Glossary (alphabetical term reference)
  glossary: "guide/core/glossary.md"
  glossary_description: "120+ terms: Claude Code-specific, community-coined patterns, AI engineering concepts. Alphabetical table with Category + Subcategory. Excludes standard CS/DevOps terms."
  # Context Engineering (consolidated reference)
  context_engineering_guide: "guide/core/context-engineering.md"
  context_engineering_what_is: "guide/core/context-engineering.md#1-what-is-context-engineering"
  context_engineering_budget: "guide/core/context-engineering.md#2-the-context-budget"
  context_engineering_hierarchy: "guide/core/context-engineering.md#3-configuration-hierarchy"
  context_engineering_modular: "guide/core/context-engineering.md#4-modular-architecture"
  context_engineering_team: "guide/core/context-engineering.md#5-team-assembly"
  context_engineering_lifecycle: "guide/core/context-engineering.md#6-context-lifecycle"
  context_engineering_quality: "guide/core/context-engineering.md#7-quality-measurement"
  context_engineering_reduction: "guide/core/context-engineering.md#8-context-reduction-techniques"
  context_engineering_maturity: "guide/core/context-engineering.md#9-maturity-assessment"
  context_engineering_maturity_description: "L0-L5 six-level maturity framework with self-assessment questions and recommended next actions per level."
  context_signal_taxonomy: "guide/core/context-engineering.md#10-signal-taxonomy-and-causal-attribution"
  context_signal_taxonomy_description: "Five-category friction signal taxonomy (syntactic/semantic/procedural/alignment/performance) + YAML event schema + per-pattern tracking dict. Replaces flat friction_score."
  context_loop_closure: "guide/core/context-engineering.md#11-loop-closure-pr-based-curation"
  context_loop_closure_description: "PR-based Curator mechanism: diff + canary A/B results + friction evidence + suggestion escalation. Multi-timescale (real-time/weekly/quarterly). Signal locality options (local cron / pushed store / hosted env)."
  context_ejection: "guide/core/context-engineering.md#12-ejection-disciplined-de-engineering"
  context_ejection_description: "Automated detection of dormant rules and negative-ROI skills for archival. Three heuristics: activation threshold, ROI tracking, profile overlap >80%."
  context_self_audit: "guide/core/context-engineering.md#13-constitutional-and-self-consistency-audits"
  context_self_audit_description: "Constitutional audit (pre-PR rule conflict check against constitution.md) + self-consistency check (weekly verification that ACE documentation claims match measured state)."
  context_multidev_reconciliation: "guide/core/context-engineering.md#14-multi-dev-profile-reconciliation"
  context_multidev_reconciliation_description: "Detection of rules present in >50% of individual profiles → hoist to shared config. Preserves personal preference rules. Bash script included."
  context_engineering_token_audit: "guide/core/context-engineering.md#15-token-audit-workflow"
  context_engineering_research: "guide/core/context-engineering.md#16-research-patterns-what-the-literature-shows"
  context_engineering_compression_tools: "guide/core/context-engineering.md#17-token-compression-tools"
  context_engineering_audit_tool: "tools/context-audit-prompt.md"
  # Setup Audit Tool (orchestrates all audit skills)
  setup_audit_tool: "tools/audit-prompt.md"
  setup_audit_tool_version: "5.0"
  setup_audit_tool_description: "Prompt-orchestrator auditing 8 weighted dimensions (100 pts): Memory & Context (20), Rules Hygiene (10), Skills Quality (10), Agents/Commands Quality (10), Security Posture (20), MCP Ecosystem (10), Workflow Commands (10), Freshness (10). Delegates to eval-skills/eval-rules/token-audit/audit-agents-skills/security-check when installed; inline bash fallback otherwise."
  setup_audit_dimensions: ["memory_context", "rules_hygiene", "skills_quality", "agents_commands", "security_posture", "mcp_ecosystem", "workflow_commands", "freshness"]
  setup_audit_delegated_skills: ["token-audit", "eval-rules", "eval-skills", "audit-agents-skills", "security-check"]
  setup_audit_scope_flag: "--include-global (extends to ~/.claude/ and ~/.claude.json)"
  setup_audit_time: "5-8 min (all skills installed) | 3-4 min (fallback mode)"
  # Agent Harness Engineering (new May 2026)
  agent_harness_guide: "guide/core/agent-harness.md"
  agent_harness_nine_components: "guide/core/agent-harness.md#2-the-nine-components"
  agent_harness_lethal_trifecta: "guide/core/agent-harness.md#3-the-lethal-trifecta-security-model"
  agent_harness_cicd: "guide/core/agent-harness.md#4-cicd-agentic-patterns"
  agent_harness_observability: "guide/core/agent-harness.md#6-observability-stack"
  agent_harness_creator_verifier: "guide/core/agent-harness.md#8-creator-verifier-pattern"
  agent_harness_three_properties: "guide/core/agent-harness.md#1-three-foundational-properties"
  agent_harness_digital_twin: "guide/core/agent-harness.md#5-digital-twin-testing"
  context_engineering_examples: "examples/context-engineering/"
  context_engineering_assembler: "examples/context-engineering/assembler.ts"
  context_engineering_profile_template: "examples/context-engineering/profile-template.yaml"
  context_engineering_skeleton: "examples/context-engineering/skeleton-template.md"
  context_engineering_canary: "examples/context-engineering/canary-check.sh"
  context_engineering_ci_drift: "examples/context-engineering/ci-drift-check.yml"
  context_engineering_budget_calc: "examples/context-engineering/context-budget-calculator.sh"
  context_engineering_eval_questions: "examples/context-engineering/eval-questions.yaml"
  context_engineering_landing: "https://cc.bruniaux.com/context/"
  context_150_ceiling: "guide/core/context-engineering.md#2-the-context-budget"
  context_ace_pipeline: "guide/core/context-engineering.md#6-context-lifecycle"
  context_path_scoping: "guide/core/context-engineering.md#4-modular-architecture"
  context_maturity_model: "guide/core/context-engineering.md#7-quality-measurement"
  # 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/core/known-issues.md"
  known_issues_github_bug: "guide/core/known-issues.md:7"  # GitHub auto-creation bug
  known_issues_token_consumption: "guide/core/known-issues.md:105"  # Excessive token usage
  known_issues_model_quality_aug2025: "guide/core/known-issues.md:197"  # Resolved: Aug 2025 degradation
  known_issues_llm_variance: "guide/core/known-issues.md:237"  # LLM day-to-day performance variance (expected behavior, not a bug)
  # RPI Workflow (Research -> Plan -> Implement)
  rpi_workflow: "guide/workflows/rpi.md"
  rpi_when_to_use: "guide/workflows/rpi.md:55"  # Decision heuristic + scenarios
  rpi_phase1_research: "guide/workflows/rpi.md:86"  # Research template + NO-GO criteria
  rpi_phase2_plan: "guide/workflows/rpi.md:173"  # Plan template + review checklist
  rpi_phase3_implement: "guide/workflows/rpi.md:237"  # Step-gate pattern + failure protocol
  rpi_slash_commands: "guide/workflows/rpi.md:281"  # /rpi:research /rpi:plan /rpi:implement templates
  rpi_vs_other_workflows: "guide/workflows/rpi.md:391"  # Comparison table: RPI vs dual-instance vs spec-first
  # Changelog Fragments Workflow
  changelog_fragments_workflow: "guide/workflows/changelog-fragments.md"  # Per-PR YAML fragments, 3-layer enforcement
  changelog_fragments_claude_rule: "guide/workflows/changelog-fragments.md:26"  # CLAUDE.md rule for autonomous fragment creation
  changelog_fragments_hook: "guide/workflows/changelog-fragments.md:88"  # UserPromptSubmit 3-tier hook (enforcement/discovery/contextual)
  changelog_fragments_ci: "guide/workflows/changelog-fragments.md:169"  # Independent CI migration check job
  # Smart-Suggest Hook
  smart_suggest_hook: "examples/hooks/bash/smart-suggest.sh"  # UserPromptSubmit behavioral coach, 3-tier priority, ROI logging
  # Identity Re-injection After Compaction (Nick Tune pattern, Feb 2026)
  identity_reinjection_hook: "guide/ultimate-guide.md:10171"  # UserPromptSubmit guard: re-injects agent identity lost after context compaction
  identity_reinjection_example: "examples/hooks/bash/identity-reinjection.sh"  # Checks last assistant message for identity marker, injects additionalContext if missing
  # Template Installation
  install_templates_script: "scripts/install-templates.sh"
  # Session management
  session_search: "guide/ops/observability.md:38"
  session_search_script: "examples/scripts/session-search.sh"
  cc_sessions_script: "examples/scripts/cc-sessions.py"  # 1225-line full version with discover subcommand
  cc_sessions_github: "https://github.com/FlorianBruniaux/cc-sessions"
  cc_sessions_discover: "guide/ultimate-guide.md#session-pattern-discovery"  # n-gram + --llm pattern analysis
  session_resume_limitations: "guide/ops/observability.md:126"
  session_cross_folder_migration: "guide/ops/observability.md:126"
  session_migration_manual: "guide/ops/observability.md:126"
  session_migration_risks: "guide/ops/observability.md:126"
  session_migration_community_tool: "guide/ops/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/ops/observability.md:467"            # Tool call audit via JSONL
  activity_monitoring_queries: "guide/ops/observability.md:467"    # jq queries for audit
  activity_monitoring_alerts: "guide/ops/observability.md:467"     # Sensitive pattern detection
  external_monitoring_tools: "guide/ops/observability.md:527"      # ccusage, claude-code-otel, Akto, MLflow, ccboard
  proxying_claude_code: "guide/ops/observability.md:699"           # Proxyman, mitmproxy, ANTHROPIC_API_URL
  ccboard_activity_plan: "docs/resource-evaluations/ccboard-activity-module-plan.md"
  # Output Styles (built-in behavior modes)
  output_styles: "guide/ultimate-guide.md:15790"
  output_styles_setting: "guide/core/settings-reference.md#outputstyle"
  output_styles_description: "Three built-in modes: Default (concise), Explanatory (adds design rationale blocks), Learning (pair-programming with TODO(human) markers). Activate via /config or outputStyle in settings.json. Custom styles via .claude/styles/."
  output_styles_custom_template: "examples/styles/custom-style-template.md"
  output_styles_official_docs: "https://code.claude.com/docs/en/output-styles"
  # Scheduled Tasks (three methods) — Cloud = Routines since 2026-04-14
  scheduled_tasks: "guide/ultimate-guide.md:9004"
  scheduled_tasks_description: "Three methods: Routines (cloud, machine-off, 3 trigger types, Anthropic infra), Desktop (local machine, min 1min, full file access), /loop (session-scoped, min 1min)"
  scheduled_tasks_cloud: "guide/ultimate-guide.md:9004"
  scheduled_tasks_cloud_plans: "Pro, Max, Team, Enterprise"
  scheduled_tasks_cloud_interval: "1 hour minimum (schedule trigger)"
  scheduled_tasks_cloud_entry_points: "claude.ai/code/routines, Desktop app (New remote task), /schedule CLI command"
  scheduled_tasks_cloud_branch_prefix: "claude/ (default)"
  scheduled_tasks_cloud_official_docs: "https://code.claude.com/docs/en/routines"
  routines_trigger_types: "schedule (cron) / API (HTTP POST endpoint) / GitHub events (webhooks)"
  routines_daily_limits: "Pro 5/day, Max 15/day, Team/Enterprise 25/day"
  routines_api_trigger: "HTTP POST to per-routine endpoint, bearer token, optional text field for context, returns session_url"
  routines_github_trigger: "17 event types (PR, push, issues, releases, check runs, workflows, discussions...), PR filters (author/label/branch/draft/fork), requires Claude GitHub App"
  routines_research_preview: "true — behavior, limits, API surface may change"
  routines_discover_command: "examples/skills/routines-discover/SKILL.md"
  routines_use_case_angles: "scheduled maintenance / event-driven reactions / alert response / cross-system sync / release automation"
  scheduled_tasks_desktop: "guide/ultimate-guide.md:9004"
  scheduled_tasks_desktop_interval: "1 minute minimum"
  scheduled_tasks_loop_command: "guide/ultimate-guide.md:9004"
  scheduled_tasks_loop_interval: "1 minute minimum"
  scheduled_tasks_loop_max_per_session: 50
  scheduled_tasks_loop_added: "v2.1.71"
  scheduled_tasks_comparison_table: "guide/ultimate-guide.md:9004"
  # 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/ecosystem/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.28.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/ecosystem/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"
  # OG Image Generation (Satori + resvg + Astro 5) - Added 2026-03-11
  og_image_generation_guide: "guide/workflows/og-image-generation.md"
  og_image_astro_template: "examples/scripts/og-image-astro.ts"
  og_image_stack: "Satori (JSX → SVG) + resvg-js (SVG → PNG) + Astro 5 static endpoint"
  og_image_gotchas: "woff1 only (no woff2/ttf), static file shadowing, dynamic stat counting from content dirs"
  og_image_testing: "opengraph.xyz + LinkedIn Post Inspector"
  # Cognitive Mode Switching / gstack (Added 2026-03-13)
  gstack_workflow: "guide/workflows/gstack-workflow.md"
  gstack_6_gears: "guide/workflows/gstack-workflow.md:34"  # Table: 6 roles, core questions, when to switch
  gstack_strategic_gate: "guide/workflows/gstack-workflow.md:47"  # Pre-implementation product gate concept
  gstack_plan_ceo_review: "examples/skills/plan-pipeline/ceo-review/SKILL.md"  # Strategic product gate command template
  gstack_plan_eng_review: "examples/skills/plan-pipeline/eng-review/SKILL.md"  # Engineering architecture gate command template
  gstack_browse_non_mcp: "guide/workflows/gstack-workflow.md:106"  # /browse native Chromium daemon vs MCP (~100ms)
  gstack_full_cycle: "guide/workflows/gstack-workflow.md:130"  # Full ship cycle demo (plan-ceo → plan-eng → review → ship → browse)
  gstack_when_to_use: "guide/workflows/gstack-workflow.md:198"  # Comparison vs Plan Pipeline and other workflows
  gstack_upstream: "https://github.com/garrytan/gstack"
  gstack_purpose: "6-skill workflow suite: strategic gate + architecture + paranoid review + release + browser QA + retro"
  third_party_tools_skill_packs: "guide/ecosystem/third-party-tools.md:558"  # Notable skill packs (gstack)
  # 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/ecosystem/remarkable-ai.md)
  remarkable_ai_guide: "guide/ecosystem/remarkable-ai.md"
  remarkable_mcp_server: "guide/ecosystem/remarkable-ai.md#1-remarkable-mcp--le-game-changer"
  remarkable_mcp_repo: "https://github.com/SamMorrowDrums/remarkable-mcp"
  remarkable_ghostwriter: "guide/ecosystem/remarkable-ai.md#2-ghostwriter--interface-vision-llm"
  remarkable_obsidian_sync: "guide/ecosystem/remarkable-ai.md#3-sync-remarkable--obsidian"
  remarkable_ocr_pipeline: "guide/ecosystem/remarkable-ai.md#4-ocr--ai-pipeline-custom"
  remarkable_ssh_tools: "guide/ecosystem/remarkable-ai.md#5-accès-ssh-et-outils-communautaires"
  remarkable_meeting_workflow: "guide/ecosystem/remarkable-ai.md#10-meeting-notes--ai-summary"
  remarkable_workflows_to_build: "guide/ecosystem/remarkable-ai.md#14-workflows-ai-augmentés-à-construire"
  remarkable_getting_started: "guide/ecosystem/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/roles/learning-with-ai.md)
  learning_quick_check: "guide/roles/learning-with-ai.md:38"
  learning_uval_protocol: "guide/roles/learning-with-ai.md:218"
  learning_claude_config: "guide/roles/learning-with-ai.md:458"
  learning_breaking_dependency: "guide/roles/learning-with-ai.md:575"
  learning_embracing_ai: "guide/roles/learning-with-ai.md:623"
  learning_30day_plan: "guide/roles/learning-with-ai.md:815"
  learning_red_flags: "guide/roles/learning-with-ai.md:612"
  # AI Roles (guide/roles/ai-roles.md)
  ai_roles_guide: "guide/roles/ai-roles.md"
  ai_roles_spec_engineer: "guide/roles/ai-roles.md#17-spec-engineer"
  ai_roles_agent_identity_architect: "guide/roles/ai-roles.md#18-agent-identity-architect"
  ai_roles_eval_engineer: "guide/roles/ai-roles.md#19-ai-eval-engineer"
  ai_roles_harness_engineer: "guide/roles/ai-roles.md#10-harness-engineer"
  ai_roles_career_matrix: "guide/roles/ai-roles.md#20-career-decision-matrix"
  # Adoption & L0-L5 (guide/roles/adoption-approaches.md)
  adoption_guide: "guide/roles/adoption-approaches.md"
  adoption_l0_l5_shapiro: "guide/roles/adoption-approaches.md#the-l0-l5-scale-where-is-your-team"
  adoption_jcurve: "guide/roles/adoption-approaches.md#the-j-curve-you-will-hit-at-l2l3"
  adoption_metr_rct: "guide/roles/adoption-approaches.md#the-metr-calibration"
  adoption_deputydev: "guide/roles/adoption-approaches.md#deputydev-enterprise-cohort"
  # Productivity Research RCTs
  productivity_rct_metr: "guide/roles/learning-with-ai.md:925"  # METR 2025: experienced devs 19% slower on large codebases despite perceiving 20% faster
  productivity_rct_echoes: "guide/roles/learning-with-ai.md:926"  # Borg 2025: 30.7% faster (median), ~55.9% habitual users, no maintainability impact downstream
  productivity_maintainability_empirical: "guide/roles/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)
  session_naming_template: "examples/claude-md/session-naming.md"
  session_naming_guide: "guide/ultimate-guide.md:815"
  session_auto_rename: 859
  learning_mode_template: "examples/claude-md/learning-mode.md"
  learn_quiz_command: "examples/skills/learn-quiz/SKILL.md"
  learn_teach_command: "examples/skills/learn-teach/SKILL.md"
  learn_alternatives_command: "examples/skills/learn-alternatives/SKILL.md"
  learning_capture_hook: "examples/hooks/bash/learning-capture.sh"
  # Anti-patterns
  vibe_coding_trap: "guide/roles/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/ops/ai-traceability.md) - Added 2026-01-24
  ai_traceability_guide: "guide/ops/ai-traceability.md"
  ai_traceability_why: "guide/ops/ai-traceability.md:29"
  ai_traceability_disclosure_spectrum: "guide/ops/ai-traceability.md:64"
  ai_traceability_co_authored_by: "guide/ops/ai-traceability.md:98"
  ai_traceability_assisted_by: "guide/ops/ai-traceability.md:120"
  ai_traceability_git_ai: "guide/ops/ai-traceability.md:170"
  ai_traceability_llvm_policy: "guide/ops/ai-traceability.md:201"
  ai_traceability_ghostty_policy: "guide/ops/ai-traceability.md:236"
  ai_traceability_fedora_policy: "guide/ops/ai-traceability.md:261"
  ai_traceability_promptpwnd: "guide/ops/ai-traceability.md:501"
  ai_traceability_implementation: "guide/ops/ai-traceability.md:566"
  ai_traceability_templates: "guide/ops/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/ecosystem/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/security/sandbox-isolation.md) - Added 2026-01-31
  sandbox_isolation_guide: "guide/security/sandbox-isolation.md"
  sandbox_isolation_decision_tree: "guide/security/sandbox-isolation.md:7"
  sandbox_docker_sandboxes: "guide/security/sandbox-isolation.md:67"
  sandbox_docker_network: "guide/security/sandbox-isolation.md:121"
  sandbox_docker_templates: "guide/security/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/core/architecture.md:606"
  # Native Claude Code Sandbox (Official docs, v2.1.0+) - Added 2026-02-02
  sandbox_native_guide: "guide/security/sandbox-native.md"
  sandbox_native_why: "guide/security/sandbox-native.md:47"  # Why Native Sandboxing
  sandbox_native_os_primitives: "guide/security/sandbox-native.md:68"  # Seatbelt vs bubblewrap
  sandbox_native_filesystem: "guide/security/sandbox-native.md:178"  # Filesystem isolation
  sandbox_native_network: "guide/security/sandbox-native.md:221"  # Network proxy architecture
  sandbox_native_modes: "guide/security/sandbox-native.md:7"  # Auto-allow vs Regular
  sandbox_native_escape_hatch: "guide/security/sandbox-native.md:341"  # dangerouslyDisableSandbox
  sandbox_native_security_limits: "guide/security/sandbox-native.md:396"  # Domain fronting, Unix sockets
  sandbox_native_opensource: "guide/security/sandbox-native.md:481"  # Open-source runtime
  sandbox_native_platforms: "guide/security/sandbox-native.md:505"  # Platform support
  sandbox_native_decision_tree: "guide/security/sandbox-native.md:517"  # Native vs Docker
  sandbox_native_config_examples: "guide/security/sandbox-native.md:564"  # Configuration examples
  sandbox_native_best_practices: "guide/security/sandbox-native.md:637"  # Best practices
  sandbox_native_troubleshooting: "guide/security/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/security/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/skills/sandbox-status/SKILL.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/security/sandbox-isolation.md:496"  # Safe Autonomy Workflows
  sandbox_anti_patterns: "guide/security/sandbox-isolation.md:546"  # Anti-Patterns
  sandbox_comparison_matrix: "guide/security/sandbox-isolation.md:477"  # Comparison Matrix
  sandbox_score: "4/5"
  # Enterprise AI Governance (guide/security/enterprise-governance.md) - Added 2026-03-10
  enterprise_governance_guide: "guide/security/enterprise-governance.md"
  enterprise_governance_local_vs_shared: "guide/security/enterprise-governance.md#1-local-vs-shared-the-governance-split"
  enterprise_governance_charter: "guide/security/enterprise-governance.md#2-ai-usage-charter"
  enterprise_governance_charter_template: "examples/scripts/ai-usage-charter-template.md"
  enterprise_governance_mcp_workflow: "guide/security/enterprise-governance.md#3-mcp-governance-workflow"
  enterprise_governance_mcp_registry: "guide/security/enterprise-governance.md#32-mcp-registry-format"
  enterprise_governance_mcp_registry_template: "examples/scripts/mcp-registry-template.yaml"
  enterprise_governance_guardrail_tiers: "guide/security/enterprise-governance.md#4-guardrail-tiers"
  enterprise_governance_tier_starter: "guide/security/enterprise-governance.md#tier-1-starter"
  enterprise_governance_tier_standard: "guide/security/enterprise-governance.md#tier-2-standard"
  enterprise_governance_tier_strict: "guide/security/enterprise-governance.md#tier-3-strict"
  enterprise_governance_tier_regulated: "guide/security/enterprise-governance.md#tier-4-regulated"
  enterprise_governance_policy_at_scale: "guide/security/enterprise-governance.md#5-policy-enforcement-at-scale"
  enterprise_governance_onboarding_checklist: "guide/security/enterprise-governance.md#52-onboarding-checklist"
  enterprise_governance_compliance_check: "guide/security/enterprise-governance.md#53-compliance-checking"
  enterprise_governance_cicd_gates: "guide/security/enterprise-governance.md#55-cicd-gates"
  enterprise_governance_audit: "guide/security/enterprise-governance.md#6-audit-compliance--governance-structure"
  enterprise_governance_soc2_iso27001: "guide/security/enterprise-governance.md#61-what-soc2-and-iso27001-auditors-actually-ask"
  enterprise_governance_audit_trail: "guide/security/enterprise-governance.md#62-audit-trail-setup"
  enterprise_governance_hook: "examples/hooks/bash/governance-enforcement-hook.sh"
  enterprise_governance_audience: "Tech leads, engineering managers, security officers"
  enterprise_governance_scope: "Org-level policy (vs security-hardening.md = individual dev security)"
  # Third-Party Tools (guide/ecosystem/third-party-tools.md) - Added 2026-02-01
  third_party_tools_guide: "guide/ecosystem/third-party-tools.md"
  third_party_tools_cost_tracking: "guide/ecosystem/third-party-tools.md:42"
  third_party_tools_rtk: "guide/ecosystem/third-party-tools.md:7"
  third_party_tools_session_mgmt: "guide/ecosystem/third-party-tools.md:126"
  third_party_tools_config_mgmt: "guide/ecosystem/third-party-tools.md:214"
  third_party_tools_hook_utilities: "guide/ecosystem/third-party-tools.md:331"
  third_party_gitdiff_watcher: "guide/ecosystem/third-party-tools.md:335"
  third_party_gitdiff_watcher_upstream: "https://github.com/fcamblor/gitdiff-watcher"
  third_party_gitdiff_watcher_purpose: "Stop hook utility — enforces build/test quality gates before handoff, fires only when matching files changed"
  third_party_tools_alternative_uis: "guide/ecosystem/third-party-tools.md:259"
  third_party_tools_known_gaps: "guide/ecosystem/third-party-tools.md:375"
  third_party_tools_recommendations: "guide/ecosystem/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_straude: "https://straude.com"
  third_party_straude_npm: "https://www.npmjs.com/package/straude"
  third_party_straude_guide: "guide/ecosystem/third-party-tools.md:92"
  third_party_straude_eval: "docs/resource-evaluations/straude-evaluation.md"
  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"
  # Project Context Bootstrapping (Added 2026-04-08)
  third_party_tools_context_bootstrap: "guide/ecosystem/third-party-tools.md:427"
  third_party_codesight: "https://github.com/Houseofmvps/codesight"
  third_party_codesight_guide: "guide/ecosystem/third-party-tools.md:433"
  third_party_codesight_purpose: "Zero-dep CLI: AST-based codebase context map (routes, schema, hot files) + wiki articles + 11 MCP tools. 7-12x token savings on base scan."
  third_party_codesight_when_useful: "TypeScript projects with recognized framework (Express/Hono/tRPC/Fastify/NestJS) and ORM. Useless on Rust. Use --wiki + MCP on large monorepos (>1500 files)."
  third_party_codesight_limitations: "AST precision TS-only; Next.js App Router = 0 routes; CF Workers raw HTTP = 0 routes; Rust = near-empty output; --init overwrites CLAUDE.md"
  # Context Compression (Added 2026-05-17)
  third_party_lean_ctx_upstream: "https://github.com/yvgude/lean-ctx"
  third_party_lean_ctx_purpose: "Local-first context compression for AI agents — Rust CLI, strips noise from LLM input (AST signatures, diff-loading, session cache, shell compression)"
  third_party_lean_ctx_stars: "1366"
  third_party_lean_ctx_status: "third_party | breaking_changes_frequent | security_fixes_recent | not_yet_integrated"
  third_party_lean_ctx_note: "Most direct RTK competitor. 60-95% token reduction claimed. Watch for stabilization before adding a dedicated guide section."
  # MCP Token Optimization (Added 2026-05-17)
  third_party_mcp2cli_upstream: "https://github.com/knowsuchagency/mcp2cli"
  third_party_mcp2cli_purpose: "Universal CLI bridge for MCP/OpenAPI/GraphQL — lazy-loads tool schemas so LLM receives only --list (16 tok/tool) + --help (120 tok) instead of full schemas injected upfront each turn"
  third_party_mcp2cli_stars: "1900"
  third_party_mcp2cli_status: "third_party | active | dev_single_tenant | cli_first_pattern | Show_HN_Best_March_2026"
  third_party_mcp2cli_note: "96-99% schema-token reduction benchmarked independently (Firecrawl, Scalekit, CircleCI). Born from 2026 MCP backlash. Caution: 4+ forks with same name — knowsuchagency is the reference. Not for enterprise multi-tenant OAuth/audit."
  # 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/core/visual-reference.md"
  # Architecture internals (guide/core/architecture.md)
  architecture_visual_overview: "guide/core/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/core/architecture.md:82"
  architecture_tools: "guide/core/architecture.md:219"
  architecture_context: "guide/core/architecture.md:312"
  architecture_subagents: "guide/core/architecture.md:471"
  architecture_permissions: "guide/core/architecture.md:541"
  architecture_mcp: "guide/core/architecture.md:746"
  architecture_mcp_visual: "guide/images/mcp-architecture-diagram.svg"
  architecture_philosophy: "guide/core/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/core/architecture.md:360"
  # MCP Apps Extension (SEP-1865) - Added 2026-01-27
  mcp_apps_architecture: "guide/core/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
  # Programmatic Billing Change (announced 2026-05-13, effective 2026-06-15)
  programmatic_billing_change: "guide/ultimate-guide.md:18854"
  programmatic_billing_effective: "2026-06-15"
  programmatic_billing_announced: "2026-05-13"
  programmatic_billing_affects: "claude -p, Agent SDK (Python+TS), GitHub Actions, OpenClaw/Hermes/Conductor, custom harnesses, CI/CD pipelines, scheduled automation"
  programmatic_billing_unaffected: "Claude Code terminal (interactive), IDE integrations, web/desktop/mobile chat, human-in-the-loop workflows"
  programmatic_billing_credits: "Pro $20/mo | Max 5x $100/mo | Max 20x $200/mo — no rollover, not automatic (requires email activation)"
  programmatic_billing_overage_sonnet: "$3/MTok input, $15/MTok output (standard API rates)"
  programmatic_billing_api_key_trap: "guide/ultimate-guide.md:18895"
  programmatic_billing_audit: "claude /cost (session) + npx ccusage (cross-session history)"
  programmatic_billing_claim_deadline: "2026-06-15 — credits require activation via Anthropic email sent ~2 weeks prior"
  programmatic_billing_strategic_context: "Split = Anthropic UX (unlimited interactive) vs your harness (capped programmatic). Related: §9.25 Harness Engineering, §11 AI Ecosystem."
  programmatic_billing_timeline: "2026-05-06 interactive limits doubled (SpaceX) → 2026-05-13 change announced → 2026-06-15 effective → 2026-07-13 +50% interactive bonus ends"
  plan_mode: 576
  ultraplan: 3003
  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
  auto_memories_file_limits: 5020  # 200-line cap, 25KB max, 200 files/dir — see also memory_limits_detail
  memory_limits_detail: "MEMORY.md: 200 lines max, 25KB max. Memory dir: 200 files max. Truncation: lines first, then bytes, warning appended."
  # Auto Dream (Community-Discovered) - Added 2026-03-25
  auto_dream: 4945
  auto_dream_phases: 4945
  auto_dream_trigger: "24h + 5 sessions since last consolidation"
  auto_dream_access: "/memory command (or /dream if available)"
  auto_dream_source: "https://github.com/Piebald-AI/claude-code-system-prompts/blob/main/system-prompts/agent-prompt-dream-memory-consolidation.md"
  auto_dream_status: "community-discovered, not in official Anthropic release notes"
  # 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
  skills_taxonomy: 6718
  skills_evals: 6954
  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: "35+ (Claude Code, Cursor, VS Code, GitHub Copilot, Codex, Gemini CLI, Goose, Roo Code, Spring AI, Databricks Genie Code, OpenHands, Amp, Letta, Junie, Firebender, OpenCode, Mux, Kiro, Snowflake Cortex Code, Ona, Laravel Boost, Emdash, TRAE, fast-agent, nanobot, VT Code, Qodo, Agentman, Mistral Vibe, Google AI Edge Gallery, Workshop, Factory, pi, Piebald, Command Code...)"
  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-03-06)
  plugins_system: 12015
  plugins_commands: 12029
  plugins_marketplace: 12042
  plugins_community_marketplaces: 12344
  plugins_featured_community: 12385  # Vitals + SE-CoVe comparison section
  plugins_recommended: "examples/plugins/"
  plugins_se_cove: "examples/plugins/se-cove.md"
  plugins_vitals:
    url: "https://github.com/chopratejas/vitals"
    install: "/plugin marketplace add chopratejas/vitals"
    command: "/vitals:scan"
    purpose: "Codebase hotspot detection — git churn x complexity x coupling centrality"
    status: "v0.1 alpha"
    updated: "2026-03-06"
  plugins_se_cove_detail:
    url: "https://github.com/vertti/se-cove-claude-plugin"
    install: "/plugin marketplace add vertti/se-cove-claude-plugin"
    command: "/chain-of-verification:verify"
    purpose: "Chain-of-Verification — independent verifier prevents confirmation bias"
    research: "arXiv:2309.11495 (ACL 2024)"
    status: "v1.1.1 stable"
    cost: "~2x tokens"
  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/core/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/core/methodologies.md:245"
  verification_loops_source: "https://www.anthropic.com/engineering/claude-code-best-practices"
  eval_harness: "guide/core/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/core/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/skills/audit-agents-skills/SKILL.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/ecosystem/ai-ecosystem.md:2170"
  practitioner_dave_van_veen: "guide/ecosystem/ai-ecosystem.md:2174"
  practitioner_matteo_collina: "guide/ecosystem/ai-ecosystem.md:2203"
  # Outcome Engineering (o16g) - Emerging manifesto (2026-02-13)
  outcome_engineering_o16g: "guide/ecosystem/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/ecosystem/ai-ecosystem.md:2242"
  practitioner_steinberger_source: "https://steipete.me/posts/2025/shipping-at-inference-speed"
  practitioner_addy_osmani: "guide/ecosystem/ai-ecosystem.md:2269"
  practitioner_osmani_source: "https://addyo.substack.com/p/the-80-problem-in-agentic-coding"
  practitioner_alan: "guide/ecosystem/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/security/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/ecosystem/ai-ecosystem.md:2269"
  comprehension_debt_secondary: "guide/ecosystem/ai-ecosystem.md:2269"  # See also: vibe_coding_trap (primary)
  # DevOps/SRE Guide (guide/ops/devops-sre.md)
  devops_sre_guide: "guide/ops/devops-sre.md"
  devops_fire_framework: "guide/ops/devops-sre.md:46"
  devops_k8s_troubleshooting: "guide/ops/devops-sre.md:129"
  devops_k8s_prompts: "guide/ops/devops-sre.md:151"
  devops_incident_response: "guide/ops/devops-sre.md:333"
  devops_iac_patterns: "guide/ops/devops-sre.md:504"
  devops_guardrails: "guide/ops/devops-sre.md:687"
  devops_limitations: "guide/ops/devops-sre.md:297"
  devops_quick_reference: "guide/ops/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"
  # Plan-Validate-Execute Pipeline (Mar 2026)
  plan_pipeline_workflow: "guide/workflows/plan-pipeline.md"
  plan_pipeline_philosophy: "non-prescriptive AI-first + No Bandaids first principles + ADR learning loop"
  plan_pipeline_commands: "/plan-start → /plan-validate → /plan-execute"
  plan_pipeline_agent_pool: "12 research agents (trigger-based) + 8 validation agents (trigger-based)"
  plan_pipeline_adr_loop: "Watching (1) → Emerging (2) → Confirmed (3+) → CLAUDE.md promotion"
  plan_pipeline_claude_md_limit: "120 lines hard limit + pointer strategy for sub-files"
  plan_pipeline_context_reset: "/clear between each command (plan, validate, execute)"
  plan_pipeline_cost: "$2-10 typical Tier 2 feature, compounds down as ADR coverage grows"
  plan_start_command: "examples/skills/plan-pipeline/start/SKILL.md"
  plan_start_phases: "5 phases: PRD analysis, design analysis, technical decisions, dynamic team, metrics"
  plan_start_tiers: "Tier 0 Solo (0 agents) → Tier 4 Full Spectrum (10+ agents)"
  plan_validate_command: "examples/skills/plan-pipeline/validate/SKILL.md"
  plan_validate_layer1: "structural checks inline: format, deps, file existence, ADR consistency, CLAUDE.md"
  plan_validate_layer2: "0-8 specialist agents triggered by plan content (security Opus, db Opus, integration Opus)"
  plan_validate_autofix: "Bucket A auto-resolve (ADR/PATTERNS/first-principles ~95%) + Bucket B human input"
  plan_execute_command: "examples/skills/plan-pipeline/execute/SKILL.md"
  plan_execute_flow: "worktree → TDD scaffold → parallel level execution → drift detection → quality gate → smoke test → PR merge → cleanup"
  planning_coordinator_agent: "examples/agents/planning-coordinator.md"
  planning_coordinator_role: "Opus synthesis agent: merges multi-agent reports into coherent task graph, resolves conflicts via ADR precedence"
  integration_reviewer_agent: "examples/agents/integration-reviewer.md"
  integration_reviewer_role: "Opus runtime validator: connection params, async/sync, env vars, library API correctness, OTEL pipeline"
  # 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/skills/git-worktree/SKILL.md"
  git_worktree_status_command: "examples/skills/git-worktree-status/SKILL.md"
  git_worktree_remove_command: "examples/skills/git-worktree-remove/SKILL.md"
  git_worktree_clean_command: "examples/skills/git-worktree-clean/SKILL.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/ecosystem/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/ecosystem/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/ecosystem/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/security/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
  spec_feature_list: "guide/workflows/spec-first.md"  # Feature list as harness primitive: triple structure (behavior+verify+state), WIP=1, state machine not_started→passing
  tdd_verification_gap: "guide/workflows/tdd-with-claude.md"  # Verification Gap pattern: 3-layer stack (lint/test/e2e), independent evaluator, Anthropic experiment source
  task_session_lifecycle: "guide/workflows/task-management.md"  # 10-step session lifecycle protocol: START/INIT/READ/SELECT/EXECUTE/VERIFY/WRAP UP/CLEANUP/COMMIT/HANDOFF + progress.md template
  session_lifecycle_feature_list_template: "examples/workflows/feature-list.json"  # Machine-readable scope tracker template
  session_lifecycle_verification_hook: "examples/hooks/bash/verification-gate.sh"  # PostToolUse independent evaluator hook
  atdd_with_agents: "guide/core/methodologies.md:161"  # ATDD + Gherkin for agentic workflows
  harness_agents_md_as_toc: "guide/ultimate-guide.md:23447"  # AGENTS.md as ~100-line TOC pointing to docs/ hierarchy, not encyclopedia
  harness_knowledge_boundary: "guide/ultimate-guide.md:23487"  # "What agent can't see doesn't exist": encode Slack/docs as repo markdown
  harness_knowledge_base: "guide/ultimate-guide.md:23505"  # Structured docs/ with design-docs/, exec-plans/, product-specs/, references/
  harness_observability_stack: "guide/ultimate-guide.md:23543"  # Ephemeral per-worktree observability: Vector + VictoriaLogs/Metrics/Traces + LogQL/PromQL/TraceQL
  harness_taste_invariants: "guide/ultimate-guide.md:23563"  # Taste invariants + custom linters with agent-readable error messages
  harness_anti_entropy: "guide/ultimate-guide.md:23563"  # Doc-gardening agent + background cleanup + quality score per domain
  harness_layered_arch: "guide/ultimate-guide.md:23563"  # Layered domain arch enforced by linters: Types→Config→Repo→Service→Runtime→UI
  harness_throughput_merge: "guide/ultimate-guide.md:23563"  # High-throughput merge philosophy: fixes cheap, waiting expensive
  openai_harness_engineering: "docs/resource-evaluations/2026-02-11-openai-harness-engineering.md"  # Score 5/5: OpenAI Codex team, 1M lines, 5 months, 3 engineers, no manual code
  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/ecosystem/ai-ecosystem.md"
  ai_ecosystem_goose: "guide/ecosystem/ai-ecosystem.md:2074"
  ai_ecosystem_goose_comparison: "guide/ecosystem/ai-ecosystem.md:2090"
  ai_ecosystem_context_packing: "guide/ecosystem/ai-ecosystem.md:2533"
  ai_ecosystem_multi_ide_sync: "guide/ecosystem/ai-ecosystem.md:1282"
  agents_md_support_status: "guide/ecosystem/ai-ecosystem.md:1348"
  ai_ecosystem_build_vs_use: "guide/ecosystem/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/ecosystem/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/ecosystem/ai-ecosystem.md:1066"
  ai_ecosystem_alternative_providers: "guide/ecosystem/ai-ecosystem.md:2639"
  voice_refine_skill: "examples/skills/voice-refine/SKILL.md"
  # PR Triage Skill (added 2026-03-05)
  pr_triage_skill: "examples/skills/pr-triage/SKILL.md"
  pr_triage_template: "examples/skills/pr-triage/templates/review-comment.md"
  pr_triage_phases: "3 (audit + deep review + validated comments)"
  pr_triage_when: "5+ open PRs, periodic backlog triage, post-sprint cleanup"
  pr_triage_vs_review_pr: "pr-triage = backlog N PRs | review-pr = single PR focus"
  # Issue Triage Skill (added 2026-03-05)
  issue_triage_skill: "examples/skills/issue-triage/SKILL.md"
  issue_triage_template: "examples/skills/issue-triage/templates/issue-comment.md"
  issue_triage_phases: "3 (audit + deep analysis + validated actions)"
  issue_triage_when: "10+ open issues, periodic backlog cleanup, duplicate detection"
  issue_triage_jaccard: "Jaccard similarity >= 0.60 on normalized title+body tokens — self-contained, no external lib"
  issue_triage_thresholds: "staleness_days=30, very_stale_days=90, jaccard_threshold=60%, closed_compare=20, open_limit=100"
  issue_triage_vs_pr_triage: "issue-triage = issue backlog (comment/label/close) | pr-triage = PR backlog (code review comment)"
  # 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/ecosystem/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 (334 questions, 16 categories)
  quiz_overview: "quiz/README.md"
  quiz_file: "quiz/questions.json"
  quiz_count: 334
  quiz_categories: 16
  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/security/production-safety.md"  # Production safety rules
  security_hardening: "guide/security/security-hardening.md"  # Security best practices
  security_cve_summary: "guide/security/security-hardening.md:15"  # Decision Matrix + CVEs
  security_supply_chain_stats: "guide/security/security-hardening.md:137"  # Agent Skills Supply Chain Risks
  security_mcp_scan_tool: "guide/security/security-hardening.md:32"  # MCP Vetting Workflow
  security_malicious_extensions: "guide/security/security-hardening.md:252"  # .claude/ attack surface (§1.5)
  security_kill_switch: "guide/security/security-hardening.md:630"  # AI Kill Switch & Containment Architecture (§3.5)
  security_claude_folder_audit: "guide/security/security-hardening.md:228"  # Repository Pre-Scan (§1.4)
  security_toxicskills_evaluation: "docs/resource-evaluations/snyk-toxicskills-evaluation.md"
  security_check_command: "examples/skills/security-check/SKILL.md"  # Quick config check vs known threats
  security_audit_command: "examples/skills/security-audit/SKILL.md"  # Full 6-phase security audit (score /100)
  security_threat_db: "examples/skills/update-threat-db/threat-db.yaml"  # Threat intelligence database (authors, skills, CVEs, patterns)
  security_update_threat_db: "examples/skills/update-threat-db/SKILL.md"  # /update-threat-db — research & update threat database
  security_cc_scanner: "guide/security/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/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/ecosystem/mcp-servers-ecosystem.md:113"  # Git MCP server documentation
  # Packmind Skill Design Patterns (Added 2026-04-16, from Packmind Apache 2.0 repo)
  skill_design_patterns_guide: "guide/core/skill-design-patterns.md"
  skill_design_patterns_shared_ground_truth: "guide/core/skill-design-patterns.md#shared-ground-truth-injection"
  skill_design_patterns_prefiltered_refs: "guide/core/skill-design-patterns.md#pre-filtered-references-via-frontmatter-paths"
  skill_design_patterns_detection_only: "guide/core/skill-design-patterns.md#detection-only-scope-boundary"
  skill_design_patterns_input_handler: "guide/core/skill-design-patterns.md#input-handler-dispatch"
  skill_design_patterns_versioned_subdirs: "guide/core/skill-design-patterns.md#versioned-sub-directories-for-tool-version-coupling"
  skill_design_patterns_two_tier: "guide/core/skill-design-patterns.md#two-tier-standards"
  skill_design_patterns_committed_plans: "guide/core/skill-design-patterns.md#plans-and-specs-as-committed-artifacts"
  # MCP Reference File Pattern (Packmind-inspired)
  mcp_reference_file_pattern: "guide/ecosystem/mcp-servers-ecosystem.md#documenting-an-mcp-for-claude-the-reference-file-pattern"
  mcp_reference_file_template: "examples/skills/mcp-integration-reference/"
  mcp_reference_file_example: "examples/skills/mcp-integration-reference/references/sentry-mcp.md"
  # Skeptical Reviewer Pattern (Packmind-inspired)
  skeptical_reviewer_pattern: "guide/ultimate-guide.md#pattern-skeptical-reviewer-sub-agent"
  skeptical_reviewer_principle: "50%+ rejection rate is normal and healthy — forces evidence-based output"
  # Handoff Triad (Packmind-inspired, merge rules per section)
  handoff_triad_create: "examples/skills/handoff-create/SKILL.md"
  handoff_triad_resume: "examples/skills/handoff-resume/SKILL.md"
  handoff_triad_update: "examples/skills/handoff-update/SKILL.md"
  handoff_triad_merge_rules: "Files=merge, Discoveries=append, Work Done=append-only, Status=replace, Next Steps=replace"
  # Recipe Template (Context Validation Checkpoints)
  recipe_template: "examples/skills/recipe-template/SKILL.md"
  recipe_template_key_pattern: "Context Validation Checkpoints — precondition checklist Claude must verify before executing steps"
  # Statusline script (32K output buffer trick)
  statusline_script: "examples/scripts/statusline.py"
  statusline_32k_trick: "Subtract 32K from context_window_size to get effective input window (output buffer reservation)"
  # context-evaluator patterns (MIT, Packmind, Added 2026-04-16)
  context_evaluator_tool: "guide/ecosystem/third-party-tools.md#context-evaluator"
  context_evaluator_website: "https://context-evaluator.ai"
  skill_design_patterns_runtime_prompt_logging: "guide/core/skill-design-patterns.md#runtime-prompt-logging"
  skill_design_patterns_adaptive_mode: "guide/core/skill-design-patterns.md#adaptive-unifiedparallel-mode"
  # Credits & Attributions
  credits_guide: "guide/core/credits.md"

# ════════════════════════════════════════════════════════════════
# 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)"
  /ultraplan: "cloud plan mode — draft in cloud, review in browser, execute on web or teleport back (v2.1.91+, GitHub required)"
  /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)"
  /usage: "shows token + cost usage per model (v2.1.118) — replaces /cost and /stats"
  /cost: "alias for /usage (v2.1.118+)"
  /stats: "alias for /usage (v2.1.118+)"
  /recap: "summarizes the current session (v2.1.108)"
  /effort: "sets thinking effort level: xlow/low/default/high/xhigh (v2.1.111)"
  /tui: "shows tool calls in TUI mode (v2.1.110)"
  /focus: "focuses agent on specific files or tasks (v2.1.110)"
  /less-permission-prompts: "reduces permission prompt frequency (v2.1.111)"
  /ultrareview: "multi-agent cloud code review (v2.1.114)"
  /proactive: "enables proactive suggestions (alias, v2.1.105)"
  /undo: "reverts last action (v2.1.108)"
  /goal: "set completion condition; Claude works autonomously until met — live overlay shows elapsed time, turns, and token usage (v2.1.139)"
  /scroll-speed: "tune mouse wheel scroll speed with interactive live-preview slider (v2.1.139)"

# ════════════════════════════════════════════════════════════════
# 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"
  "project purge [path]": "delete all Claude Code state for a project (transcripts, tasks, file history); flags: --dry-run -y -i --all (v2.1.126)"
  "ultrareview [target]": "run /ultrareview non-interactively from CI/scripts; --json; exits 0 on completion 1 on failure (v2.1.120)"
  "plugin prune": "remove orphaned auto-installed plugin dependencies; cascade with plugin uninstall --prune (v2.1.121)"
  "plugin details <name>": "show plugin component inventory (skills, agents, commands, hooks, MCP) and projected per-session token cost (v2.1.139)"
  "--plugin-url <url>": "fetch plugin .zip from URL and load for current session (v2.1.129)"

# ════════════════════════════════════════════════════════════════
# ENVIRONMENT VARIABLES
# ════════════════════════════════════════════════════════════════
env_vars:
  CLAUDE_CODE_SESSION_ID: "unique session ID injected into all Bash subprocess envs, matches hook stdin session_id field (v2.1.132)"
  CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN: "set to 1 to opt out of fullscreen alternate-screen renderer, keeps output in native scrollback (v2.1.132)"
  CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE: "set to 1 for auto Homebrew/WinGet upgrades in background with restart prompt (v2.1.129)"

# ════════════════════════════════════════════════════════════════
# WORKTREE SETTINGS
# ════════════════════════════════════════════════════════════════
worktree_settings:
  baseRef: "fresh|head — controls branch base for --worktree/EnterWorktree/agent-isolation; fresh=origin default, head=local HEAD including unpushed commits; BREAKING default changed to fresh in v2.1.133"

# ════════════════════════════════════════════════════════════════
# 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"
  skills/: "user-invocable skills in .claude/skills/ (slash commands + knowledge modules; since CC 2.1.3 commands/ merged here — use disable-model-invocation: true for user-only skills)"
  hooks/: "event scripts"
  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"
  bypass_safety_invariant: 1076  # Paths always prompted even in bypassPermissions (git/, .claude/, shell configs)
  bypass_safe_paths: ".git/, .claude/ (except worktrees), .bashrc, .zshrc, .bash_profile, .gitconfig, .mcp.json, .claude.json"
  bypass_note: "Content-specific ask rules (e.g. Bash(npm publish:*)) also survive bypassPermissions"

# ════════════════════════════════════════════════════════════════
# 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/ecosystem/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/ecosystem/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"
  alwaysLoad: "when true in MCP server config, all tools skip tool-search deferral and are always available without ToolSearch call (v2.1.121)"
  CLAUDE_PROJECT_DIR: "auto-injected into stdio MCP server process envs; usable as ${CLAUDE_PROJECT_DIR} in plugin command strings (v2.1.139)"
  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/core/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/core/architecture.md:284"

# ════════════════════════════════════════════════════════════════
# ARCHITECTURE INTERNALS - see guide/core/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/core/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 ($$)"
  ultraplan: "cloud planning (multi-agent Opus 4.6) + browser review + web or terminal execution (v2.1.91+)"
  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:
  # Lifecycle
  SessionStart: "session opened"
  SessionEnd: "session closed"
  Setup: "initialization phase"
  # Agent actions
  Stop: "agent stopped naturally"
  StopFailure: "agent stopped with error"
  PreToolUse: "before tool call (exit 2 to block, return JSON to approve/modify)"
  PostToolUse: "after tool completes"
  PostToolUseFailure: "after tool fails"
  # Permissions
  PermissionDenied: "permission refused"
  PermissionRequest: "permission being requested (can return decision)"
  # Compaction
  PreCompact: "before context compaction"
  PostCompact: "after context compaction"
  # Multi-agent
  SubagentStart: "subagent spawned"
  SubagentStop: "subagent completed"
  TeammateIdle: "teammate waiting"
  TaskCreated: "new task created"
  TaskCompleted: "task finished"
  # Configuration
  ConfigChange: "settings changed"
  InstructionsLoaded: "CLAUDE.md loaded"
  # File system
  CwdChanged: "working directory changed"
  FileChanged: "file modified on disk"
  WorktreeCreate: "git worktree created"
  WorktreeRemove: "git worktree removed"
  # User interaction
  UserPromptSubmit: "before prompt sent to model (can inject additionalContext)"
  Notification: "UI notification triggered"
  Elicitation: "model requesting additional info"
  ElicitationResult: "user responded to elicitation"
  # Total: 27 events (updated 2026-04-02, source: source code analysis)

# Hook Execution Model (v2.1.0+)
hooks_execution_model: 7969  # Section in ultimate-guide.md
hooks_session_scoped: 9507   # Session-scoped hooks (ephemeral, no settings.json, skills use this)
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", "334-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"
      - "init_official_docs() — fetch and store local baseline snapshot of official Anthropic docs (run once)"
      - "refresh_official_docs() — update current snapshot without touching baseline"
      - "diff_official_docs() — compare baseline vs current at section level, zero network calls"
      - "search_official_docs(query) — search official docs, loads only matching sections"
    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", "/ccguide:init-docs", "/ccguide:refresh-docs", "/ccguide:diff-docs", "/ccguide:search-docs", "/ccguide:daily"]
    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/ecosystem/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 (334 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.40.0, 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.1.0"
  last_updated: "2026-03-09"
  aligned_with_guide: "3.40.0"
  changelog:
    - version: "2.1.0"
      date: "2026-03-09"
      changes: "Quiz count 264→271, skills_taxonomy/skills_evals/session_auto_rename deep_dive keys, plan_pipeline adaptive triggers in build_agents+learn_everything, v3.21-3.32 version refs updated"
    - 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.32 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.40.0 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.32)"

    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]
        - trigger: "plan|pipeline"
          topics: [plan_pipeline_workflow]
        - default: [batch_operations, rtk_guide]
      time_budget: "60 min"
      topics_max: 7
      note: "Comprehensive optimization with all v3.21-3.32 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]
        - trigger: "plan|pipeline|validate|execute"
          topics: [plan_pipeline_workflow]
        - default: agent_validation_checklist
      time_budget: "60 min"
      topics_max: 6
      note: "Dual-instance pattern for quality workflows (v3.40.0)"

  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.40.0) - 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.40.0 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.32 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]
        - trigger: "plan|pipeline|validate|execute"
          topics: [plan_pipeline_workflow]
        - default: [rtk_guide, bridge_guide]
      time_budget: "120 min"
      topics_max: 9
      note: "Advanced patterns + all v3.21-3.32 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"