{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/agents-md/refs/heads/main/json-schema/agents-md-file-schema.json",
  "title": "AgentsMdFile",
  "description": "Representation of an AGENTS.md file's structured content providing context and instructions to AI coding agents.",
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "The filename, typically AGENTS.md.",
      "example": "AGENTS.md"
    },
    "location": {
      "type": "string",
      "description": "File path within the repository.",
      "example": "/AGENTS.md"
    },
    "project_name": {
      "type": "string",
      "description": "Name of the project or subproject this file applies to.",
      "example": "My API Service"
    },
    "description": {
      "type": "string",
      "description": "Brief description of the project's purpose and architecture.",
      "example": "A REST API service built with FastAPI and PostgreSQL."
    },
    "build_commands": {
      "type": "array",
      "description": "Commands for building the project.",
      "items": {
        "type": "object",
        "properties": {
          "label": { "type": "string", "example": "Install dependencies" },
          "command": { "type": "string", "example": "pip install -r requirements.txt" }
        }
      }
    },
    "test_commands": {
      "type": "array",
      "description": "Commands for running tests.",
      "items": {
        "type": "object",
        "properties": {
          "label": { "type": "string", "example": "Run unit tests" },
          "command": { "type": "string", "example": "pytest tests/ -v" }
        }
      }
    },
    "lint_commands": {
      "type": "array",
      "description": "Commands for linting and formatting code.",
      "items": {
        "type": "object",
        "properties": {
          "label": { "type": "string", "example": "Lint code" },
          "command": { "type": "string", "example": "ruff check . && black --check ." }
        }
      }
    },
    "coding_standards": {
      "type": "array",
      "description": "Coding conventions and style guidelines for the project.",
      "items": { "type": "string" },
      "example": ["Use snake_case for Python identifiers", "Keep functions under 50 lines"]
    },
    "security_notes": {
      "type": "array",
      "description": "Security considerations and sensitive file locations agents should be aware of.",
      "items": { "type": "string" },
      "example": ["Never commit .env files", "Secrets are stored in AWS Secrets Manager"]
    },
    "created": {
      "type": "string",
      "format": "date",
      "description": "Date the AGENTS.md file was created.",
      "example": "2026-01-15"
    },
    "modified": {
      "type": "string",
      "format": "date",
      "description": "Date the AGENTS.md file was last modified.",
      "example": "2026-04-19"
    }
  },
  "required": ["filename"]
}