docs(agents): Consolidate critical instructions into main AGENTS.md #106515
+135
−147
Conversation
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
…ENTS.md Critical command execution instructions were scattered across subdirectory AGENTS.md files, leading to AI agents making common mistakes like: - Running pytest without activating virtualenv - Missing required pytest flags (-svv --reuse-db) - Forgetting CI=true flag for frontend tests - Not using proper pre-commit commands This consolidation ensures agents always see these critical instructions since the main AGENTS.md is always loaded, regardless of which file is being edited. Changes: - Added "Command Execution Guide" section to main AGENTS.md with: * Python virtualenv requirements for AI agents vs humans * Backend commands (setup, linting, testing, database) * Frontend commands (dev, typechecking, linting, testing) - Removed duplicate command sections from src/AGENTS.md, tests/AGENTS.md, and static/AGENTS.md - Updated all references to point to the consolidated guide - Subdirectory files now focus on domain-specific patterns only Benefits: - Single source of truth for command execution - Prevents common command execution errors - Always visible to AI agents - Better separation: commands in main file, patterns in domain files
github-actions
bot
added
the
Scope: Frontend
armenzg
removed
the
Scope: Frontend
untitaker
reviewed
Jan 19, 2026
| devenv sync | ||
|
|
||
| # Activate the Python virtual environment (required for running tests and Python commands) | ||
| direnv allow |
Member
There was a problem hiding this comment.
so this still instructs the agent to run direnv allow, but i don't think direnv works within cursor properly. Further down there's a bare pytest. can we get rid of this and use uv run pytest further down?
Member
Author
There was a problem hiding this comment.
Right! Let me get rid of it.
Do we install uv by default?
Member
There was a problem hiding this comment.
uv is used to manage python deps, so yeah
Member
Author
There was a problem hiding this comment.
I have removed the note about the commands for humans but I would like to leave switching to uv outside of this PR.
Please propose it in #discuss-backend
Member
Author
There was a problem hiding this comment.
I may have figured out switching to uv locally. I will open a different PR for it.
github-actions
bot
added
the
Scope: Frontend
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.
Critical command execution instructions were scattered across subdirectory AGENTS.md files, leading to AI agents making common mistakes like:
pytestwithout activating virtualenvEven though #105426 helped, if you are not viewing a file that matches and load the sub-directory AGENTS.md, you will not benefit from that change.
This consolidation ensures agents always see these critical instructions since the main AGENTS.md is always loaded, regardless of which file is being edited.
Changes:
src/AGENTS.md,tests/AGENTS.md, andstatic/AGENTS.mdBenefits: