Skip to content

chore: check AGENTS.md path claims in both directions - #115

Merged
Mtze merged 1 commit into
mainfrom
chore/agents-guard-both-directions
Aug 27, 2026
Merged

chore: check AGENTS.md path claims in both directions#115
Mtze merged 1 commit into
mainfrom
chore/agents-guard-both-directions

Conversation

@Mtze

@Mtze Mtze commented Aug 26, 2026

Copy link
Copy Markdown
Member

A backticked path must exist — unless the sentence says it does not, in which case it must not.

The second direction is the one this org needs. The rewritten AGENTS.md files deliberately name dead paths so nobody mistakes retired directories for live code — EduIDE points at four retired image trees, EduIDE-Cloud states that java/pom.xml does not exist and explains why that means the Dockerfiles are the build order. If someone later creates one of those, the doc is quietly wrong again and a one-directional check says nothing.

Only true absence flips the check. "is dead", "retired" and "never built" describe something that exists and does not work — a different claim. Conflating them made the guard demand the deletion of a workflow that exists and is simply broken.

Verified by creating a path the doc says is absent and watching it fail.

The same script lands in EduIDE, EduIDE-Cloud, EduIDE-Landing-Page and theia-scale-tests alongside their AGENTS.md rewrites.

A backticked path must exist - unless the sentence says it does not, in which
case it must NOT exist.

That second direction is the one this org needs. The AGENTS.md files now name
dead paths deliberately, so nobody mistakes retired directories for live code:
EduIDE points at four retired image trees, EduIDE-Cloud says java/pom.xml does
not exist and explains why that means the Dockerfiles are the build. If someone
later creates one of those, the doc has quietly become wrong again and the
one-directional check would say nothing.

Only true absence flips the check. "is dead", "retired" and "never built"
describe something that exists and does not work, which is a different claim -
scorpio_auto_update.yml is exactly that, and conflating the two made the guard
demand its deletion.

Verified by creating a path the doc says is absent and watching it fail.
Copilot AI lite review requested due to automatic review settings August 26, 2026 22:30

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 35 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 0b65cf21-b476-45a3-813b-33b1503e8818

📥 Commits

Reviewing files that changed from the base of the PR and between 1987c36 and 4b928f5.

📒 Files selected for processing (1)
  • scripts/check-agents-md.sh

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Mtze
Mtze merged commit 36accf1 into main Aug 27, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants