simt-dev 0.7.0 → 0.8.0

package/harnesses/antigravity.json

@@ -0,0 +1,162 @@
+{
+  "id": "antigravity",
+  "loaderOrder": 5,
+  "surfaceOrder": 4,
+  "surface": {
+    "id": "antigravity",
+    "label": "Antigravity workspace rules",
+    "readers": "Antigravity IDE, Antigravity CLI",
+    "primary": null,
+    "kind": "file",
+    "rule": ".agents/rules/{name}.md",
+    "readsAgentsMd": "all",
+    "configDirs": [
+      ".agents"
+    ],
+    "documentedKeys": [
+      "trigger",
+      "description",
+      "globs",
+      "glob"
+    ],
+    "readsPrimary": true,
+    "verified": "Google Antigravity docs, \"Rules\" — .agents/rules/*.md, YAML frontmatter with trigger: always_on | model_decision | glob | manual; missing or invalid frontmatter silently discards the rule; trigger: glob takes comma-separated globs, which the docs require to be quoted so YAML does not read a leading * as an alias anchor; a 24 KB per-file limit and a 20,000-token budget for always_on rules, with automatic demotion to pointers past it",
+    "note": "This is why frontmatter is mandatory here and why the trigger value is not guessed: an unrecognised trigger means the rule is dropped with no message."
+  },
+  "pointerOrder": 2,
+  "pointer": {
+    "id": "gemini-md",
+    "surface": "antigravity",
+    "path": "GEMINI.md",
+    "to": "AGENTS.md",
+    "readers": "Gemini CLI, Antigravity",
+    "verified": "Google Antigravity docs, \"Rules\": workspace rules are AGENTS.md or GEMINI.md in the root or any subdirectory; Copilot CLI also discovers GEMINI.md. Gemini CLI, read today: its own docs (core memory index, and the configuration reference) say the memory service loads GEMINI.md hierarchically from the working directory up to the project root and the home directory and also into subdirectories, and that `context.fileName` in settings.json \"accepts either a single string or an array of strings\" naming the context file(s) to load, default undefined",
+    "note": "Covers Gemini CLI and gives Antigravity a second, equally-native name for the same file. A repository can also point Gemini CLI at AGENTS.md itself with `context.fileName: [\"AGENTS.md\"]` and need no pointer at all, which is the reason there is no separate Gemini CLI row here: this pointer and a native row would be two ways to hand one reader the same rule."
+  },
+  "loader": {
+    "id": "antigravity",
+    "label": "Antigravity",
+    "readers": "Antigravity IDE, Antigravity CLI",
+    "surface": "antigravity",
+    "start": [
+      {
+        "scope": "project",
+        "path": ".agents/rules/{name}.md",
+        "tree": "flat",
+        "dir": ".agents/rules",
+        "suffix": ".md",
+        "frontmatter": {
+          "trigger": "always_on"
+        },
+        "atStart": true,
+        "why": "Antigravity rules docs: trigger is one of always_on, model_decision, glob, manual; model_decision injects only the path and description"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Antigravity rules docs: AGENTS.md, GEMINI.md and .agents/AGENTS.md in the root or any subdirectory are always-on workspace rules, and they take no frontmatter"
+      },
+      {
+        "scope": "user",
+        "path": "~/.gemini/config/rules/*.md",
+        "tree": "flat",
+        "dir": ".gemini/config/rules",
+        "atStart": true,
+        "why": "Antigravity rules docs: global modular rules at ~/.gemini/config/rules/*.md, alongside ~/.gemini/AGENTS.md and ~/.gemini/config/AGENTS.md"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": ".agents/rules/*.md with trigger: model_decision",
+        "atStart": false,
+        "why": "Antigravity rules docs: progressive disclosure — the path and description are injected and the body is opened on demand"
+      },
+      {
+        "what": ".agents/rules/*.md in nested directories",
+        "atStart": false,
+        "why": "Antigravity rules docs: .agents/rules/ is scanned flat — nested files are ignored unless registered in .agents/rules.json"
+      }
+    ],
+    "order": "rules are cumulative across the global, workspace and directory scopes; directory scope is resolved by walking up from the edited file to the workspace root",
+    "cap": {
+      "bytes": 24000,
+      "scope": "file",
+      "config": "none — a fixed limit",
+      "why": "Antigravity rules docs: a rule file is truncated at 24,000 bytes, counted after @[label](path) includes are expanded"
+    },
+    "alsoCaps": [
+      {
+        "bytes": 20000,
+        "scope": "tokens",
+        "appliesTo": "global plus always_on rules combined",
+        "why": "Antigravity rules docs: past a 20,000-token budget the largest rules are demoted to a pointer line, \"- <path>: <description>\""
+      }
+    ],
+    "imports": {
+      "syntax": "@[label](path)",
+      "depth": 0,
+      "why": "Antigravity rules docs: @[label](path) inlines the file before the size limits are checked, with its frontmatter stripped; a bare @filename only rewrites to a canonical absolute path"
+    },
+    "nested": "cumulative — a rule applies to its directory and every subdirectory; the .agents/rules/ scan itself is flat",
+    "skills": [],
+    "skillsNote": "no skill directory is documented for Antigravity",
+    "hooks": {
+      "path": ".agents/hooks.json",
+      "verified": "Antigravity hooks docs: workspace level .agents/hooks.json, global ~/.gemini/config/hooks.json"
+    },
+    "agents": {
+      "dir": ".agents/agents",
+      "ext": ".md",
+      "verified": "Google Antigravity subagents docs (antigravity.google/docs/subagents, read 2026-10-30): project subagents are markdown files with name and description frontmatter under .agents/agents/"
+    },
+    "mcp": {
+      "path": ".agents/mcp_config.json",
+      "key": null,
+      "verified": "Antigravity MCP docs (read 2026-10-14): \"Configured in your workspace under .agents/mcp_config.json\""
+    },
+    "verified": "Google Antigravity rules documentation (antigravity.google/docs/rules/, read 2026-10-14) — rules are cumulative across global, workspace and directory scope; .agents/rules/*.md requires frontmatter with trigger, and an invalid block silently discards the rule; the directory is scanned flat and nested files are ignored unless registered in .agents/rules.json; each rule file is truncated at 24,000 bytes after includes are expanded, and global plus always_on rules share a 20,000-token budget past which the largest are demoted to pointers",
+    "note": "The flat scan is the fact that made the meter wrong before this table existed: a recursive walk of .agents/rules/ counts bytes for files Antigravity never reads."
+  },
+  "scopeKey": true,
+  "hooks": {
+    "id": "antigravity",
+    "event": "PreToolUse",
+    "matcher": "run_command|write_to_file|replace_file_content|multi_replace_file_content",
+    "denyExit": 0,
+    "verified": "antigravity.google/docs/hooks, read 2026-10-16",
+    "prompt": null,
+    "post": null,
+    "deny": {
+      "decision": "deny",
+      "reason": "__SIMT_TEXT__"
+    }
+  },
+  "payload": {
+    "toolKey": "toolCall",
+    "toolNameKey": "name",
+    "inputSubKey": "args",
+    "shellTools": [
+      "run_command"
+    ],
+    "commandKey": "CommandLine",
+    "writeTools": [
+      "write_to_file",
+      "replace_file_content",
+      "multi_replace_file_content"
+    ],
+    "pathKeys": [
+      "TargetFile"
+    ],
+    "rootKeys": [
+      [
+        "workspacePaths",
+        0
+      ],
+      [
+        "cwd"
+      ]
+    ]
+  }
+}

package/harnesses/claude.json

@@ -0,0 +1,206 @@
+{
+  "id": "claude",
+  "loaderOrder": 2,
+  "surfaceOrder": 3,
+  "surface": {
+    "id": "claude",
+    "label": "Claude Code rules",
+    "readers": "Claude Code",
+    "primary": null,
+    "kind": "file",
+    "rule": ".claude/rules/{name}.md",
+    "readsAgentsMd": "some",
+    "readsAgentsMdNote": "CLAUDE.md is read first; AGENTS.md is read only when there is no CLAUDE.md, which is why the pointer exists",
+    "configDirs": [
+      ".claude"
+    ],
+    "documentedKeys": [
+      "paths",
+      "description"
+    ],
+    "readsPrimary": true,
+    "substitutions": {
+      "askTool": "Use the interactive `AskUserQuestion` tool"
+    },
+    "verified": "Claude Code, \"Organize rules with .claude/rules/\" — recursive discovery, symlinks supported, no `paths` loads at session start",
+    "note": "CLAUDE.md is a separate pointer surface (see POINTERS). A rule file without frontmatter loads eagerly, which is what an always-on rule wants."
+  },
+  "pointerOrder": 1,
+  "pointer": {
+    "id": "claude-md",
+    "surface": "claude",
+    "path": "CLAUDE.md",
+    "to": "AGENTS.md",
+    "readers": "Claude Code",
+    "verified": "Claude Code memory docs: \"A symlink also works\" — `ln -s AGENTS.md CLAUDE.md`; Claude reads CLAUDE.md by default and AGENTS.md only as a fallback",
+    "note": "Claude Code reads CLAUDE.md and ignores AGENTS.md when both exist. A pointer is what makes one file answer for both without a second copy."
+  },
+  "loader": {
+    "id": "claude",
+    "label": "Claude Code",
+    "readers": "Claude Code",
+    "surface": "claude",
+    "start": [
+      {
+        "scope": "project",
+        "path": "CLAUDE.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Claude Code memory docs: CLAUDE.md and CLAUDE.local.md are discovered from the working directory and every directory above it, and all discovered files are concatenated"
+      },
+      {
+        "scope": "project",
+        "path": "CLAUDE.local.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Claude Code memory docs: CLAUDE.local.md is loaded at each level, after CLAUDE.md from that level"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "absent": [
+          "CLAUDE.md",
+          "CLAUDE.local.md"
+        ],
+        "why": "Claude Code memory docs: AGENTS.md is read directly, but only when there is no CLAUDE.md or CLAUDE.local.md in the working directory or above it"
+      },
+      {
+        "scope": "project",
+        "path": ".claude/rules/{name}.md",
+        "tree": "nested",
+        "dir": ".claude/rules",
+        "suffix": ".md",
+        "atStart": true,
+        "why": "Claude Code memory docs: project rules under .claude/rules/ are discovered recursively and loaded at session start when unscoped"
+      },
+      {
+        "scope": "user",
+        "path": "~/.claude/rules/*.md",
+        "tree": "flat",
+        "dir": ".claude/rules",
+        "atStart": true,
+        "why": "Claude Code memory docs: user-level rules in ~/.claude/rules/ load before project rules"
+      },
+      {
+        "scope": "project",
+        "path": ".claude/skills/{name}/SKILL.md",
+        "tree": "nested",
+        "dir": ".claude/skills",
+        "suffix": "/SKILL.md",
+        "atStart": true,
+        "metadata": true,
+        "why": "Claude Code memory docs: skills are discovered under .claude/skills"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": "MEMORY.md (auto memory)",
+        "atStart": true,
+        "why": "Claude Code memory docs: auto memory loads the first 200 lines or 25 KB, whichever comes first"
+      }
+    ],
+    "order": "filesystem root down to the working directory, CLAUDE.md before CLAUDE.local.md at each level",
+    "cap": {
+      "bytes": 4194304,
+      "scope": "file",
+      "config": "none — a fixed limit",
+      "why": "Claude Code memory docs: \"Claude Code loads a CLAUDE.md file of up to 4 MiB in full and skips a larger file\""
+    },
+    "imports": {
+      "syntax": "@path",
+      "depth": 4,
+      "why": "Claude Code memory docs: `@path/to/import` is expanded at launch, resolved relative to the importing file, to a maximum depth of four hops; parsing skips code spans and fenced blocks, `@` inside backticks is literal, quoted paths are not imported, and an import outside the working directory prompts for approval"
+    },
+    "nested": "on demand — a subdirectory CLAUDE.md loads when Claude reads, writes or edits a file in that directory",
+    "skills": [
+      ".claude/skills"
+    ],
+    "hooks": {
+      "path": ".claude/settings.json",
+      "verified": "Claude Code hooks docs, hook locations: project settings at .claude/settings.json and .claude/settings.local.json, user settings at ~/.claude/settings.json"
+    },
+    "agents": {
+      "dir": ".claude/agents",
+      "ext": ".md",
+      "verified": "Claude Code subagents docs (code.claude.com/docs/en/sub-agents, read 2026-10-30): project subagents are markdown files with name and description frontmatter under .claude/agents/"
+    },
+    "mcp": {
+      "path": ".mcp.json",
+      "key": null,
+      "verified": "Claude Code MCP docs (read 2026-10-14): project-scoped servers live in .mcp.json in the project root; local and user scope live in ~/.claude.json"
+    },
+    "verified": "Claude Code memory docs (docs.claude.com/en/docs/claude-code/memory, read 2026-10-14) — CLAUDE.md and CLAUDE.local.md are concatenated from every directory above the working directory, subdirectory files load on demand, `@path` imports expand to four hops, a CLAUDE.md larger than 4 MiB is skipped, and AGENTS.md is read only when no CLAUDE.md exists above the working directory",
+    "note": "The AGENTS.md row carries an `absent` condition because the vendor documents it as one. A repository holding both files is read by Claude Code for the CLAUDE.md alone, which is why the pointer surface exists."
+  },
+  "hooks": {
+    "id": "claude",
+    "event": "PreToolUse",
+    "matcher": "Bash|Edit|Write|MultiEdit|NotebookEdit",
+    "denyExit": 2,
+    "verified": "docs.claude.com/en/docs/claude-code/hooks, read 2026-10-16",
+    "prompt": {
+      "event": "UserPromptSubmit",
+      "verified": "code.claude.com/docs/en/hooks, read 2026-10-19",
+      "delivery": {
+        "hookSpecificOutput": {
+          "hookEventName": "UserPromptSubmit",
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "post": {
+      "event": "PostToolUse",
+      "matcher": "Bash",
+      "verified": "code.claude.com/docs/en/hooks, read 2026-10-19",
+      "delivery": {
+        "hookSpecificOutput": {
+          "hookEventName": "PostToolUse",
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "deny": {
+      "hookSpecificOutput": {
+        "hookEventName": "PreToolUse",
+        "permissionDecision": "deny",
+        "permissionDecisionReason": "__SIMT_TEXT__"
+      }
+    }
+  },
+  "payload": {
+    "toolKey": "tool_name",
+    "inputKey": "tool_input",
+    "shellTools": [
+      "Bash"
+    ],
+    "commandKey": "command",
+    "writeTools": [
+      "Edit",
+      "Write",
+      "MultiEdit",
+      "NotebookEdit"
+    ],
+    "pathKeys": [
+      "file_path"
+    ],
+    "pathOverrides": {
+      "NotebookEdit": [
+        "notebook_path"
+      ]
+    },
+    "rootKeys": [
+      [
+        "cwd"
+      ]
+    ]
+  },
+  "pluginOrder": 1,
+  "plugin": {
+    "rootVar": "CLAUDE_PLUGIN_ROOT",
+    "projectVar": "CLAUDE_PROJECT_DIR",
+    "hooksPath": "hooks/hooks.json",
+    "runtimeDir": "."
+  }
+}

package/harnesses/codex.json

@@ -0,0 +1,136 @@
+{
+  "id": "codex",
+  "loaderOrder": 3,
+  "loader": {
+    "id": "codex",
+    "label": "Codex CLI",
+    "readers": "Codex CLI, Codex IDE extension",
+    "surface": null,
+    "start": [
+      {
+        "scope": "project",
+        "path": "AGENTS.override.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Codex AGENTS.md docs: each directory from the project root to the working directory is checked for AGENTS.override.md first, then AGENTS.md, then the configured fallback filenames, and at most one file per directory is used"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Codex AGENTS.md docs: AGENTS.md is the second precedence in the same per-directory search"
+      },
+      {
+        "scope": "user",
+        "path": "~/.codex/AGENTS.override.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "Codex AGENTS.md docs: the global file is AGENTS.override.md if non-empty, otherwise AGENTS.md; CODEX_HOME overrides the home directory"
+      },
+      {
+        "scope": "user",
+        "path": "~/.codex/AGENTS.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "Codex AGENTS.md docs: AGENTS.md is the global fallback when AGENTS.override.md is empty or absent"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": "project_doc_fallback_filenames",
+        "atStart": true,
+        "why": "Codex config reference: an array of additional filenames checked per directory after AGENTS.override.md and AGENTS.md"
+      },
+      {
+        "what": "model_instructions_file",
+        "atStart": true,
+        "why": "Codex config reference: a file that replaces AGENTS.md as the project instructions source"
+      }
+    ],
+    "order": "project root down to the working directory, merged in that order and joined with blank lines",
+    "cap": {
+      "bytes": 32768,
+      "scope": "chain",
+      "config": "project_doc_max_bytes",
+      "why": "Codex AGENTS.md docs: empty files are skipped and Codex stops adding files once the combined size reaches project_doc_max_bytes, which defaults to 32 KiB"
+    },
+    "imports": {
+      "syntax": null,
+      "depth": 0,
+      "why": "no import syntax documented for AGENTS.md; a reference to another file is an instruction to the model, not an include"
+    },
+    "nested": "cumulative — every directory from the project root to the working directory is merged, and the cap applies to the merge",
+    "skills": [],
+    "skillsNote": "no skill directory is documented for Codex, so the cell is empty rather than borrowed from another reader",
+    "hooks": {
+      "path": ".codex/hooks.json",
+      "verified": "Codex hooks docs: <repo>/.codex/hooks.json or ~/.codex/hooks.json, or inline [hooks] tables in config.toml"
+    },
+    "agents": {
+      "dir": ".codex/agents",
+      "ext": ".toml",
+      "verified": "Codex custom agents docs (developers.openai.com/codex/subagents, read 2026-10-30): standalone TOML files under .codex/agents/ defining name, description and developer_instructions"
+    },
+    "mcp": {
+      "path": ".codex/config.toml",
+      "key": "mcp_servers",
+      "verified": "Codex MCP docs (read 2026-10-14): MCP configuration is stored in config.toml, ~/.codex/config.toml by default"
+    },
+    "verified": "Codex AGENTS.md documentation and configuration reference (developers.openai.com/codex, read 2026-10-14) — the project scope walks from the project root to the working directory, taking at most one file per directory in the order AGENTS.override.md, AGENTS.md, project_doc_fallback_filenames; the merge runs root to cwd and stops adding files at project_doc_max_bytes, 32 KiB by default",
+    "note": "This is the row that made the table worth building: `cap.scope` is `chain`, so a repository can be inside 32 KiB in every file and still lose the tail of its deepest instruction file to the merge."
+  },
+  "hooks": {
+    "id": "codex",
+    "event": "PreToolUse",
+    "matcher": "Bash|apply_patch",
+    "denyExit": 2,
+    "verified": "developers.openai.com/codex/hooks, read 2026-10-16",
+    "trust": "Codex skips a hook nobody has trusted: review it with /hooks, or the entry stays inert.",
+    "prompt": {
+      "event": "UserPromptSubmit",
+      "verified": "developers.openai.com/codex/hooks, read 2026-10-19",
+      "delivery": {
+        "hookSpecificOutput": {
+          "hookEventName": "UserPromptSubmit",
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "post": {
+      "event": "PostToolUse",
+      "matcher": "Bash",
+      "verified": "developers.openai.com/codex/hooks, read 2026-10-19",
+      "delivery": {
+        "hookSpecificOutput": {
+          "hookEventName": "PostToolUse",
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "deny": {
+      "hookSpecificOutput": {
+        "hookEventName": "PreToolUse",
+        "permissionDecision": "deny",
+        "permissionDecisionReason": "__SIMT_TEXT__"
+      }
+    }
+  },
+  "payload": {
+    "toolKey": "tool_name",
+    "inputKey": "tool_input",
+    "shellTools": [
+      "Bash"
+    ],
+    "commandKey": "command",
+    "writeTools": [
+      "apply_patch"
+    ],
+    "writesFrom": "patch",
+    "rootKeys": [
+      [
+        "cwd"
+      ]
+    ]
+  }
+}

package/harnesses/copilot.json

@@ -0,0 +1,88 @@
+{
+  "id": "copilot",
+  "loaderOrder": 7,
+  "surfaceOrder": 5,
+  "surface": {
+    "id": "copilot",
+    "label": "GitHub Copilot instructions",
+    "readers": "GitHub Copilot chat, Copilot CLI, Copilot code review, Copilot cloud agent",
+    "primary": null,
+    "kind": "file",
+    "rule": ".github/instructions/{name}.instructions.md",
+    "readsAgentsMd": "some",
+    "readsAgentsMdNote": "Copilot CLI reads AGENTS.md; the editor, code review and the cloud agent do not",
+    "configDirs": [
+      ".github"
+    ],
+    "documentedKeys": [
+      "applyTo",
+      "excludeAgent"
+    ],
+    "verified": "GitHub docs, \"Adding repository custom instructions\" — .github/instructions/NAME.instructions.md with applyTo globs; `applyTo: \"**\"` is the documented example, and a comma-separated pattern list is how more than one is named",
+    "note": "Copilot reads AGENTS.md itself through Copilot CLI, but the editor and code review do not; this is the channel they use."
+  },
+  "loader": {
+    "id": "copilot",
+    "label": "GitHub Copilot",
+    "readers": "Copilot CLI, Copilot chat, Copilot code review, Copilot cloud agent",
+    "surface": "copilot",
+    "start": [
+      {
+        "scope": "project",
+        "path": ".github/copilot-instructions.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "GitHub Copilot docs, adding repository instructions: .github/copilot-instructions.md applies to every request in the repository"
+      },
+      {
+        "scope": "project",
+        "path": ".github/instructions/**/*.instructions.md",
+        "tree": "nested",
+        "dir": ".github/instructions",
+        "suffix": ".instructions.md",
+        "frontmatter": {
+          "applyTo": "**"
+        },
+        "atStart": true,
+        "why": "GitHub Copilot docs: a path-specific file is applied when a file matching applyTo is in context, and applyTo: \"**\" matches every file at session start"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "GitHub Copilot docs, agent instructions: one or more AGENTS.md anywhere in the repository, the nearest to the file in play wins, or a single CLAUDE.md or GEMINI.md at the root"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": ".github/instructions/**/*.instructions.md",
+        "atStart": false,
+        "why": "GitHub Copilot docs: applyTo globs select the files, and excludeAgent keeps the file away from code review or the cloud agent"
+      }
+    ],
+    "order": "personal instructions, then repository instructions, then organization instructions",
+    "cap": null,
+    "capNote": "no byte cap published for Copilot instructions",
+    "imports": {
+      "syntax": null,
+      "depth": 0,
+      "why": "no import syntax documented for Copilot instruction files"
+    },
+    "nested": "nearest wins — AGENTS.md files anywhere in the repository are candidates and the nearest one to the file in play is used; .github/instructions/ may hold subdirectories",
+    "skills": [],
+    "skillsNote": "no project skill directory is documented for Copilot",
+    "hooks": null,
+    "hooksNote": "no hooks file is documented for Copilot in any first-party page checked on 2026-10-14",
+    "agents": null,
+    "agentsNote": "no file-based agents are documented for Copilot in any first-party page checked on 2026-10-30",
+    "mcp": {
+      "path": ".vscode/mcp.json",
+      "key": null,
+      "verified": "GitHub Copilot MCP docs (read 2026-10-14): the VS Code extension reads .vscode/mcp.json; Copilot CLI reads .mcp.json, .github/mcp.json or ~/.copilot/mcp-config.json; a repository-level configuration entered on github.com is not a file at all"
+    },
+    "verified": "GitHub Copilot documentation (docs.github.com/en/copilot, read 2026-10-14) — repository-wide instructions live at .github/copilot-instructions.md; path-specific instructions live at .github/instructions/**/NAME.instructions.md with applyTo globs and an optional excludeAgent; agent instructions are one or more AGENTS.md anywhere in the repository, nearest wins, or a single root CLAUDE.md or GEMINI.md; no byte cap is published",
+    "note": "Which Copilot reader consumes these differs — the cloud agent and code review are documented as reading repository and path-specific instructions — so the row is one reader with a split, the same split `surfaces.mjs` records on the copilot row."
+  },
+  "scopeKey": true
+}