name: validate-agent-format
description: Validate YAML frontmatter in all agent definition files
trigger:
  - manual

inputs: {}

steps:
  - name: scan-agent-files
    description: Find all agent definition files
    command: ls -1 ~/.claude/agents/*.md

  - name: validate-frontmatter
    description: Check each agent file for required YAML frontmatter
    for_each: "{{ steps.scan-agent-files.output }}"
    validation:
      - name: has-frontmatter
        check: "File starts with '---' delimiter"
        required: true

      - name: has-name-field
        check: "YAML contains 'name:' field"
        required: true

      - name: has-description-field
        check: "YAML contains 'description:' field"
        required: true

      - name: has-model-field
        check: "YAML contains 'model:' field"
        required: true

      - name: has-tools-field
        check: "YAML contains 'tools:' field"
        required: true

      - name: valid-model-value
        check: "model value is one of: haiku, sonnet, opus"
        required: true

  - name: report-results
    description: Generate validation report
    output:
      format: table
      columns:
        - file
        - has_frontmatter
        - has_name
        - has_description
        - has_model
        - has_tools
        - valid_model
        - status

success_criteria:
  - all_files_have_frontmatter: true
  - all_required_fields_present: true
  - all_model_values_valid: true

on_failure:
  - report: List files with missing or invalid frontmatter
  - suggest: Provide exact frontmatter template for each failing file