agent-config.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "LightSpeedWP Unified Branding Agent Configuration Schema",
  "description": "Configuration schema for the unified branding agent, defining document categories, frontmatter requirements, footer templates, and badge schemas",
  "type": "object",
  "definitions": {
    "category": {
      "type": "string",
      "enum": [
        "root",
        "github-config",
        "workflows",
        "wceu-talk",
        "tests",
        "skills",
        "scripts",
        "plugins",
        "instructions",
        "hooks",
        "documentation",
        "cookbook",
        "ai-configs",
        "agent-specs",
        "slides"
      ]
    },
    "requiredFrontmatterFields": {
      "type": "object",
      "properties": {
        "file_type": {
          "type": "string",
          "description": "Type of file (report, documentation, instruction, agent, skill, etc.)"
        },
        "title": {
          "type": "string",
          "description": "Human-readable title of the document"
        },
        "last_updated": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 datetime of last update (must be current for changed content)"
        }
      },
      "required": ["file_type", "title", "last_updated"]
    },
    "optionalFrontmatterFields": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "Brief description of document purpose"
        },
        "version": {
          "type": "string",
          "pattern": "^\\d+\\.\\d+(\\.\\d+)?$",
          "description": "Semantic version string (e.g., 1.0 or 1.2.3)"
        },
        "created_date": {
          "type": "string",
          "format": "date",
          "description": "ISO date when file was created"
        },
        "owners": {
          "type": "array",
          "items": { "type": "string" },
          "description": "List of file owners/maintainers"
        },
        "tags": {
          "type": "array",
          "items": { "type": "string" },
          "maxItems": 8,
          "description": "Keywords for discoverability (max 8 tags)"
        },
        "category": {
          "$ref": "#/definitions/category",
          "description": "Document category for footer/badge selection"
        },
        "domain": {
          "type": "string",
          "description": "Domain or functional area"
        },
        "stability": {
          "type": "string",
          "enum": ["stable", "experimental", "incubating", "deprecated"],
          "description": "Maturity level of the content"
        },
        "maintainer": {
          "type": "string",
          "description": "Primary maintainer or team responsible for updates"
        },
        "license": {
          "type": "string",
          "description": "License identifier (e.g., GPL-3.0, MIT)"
        }
      }
    },
    "categoryFooterTemplate": {
      "type": "object",
      "properties": {
        "category": { "$ref": "#/definitions/category" },
        "footer_format": {
          "type": "string",
          "description": "Template string for footer generation"
        },
        "variations": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Alternative footer formats for this category"
        }
      }
    },
    "badgeSchema": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": ["status", "category", "version", "review", "maintenance"],
          "description": "Badge type/category"
        },
        "placement": {
          "type": "string",
          "enum": ["header", "footer", "inline"],
          "description": "Recommended badge placement"
        },
        "template": {
          "type": "string",
          "description": "Badge template (Markdown image syntax)"
        }
      }
    }
  },
  "properties": {
    "version": {
      "type": "string",
      "description": "Schema version"
    },
    "categories": {
      "type": "object",
      "description": "Document category definitions with paths and metadata",
      "properties": {
        "root": {
          "type": "object",
          "description": "Root-level GitHub configuration files",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "github-config": {
          "type": "object",
          "description": ".github/ directory files (templates, workflows, config)",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "workflows": {
          "type": "object",
          "description": "GitHub Actions workflow files",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "skills": {
          "type": "object",
          "description": "Portable skill definitions (highest priority for remediation)",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "instructions": {
          "type": "object",
          "description": "Portable instruction files",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "plugins": {
          "type": "object",
          "description": "Plugin definitions and packages",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "documentation": {
          "type": "object",
          "description": "Documentation and guides",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        },
        "agent-specs": {
          "type": "object",
          "description": "Agent specification files",
          "properties": {
            "path_pattern": { "type": "string" },
            "footer_required": { "type": "boolean" },
            "badge_support": { "type": "boolean" }
          }
        }
      }
    },
    "frontmatter_rules": {
      "type": "object",
      "description": "Frontmatter validation and transformation rules",
      "properties": {
        "required_fields": {
          "$ref": "#/definitions/requiredFrontmatterFields"
        },
        "optional_fields": {
          "$ref": "#/definitions/optionalFrontmatterFields"
        },
        "field_defaults": {
          "type": "object",
          "description": "Default values for fields per category"
        },
        "validation_rules": {
          "type": "object",
          "description": "Validation constraints per field and category"
        }
      }
    },
    "footer_templates": {
      "type": "object",
      "description": "Category-specific footer templates",
      "additionalProperties": { "$ref": "#/definitions/categoryFooterTemplate" }
    },
    "badge_schemas": {
      "type": "object",
      "description": "Badge definitions by type and category",
      "additionalProperties": { "$ref": "#/definitions/badgeSchema" }
    }
  },
  "required": ["version"]
}