Skip to content

docs: add Quality Gates guidance to AGENTS.md#1849

Open
aozherelyeva wants to merge 2 commits intodevelopfrom
zarechneva/tests-claude-instructions
Open

docs: add Quality Gates guidance to AGENTS.md#1849
aozherelyeva wants to merge 2 commits intodevelopfrom
zarechneva/tests-claude-instructions

Conversation

@aozherelyeva
Copy link
Copy Markdown
Contributor

  1. Add mandatory Quality Gates guidance to AGENTS.md (as discussed on the retro)
  2. Update MediaTestScenarios and RetryUtils

@aozherelyeva aozherelyeva added documentation Improvements or additions to documentation enhancement New feature or request tests Add new tests or modify existing labels Apr 13, 2026
@devcrocod
Copy link
Copy Markdown
Contributor

agents.md needs a complete rewrite because it has become significantly outdated over the past year

It should stay short, since it is included in every request. Once the file grows to 300+ lines, it starts consuming too much context, which negatively affects coding agent results

It is also better not to include behavioral instructions there. Those instructions usually cover only specific use cases, while coding agents are used much more broadly. As a result, such instructions may be useful in some scenarios, but harmful in others: they can reduce output quality, lead to worse decisions, and produce unexpected behavior. With the introduction of skills, behavioral instructions in agents.md have become obsolete

@aozherelyeva aozherelyeva force-pushed the zarechneva/tests-claude-instructions branch from 622ff08 to 9350f45 Compare April 14, 2026 09:58
@aozherelyeva
Copy link
Copy Markdown
Contributor Author

@devcrocod fair point! I moved quality gates to TESTING.md and added a note about it in the AGENTS.md. I think rewriting this file should be done as a separate task. I also removed some of the instructions, so now they're more general.

@aozherelyeva aozherelyeva force-pushed the zarechneva/tests-claude-instructions branch from 9350f45 to 749fcaa Compare April 14, 2026 09:59
@aozherelyeva aozherelyeva force-pushed the zarechneva/tests-claude-instructions branch from 749fcaa to ef02d02 Compare April 15, 2026 13:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request tests Add new tests or modify existing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants