Skip to content

docs: fix stale DEVIN.md/GEMINI.md references in .agents/ files#56

Merged
afonsoft merged 1 commit into
mainfrom
devin/1780076972-fix-stale-refs
May 29, 2026
Merged

docs: fix stale DEVIN.md/GEMINI.md references in .agents/ files#56
afonsoft merged 1 commit into
mainfrom
devin/1780076972-fix-stale-refs

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented May 29, 2026

Copy link
Copy Markdown
Contributor

All Submissions:

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same update/change?

Changes to Core Features:

  • Have you added an explanation of what your changes do and why you'd like us to include them?

What: Fix stale references to DEVIN.md, GEMINI.md, .aiignore, .cursorignore, and .geminiignore in .agents/README.md and .agents/CONTEXT.md.

Why: PR #55 removed DEVIN.md and GEMINI.md (out-of-scope per harness playbook) but left stale references in .agents/ files. An agent following the context hierarchy in .agents/CONTEXT.md would attempt to load these non-existent files.

Changes:

  • .agents/README.md: Updated file diagram to remove deleted files; updated compatibility table to show only in-scope platforms (Claude Code, Devin, Windsurf)
  • .agents/CONTEXT.md: Updated priority hierarchy to note that Devin and Windsurf read AGENTS.md directly

Link to Devin session: https://app.devin.ai/sessions/3b8be10535714264b5ab7946c1f110c3
Requested by: @afonsoft


Open in Devin Review

Remove references to deleted DEVIN.md, GEMINI.md, .aiignore,
.cursorignore, and .geminiignore from .agents/README.md and
.agents/CONTEXT.md. Update compatibility table to reflect
in-scope platforms only (Claude Code, Devin, Windsurf).

Co-Authored-By: Afonso Dutra Nogueira Filho <afonsoft@gmail.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@sonarqubecloud

Copy link
Copy Markdown

@afonsoft afonsoft merged commit d321871 into main May 29, 2026
12 of 15 checks passed

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Devin Review found 2 potential issues.

Open in Devin Review

Comment thread .agents/README.md
Comment on lines +6 to 10
AGENTS.md ← SSoT (≤500 linhas) — lido por Devin e Windsurf
CLAUDE.md ← Delta para Claude Code (@import AGENTS.md)
.claudeignore ← Ignore Claude Code
.cursorignore ← Ignore Cursor
.devinignore ← Ignore Devin
.geminiignore ← Ignore Gemini CLI
.windsurfignore ← Ignore Windsurf

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

📝 Info: Stale ignore files remain in repo after documentation cleanup

The PR removes .aiignore, .cursorignore, and .geminiignore from the README diagram, but these files still exist in the repository (confirmed via ls). While the documentation is being simplified to only reference Claude Code, Devin, and Windsurf, the orphaned ignore files for removed platforms were not cleaned up. This isn't a bug (the files are harmless), but a follow-up to delete them would keep the repo consistent with the updated docs.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Comment thread .agents/README.md
| Feature | Claude Code | Devin | Windsurf |
|---------|-------------|-------|----------|
| AGENTS.md (SSoT) | Sim | Sim | Sim |
| Platform file | CLAUDE.md | AGENTS.md | AGENTS.md |

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

🚩 Cross-file inconsistency: Windsurf config principal in AGENTS.md vs README

The new README line 37 states Windsurf's platform file is AGENTS.md, and CONTEXT.md line 16 states "Devin e Windsurf leem AGENTS.md diretamente". However, AGENTS.md:61 lists Windsurf's Config Principal as .windsurfignore, which is an ignore file, not a configuration file. The AGENTS.md entry appears to be a pre-existing error (an ignore file shouldn't be listed as config principal), and this PR's changes are arguably more accurate. However, since AGENTS.md is the declared SSoT, the inconsistency between these files should be resolved — ideally by also correcting AGENTS.md:61 to list AGENTS.md as Windsurf's config principal.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

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.

1 participant