[FEATURE]: Configurable instruction file search boundary and file types

[EvanZhang008]

Feature hasn't been suggested before.

• I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Feature Request: Configurable AGENTS.md Search Behavior

Problem

OpenCode searches for instruction files (AGENTS.md, CLAUDE.md, CONTEXT.md) but has two limitations:

1. Search stops at git repository root - Cannot find AGENTS.md files in parent directories above the repository
2. Only first file type is loaded - If AGENTS.md exists, CLAUDE.md is never checked (due to break statement)

Example: Monorepo Issue

/workspace/company-monorepo/
├── AGENTS.md                          ← Cannot be found
└── services/
    ├── AGENTS.md                      ← Cannot be found
    └── my-service/
        └── .git/                      ← Search stops here
            └── src/working-here/

Code: packages/opencode/src/session/system.ts:74-80

for (const localRuleFile of LOCAL_RULE_FILES) {
  const matches = await Filesystem.findUp(localRuleFile, Instance.directory, Instance.worktree)
  if (matches.length > 0) {
    matches.forEach((path) => paths.add(path))
    break // ← Stops after first file type found
  }
}

Proposed Solution

Add two configuration options in opencode.json:

{
  "instructions": {
    "searchBoundary": "git-root" | "filesystem-root",
    "fileTypes": ["AGENTS.md", "CLAUDE.md", "CONTEXT.md"]
  }
}

Defaults (Backward Compatible)

{
  "instructions": {
    "searchBoundary": "git-root",
    "fileTypes": ["AGENTS.md", "CLAUDE.md", "CONTEXT.md"],
  },
}

Examples

Monorepo setup:

{
  "instructions": {
    "searchBoundary": "filesystem-root",
    "fileTypes": ["AGENTS.md"],
  },
}

Use both AGENTS.md and CLAUDE.md:

{
  "instructions": {
    "fileTypes": ["AGENTS.md", "CLAUDE.md"],
  },
}

Implementation

1. Update config schema (packages/opencode/src/config/config.ts):

instructions: z.object({
  searchBoundary: z.enum(["git-root", "filesystem-root"]).default("git-root"),
  fileTypes: z
    .array(z.enum(["AGENTS.md", "CLAUDE.md", "CONTEXT.md"]))
    .default(["AGENTS.md", "CLAUDE.md", "CONTEXT.md"]),
}).optional()

2. Update search logic (packages/opencode/src/session/system.ts):

const fileTypes = config.instructions?.fileTypes ?? LOCAL_RULE_FILES
const searchStop = config.instructions?.searchBoundary === "filesystem-root" ? undefined : Instance.worktree

for (const localRuleFile of fileTypes) {
  const matches = await Filesystem.findUp(localRuleFile, Instance.directory, searchStop)
  matches.forEach((path) => paths.add(path))
  // Remove break statement - search all file types
}

Benefits

• ✅ Monorepo support
• ✅ Backward compatible
• ✅ Choose specific file formats
• ✅ Load multiple file types together