Skip to content

docs: clarify rule file loading behavior and precedence - #14330

Closed
jstasiak wants to merge 1 commit into
anomalyco:devfrom
jstasiak:clarify-rules-docs
Closed

jstasiak wants to merge 1 commit into
anomalyco:devfrom
jstasiak:clarify-rules-docs

Conversation

@jstasiak

@jstasiak jstasiak commented Feb 19, 2026 •

Copy link
Copy Markdown

Issue for this PR

Closes #9282

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

  • Document subdirectory rule files (loaded dynamically on file read, not at startup)
  • Explain the upward walk from file location to project root
  • Fix misleading "first matching file wins" phrasing: clarify it applies to filename variants (AGENTS.md vs CLAUDE.md), not across directories or categories
  • Note that project-level and global rules are combined, not overridden

How did you verify your code works?

N/A

Screenshots / recordings

N/A

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

If you do not follow this template your PR will be automatically rejected.

- Document subdirectory rule files (loaded dynamically on file read,
  not at startup)
- Explain the upward walk from file location to project root
- Fix misleading "first matching file wins" phrasing: clarify it
  applies to filename variants (AGENTS.md vs CLAUDE.md), not across
  directories or categories
- Note that project-level and global rules are combined, not overridden

Fixes anomalyco#9282
@github-actions github-actions Bot added the needs:compliance This means the issue will auto-close after 2 hours. label Feb 19, 2026
@github-actions

Copy link
Copy Markdown
Contributor

The following comment was made by an LLM, it may be inaccurate:

Found a related PR:

PR #9287: docs: clarify that project and global AGENTS.md files are combined

This PR appears to be related as it addresses clarification about how project-level and global AGENTS.md files are combined (not overridden), which is one of the points in the current PR #14330. The current PR may be an update or expansion of the documentation effort started in PR #9287.

@github-actions github-actions Bot removed the needs:compliance This means the issue will auto-close after 2 hours. label Feb 19, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Thanks for updating your PR! It now meets our contributing guidelines. 👍

@github-actions

Copy link
Copy Markdown
Contributor

Closing this pull request because it has had no updates for more than 60 days. If you plan to continue working on it, feel free to reopen or open a new PR.

@github-actions github-actions Bot closed this Apr 21, 2026
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.

docs: clarify that project and global AGENTS.md files are combined, not overridden

1 participant