A session reads no other tool's file at run time, CLAUDE.md, GEMINI.md, Copilot's and Cursor's rules and opencode's settings among them; each instruction file found is listed as not read, and Troupe's own rules are .troupe/rules/*.md¶
Decision 828 · accepted · 2026-10-10 · issue #516 · supersedes 683, 706, 806, 809
The maintainer decided that other tools' configuration stops being read at run time: it is
brought into Troupe's own files once (troupe onboard, Decision 823), and a session reads
only those, AGENTS.md and .agents/ (Decision 822). For this wave the maintainer also
decided the two things #516 left open for this slice: Cursor's rules are onboarded
too, not read in place (#516's first decision, against its recommendation), and the
readers go now, with no release of warning and no key to keep the old reading (its
fifth).
What a person upgrading sees. A repository whose agents' instructions are in a
CLAUDE.md, a GEMINI.md, .github/copilot-instructions.md, .cursorrules or
.cursor/rules/*.mdc no longer has them in any session's prompt until troupe onboard is
run there (or the person moves them into AGENTS.md and .troupe/rules/ by hand).
/context lists each such file as not read: run troupe onboard, and the session's
first start in such a workspace says what troupe onboard would propose (Decision 827).
A machine that reached a model only through opencode's opencode.jsonc and auth.json
has no provider until opencode's providers are copied into config.yaml: troupe config
and troupe setup offer the copy on a machine with no settings, and troupe-daemon config
import-opencode makes it.
- The instruction files (supersedes the aliases of 706 and 806). One name is read in a
directory:
AGENTS.md, beside.agents/AGENTS.md(822), in the person's own<config>, the repository root and each directory on the way to where the session works (798).CLAUDE.mdandGEMINI.md, which 706 read as aliases wherever they were, and Copilot's.github/copilot-instructions.md, which 806 read at the root, are no longer read anywhere: each one found in one of those directories is listed incontext.get, theinstructions_loadedevent and/contextasskipped, withreasonnot read: run troupe onboard, itssize,charsandhashempty, and nothing of it read, a link's target included. A Copilot file below the root keeps 806's reason,not read: Copilot's file counts only at the root, because it never counted and onboarding does not take it. Nothing hides anything any more, so a file'sskippedis always[]; the field stays, since a v1 field is never dropped, and a client that reads only it is right.@CLAUDE.mdwritten in anAGENTS.mdis still an import the person asked for, and is followed as any import is (798). - Rules (supersedes 809's place, keeps its meaning).
.troupe/rules/*.mdis read where.cursor/rules/*.mdcwas: at the repository root and in each directory on the way to where the session works, after the directory'sAGENTS.md, in name order, only the files directly in it. Its front matter is the one 809 read from an.mdc(description,globsas a list or a comma-separated string,alwaysApply), read byTroupe.Instructions.FrontMatter, the one reader onboarding reads Cursor's and Copilot's rules with (Decision 827), so a rule onboarding read one way is never read another once written; the loader's own copy had read a quoted string of globs (globs: "docs/**,lib/**") as two broken ones, which onboarding read as two. It means what it meant there: an always rule joins every prompt; aglobsrule joins from the turn after a file it matches is worked on, the globs taken from the directory that holds.troupe; a description-only rule is listed by its description and not joined; one with none isinactive. Confined by real path as before: a rule, a.troupe/rulesor a whole.troupethat is really outside the repository isoutside, a directory listed once and not looked into. The budget,applies,reasonandruleare 809's. Not in the person's<config>, as 809 had it..troupe/rules/is what the instruction files' onboarding source writes (rules/<name>.md, Decision 827). The legacy.cursorrules, which 809 joined as an always rule, and every.cursor/rules/*.mdcare now listed asskipped,not read: run troupe onboard, and a.cursor/ruleslinked out of the repository is still listed once asoutsideand not looked into. So is Copilot's.github/instructions/*.instructions.md, which Troupe never read and onboarding brings in (Decision 827): each at the repository root is listed after Cursor's, and a.github/instructionslinked out once asoutside; not below the root, where Copilot does not read them and onboarding does not take them. Not chosen: reading.cursor/rulesin place and.troupe/rulesbeside it (#516's recommendation, overruled), which keeps a format Troupe does not own read at every turn; a<config>/rulesfor the person, which nothing writes. - A file that cannot be read is listed (D84, D99). One found in a directory, an
AGENTS.md, an.agents/AGENTS.mdor a rule, that is there and cannot be read was logged and left out ofcontext.get. It is now listed with the newstatusunreadableandreasonnot read: <why>(permission denied), nothing of it in the prompt. An import that cannot be read is stillmissingon its importer. - An
.agentsdirectory has no file of its own. A session that worked on a file under.agents/walked.agentsas a directory on the way and read itsAGENTS.mda second time, as that directory's own, beside its parent's.agents/AGENTS.md(822). It is read once, as the parent's. troupe instructions checkfollows the loader (810, unchanged). It checks what the loader reads, so.troupe/rulesare checked and the files listed as skipped are not. A path written in<dir>/.agents/AGENTS.md, or in a rule in<dir>/.troupe/rules, is looked for from<dir>, the directory the file is about, as well as from its own directory and the root (D99: a nested one was called missing); 810's preference for a missed finding over a false one is why the file's own directory stays a base.- opencode's settings (supersedes 683's premise).
Troupe.Config.resolve/3no longer readsopencode.jsoncorauth.json: a configuration with no key of its own has no opencode providers and no opencode default model,config.get'sapi_key_sourceis neveropencodeand itsoverridesname no opencode fallback, no setting'slayerisopencode, andtroupe config's report no longer names opencode's path. What reads them is the one-time copy,Troupe.Config.ModelSettings.import_opencode/1, called byconfig.import(troupe config's first run), the first run'sreuse: opencode(setup.answer, in the terminal UI and the desktop app) andtroupe-daemon config import-opencode(the installers); andTroupe.Setup.detect/0, which looks to offer that copy.troupe confignow asks the daemon what opencode declares (setup.get'sdetected) instead of what a session would use, offers the copy saying Troupe does not read opencode's settings, and a no goes on to the other ways to a model; the installers say the same and go on totroupe configafter a no. opencode's agents, commands and MCP servers were never read at run time; onboarding (824) and/mcp import(820) copy them.
Governs: apps/troupe_core/lib/troupe/instructions.ex, apps/troupe_core/lib/troupe/instructions/front_matter.ex, apps/troupe_core/lib/troupe/instructions/check.ex, apps/troupe_core/lib/troupe/config/open_code.ex, apps/troupe_core/lib/troupe/config/model_settings.ex