claude-code-ultimate-guide-mcp 1.0.4 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3,8 +3,8 @@
3
3
  # Source: guide/ultimate-guide.md
4
4
  # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
5
5
 
6
- version: "3.29.0"
7
- updated: "2026-02-26"
6
+ version: "3.38.0"
7
+ updated: "2026-03-17"
8
8
 
9
9
  # ════════════════════════════════════════════════════════════════
10
10
  # DEEP DIVE - Line numbers in guide/ultimate-guide.md
@@ -12,12 +12,12 @@ updated: "2026-02-26"
12
12
  # For architecture internals, see guide/core/architecture.md
13
13
  # ════════════════════════════════════════════════════════════════
14
14
  deep_dive:
15
- # Visual Diagrams Series (40 Mermaid diagrams)
15
+ # Visual Diagrams Series (41 Mermaid diagrams)
16
16
  mermaid_diagrams:
17
17
  path: "guide/diagrams/"
18
18
  description: "41 interactive Mermaid diagrams: model selection, agent lifecycle, memory hierarchy, security threats, multi-agent patterns, AI fluency paths"
19
19
  files: 10
20
- total_diagrams: 40
20
+ total_diagrams: 41
21
21
  # AI-Assisted Development Workflows (from MetalBear/arXiv research)
22
22
  exploration_workflow: "guide/workflows/exploration-workflow.md"
23
23
  script_generation: "guide/workflows/iterative-refinement.md:200"
@@ -47,6 +47,47 @@ deep_dive:
47
47
  rules_code_quality_review: "examples/rules/code-quality-review.md"
48
48
  rules_test_review: "examples/rules/test-review.md"
49
49
  rules_performance_review: "examples/rules/performance-review.md"
50
+ rules_first_principles: "examples/rules/first-principles.md" # Session invariants: Contract/Working Set/Noise model
51
+ # Advanced Patterns (10 practitioner patterns, fact-checked March 2026)
52
+ modular_context_architecture: "guide/ultimate-guide.md:4645" # Pattern #1: CLAUDE.md-as-index + path-scoped rules
53
+ adversarial_plan_review: "examples/agents/plan-challenger.md" # Pattern #5: +52.8% security, +80% bug detection
54
+ adr_auto_generation: "examples/agents/adr-writer.md" # Pattern #3: criticality matrix C1/C2/C3
55
+ codebase_audit_scoring: "examples/commands/audit-codebase.md" # Pattern #9: 7-category scoring (Variant Systems)
56
+ event_driven_agents: "guide/workflows/event-driven-agents.md" # Pattern #8: Linear/GitHub/Jira webhook→agent
57
+ worktree_dependency_management: "guide/ultimate-guide.md:15180" # Pattern #6: manual analysis, no auto-detection
58
+ deployment_automation: "guide/ultimate-guide.md:13172" # Pattern #10: Vercel + Infisical guardrails
59
+ iterative_refinement_community: "guide/workflows/iterative-refinement.md:515" # Pattern #7: Ralph Loop + Auto-Continue
60
+ agent_teams_large_justified: "guide/workflows/agent-teams.md:120" # Pattern #4: when >5 agents are justified
61
+ # Settings Reference (comprehensive settings.json + env vars)
62
+ settings_reference: "guide/core/settings-reference.md"
63
+ 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 📋."
64
+ # Glossary (alphabetical term reference)
65
+ glossary: "guide/core/glossary.md"
66
+ glossary_description: "120+ terms: Claude Code-specific, community-coined patterns, AI engineering concepts. Alphabetical table with Category + Subcategory. Excludes standard CS/DevOps terms."
67
+ # Context Engineering (consolidated reference)
68
+ context_engineering_guide: "guide/core/context-engineering.md"
69
+ context_engineering_what_is: "guide/core/context-engineering.md#1-what-is-context-engineering"
70
+ context_engineering_budget: "guide/core/context-engineering.md#2-the-context-budget"
71
+ context_engineering_hierarchy: "guide/core/context-engineering.md#3-configuration-hierarchy"
72
+ context_engineering_modular: "guide/core/context-engineering.md#4-modular-architecture"
73
+ context_engineering_team: "guide/core/context-engineering.md#5-team-assembly"
74
+ context_engineering_lifecycle: "guide/core/context-engineering.md#6-context-lifecycle"
75
+ context_engineering_quality: "guide/core/context-engineering.md#7-quality-measurement"
76
+ context_engineering_reduction: "guide/core/context-engineering.md#8-context-reduction-techniques"
77
+ context_engineering_audit_tool: "tools/context-audit-prompt.md"
78
+ context_engineering_examples: "examples/context-engineering/"
79
+ context_engineering_assembler: "examples/context-engineering/assembler.ts"
80
+ context_engineering_profile_template: "examples/context-engineering/profile-template.yaml"
81
+ context_engineering_skeleton: "examples/context-engineering/skeleton-template.md"
82
+ context_engineering_canary: "examples/context-engineering/canary-check.sh"
83
+ context_engineering_ci_drift: "examples/context-engineering/ci-drift-check.yml"
84
+ context_engineering_budget_calc: "examples/context-engineering/context-budget-calculator.sh"
85
+ context_engineering_eval_questions: "examples/context-engineering/eval-questions.yaml"
86
+ context_engineering_landing: "https://cc.bruniaux.com/context/"
87
+ context_150_ceiling: "guide/core/context-engineering.md#2-the-context-budget"
88
+ context_ace_pipeline: "guide/core/context-engineering.md#6-context-lifecycle"
89
+ context_path_scoping: "guide/core/context-engineering.md#4-modular-architecture"
90
+ context_maturity_model: "guide/core/context-engineering.md#7-quality-measurement"
50
91
  # Team Configuration at Scale (Profile-Based Module Assembly)
51
92
  team_ai_instructions_section: "guide/ultimate-guide.md#35-team-configuration-at-scale"
52
93
  team_ai_instructions_workflow: "guide/workflows/team-ai-instructions.md"
@@ -62,12 +103,33 @@ deep_dive:
62
103
  known_issues_github_bug: "guide/core/known-issues.md:7" # GitHub auto-creation bug
63
104
  known_issues_token_consumption: "guide/core/known-issues.md:105" # Excessive token usage
64
105
  known_issues_model_quality_aug2025: "guide/core/known-issues.md:197" # Resolved: Aug 2025 degradation
106
+ known_issues_llm_variance: "guide/core/known-issues.md:237" # LLM day-to-day performance variance (expected behavior, not a bug)
107
+ # RPI Workflow (Research -> Plan -> Implement)
108
+ rpi_workflow: "guide/workflows/rpi.md"
109
+ rpi_when_to_use: "guide/workflows/rpi.md:55" # Decision heuristic + scenarios
110
+ rpi_phase1_research: "guide/workflows/rpi.md:86" # Research template + NO-GO criteria
111
+ rpi_phase2_plan: "guide/workflows/rpi.md:173" # Plan template + review checklist
112
+ rpi_phase3_implement: "guide/workflows/rpi.md:237" # Step-gate pattern + failure protocol
113
+ rpi_slash_commands: "guide/workflows/rpi.md:281" # /rpi:research /rpi:plan /rpi:implement templates
114
+ rpi_vs_other_workflows: "guide/workflows/rpi.md:391" # Comparison table: RPI vs dual-instance vs spec-first
115
+ # Changelog Fragments Workflow
116
+ changelog_fragments_workflow: "guide/workflows/changelog-fragments.md" # Per-PR YAML fragments, 3-layer enforcement
117
+ changelog_fragments_claude_rule: "guide/workflows/changelog-fragments.md:26" # CLAUDE.md rule for autonomous fragment creation
118
+ changelog_fragments_hook: "guide/workflows/changelog-fragments.md:88" # UserPromptSubmit 3-tier hook (enforcement/discovery/contextual)
119
+ changelog_fragments_ci: "guide/workflows/changelog-fragments.md:169" # Independent CI migration check job
120
+ # Smart-Suggest Hook
121
+ smart_suggest_hook: "examples/hooks/bash/smart-suggest.sh" # UserPromptSubmit behavioral coach, 3-tier priority, ROI logging
122
+ # Identity Re-injection After Compaction (Nick Tune pattern, Feb 2026)
123
+ identity_reinjection_hook: "guide/ultimate-guide.md:10171" # UserPromptSubmit guard: re-injects agent identity lost after context compaction
124
+ identity_reinjection_example: "examples/hooks/bash/identity-reinjection.sh" # Checks last assistant message for identity marker, injects additionalContext if missing
65
125
  # Template Installation
66
126
  install_templates_script: "scripts/install-templates.sh"
67
127
  # Session management
68
128
  session_search: "guide/ops/observability.md:38"
69
129
  session_search_script: "examples/scripts/session-search.sh"
70
- cc_sessions_script: "examples/scripts/cc-sessions.py"
130
+ cc_sessions_script: "examples/scripts/cc-sessions.py" # 1225-line full version with discover subcommand
131
+ cc_sessions_github: "https://github.com/FlorianBruniaux/cc-sessions"
132
+ cc_sessions_discover: "guide/ultimate-guide.md#session-pattern-discovery" # n-gram + --llm pattern analysis
71
133
  session_resume_limitations: "guide/ops/observability.md:126"
72
134
  session_cross_folder_migration: "guide/ops/observability.md:126"
73
135
  session_migration_manual: "guide/ops/observability.md:126"
@@ -96,7 +158,7 @@ deep_dive:
96
158
  rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
97
159
  rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh"
98
160
  rtk_purpose: "Command output filtering before LLM context (60-90% avg reduction)"
99
- rtk_version_tested: "v0.16.0"
161
+ rtk_version_tested: "v0.28.0"
100
162
  rtk_score: "5/5"
101
163
  rtk_installation: "cargo install rtk or brew install rtk-ai/tap/rtk"
102
164
  # Google Antigravity (Agent-First IDE)
@@ -108,6 +170,24 @@ deep_dive:
108
170
  # PDF Generation
109
171
  pdf_generation: "guide/workflows/pdf-generation.md"
110
172
  pdf_generator_skill: "examples/skills/pdf-generator.md"
173
+ # OG Image Generation (Satori + resvg + Astro 5) - Added 2026-03-11
174
+ og_image_generation_guide: "guide/workflows/og-image-generation.md"
175
+ og_image_astro_template: "examples/scripts/og-image-astro.ts"
176
+ og_image_stack: "Satori (JSX → SVG) + resvg-js (SVG → PNG) + Astro 5 static endpoint"
177
+ og_image_gotchas: "woff1 only (no woff2/ttf), static file shadowing, dynamic stat counting from content dirs"
178
+ og_image_testing: "opengraph.xyz + LinkedIn Post Inspector"
179
+ # Cognitive Mode Switching / gstack (Added 2026-03-13)
180
+ gstack_workflow: "guide/workflows/gstack-workflow.md"
181
+ gstack_6_gears: "guide/workflows/gstack-workflow.md:34" # Table: 6 roles, core questions, when to switch
182
+ gstack_strategic_gate: "guide/workflows/gstack-workflow.md:47" # Pre-implementation product gate concept
183
+ gstack_plan_ceo_review: "examples/commands/plan-ceo-review.md" # Strategic product gate command template
184
+ gstack_plan_eng_review: "examples/commands/plan-eng-review.md" # Engineering architecture gate command template
185
+ gstack_browse_non_mcp: "guide/workflows/gstack-workflow.md:106" # /browse native Chromium daemon vs MCP (~100ms)
186
+ gstack_full_cycle: "guide/workflows/gstack-workflow.md:130" # Full ship cycle demo (plan-ceo → plan-eng → review → ship → browse)
187
+ gstack_when_to_use: "guide/workflows/gstack-workflow.md:198" # Comparison vs Plan Pipeline and other workflows
188
+ gstack_upstream: "https://github.com/garrytan/gstack"
189
+ gstack_purpose: "6-skill workflow suite: strategic gate + architecture + paranoid review + release + browser QA + retro"
190
+ third_party_tools_skill_packs: "guide/ecosystem/third-party-tools.md:558" # Notable skill packs (gstack)
111
191
  # Talk Preparation Pipeline (6-stage: extract → research → concepts → position → script → revision)
112
192
  talk_pipeline_workflow: "guide/workflows/talk-pipeline.md"
113
193
  talk_pipeline_skills: "examples/skills/talk-pipeline/"
@@ -155,6 +235,9 @@ deep_dive:
155
235
  productivity_rct_echoes: "guide/roles/learning-with-ai.md:926" # Borg 2025: 30.7% faster (median), ~55.9% habitual users, no maintainability impact downstream
156
236
  productivity_maintainability_empirical: "guide/roles/learning-with-ai.md:926" # Empirical data on "AI code is unmaintainable" claim — blind RCT shows no significant difference
157
237
  trust_calibration_maintainability_nuance: "guide/ultimate-guide.md:1097" # Nuance: defect rates ≠ maintenance burden (Borg et al. 2025)
238
+ session_naming_template: "examples/claude-md/session-naming.md"
239
+ session_naming_guide: "guide/ultimate-guide.md:815"
240
+ session_auto_rename: 859
158
241
  learning_mode_template: "examples/claude-md/learning-mode.md"
159
242
  learn_quiz_command: "examples/commands/learn/quiz.md"
160
243
  learn_teach_command: "examples/commands/learn/teach.md"
@@ -236,18 +319,49 @@ deep_dive:
236
319
  sandbox_anti_patterns: "guide/security/sandbox-isolation.md:546" # Anti-Patterns
237
320
  sandbox_comparison_matrix: "guide/security/sandbox-isolation.md:477" # Comparison Matrix
238
321
  sandbox_score: "4/5"
322
+ # Enterprise AI Governance (guide/security/enterprise-governance.md) - Added 2026-03-10
323
+ enterprise_governance_guide: "guide/security/enterprise-governance.md"
324
+ enterprise_governance_local_vs_shared: "guide/security/enterprise-governance.md#1-local-vs-shared-the-governance-split"
325
+ enterprise_governance_charter: "guide/security/enterprise-governance.md#2-ai-usage-charter"
326
+ enterprise_governance_charter_template: "examples/scripts/ai-usage-charter-template.md"
327
+ enterprise_governance_mcp_workflow: "guide/security/enterprise-governance.md#3-mcp-governance-workflow"
328
+ enterprise_governance_mcp_registry: "guide/security/enterprise-governance.md#32-mcp-registry-format"
329
+ enterprise_governance_mcp_registry_template: "examples/scripts/mcp-registry-template.yaml"
330
+ enterprise_governance_guardrail_tiers: "guide/security/enterprise-governance.md#4-guardrail-tiers"
331
+ enterprise_governance_tier_starter: "guide/security/enterprise-governance.md#tier-1-starter"
332
+ enterprise_governance_tier_standard: "guide/security/enterprise-governance.md#tier-2-standard"
333
+ enterprise_governance_tier_strict: "guide/security/enterprise-governance.md#tier-3-strict"
334
+ enterprise_governance_tier_regulated: "guide/security/enterprise-governance.md#tier-4-regulated"
335
+ enterprise_governance_policy_at_scale: "guide/security/enterprise-governance.md#5-policy-enforcement-at-scale"
336
+ enterprise_governance_onboarding_checklist: "guide/security/enterprise-governance.md#52-onboarding-checklist"
337
+ enterprise_governance_compliance_check: "guide/security/enterprise-governance.md#53-compliance-checking"
338
+ enterprise_governance_cicd_gates: "guide/security/enterprise-governance.md#55-cicd-gates"
339
+ enterprise_governance_audit: "guide/security/enterprise-governance.md#6-audit-compliance--governance-structure"
340
+ enterprise_governance_soc2_iso27001: "guide/security/enterprise-governance.md#61-what-soc2-and-iso27001-auditors-actually-ask"
341
+ enterprise_governance_audit_trail: "guide/security/enterprise-governance.md#62-audit-trail-setup"
342
+ enterprise_governance_hook: "examples/hooks/bash/governance-enforcement-hook.sh"
343
+ enterprise_governance_audience: "Tech leads, engineering managers, security officers"
344
+ enterprise_governance_scope: "Org-level policy (vs security-hardening.md = individual dev security)"
239
345
  # Third-Party Tools (guide/ecosystem/third-party-tools.md) - Added 2026-02-01
240
346
  third_party_tools_guide: "guide/ecosystem/third-party-tools.md"
241
347
  third_party_tools_cost_tracking: "guide/ecosystem/third-party-tools.md:42"
242
348
  third_party_tools_rtk: "guide/ecosystem/third-party-tools.md:7"
243
349
  third_party_tools_session_mgmt: "guide/ecosystem/third-party-tools.md:126"
244
350
  third_party_tools_config_mgmt: "guide/ecosystem/third-party-tools.md:214"
351
+ third_party_tools_hook_utilities: "guide/ecosystem/third-party-tools.md:331"
352
+ third_party_gitdiff_watcher: "guide/ecosystem/third-party-tools.md:335"
353
+ third_party_gitdiff_watcher_upstream: "https://github.com/fcamblor/gitdiff-watcher"
354
+ third_party_gitdiff_watcher_purpose: "Stop hook utility — enforces build/test quality gates before handoff, fires only when matching files changed"
245
355
  third_party_tools_alternative_uis: "guide/ecosystem/third-party-tools.md:259"
246
356
  third_party_tools_known_gaps: "guide/ecosystem/third-party-tools.md:375"
247
357
  third_party_tools_recommendations: "guide/ecosystem/third-party-tools.md:391"
248
358
  third_party_ccusage: "https://www.npmjs.com/package/ccusage"
249
359
  third_party_ccusage_site: "https://ccusage.com"
250
360
  third_party_ccburn: "https://github.com/JuanjoFuchs/ccburn"
361
+ third_party_straude: "https://straude.com"
362
+ third_party_straude_npm: "https://www.npmjs.com/package/straude"
363
+ third_party_straude_guide: "guide/ecosystem/third-party-tools.md:92"
364
+ third_party_straude_eval: "docs/resource-evaluations/straude-evaluation.md"
251
365
  third_party_claude_code_viewer: "https://www.npmjs.com/package/@kimuson/claude-code-viewer"
252
366
  third_party_claude_code_config: "https://github.com/joeyism/claude-code-config"
253
367
  third_party_aiblueprint: "https://github.com/Melvynx/aiblueprint"
@@ -351,6 +465,13 @@ deep_dive:
351
465
  # Auto-Memories (v2.1.32+) - Added 2026-02-09
352
466
  auto_memories: 4439
353
467
  auto_memories_vs_claudemd: 4439
468
+ # Auto Dream (Community-Discovered) - Added 2026-03-25
469
+ auto_dream: 4945
470
+ auto_dream_phases: 4945
471
+ auto_dream_trigger: "24h + 5 sessions since last consolidation"
472
+ auto_dream_access: "/memory command (or /dream if available)"
473
+ auto_dream_source: "https://github.com/Piebald-AI/claude-code-system-prompts/blob/main/system-prompts/agent-prompt-dream-memory-consolidation.md"
474
+ auto_dream_status: "community-discovered, not in official Anthropic release notes"
354
475
  # Fast Mode (v2.1.36+) - Added 2026-02-09
355
476
  fast_mode_command: 720 # /fast in commands table
356
477
  fast_mode_api: 720 # API breaking changes section
@@ -434,6 +555,8 @@ deep_dive:
434
555
  agent_template: 5636
435
556
  agent_examples: 5836
436
557
  skills: 6246
558
+ skills_taxonomy: 6718
559
+ skills_evals: 6954
437
560
  skill_template: 6384
438
561
  skill_examples: 6452
439
562
  design_patterns_skill: 6630
@@ -506,13 +629,29 @@ deep_dive:
506
629
  - "test-driven-development: 721 installs"
507
630
  skills_marketplace_status: "Community (Vercel Labs), launched Jan 21, 2026"
508
631
  skills_marketplace_changelog: "https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem"
509
- # Plugin System & Community Marketplaces (updated 2026-01-24)
510
- plugins_system: 11048
511
- plugins_commands: 11062
512
- plugins_marketplace: 11100
513
- plugins_community_marketplaces: 11358 # New section with ecosystem stats
632
+ # Plugin System & Community Marketplaces (updated 2026-03-06)
633
+ plugins_system: 12015
634
+ plugins_commands: 12029
635
+ plugins_marketplace: 12042
636
+ plugins_community_marketplaces: 12344
637
+ plugins_featured_community: 12385 # Vitals + SE-CoVe comparison section
514
638
  plugins_recommended: "examples/plugins/"
515
639
  plugins_se_cove: "examples/plugins/se-cove.md"
640
+ plugins_vitals:
641
+ url: "https://github.com/chopratejas/vitals"
642
+ install: "/plugin marketplace add chopratejas/vitals"
643
+ command: "/vitals:scan"
644
+ purpose: "Codebase hotspot detection — git churn x complexity x coupling centrality"
645
+ status: "v0.1 alpha"
646
+ updated: "2026-03-06"
647
+ plugins_se_cove_detail:
648
+ url: "https://github.com/vertti/se-cove-claude-plugin"
649
+ install: "/plugin marketplace add vertti/se-cove-claude-plugin"
650
+ command: "/chain-of-verification:verify"
651
+ purpose: "Chain-of-Verification — independent verifier prevents confirmation bias"
652
+ research: "arXiv:2309.11495 (ACL 2024)"
653
+ status: "v1.1.1 stable"
654
+ cost: "~2x tokens"
516
655
  plugins_official_docs: "https://code.claude.com/docs/en/plugins"
517
656
  plugins_official_reference: "https://code.claude.com/docs/en/plugins-reference"
518
657
  plugins_official_marketplaces: "https://code.claude.com/docs/en/plugin-marketplaces"
@@ -652,6 +791,28 @@ deep_dive:
652
791
  dual_instance_pattern: "Vertical separation (planner vs implementer) - orthogonal to Boris horizontal scaling"
653
792
  dual_instance_cost: "$100-200/month (vs $500-1K Boris pattern)"
654
793
  dual_instance_audience: "Solo devs, spec-heavy work, quality > speed"
794
+ # Plan-Validate-Execute Pipeline (Mar 2026)
795
+ plan_pipeline_workflow: "guide/workflows/plan-pipeline.md"
796
+ plan_pipeline_philosophy: "non-prescriptive AI-first + No Bandaids first principles + ADR learning loop"
797
+ plan_pipeline_commands: "/plan-start → /plan-validate → /plan-execute"
798
+ plan_pipeline_agent_pool: "12 research agents (trigger-based) + 8 validation agents (trigger-based)"
799
+ plan_pipeline_adr_loop: "Watching (1) → Emerging (2) → Confirmed (3+) → CLAUDE.md promotion"
800
+ plan_pipeline_claude_md_limit: "120 lines hard limit + pointer strategy for sub-files"
801
+ plan_pipeline_context_reset: "/clear between each command (plan, validate, execute)"
802
+ plan_pipeline_cost: "$2-10 typical Tier 2 feature, compounds down as ADR coverage grows"
803
+ plan_start_command: "examples/commands/plan-start.md"
804
+ plan_start_phases: "5 phases: PRD analysis, design analysis, technical decisions, dynamic team, metrics"
805
+ plan_start_tiers: "Tier 0 Solo (0 agents) → Tier 4 Full Spectrum (10+ agents)"
806
+ plan_validate_command: "examples/commands/plan-validate.md"
807
+ plan_validate_layer1: "structural checks inline: format, deps, file existence, ADR consistency, CLAUDE.md"
808
+ plan_validate_layer2: "0-8 specialist agents triggered by plan content (security Opus, db Opus, integration Opus)"
809
+ plan_validate_autofix: "Bucket A auto-resolve (ADR/PATTERNS/first-principles ~95%) + Bucket B human input"
810
+ plan_execute_command: "examples/commands/plan-execute.md"
811
+ plan_execute_flow: "worktree → TDD scaffold → parallel level execution → drift detection → quality gate → smoke test → PR merge → cleanup"
812
+ planning_coordinator_agent: "examples/agents/planning-coordinator.md"
813
+ planning_coordinator_role: "Opus synthesis agent: merges multi-agent reports into coherent task graph, resolves conflicts via ADR precedence"
814
+ integration_reviewer_agent: "examples/agents/integration-reviewer.md"
815
+ integration_reviewer_role: "Opus runtime validator: connection params, async/sync, env vars, library API correctness, OTEL pipeline"
655
816
  # Boris Tane Pattern (Annotation Cycle, Feb 2026)
656
817
  annotation_cycle_pattern: "guide/workflows/plan-driven.md#the-annotation-cycle"
657
818
  custom_markdown_plans: "guide/workflows/plan-driven.md#why-custom-plans-over-plan"
@@ -860,6 +1021,20 @@ deep_dive:
860
1021
  ai_ecosystem_voice_to_text: "guide/ecosystem/ai-ecosystem.md:1066"
861
1022
  ai_ecosystem_alternative_providers: "guide/ecosystem/ai-ecosystem.md:2639"
862
1023
  voice_refine_skill: "examples/skills/voice-refine/SKILL.md"
1024
+ # PR Triage Skill (added 2026-03-05)
1025
+ pr_triage_skill: "examples/skills/pr-triage/SKILL.md"
1026
+ pr_triage_template: "examples/skills/pr-triage/templates/review-comment.md"
1027
+ pr_triage_phases: "3 (audit + deep review + validated comments)"
1028
+ pr_triage_when: "5+ open PRs, periodic backlog triage, post-sprint cleanup"
1029
+ pr_triage_vs_review_pr: "pr-triage = backlog N PRs | review-pr = single PR focus"
1030
+ # Issue Triage Skill (added 2026-03-05)
1031
+ issue_triage_skill: "examples/skills/issue-triage/SKILL.md"
1032
+ issue_triage_template: "examples/skills/issue-triage/templates/issue-comment.md"
1033
+ issue_triage_phases: "3 (audit + deep analysis + validated actions)"
1034
+ issue_triage_when: "10+ open issues, periodic backlog cleanup, duplicate detection"
1035
+ issue_triage_jaccard: "Jaccard similarity >= 0.60 on normalized title+body tokens — self-contained, no external lib"
1036
+ issue_triage_thresholds: "staleness_days=30, very_stale_days=90, jaccard_threshold=60%, closed_compare=20, open_limit=100"
1037
+ issue_triage_vs_pr_triage: "issue-triage = issue backlog (comment/label/close) | pr-triage = PR backlog (code review comment)"
863
1038
  # Cowork documentation (v1.0 - migrated to dedicated repo)
864
1039
  cowork_reference: "machine-readable/cowork-reference.yaml" # Dedicated YAML index (kept local)
865
1040
  cowork_hub: "https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/README.md"
@@ -895,10 +1070,10 @@ deep_dive:
895
1070
  myths_tasks_api_autonomous: 20965
896
1071
  myths_100x_faster: 20997
897
1072
  myths_reliable_sources: 20983
898
- # Quiz System (264 questions, 15 categories)
1073
+ # Quiz System (271 questions, 15 categories)
899
1074
  quiz_overview: "quiz/README.md"
900
1075
  quiz_file: "quiz/questions.json"
901
- quiz_count: 264
1076
+ quiz_count: 271
902
1077
  quiz_categories: 15
903
1078
  quiz_beginner: "quiz/categories/basics,commands,shortcuts,reference"
904
1079
  quiz_beginner_count: 60
@@ -1277,7 +1452,41 @@ rules:
1277
1452
  ecosystem:
1278
1453
  this_guide:
1279
1454
  focus: "Education - Learn & master"
1280
- unique: ["architecture docs", "TDD/SDD methodologies", "264-question quiz", "YAML index"]
1455
+ unique: ["architecture docs", "TDD/SDD methodologies", "271-question quiz", "YAML index", "MCP server"]
1456
+ mcp_server:
1457
+ npm: "claude-code-ultimate-guide-mcp"
1458
+ install: "npx -y claude-code-ultimate-guide-mcp"
1459
+ guide_section: "guide/ultimate-guide.md:10602"
1460
+ readme: "mcp-server/README.md"
1461
+ tools:
1462
+ - "search_guide(query, limit?) — search 882 indexed entries"
1463
+ - "read_section(path, offset?, limit?) — read any guide file paginated"
1464
+ - "list_topics() — browse 25 topic categories"
1465
+ - "get_example(name) — fetch production templates"
1466
+ - "list_examples(category?) — agents/commands/hooks/skills/scripts"
1467
+ - "search_examples(query, limit?) — semantic search across all templates by intent"
1468
+ - "get_changelog(count?) — last N guide CHANGELOG entries"
1469
+ - "get_digest(period) — day/week/month combined digest"
1470
+ - "get_release(version?) — Claude Code CLI releases"
1471
+ - "compare_versions(from, to?) — diff two CC versions: aggregated highlights + breaking changes"
1472
+ - "get_cheatsheet(section?) — cheatsheet full or filtered"
1473
+ - "get_threat(id) — look up CVE or attack technique from threat database"
1474
+ - "list_threats(category?) — browse threat-db: global summary or section list"
1475
+ - "init_official_docs() — fetch and store local baseline snapshot of official Anthropic docs (run once)"
1476
+ - "refresh_official_docs() — update current snapshot without touching baseline"
1477
+ - "diff_official_docs() — compare baseline vs current at section level, zero network calls"
1478
+ - "search_official_docs(query) — search official docs, loads only matching sections"
1479
+ resources:
1480
+ - "claude-code-guide://reference — 94KB YAML index (~900 entries)"
1481
+ - "claude-code-guide://releases — CC releases history"
1482
+ - "claude-code-guide://llms — llms.txt"
1483
+ prompt: "claude-code-expert — activates expert mode with optimal search workflow"
1484
+ slash_commands:
1485
+ location: "~/.claude/commands/ccguide/"
1486
+ 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"]
1487
+ agent: ".claude/agents/claude-code-guide.md — Haiku, read-only, searches before answering"
1488
+ bundle_size: "132KB compressed (YAML indexes bundled, markdown lazy-fetched)"
1489
+ cache: "~/.cache/claude-code-guide/{version}/ — 24h TTL"
1281
1490
  complementary:
1282
1491
  claude_code_templates:
1283
1492
  url: "github.com/davila7/claude-code-templates"
@@ -1371,7 +1580,7 @@ ecosystem:
1371
1580
  local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/"
1372
1581
  purpose: "Marketing site for Claude Code guide"
1373
1582
  audience: "Developers discovering the guide"
1374
- features: ["badges (version, templates, lines)", "quiz (264 questions)", "FAQ", "cross-links to Cowork"]
1583
+ features: ["badges (version, templates, lines)", "quiz (271 questions)", "FAQ", "cross-links to Cowork"]
1375
1584
  sync_with: "Guide Code (version, templates count, guide lines)"
1376
1585
  cowork_landing:
1377
1586
  local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/"
@@ -1385,7 +1594,7 @@ ecosystem:
1385
1594
  - "Cross-links modified → Update all 4 repos"
1386
1595
  history:
1387
1596
  - date: "2026-01-20"
1388
- event: "Code Landing sync v3.29.0, 66 templates, cross-links"
1597
+ event: "Code Landing sync v3.38.0, 66 templates, cross-links"
1389
1598
  commit: "5b5ce62"
1390
1599
  - date: "2026-01-20"
1391
1600
  event: "Cowork Landing fix (paths, README, UI badges)"
@@ -1395,10 +1604,13 @@ ecosystem:
1395
1604
  # ONBOARDING MATRIX METADATA
1396
1605
  # ════════════════════════════════════════════════════════════════
1397
1606
  onboarding_matrix_meta:
1398
- version: "2.0.0"
1399
- last_updated: "2026-02-05"
1400
- aligned_with_guide: "3.29.0"
1607
+ version: "2.1.0"
1608
+ last_updated: "2026-03-09"
1609
+ aligned_with_guide: "3.38.0"
1401
1610
  changelog:
1611
+ - version: "2.1.0"
1612
+ date: "2026-03-09"
1613
+ 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"
1402
1614
  - version: "2.0.0"
1403
1615
  date: "2026-02-05"
1404
1616
  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"
@@ -1417,7 +1629,7 @@ onboarding_matrix_meta:
1417
1629
  # ════════════════════════════════════════════════════════════════
1418
1630
  onboarding_matrix:
1419
1631
  # Adaptive architecture: Each profile has core (always) + adaptive (context-based) topics
1420
- # Adaptive triggers: keywords in user messages → relevant v3.21-3.22 topics
1632
+ # Adaptive triggers: keywords in user messages → relevant v3.21-3.32 topics
1421
1633
  # Time budgets: Validated (6-8 min/topic average, respects topics_max limits)
1422
1634
 
1423
1635
  get_started:
@@ -1425,7 +1637,7 @@ onboarding_matrix:
1425
1637
  core: [rules, sandbox_native_guide, commands]
1426
1638
  time_budget: "5 min"
1427
1639
  topics_max: 3
1428
- note: "SECURITY FIRST - sandbox before commands (v3.29.0 critical fix)"
1640
+ note: "SECURITY FIRST - sandbox before commands (v3.38.0 critical fix)"
1429
1641
 
1430
1642
  beginner_15min:
1431
1643
  core: [rules, sandbox_native_guide, workflow, essential_commands]
@@ -1469,7 +1681,7 @@ onboarding_matrix:
1469
1681
  - default: batch_operations
1470
1682
  time_budget: "30 min"
1471
1683
  topics_max: 4
1472
- note: "Adaptive: picks up to 2 from adaptive based on user context (v3.21-3.22)"
1684
+ note: "Adaptive: picks up to 2 from adaptive based on user context (v3.21-3.32)"
1473
1685
 
1474
1686
  power_60min:
1475
1687
  core: [context_triage, cost_optimization, config_hierarchy]
@@ -1480,10 +1692,12 @@ onboarding_matrix:
1480
1692
  topics: [mcp_secrets_management]
1481
1693
  - trigger: "security|sandbox|isolation"
1482
1694
  topics: [sandbox_native_guide]
1695
+ - trigger: "plan|pipeline"
1696
+ topics: [plan_pipeline_workflow]
1483
1697
  - default: [batch_operations, rtk_guide]
1484
1698
  time_budget: "60 min"
1485
1699
  topics_max: 7
1486
- note: "Comprehensive optimization with all v3.21-3.22 topics"
1700
+ note: "Comprehensive optimization with all v3.21-3.32 topics"
1487
1701
 
1488
1702
  build_agents:
1489
1703
  intermediate_30min:
@@ -1507,10 +1721,12 @@ onboarding_matrix:
1507
1721
  topics: [dual_instance_planning]
1508
1722
  - trigger: "validation|checklist|production|deploy"
1509
1723
  topics: [agent_validation_checklist]
1724
+ - trigger: "plan|pipeline|validate|execute"
1725
+ topics: [plan_pipeline_workflow]
1510
1726
  - default: agent_validation_checklist
1511
1727
  time_budget: "60 min"
1512
1728
  topics_max: 6
1513
- note: "Dual-instance pattern for quality workflows (v3.29.0)"
1729
+ note: "Dual-instance pattern for quality workflows (v3.38.0)"
1514
1730
 
1515
1731
  learn_security:
1516
1732
  intermediate_30min:
@@ -1521,7 +1737,7 @@ onboarding_matrix:
1521
1737
  - default: permission_modes
1522
1738
  time_budget: "30 min"
1523
1739
  topics_max: 4
1524
- note: "NEW goal (v3.29.0) - Security-focused learning path"
1740
+ note: "NEW goal (v3.38.0) - Security-focused learning path"
1525
1741
 
1526
1742
  power_60min:
1527
1743
  core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@@ -1546,23 +1762,25 @@ onboarding_matrix:
1546
1762
  core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
1547
1763
  time_budget: "60 min"
1548
1764
  topics_max: 6
1549
- note: "Security foundation + core workflow (v3.29.0 sandbox added)"
1765
+ note: "Security foundation + core workflow (v3.38.0 sandbox added)"
1550
1766
 
1551
1767
  intermediate_120min:
1552
1768
  core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]
1553
1769
  time_budget: "120 min"
1554
1770
  topics_max: 7
1555
- note: "Agents + v3.21-3.22 topics (config/git)"
1771
+ note: "Agents + v3.21-3.32 topics (config/git)"
1556
1772
 
1557
1773
  power_120min:
1558
1774
  core: [architecture, dual_instance_planning, mcp_secrets_management, cost_optimization, cicd]
1559
1775
  adaptive:
1560
1776
  - trigger: "security"
1561
1777
  topics: [security_hardening, sandbox_native_guide]
1778
+ - trigger: "plan|pipeline|validate|execute"
1779
+ topics: [plan_pipeline_workflow]
1562
1780
  - default: [rtk_guide, bridge_guide]
1563
1781
  time_budget: "120 min"
1564
1782
  topics_max: 9
1565
- note: "Advanced patterns + all v3.21-3.22 features"
1783
+ note: "Advanced patterns + all v3.21-3.32 features"
1566
1784
 
1567
1785
  # ════════════════════════════════════════════════════════════════
1568
1786
  # ONBOARDING QUESTIONS - Structure for interactive profiling