infrahub-analyst

Overview

• Compliance — "Are all devices following the naming convention?"
• Service impact — "Which services are hosted on devices in this rack?"
• Maintenance windows — "Which devices are currently in a maintenance window, and what depends on them?"
• Drift detection — "Which realized devices differ from their topology design?"
• Capacity — "Which racks are over 80% full?"
• Change impact — "What BGP sessions, services, and IPs depend on this prefix?"
• Inventory gaps — "Which devices have no platform or OS version recorded?"

../infrahub-check-creator/SKILL.md

../infrahub-transform-creator/SKILL.md

When to Use

• Answering operational questions interactively via natural language
• Cross-referencing two or more node types to find relationships or gaps
• Investigating the blast radius of a change before executing it
• Auditing data quality across the inventory
• Producing one-time or on-demand reports for stakeholders
• Exploring schema structure and data before writing a generator or check

How It Works

1. Query — use MCP tools to fetch current state from Infrahub
2. Correlate — join, diff, or filter the data against a policy or second dataset
3. Reason — identify gaps, anomalies, or relationships
4. Report — surface findings with context and remediation hints

Rule Categories

mcp-

query-

correlation-

reporting-

approach-

MCP Server Basics

• mcp__infrahub__infrahub_query

  — Execute a GraphQL query (primary tool)

• mcp__infrahub__infrahub_list_schema

  — List available node kinds

• mcp__infrahub__infrahub_get

  — Retrieve a specific object by ID or filters

• mcp__infrahub__infrahub_create

  — Create an object (remediation, on a branch)

• mcp__infrahub__infrahub_update

  — Update an object (remediation, on a branch)

# Example: find all devices in an active
# maintenance window
query MaintenanceDevices {
  MaintenanceWindow(status__value: "active") {
    edges {
      node {
        name { value }
        start_time { value }
        end_time { value }
        devices {
          edges {
            node {
              name { value }
              role { value }
              site {
                node { name { value } }
              }
            }
          }
        }
      }
    }
  }
}

Typical Analysis Workflow

1. Understand the question
   → "Which services depend on devices currently
      in a maintenance window?"

2. Identify the node types involved
   → MaintenanceWindow, DcimDevice, Service
     (or equivalent in your schema)

3. Query current state
   → mcp__infrahub__infrahub_query — one query
     per node type, or combined

4. Correlate the data
   → Join across node types, filter, count, diff

5. Report findings
   → Summarize with counts, list affected objects,
     suggest next steps

Supporting References

• examples.md — Analysis patterns (naming, VLAN, BGP, maintenance, service impact)
• ../infrahub-common/graphql-queries.md — GraphQL query writing reference
• ../infrahub-common/infrahub-yml-reference.md — .infrahub.yml project configuration
• ../infrahub-check-creator/SKILL.md — Automated pipeline checks (for enforcement)
• ../infrahub-transform-creator/SKILL.md — Transforms for scheduled report artifacts
• rules/ — Individual rules organized by category prefix