Claude Code Research

Tags - Complete Reference & Index

7 min read

Tags - Complete Reference & Index

This document provides comprehensive tag documentation including guidelines, best practices, and a dynamic index of all tags used throughout the Claude Code Knowledge Base.

🎯 Tag Philosophy & Guidelines

Core Principles

  1. Always include claude-code - This is the primary identifier for all Claude Code documentation
  2. Use specific feature tags - Add relevant feature tags (#hooks, typescript, sdk, subagents)
  3. Specify difficulty level - Include beginner, intermediate, or advanced
  4. Identify content type - Add type tags like tutorial, reference, workshop
  5. Add quality/topic tags - Include relevant tags like best-practices, troubleshooting, security

Tag Consolidation Rules

✅ Standard Tag Usage

  • Always use claude-code as the primary identifier
  • Use feature-specific tags separately rather than compound tags
  • Maintain consistency across all documentation files
  • Use lowercase for all tags
  • Use singular forms (e.g., workshop not workshops)

❌ Deprecated Tags (Do Not Use)

The following compound tags have been consolidated:

⚠️ Common Mistakes to Avoid

  • Don’t create compound feature tags
  • Don’t use hex color codes as tags
  • Don’t create overly specific single-use tags
  • Don’t use file names as tags
  • Don’t capitalize tags inconsistently
  • Don’t create redundant variations

📊 Dynamic Tag Analytics

📈 Tag Statistics

TABLE WITHOUT ID
  "Total Unique Tags" AS Metric,
  length(unique(flatten(pages().file.tags))) AS Count
UNION ALL
TABLE WITHOUT ID
  "Tagged Pages" AS Metric,
  length(pages() WHERE file.tags) AS Count
UNION ALL
TABLE WITHOUT ID
  "Average Tags per Page" AS Metric,
  round(sum(pages().file.tags.length) / length(pages() WHERE file.tags), 2) AS Count

🔥 Most Used Tags

TABLE WITHOUT ID
  tag AS "Tag",
  length(pages() WHERE contains(file.tags, tag)) AS "Usage Count"
FROM ""
FLATTEN file.tags AS tag
GROUP BY tag
SORT length(pages() WHERE contains(file.tags, tag)) DESC
LIMIT 20

📑 Tag Categories

🎨 Core Feature Tags

  • claude-code - Primary identifier for all Claude Code content
  • hooks - Claude Code hooks system and event handling
  • typescript - TypeScript-specific implementations
  • sdk - Software Development Kit documentation
  • subagents - Subagent patterns and usage
  • containers - Docker, Kubernetes, and deployment
  • docker - Docker-specific configurations
  • kubernetes - Kubernetes deployment strategies
  • devcontainer - VS Code devcontainer configurations
  • ai-orchestration - Multi-model AI orchestration
  • multi-model - Integration with multiple AI models
  • gemini - Google Gemini model integration
  • claude-md - CLAUDE.md configuration patterns
  • mcp - Model Context Protocol integration
  • llm - Large Language Model integration patterns
  • context-window - Large context window management

📚 Content Type Tags

🎓 Difficulty Level Tags

🛠️ Technical & Quality Tags

🗂️ Organization Tags

🔍 Tag Usage by Section

📚 Documentation Tags

TABLE WITHOUT ID
  link(file.name, file.name) AS "Documentation",
  join(file.tags, ", ") AS "Tags"
WHERE contains(file.path, "docs/") AND file.tags
SORT file.name ASC
LIMIT 10

🎯 Pattern Tags

TABLE WITHOUT ID
  link(file.name, file.name) AS "Pattern",
  join(file.tags, ", ") AS "Tags"
WHERE contains(file.path, "patterns/") AND file.tags
SORT file.name ASC
LIMIT 10

🔬 Experiment Tags

TABLE WITHOUT ID
  link(file.name, file.name) AS "Experiment",
  join(file.tags, ", ") AS "Tags"
WHERE contains(file.path, "experiments/") AND file.tags
SORT file.name ASC
LIMIT 10

📅 Recently Tagged Content

TABLE WITHOUT ID
  link(file.name, file.name) AS "Page",
  file.tags AS "Tags",
  dateformat(file.mtime, "yyyy-MM-dd HH:mm") AS "Modified"
WHERE file.tags AND file.mtime > date(today) - dur(7 days)
SORT file.mtime DESC
LIMIT 10

🔗 Tag Relationships

TABLE WITHOUT ID
  tag1 AS "Tag",
  tag2 AS "Related Tag",
  count AS "Co-occurrences"
FROM ""
WHERE file.tags
FLATTEN file.tags AS tag1
FLATTEN file.tags AS tag2
WHERE tag1 < tag2
GROUP BY tag1 + "|" + tag2
LET count = length(pages() WHERE contains(file.tags, tag1) AND contains(file.tags, tag2))
WHERE count > 1
SORT count DESC
LIMIT 15

📄 Untagged Pages

TABLE WITHOUT ID
  link(file.name, file.name) AS "Untagged Page",
  file.folder AS "Folder",
  dateformat(file.mtime, "yyyy-MM-dd") AS "Modified"
WHERE !file.tags OR length(file.tags) = 0
SORT file.folder ASC, file.name ASC
LIMIT 20

🏷️ Tag Combination Examples

Effective Tag Combinations

  • Tutorial for beginners on hooks: #claude-code #hooks #beginner #tutorial
  • Advanced TypeScript patterns: #claude-code #typescript #advanced #patterns #best-practices
  • SDK troubleshooting guide: #claude-code #sdk #troubleshooting #guide
  • Workshop on subagents: #claude-code #subagents #workshop #exercises
  • Container deployment guide: #claude-code #containers #docker #deployment #guide
  • AI orchestration patterns: #claude-code #ai-orchestration #multi-model #patterns
  • Gemini integration workshop: #claude-code #gemini #integration #workshop
  • CLAUDE.md configuration: #claude-code #claude-md #configuration #best-practices

🔍 Quick Search Queries

By Feature

  • Hooks documentation: tag:#hooks
  • TypeScript SDK: tag:#typescript AND tag:#sdk
  • Container deployment: tag:#containers OR tag:#docker OR tag:#kubernetes
  • AI orchestration: tag:#ai-orchestration OR tag:#multi-model
  • Gemini integration: tag:#gemini AND tag:#integration
  • CLAUDE.md patterns: tag:#claude-md AND tag:#patterns

By Level

  • Beginner tutorials: tag:#beginner AND tag:#tutorial
  • Advanced patterns: tag:#advanced AND tag:#patterns
  • Intermediate workshops: tag:#intermediate AND tag:#workshop

By Quality Aspect

  • Security best practices: tag:#security AND tag:#best-practices
  • Performance optimization: tag:#performance AND tag:#optimization
  • Error handling guides: tag:#error-handling AND tag:#troubleshooting

Combined Queries

  • Beginner hooks tutorials: tag:#hooks AND tag:#beginner AND tag:#tutorial
  • Advanced TypeScript patterns: tag:#typescript AND tag:#advanced AND tag:#patterns
  • SDK troubleshooting: tag:#sdk AND tag:#troubleshooting

📋 Tag Maintenance Checklist

When creating or updating documentation:

  1. ✅ Include #claude-code as the primary tag
  2. ✅ Add at least one feature tag
  3. ✅ Specify difficulty level if applicable
  4. ✅ Include content type tag
  5. ✅ Add relevant quality/topic tags
  6. ✅ Use lowercase only
  7. ✅ Avoid compound tags
  8. ✅ Check for existing similar tags

🎨 Custom Tag Groups

Research Tags

LIST
WHERE contains(file.tags, "research") OR
      contains(file.tags, "exploration") OR
      contains(file.tags, "investigation")

Status Tags

LIST
WHERE contains(file.tags, "draft") OR
      contains(file.tags, "review") OR
      contains(file.tags, "complete")

Priority Tags

LIST
WHERE contains(file.tags, "high-priority") OR
      contains(file.tags, "urgent") OR
      contains(file.tags, "important")

🏷️ Pages with Multiple Tags

TABLE WITHOUT ID
  link(file.name, file.name) AS "Page",
  length(file.tags) AS "Tag Count",
  join(file.tags, ", ") AS "Tags"
WHERE length(file.tags) > 3
SORT length(file.tags) DESC

🔗 Related Resources

This tag reference automatically updates to reflect all tags in the knowledge base. Consistent tagging improves navigation and content discovery.

Graph View

Backlinks