commandby nuttea

Level 0: Tagging Audit

Execute comprehensive tagging audit for Level 0 (Foundation).

Installs: 0
Used in: 1 repos
Updated: 2d ago
$npx ai-builder add command nuttea/level0-tagging

Installs to .claude/commands/level0-tagging.md

# Level 0: Tagging Audit

Execute comprehensive tagging audit for Level 0 (Foundation).

**For detailed tagging implementation guidance**, see:
→ [operational-standards-tagging-strategy.md](../notebooks/operational-standards-tagging-strategy.md)

This operational standard provides:
- UST tag definitions (env, service, version)
- Tag format requirements (lowercase, underscores)
- Reserved vs recommended tags
- Anti-patterns to avoid
- Tag enforcement strategies

**Task: Analyze Current Tagging Practices**

**Step 1: Query All Hosts with Tags**
```
search_datadog_hosts(
    context="Level 0: Auditing current tagging practices",
    filter="*",
    include_all_tags=True,
    max_tokens=50000
)
```

**Step 2: Analyze Required Tag Coverage**

Check coverage for Unified Service Tagging (UST) tags:
- **env tag**: `search_datadog_hosts(filter="env:*")`
- **service tag**: `search_datadog_hosts(filter="service:*")`
- **version tag**: `search_datadog_hosts(filter="version:*")`

Check coverage for business tags:
- **team tag**: `search_datadog_hosts(filter="team:*")`
- **cost_center tag**: `search_datadog_hosts(filter="cost_center:*")`

**Step 3: Identify Tag Format Issues**

Look for common anti-patterns:
- CamelCase tags: `env:Production` (should be `env:prod`)
- Inconsistent values: `env:production` vs `env:prod`
- Unbounded tags: timestamps, user IDs, request IDs in tags
- Special characters causing issues

**Step 4: Service-Level Tagging**
```
search_datadog_services(
    context="Analyzing service tagging",
    query="*",
    detailed_output=True
)
```

Check if services have proper metadata and tags.

**Step 5: Calculate Compliance Rates**

For each tag category:
- Total resources: [COUNT]
- Resources with tag: [COUNT]
- Compliance rate: [%]
- Gap: [COUNT resources missing tag]

**Analyze and Report:**

**Current State:**
1. env tag coverage: [%] - [STATUS]
2. service tag coverage: [%] - [STATUS]
3. version tag coverage: [%] - [STATUS]
4. team tag coverage: [%] - [STATUS]

**Tag Quality Issues:**
1. Format inconsistencies: [LIST]
2. Anti-patterns detected: [LIST]
3. Unbounded tag sources: [LIST]

**Recommended Tagging Strategy:**
1. Required tags: env, service, version
2. Recommended tags: team, cost_center, application
3. Tag format standards: lowercase, underscores
4. Tag validation approach

**Deliverable:**

Automatically create Datadog Notebook with tagging audit results:

```
create_datadog_notebook(
    name="Level 0 - Foundation - Tagging Audit - [DATE]",
    type="documentation",
    cells=[
        {
            "type": "markdown",
            "data": "# Level 0 - Tagging Audit Report\n\n**Date**: [DATE]\n**Overall Compliance**: [%]\n\n## UST Tag Coverage\n- env: [%]\n- service: [%]\n- version: [%]\n- team: [%]\n\n## Tag Quality Issues\n[Details]\n\n## Recommended Actions\n[Roadmap]"
        }
    ]
)
```

**Notebook naming format:**
- "Level 0 - Foundation - Tagging Audit - YYYY-MM-DD"
- Example: "Level 0 - Foundation - Tagging Audit - 2025-12-12"

Include:
- Current compliance rates with charts
- Identified issues with examples
- Recommended tagging standard
- Implementation roadmap with priorities
- Tag enforcement strategy

Return notebook URL for team collaboration.

Quick Install

$npx ai-builder add command nuttea/level0-tagging

Details

Type
command
Author
nuttea
Slug
nuttea/level0-tagging
Created
6d ago