{
  "schema_version": "2026-05-15.eval.v1",
  "id": "multi-agent-compatibility",
  "name": "TokRepo Multi-Agent Compatibility Matrix",
  "updated_at": "2026-05-15T00:00:00Z",
  "claim": "TokRepo exposes the same discovery, trust, install-plan, lifecycle, and handoff contracts to multiple agent runtimes through project memory, MCP, CLI, and machine-readable manifests.",
  "targets_under_test": [
    { "target": "codex", "project_memory": "AGENTS.md", "status": "contract-tested" },
    { "target": "claude_code", "project_memory": "CLAUDE.md", "status": "contract-tested" },
    { "target": "gemini_cli", "project_memory": "GEMINI.md", "status": "contract-tested" },
    { "target": "cursor", "project_memory": ".cursor/rules/tokrepo.mdc", "status": "contract-tested" },
    { "target": "github_copilot", "project_memory": ".github/copilot-instructions.md", "status": "contract-tested" },
    { "target": "cline", "project_memory": ".clinerules/tokrepo.md", "status": "contract-tested" },
    { "target": "windsurf", "project_memory": ".windsurf/rules/tokrepo.md", "status": "contract-tested" },
    { "target": "roo_code", "project_memory": ".roo/rules/tokrepo.md", "status": "contract-tested" },
    { "target": "openhands", "project_memory": ".openhands/microagents/repo.md", "status": "contract-tested" },
    { "target": "aider", "project_memory": "CONVENTIONS.md", "status": "contract-tested" },
    { "target": "mcp_clients", "project_memory": ".mcp.json", "status": "contract-tested" },
    { "target": "machine_contract_agents", "project_memory": ".tokrepo/agent.json", "status": "contract-tested" }
  ],
  "entrypoints_under_test": [
    "tokrepo init-agent --target all --dry-run --json",
    ".tokrepo/agent.json",
    "tokrepo_discover",
    "tokrepo_detail",
    "tokrepo_verify",
    "tokrepo_install_plan",
    "tokrepo_installed",
    "tokrepo_update",
    "tokrepo_uninstall",
    "tokrepo_rollback",
    "tokrepo_handoff_plan",
    "tokrepo agent-check --offline --json",
    "tokrepo eval-agent --offline --json",
    "https://tokrepo.com/.well-known/tool-catalog.json",
    "https://tokrepo.com/schemas/agent-memory.schema.json"
  ],
  "local_command": "node scripts/verify_agent_contract.mjs",
  "production_command": "WEB_BASE=https://tokrepo.com API_BASE=https://api.tokrepo.com node scripts/production-agent-discovery-check.mjs",
  "expected_agent_behavior": [
    "Load .tokrepo/agent.json when present, then read the vendor-specific instruction file for the active runtime.",
    "Call tokrepo_discover during planning when a reusable capability gap exists.",
    "Call tokrepo_verify and tokrepo_install_plan before any write or activation.",
    "Use tokrepo_installed, tokrepo_update, tokrepo_uninstall, and tokrepo_rollback for local managed state and recovery.",
    "Call tokrepo_handoff_plan or tokrepo agent-handoff --json after creating reusable work; never publish automatically."
  ],
  "public_success_criteria": [
    "The CLI dry-run plans every supported project-memory file plus .tokrepo/agent.json.",
    "The local MCP tools/list exposes lifecycle and handoff tools with safety annotations.",
    "Starter templates include every supported project-memory file.",
    "Public manifests and crawler text link to the agent memory schema and multi-agent eval evidence.",
    "Hosted read-only MCP remains usable for remote discovery while local MCP/CLI handle writes."
  ],
  "status": "implemented",
  "last_verified_by": "release-check"
}