nayrbryanGaming opened a new pull request, #63981: URL: https://github.com/apache/airflow/pull/63981
### Description While analyzing `AGENTS.md` for the GSoC 2026 "Contribution & Verification Agent Skills" project, I noticed a logical contradiction in the `## Commands` section that can actively mislead AI coding agents. The `## Environment Setup` section strictly dictates never to run `pytest` directly on the host. However, the `## Commands` section lists `uv run --project <PROJECT> pytest ...` as the primary command, only mentioning `breeze` as a fallback. Since AI agents often lack environment awareness (host vs. container), they tend to pattern-match the first command they see, leading to execution failures. **Changes made:** - Replaced the confusing command list with a `[!IMPORTANT]` block clarifying exactly when an AI agent should use `uv run` vs `breeze run`. - - Added explicit detection markers (`/.dockerenv`, `AIRFLOW_CI_IMAGE_NAME`, `BREEZE`) directly into the prompt instructions so AI agents reading this file can programmatically detect their execution context before running tests. This is a small documentation fix to serve as my first good first issue contribution while I prepare my GSoC proposal. ### Related Issues - Related to GSoC 2026 Agent Skills initiatives (#62500) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
