Inspect Control

Analyze a control file and report its current state: how many requirements are mapped, unmapped, manual, etc. Useful for understanding a control file before starting a mapping session.

Arguments: $ARGUMENTS (control file ID, e.g., anssi, srg_gpos, hipaa)

Tool Strategy

This skill uses mcp__content-agent__* tools when available (preferred — deterministic, structured results). When the MCP server is not configured, fall back to filesystem-based alternatives noted as Fallback in each step. See .claude/skills/shared/mcp_fallbacks.md for detailed fallback procedures. The skill must complete successfully either way.

Phase 1: Validate and Load Control File

1. Parse arguments: Extract control_id from $ARGUMENTS.

2. Validate control exists: Call mcp__content-agent__get_control_stats with control_id=$ARGUMENTS.

   • If the tool returns an error (control not found), call mcp__content-agent__list_controls and present available control files via AskUserQuestion:
     • "Control file '$ARGUMENTS' not found. Which control file do you want to inspect?"
     • Options: top 4 most relevant from the list + Other
   • Fallback: Look for controls/$ARGUMENTS.yml or products/**/controls/$ARGUMENTS.yml. If not found, run ls controls/*.yml and ls products/*/controls/*.yml to list available control files. To compute stats, read the control YAML and count requirements grouped by status field.