diff --git a/guide/README.md b/guide/README.md index 32706c3..04f3f2d 100644 --- a/guide/README.md +++ b/guide/README.md @@ -1,3 +1,9 @@ +--- +title: "Guide Documentation" +description: "Index of all core documentation files for mastering Claude Code" +tags: [guide, reference] +--- + # Guide Documentation Core documentation for mastering Claude Code. diff --git a/guide/adoption-approaches.md b/guide/adoption-approaches.md index 2297576..6430a5a 100644 --- a/guide/adoption-approaches.md +++ b/guide/adoption-approaches.md @@ -1,3 +1,9 @@ +--- +title: "Choosing Your Adoption Approach" +description: "Starting points for team adoption patterns and CLAUDE.md configuration strategies" +tags: [guide, config, workflows] +--- + # Choosing Your Adoption Approach > **Disclaimer**: Claude Code is young (~1 year). Nobody has definitive answers yet — including this guide. These are starting points based on observed patterns, not proven best practices. Adapt heavily to your context. diff --git a/guide/agent-evaluation.md b/guide/agent-evaluation.md index a770cc2..58ec5ca 100644 --- a/guide/agent-evaluation.md +++ b/guide/agent-evaluation.md @@ -1,3 +1,9 @@ +--- +title: "Agent Evaluation" +description: "Metrics, patterns, and tools for measuring custom agent effectiveness" +tags: [agents, testing, guide] +--- + # Agent Evaluation **Quick nav**: [Why Evaluate?](#why-evaluate-agents) · [Metrics to Track](#metrics-to-track) · [Implementation](#implementation-patterns) · [Example](#example-agent-with-evaluation) · [Tools](#tools--references) diff --git a/guide/ai-ecosystem.md b/guide/ai-ecosystem.md index 8ac6854..520e0bb 100644 --- a/guide/ai-ecosystem.md +++ b/guide/ai-ecosystem.md @@ -1,3 +1,9 @@ +--- +title: "AI Ecosystem: Maximizing Claude Code with Complementary Tools" +description: "When to use Claude Code vs complementary AI tools and how to chain them for optimal workflows" +tags: [ai-ecosystem, guide, workflows, integration] +--- + # AI Ecosystem: Maximizing Claude Code with Complementary Tools > **Reading time**: ~25 minutes diff --git a/guide/ai-traceability.md b/guide/ai-traceability.md index f7631a4..b581bd9 100644 --- a/guide/ai-traceability.md +++ b/guide/ai-traceability.md @@ -1,3 +1,9 @@ +--- +title: "AI Code Traceability & Attribution" +description: "Industry standards, tools, and templates for AI-generated code attribution policies" +tags: [guide, git, workflows] +--- + # AI Code Traceability & Attribution > **TL;DR**: As AI-generated code becomes ubiquitous, projects need clear attribution policies. This guide covers industry standards (LLVM, Ghostty, Fedora), practical tools (git-ai), and implementation templates. diff --git a/guide/architecture.md b/guide/architecture.md index 092fe70..d265b89 100644 --- a/guide/architecture.md +++ b/guide/architecture.md @@ -1,3 +1,9 @@ +--- +title: "How Claude Code Works: Architecture & Internals" +description: "Technical deep-dive into Claude Code internal mechanisms and architecture" +tags: [architecture, guide, performance] +--- + # How Claude Code Works: Architecture & Internals > A technical deep-dive into Claude Code's internal mechanisms, based on official Anthropic documentation and verified community analysis. diff --git a/guide/cheatsheet.md b/guide/cheatsheet.md index 0532fce..fa53473 100644 --- a/guide/cheatsheet.md +++ b/guide/cheatsheet.md @@ -1,3 +1,9 @@ +--- +title: "Claude Code Cheatsheet" +description: "One-page printable daily essentials for maximum Claude Code productivity" +tags: [cheatsheet, reference] +--- + # Claude Code Cheatsheet **1 printable page** - Daily essentials for maximum productivity diff --git a/guide/claude-code-releases.md b/guide/claude-code-releases.md index 8fae1b1..96b9f90 100644 --- a/guide/claude-code-releases.md +++ b/guide/claude-code-releases.md @@ -1,3 +1,9 @@ +--- +title: "Claude Code Release History" +description: "Condensed changelog of official Claude Code releases with highlights and breaking changes" +tags: [reference, release] +--- + # Claude Code Release History > Condensed changelog of Claude Code official releases. diff --git a/guide/cowork.md b/guide/cowork.md index 0038c74..84eb9f2 100644 --- a/guide/cowork.md +++ b/guide/cowork.md @@ -1,3 +1,9 @@ +--- +title: "Claude Cowork: Agentic Desktop for Knowledge Work" +description: "Summary of Claude's agentic desktop feature for non-technical knowledge workers" +tags: [guide, agents, workflows] +--- + # Claude Cowork: Agentic Desktop for Knowledge Work > **📦 Complete documentation migrated to dedicated repository** diff --git a/guide/data-privacy.md b/guide/data-privacy.md index 54dfa6b..e856464 100644 --- a/guide/data-privacy.md +++ b/guide/data-privacy.md @@ -1,3 +1,9 @@ +--- +title: "Data Privacy & Retention Guide" +description: "What data Claude Code sends to Anthropic servers and how to protect sensitive information" +tags: [privacy, security, guide] +--- + # Data Privacy & Retention Guide > **Critical**: Everything you share with Claude Code is sent to Anthropic servers. This guide explains what data leaves your machine and how to protect sensitive information. diff --git a/guide/devops-sre.md b/guide/devops-sre.md index af49c28..5b6ba23 100644 --- a/guide/devops-sre.md +++ b/guide/devops-sre.md @@ -1,3 +1,9 @@ +--- +title: "DevOps & SRE with Claude Code" +description: "FIRE framework for infrastructure diagnosis and DevOps workflows with Claude Code" +tags: [devops, guide, ci-cd, workflows] +--- + # DevOps & SRE with Claude Code **Reading time**: 30 minutes diff --git a/guide/known-issues.md b/guide/known-issues.md index b2086d7..806b399 100644 --- a/guide/known-issues.md +++ b/guide/known-issues.md @@ -1,3 +1,9 @@ +--- +title: "Known Issues & Critical Bugs" +description: "Verified critical issues affecting Claude Code users from community reports and official communications" +tags: [reference, security, debugging] +--- + # Known Issues & Critical Bugs This document tracks verified, critical issues affecting Claude Code users based on community reports and official communications. diff --git a/guide/learning-with-ai.md b/guide/learning-with-ai.md index 71727d2..a8cdc14 100644 --- a/guide/learning-with-ai.md +++ b/guide/learning-with-ai.md @@ -1,3 +1,9 @@ +--- +title: "Learning to Code with AI: The Conscious Developer's Guide" +description: "Research-based guide for junior developers learning to code effectively with AI assistance" +tags: [guide, workflows] +--- + # Learning to Code with AI: The Conscious Developer's Guide > **Confidence**: Tier 2 — Based on academic research (2023-2025) and educator feedback diff --git a/guide/mcp-servers-ecosystem.md b/guide/mcp-servers-ecosystem.md index 500dc38..2ccbd8e 100644 --- a/guide/mcp-servers-ecosystem.md +++ b/guide/mcp-servers-ecosystem.md @@ -1,3 +1,9 @@ +--- +title: "MCP Servers Ecosystem" +description: "Validated community MCP servers evaluated for production readiness and security" +tags: [mcp, reference, integration] +--- + # MCP Servers Ecosystem **Last updated**: February 2026 • **Next review**: March 2026 diff --git a/guide/methodologies.md b/guide/methodologies.md index 6ef021a..04a3bee 100644 --- a/guide/methodologies.md +++ b/guide/methodologies.md @@ -1,3 +1,9 @@ +--- +title: "Development Methodologies Reference" +description: "Quick reference for 15 structured AI-assisted development methodologies including TDD, SDD, and BDD" +tags: [reference, tdd, design-patterns, workflows] +--- + # Development Methodologies Reference > **Confidence**: Tier 2 — Validated by multiple production reports and official documentation. diff --git a/guide/observability.md b/guide/observability.md index 65c540f..78785a0 100644 --- a/guide/observability.md +++ b/guide/observability.md @@ -1,3 +1,9 @@ +--- +title: "Session Observability & Monitoring" +description: "Track Claude Code usage, estimate costs, and identify patterns across development sessions" +tags: [observability, guide, performance] +--- + # Session Observability & Monitoring > Track Claude Code usage, estimate costs, and identify patterns across your development sessions. diff --git a/guide/production-safety.md b/guide/production-safety.md index 7c77155..707e7b5 100644 --- a/guide/production-safety.md +++ b/guide/production-safety.md @@ -1,3 +1,9 @@ +--- +title: "Production Safety Rules" +description: "Non-negotiable safety rules for teams deploying Claude Code in production environments" +tags: [security, guide, devops] +--- + # Production Safety Rules > **Audience**: Teams deploying Claude Code in production environments. diff --git a/guide/sandbox-isolation.md b/guide/sandbox-isolation.md index 8cfcb5a..c821c3d 100644 --- a/guide/sandbox-isolation.md +++ b/guide/sandbox-isolation.md @@ -1,3 +1,9 @@ +--- +title: "Sandbox Isolation for Coding Agents" +description: "Running Claude Code safely in isolated environments with Docker, native sandbox, and cloud solutions" +tags: [security, sandbox, devops, guide] +--- + # Sandbox Isolation for Coding Agents > **Confidence**: Tier 2 — Official Docker docs + verified vendor documentation diff --git a/guide/sandbox-native.md b/guide/sandbox-native.md index f33a5f3..2b01b76 100644 --- a/guide/sandbox-native.md +++ b/guide/sandbox-native.md @@ -1,3 +1,9 @@ +--- +title: "Native Sandboxing in Claude Code" +description: "Understanding and configuring native process-level sandboxing in Claude Code" +tags: [security, sandbox, guide] +--- + # Native Sandboxing in Claude Code > **Confidence**: Tier 1 — Official Anthropic documentation diff --git a/guide/search-tools-cheatsheet.md b/guide/search-tools-cheatsheet.md index 73bc909..06ad8b2 100644 --- a/guide/search-tools-cheatsheet.md +++ b/guide/search-tools-cheatsheet.md @@ -1,3 +1,9 @@ +--- +title: "Search Tools Cheatsheet" +description: "Quick reference for choosing between rg, grepai, Serena and ast-grep" +tags: [cheatsheet, search, reference] +--- + # Search Tools Cheatsheet (1-Page Reference) > **Quick reference for choosing between rg, grepai, Serena & ast-grep** diff --git a/guide/security-hardening.md b/guide/security-hardening.md index 3dfd000..b2a7747 100644 --- a/guide/security-hardening.md +++ b/guide/security-hardening.md @@ -1,3 +1,9 @@ +--- +title: "Security Hardening Guide" +description: "Active threats, injection defense, and CVE-based security hardening for Claude Code" +tags: [security, guide, hooks] +--- + # Security Hardening Guide > **Confidence**: Tier 2 — Based on CVE disclosures, security research (2024-2026), and community validation diff --git a/guide/third-party-tools.md b/guide/third-party-tools.md index 7695a9e..b4e276d 100644 --- a/guide/third-party-tools.md +++ b/guide/third-party-tools.md @@ -1,3 +1,9 @@ +--- +title: "Third-Party Tools for Claude Code" +description: "Community tools for token tracking, session management, configuration, and alternative UIs" +tags: [reference, integration, plugin] +--- + # Third-Party Tools for Claude Code > Community tools for token tracking, session management, configuration, and alternative UIs. diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index 33894b4..0d949d2 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -1,3 +1,9 @@ +--- +title: "The Ultimate Claude Code Guide" +description: "Comprehensive self-contained guide to mastering Claude Code from zero to power user" +tags: [guide, reference, workflows, agents, hooks, mcp, security] +--- + # The Ultimate Claude Code Guide > A comprehensive, self-contained guide to mastering Claude Code - from zero to power user. diff --git a/guide/visual-reference.md b/guide/visual-reference.md index ccfda56..53c6438 100644 --- a/guide/visual-reference.md +++ b/guide/visual-reference.md @@ -1,3 +1,9 @@ +--- +title: "Claude Code — Visual Reference" +description: "ASCII diagrams consolidating key Claude Code concepts in one visual overview" +tags: [reference, architecture, cheatsheet] +--- + # Claude Code — Visual Reference All diagrams in one place. Quick visual overview of Claude Code's key concepts.