simt-dev 0.7.1 → 0.8.0

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
+}

package/harnesses/cursor.json

@@ -0,0 +1,140 @@
+{
+  "id": "cursor",
+  "loaderOrder": 4,
+  "surfaceOrder": 2,
+  "surface": {
+    "id": "cursor",
+    "label": "Cursor rules",
+    "readers": "Cursor",
+    "primary": null,
+    "kind": "file",
+    "rule": ".cursor/rules/{name}.mdc",
+    "readsAgentsMd": "all",
+    "configDirs": [
+      ".cursor"
+    ],
+    "documentedKeys": [
+      "description",
+      "alwaysApply",
+      "globs"
+    ],
+    "readsPrimary": true,
+    "substitutions": {
+      "askTool": "Use the interactive `AskQuestion` tool"
+    },
+    "verified": "Cursor project rules (.cursor/rules/*.mdc, description + alwaysApply + globs); alwaysApply: false with globs is \"auto-attached when a matching file is in context\", and the docs warn that alwaysApply: false with no description is manual @-mention only",
+    "note": "The only surface that reads `.mdc`. Every other row here is a plain `.md` or a symlink."
+  },
+  "loader": {
+    "id": "cursor",
+    "label": "Cursor",
+    "readers": "Cursor",
+    "surface": "cursor",
+    "start": [
+      {
+        "scope": "project",
+        "path": ".cursor/rules/{name}.mdc",
+        "tree": "nested",
+        "dir": ".cursor/rules",
+        "suffix": ".mdc",
+        "frontmatter": {
+          "alwaysApply": "true"
+        },
+        "atStart": true,
+        "why": "Cursor rules docs: alwaysApply: true alone means the rule is always included; alwaysApply: false attaches on a matching file, on a description match, or only on an @-mention"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Cursor rules docs: AGENTS.md is supported in the project root and in subdirectories, combined with parent files, with the more specific one winning"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": ".cursor/rules/*.mdc with alwaysApply: false",
+        "atStart": false,
+        "why": "Cursor rules docs: globs auto-attach on a matching file, a description lets the model decide, and a rule with neither loads only on an @-mention"
+      },
+      {
+        "what": "team and user rules",
+        "atStart": true,
+        "why": "Cursor rules docs: precedence is Team Rules, then Project Rules, then User Rules; the latter two are configured in the app, not in a file this tool can project"
+      }
+    ],
+    "order": "team rules, then project rules, then user rules",
+    "cap": null,
+    "capNote": "no byte cap published; the docs recommend keeping rules under 500 lines, which is guidance and not a limit the reader enforces",
+    "imports": {
+      "syntax": null,
+      "depth": 0,
+      "why": "Cursor rules docs: an @file in a rule body is not inlined — \"the file's contents are not inlined into the prompt\""
+    },
+    "nested": "cumulative — nested AGENTS.md files are combined with their parents and the more specific one wins; .cursor/rules/ may hold folders",
+    "skills": [],
+    "skillsNote": "no project skill directory is documented for Cursor",
+    "hooks": {
+      "path": ".cursor/hooks.json",
+      "verified": "Cursor agent hooks docs: <project-root>/.cursor/hooks.json and ~/.cursor/hooks.json"
+    },
+    "agents": {
+      "dir": ".cursor/agents",
+      "ext": ".md",
+      "verified": "Cursor subagents docs (cursor.com/docs/subagents, read 2026-10-30): project subagents are markdown files with name and description frontmatter under .cursor/agents/"
+    },
+    "mcp": {
+      "path": ".cursor/mcp.json",
+      "key": null,
+      "verified": "Cursor MCP docs (read 2026-10-14): \"Create .cursor/mcp.json in your project\""
+    },
+    "verified": "Cursor rules documentation (cursor.com/docs/context/rules, read 2026-10-14) — only .cursor/rules/*.mdc is read, a plain .md there is ignored; alwaysApply decides whether a rule costs bytes at start; @file references in a rule body are not inlined; AGENTS.md is read in the project root and in subdirectories, combined with parents",
+    "note": "A rule with alwaysApply: false is listed under alsoReads rather than start, because it costs nothing until something matches."
+  },
+  "scopeKey": true,
+  "hooks": {
+    "id": "cursor",
+    "event": "preToolUse",
+    "matcher": "Shell|Write|Edit",
+    "denyExit": 2,
+    "verified": "cursor.com/docs/agent/hooks, read 2026-10-16",
+    "prompt": null,
+    "post": null,
+    "deny": {
+      "permission": "deny",
+      "user_message": "__SIMT_TEXT__",
+      "agent_message": "__SIMT_TEXT__"
+    }
+  },
+  "payload": {
+    "toolKey": "tool_name",
+    "inputKey": "tool_input",
+    "shellTools": [
+      "Shell"
+    ],
+    "commandKey": "command",
+    "writeTools": [
+      "Write",
+      "Edit"
+    ],
+    "pathKeys": [
+      "file_path",
+      "path"
+    ],
+    "rootKeys": [
+      [
+        "working_directory"
+      ],
+      [
+        "cwd"
+      ]
+    ]
+  },
+  "pluginOrder": 3,
+  "plugin": {
+    "rootVar": null,
+    "projectVar": "CURSOR_PROJECT_DIR",
+    "hooksPath": ".cursor/hooks.json",
+    "runtimeDir": ".cursor/simt"
+  }
+}

package/harnesses/deepseek.json

@@ -0,0 +1,99 @@
+{
+  "id": "deepseek",
+  "loaderOrder": 8,
+  "loader": {
+    "id": "deepseek",
+    "label": "DeepSeek harness",
+    "readers": "DeepSeek harness",
+    "surface": null,
+    "chainMerge": "all",
+    "dedupe": "trim",
+    "start": [
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: AGENTS.md is the first base candidate in each directory from the project root down to the session working directory"
+      },
+      {
+        "scope": "project",
+        "path": "CLAUDE.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: CLAUDE.md is the second base candidate and loads beside AGENTS.md unless the two are identical after trimming"
+      },
+      {
+        "scope": "project",
+        "path": "AGENTS.local.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: AGENTS.local.md is a local overlay loaded after the base candidates in the same directory"
+      },
+      {
+        "scope": "project",
+        "path": "CLAUDE.local.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: CLAUDE.local.md is the second local overlay, under the same per-directory trim dedup"
+      },
+      {
+        "scope": "user",
+        "path": "~/.dsh/AGENTS.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: the user-global file is $DSH_HOME/AGENTS.md, defaulting to ~/.dsh/AGENTS.md"
+      },
+      {
+        "scope": "user",
+        "path": "~/.agents/AGENTS.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "DeepSeek harness agent-instructions docs: the shared agents root is $DSH_AGENTS_HOME or ~/.agents, and a copy that matches the harness-home file collapses behind it"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": "AGENTS.md below the session working directory",
+        "atStart": false,
+        "why": "DeepSeek harness agent-instructions docs: a successful read, write or edit that reaches a deeper directory loads that directory's instruction file on the next request; shell navigation does not"
+      }
+    ],
+    "order": "user-global ~/.dsh/AGENTS.md, then ~/.agents/AGENTS.md, then every project candidate from the project root down to the working directory, broad to specific; within one directory, base files then local overlays",
+    "cap": {
+      "bytes": 65536,
+      "scope": "chain",
+      "config": "maxBytes",
+      "drop": "broader",
+      "why": "DeepSeek harness agent-instructions docs: dsh-base sets maxBytes to 65536, and rendering drops whole broader files before truncating the most specific one"
+    },
+    "alsoCaps": [
+      {
+        "bytes": 1048576,
+        "scope": "file",
+        "appliesTo": "one source file before rendering",
+        "config": "maxSourceBytes",
+        "why": "DeepSeek harness agent-instructions docs: maxSourceBytes defaults to 1048576, and a larger source file is ignored rather than truncated into the chain"
+      }
+    ],
+    "imports": {
+      "syntax": null,
+      "depth": 0,
+      "why": "DeepSeek harness agent-instructions docs: @path imports are not interpreted; a reference inside an instruction file is not an include"
+    },
+    "nested": "on touch — the baseline is the root-to-cwd chain; a deeper AGENTS.md loads after a successful read, write or edit in that directory, not because the shell changed directory",
+    "skills": [],
+    "skillsNote": "the agent-instructions package does not document a project skill directory; shared agent configuration lives at ~/.agents, which is user scope and is not measured here",
+    "hooks": null,
+    "hooksNote": "DeepSeek harness hooks docs: the Claude Code and Codex bridges take an explicit configPath, and project-local hooks.json discovery is still marked TODO, so no repository path is loaded by default",
+    "agents": null,
+    "agentsNote": "no file-based agents are documented for the DeepSeek harness in any first-party page checked on 2026-10-30",
+    "mcp": {
+      "path": null,
+      "key": "@deepseek-ai/dsh-mcp-client",
+      "verified": "DeepSeek harness MCP docs: a server is a profile plugin row (@deepseek-ai/dsh-mcp-client), not a project file this tool can project"
+    },
+    "verified": "DeepSeek harness agent-instructions package (deepseek-ai/deepseek-harness packages/context/agent-instructions/README.md, read 2026-10-14) — the baseline loads ~/.dsh/AGENTS.md, ~/.agents/AGENTS.md, then AGENTS.md and CLAUDE.md plus the local overlays from the project root down to the working directory; trimmed duplicates in one directory collapse; dsh-base caps the rendered baseline at 65536 bytes and ignores a source file over 1048576 bytes",
+    "note": "A drifted CLAUDE.md beside AGENTS.md is loaded in full. A symlink or a byte-identical copy is not. That is why this reader does not share Codex's one-file-per-directory rule."
+  }
+}