Repository navigation
feat(context): load ~/.agents/AGENTS.md and order instruction files by scope - #93
Merged
Merged
Conversation
- Read the shared ~/.agents/AGENTS.md once per session and put it first in Pi's context files - Skip it when Pi already loaded the same file through a link, or when --no-context-files is set - Document the behavior in docs/USAGE.md and record the decision in .agents/notes/shared-agents.md
- Label each context file global, parent, project or folder, listed broadest first. - Tell the model narrower files win over broader ones, and chat wins over all files. - Files can override bruv's defaults on tone and asking, but not "How bruv works". - Replace Pi's project_context section in place.
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars.
 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
~/.agents/AGENTS.mdbefore project instruction files. Skip it when Pi already loaded the same file through a link, and when Pi runs with--no-context-files.global,parent,projectorfolderand lists them broadest first, so narrower files win on conflict.finish, jobs, agents, waiting).docs/USAGE.mdand record the decisions in.agents/notes/.Testing
bun run checkpasses (typecheck for root,siteandweb).bun testpasses: 302 tests across 45 files, including new tests for scope labels, file order, the replaced context section, the shared file order, and skipping a linked duplicate.bunx biome ci .passes with one existing warning about an unused import insrc/ui.ts, not from this change.pi -pruns in a fake home outside any repo, covering tone, ask-first, tabs vs spaces, never callingfinish, and a user request overriding "never commit":finishexception was moved under "How bruv works":deepseek-v4.1-flashpassed 2 of 2. Only that case was re-run.bun run test:site, GPT throughopenai-codex(not signed in on this machine), and the--webbuild, which does not yet use the new ordering.