[
  {
    "role": "system",
    "content": {
      "protocol": "AISP V1.0.0",
      "axiom_0": "Human_Sovereignty_and_Wellbeing",
      "id": "agency_index_contract_aisp",
      "name": "Agency Agents Index Contract",
      "version": "1.0.0",
      "license": "MIT",
      "summary": "A machine-checkable AISP package for agency-agents routing, validation, and host-specific exports.",
      "description": "Defines a structured contract for the agency-agents catalog: agent identity, division membership, routing metadata, host export profiles, install paths, generated artifact validation, overlap detection, and quality checks.",
      "flow_format": "mermaid",
      "loading_mode": "node",
      "tools": [
        "filesystem",
        "shell"
      ],
      "params": {
        "repo_root": "string",
        "source_agents_root": "string",
        "target_host": "string?",
        "output_root": "string?"
      },
      "system_prompt": ""
    }
  },
  {
    "role": "user",
    "content": {
      "instruction": "STRICTLY OBEY aisp_contract; its non_negotiable rules are inviolable; then RUN aisop.main",
      "user_input": "{user_input}",
      "aisp_contract": {
        "profile": "aisp.skill.v1",
        "invocation": {
          "mode": "catalog_validation_or_host_export",
          "when_to_use": [
            "before converting agency agents to host-specific integration formats",
            "before installing agents into a supported host",
            "before validating the full agent catalog",
            "before adding a new agent to the catalog",
            "before generating integrations for Claude Code, OpenClaw, Cursor, Codex, Hermes, Aider, Windsurf, OpenCode, Qwen, Kimi, Osaurus, Gemini CLI, or Antigravity"
          ],
          "when_not_to_use": [
            "one-off manual copy of a single agent with no claim of generated integration support",
            "external forks that do not claim compatibility with upstream conversion scripts",
            "runtime execution of a single already-installed agent"
          ]
        },
        "non_negotiable": [
          {
            "rule": "Every source agent must have a stable canonical identity.",
            "enforced_by": "scan_agents.step2:sys.assert"
          },
          {
            "rule": "Every source agent must map to exactly one valid division unless explicitly marked as shared or special.",
            "enforced_by": "division_map.step2:sys.assert"
          },
          {
            "rule": "Host-specific exports must report which source fields were preserved and which were dropped.",
            "enforced_by": "export_host.step3:sys.assert"
          },
          {
            "rule": "Generated integrations must be reproducible from source agents and host export profiles.",
            "enforced_by": "validate_export.step2:sys.assert"
          },
          {
            "rule": "Install path resolution must distinguish config roots from agent directories.",
            "enforced_by": "install_path.step2:sys.assert"
          },
          {
            "rule": "Agent overlap must be detected before adding a new agent with similar role, description, or deliverables.",
            "enforced_by": "overlap.step2:sys.assert"
          },
          {
            "rule": "Agent quality validation must check required sections, deliverables, workflow process, and success metrics.",
            "enforced_by": "quality.step2:sys.assert"
          },
          {
            "rule": "Single-file host exports must not silently exceed host context or size assumptions.",
            "enforced_by": "host_limits.step2:sys.assert"
          },
          {
            "rule": "Every conversion or install run must emit a trace with source count, selected divisions, target host, output files, warnings, and dropped fields.",
            "enforced_by": "trace.step2:sys.assert"
          }
        ],
        "discovery": {
          "category": "agent_catalog_governance",
          "tags": [
            "agency-agents",
            "agent-index",
            "routing",
            "host-export",
            "install-validation",
            "agent-quality",
            "overlap-detection",
            "aisp"
          ]
        },
        "risk_level": "medium",
        "resources": [
          {
            "id": "host_export_profiles",
            "path": "resources/host-export-profiles.json",
            "kind": "config",
            "mode": "read_only",
            "when": "Read before converting agents to a host-specific format.",
            "scope": "skill"
          },
          {
            "id": "agent_quality_rules",
            "path": "resources/agent-quality-rules.json",
            "kind": "config",
            "mode": "read_only",
            "when": "Read before validating source agent files.",
            "scope": "skill"
          },
          {
            "id": "install_path_rules",
            "path": "resources/install-path-rules.json",
            "kind": "config",
            "mode": "read_only",
            "when": "Read before resolving install destinations.",
            "scope": "skill"
          },
          {
            "id": "overlap_groups",
            "path": "resources/overlap-groups.json",
            "kind": "index",
            "mode": "read_only",
            "when": "Read before checking duplicate or overlapping agents.",
            "scope": "skill"
          }
        ]
      },
      "aisop": {
        "main": "graph TD\n    scan_agents[Scan source agents] --> division_map[Validate division mapping]\n    division_map --> quality[Validate agent quality]\n    quality --> overlap[Detect overlap and duplicates]\n    overlap --> host_profile[Load host export profile]\n    host_profile --> export_host[Generate host-specific export]\n    export_host --> host_limits[Check host limits]\n    host_limits --> install_path[Resolve install path]\n    install_path --> validate_export[Validate generated export]\n    validate_export --> trace[Write conversion/install trace]\n    trace --> end_node((End))"
      },
      "functions": {
        "scan_agents": {
          "step1": "Scan source_agents_root for source agent Markdown files.",
          "step2": "sys.assert('each source agent has canonical identity fields', 'Every source agent requires canonical identity')",
          "output_mapping": "agent_inventory",
          "constraints": [
            "Canonical identity should include file path, slug, display name, division, description, and source hash.",
            "Generated integration files should not be treated as source agents."
          ]
        },
        "division_map": {
          "step1": "Validate every source agent against the division list and special directories.",
          "step2": "sys.assert('each source agent maps to exactly one valid division or declared special bucket', 'Invalid or ambiguous division mapping')",
          "output_mapping": "division_mapping_status",
          "constraints": [
            "Integration output directories are not source divisions.",
            "Special directories should be explicitly excluded or classified."
          ]
        },
        "quality": {
          "step1": "Validate required frontmatter and required semantic sections.",
          "step2": "sys.assert('agent file includes deliverables workflow and success metrics', 'Agent quality requirements missing')",
          "output_mapping": "agent_quality_report",
          "constraints": [
            "Quality validation should check name, description, color, emoji, vibe, services if required by project conventions.",
            "Quality validation should check Core Mission, Technical Deliverables, Workflow Process, and Success Metrics.",
            "Warnings should be emitted before becoming hard failures."
          ]
        },
        "overlap": {
          "step1": "Compare new or changed agents against existing agents by name, description, division, services, deliverables, and embeddings or lexical similarity.",
          "step2": "sys.assert('overlap status recorded for similar agents', 'Potential duplicate or overlapping agent must be reported')",
          "output_mapping": "overlap_report",
          "constraints": [
            "Near duplicates should be reported for maintainer review.",
            "Overlap does not automatically block a new agent if specialization is clear."
          ]
        },
        "host_profile": {
          "step1": "Load host export profile for target_host.",
          "output_mapping": "host_export_profile",
          "constraints": [
            "Host profile should define output format, path rules, preserved fields, dropped fields, size constraints, and install destination logic."
          ]
        },
        "export_host": {
          "step1": "Generate host-specific output from agent_inventory and host_export_profile.",
          "step2": "Record preserved fields and dropped fields for each exported agent.",
          "step3": "sys.assert('field preservation/dropping recorded for host export', 'Host export must report preserved and dropped fields')",
          "output_mapping": "generated_host_export",
          "constraints": [
            "Export should not silently drop routing-critical metadata.",
            "Export should preserve agent identity and description.",
            "Hosts with only name/description routing should receive compact routing-relevant descriptions."
          ]
        },
        "host_limits": {
          "step1": "Check generated_host_export against target host capacity, file size, count, description length, and format limits.",
          "step2": "sys.assert('host limits are checked before install', 'Generated export must be checked against host limits')",
          "output_mapping": "host_limit_report",
          "constraints": [
            "Single-file hosts should receive compact output or warnings.",
            "Hosts with agent count caps should warn before install.",
            "Description length should be checked where hosts route by description."
          ]
        },
        "install_path": {
          "step1": "Resolve install destination using install_path_rules and environment variables.",
          "step2": "sys.assert('config root and agent directory are distinguished', 'Install path resolution must distinguish config root from agent directory')",
          "output_mapping": "install_path_resolution",
          "constraints": [
            "Environment variables that point to config roots should not be treated as final agent directories unless documented.",
            "Dry-run should print resolved install path."
          ]
        },
        "validate_export": {
          "step1": "Validate generated files exist and correspond to source agents.",
          "step2": "sys.assert('generated integration reproducible from source and profile', 'Generated integration validation failed')",
          "output_mapping": "export_validation_report",
          "constraints": [
            "Generated integration files should be reproducible from source agents.",
            "Validation should report missing files, stale files, and orphaned files."
          ]
        },
        "trace": {
          "step1": "Write conversion/install trace with source agent count, selected divisions, selected agents, target host, output files, install paths, warnings, dropped fields, and validation status.",
          "step2": "sys.assert('conversion/install trace contains required fields', 'Trace missing required conversion/install evidence')",
          "output_mapping": "agency_index_trace",
          "constraints": [
            "Trace is evidence, not a trust certificate.",
            "Trace should make host export and install decisions debuggable."
          ]
        },
        "end_node": {
          "step1": "Return agent_quality_report, overlap_report, host_limit_report, export_validation_report, and agency_index_trace."
        }
      }
    }
  }
]