refactor: improved agent documentation#6465
Merged
Merged
Conversation
✅ Deploy Preview for bloom-angelopolis canceled.
|
✅ Deploy Preview for partners-bloom-dev ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for bloom-exygy-dev ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
emilyjablonski
added
the
1 review needed
ludtkemorgan
approved these changes
Jul 9, 2026
ludtkemorgan
added
ready to merge
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Consolidates AI coding-agent instructions into a single source of truth and fixes several small doc/config gaps found while doing an audit. No app code changes.
.github/copilot-instructions.mdis still the main instruction set for this repo. CLAUDE.md and AGENTS.md (both new) are one-line pointers to it, so Claude Code, GitHub Copilot, and any AGENTS.md-aware tool read the same guidance instead of drifting copies.copilot-instructions.md: just reorganized the guidelines into categories, and fixed several relative links that were broken (missing ../ since the file lives in .github/)..github/a11y-guidelines.mdto.github/instructions/a11y.instructions.mdso it sits in the location Copilot's path-scoped instructions actually discover.CONTRIBUTING.md: added a link from the human contributor guide to the new Conventions section.CHANGELOG.md: marked archived - it's been stale since 2021 and no longer reflects real change history..claude/settings.json: a basic permission allowlist seeded from real usage (npx jest, yarn tsc, npm view), add a deny rule blocking Claude's Read tool from opening any .env file due to sensitive local variables..gitignore: added .claude/settings.local.json (personal Claude Code overrides) so it's excluded for every contributor.How Can This Be Tested/Reviewed?
Docs/config only - no app behavior to QA. To review:
.github/copilot-instructions.md- changes are mostly organization - confirm CLAUDE.md and AGENTS.md are just pointers to that file. Here is a link to the formatted reviewable version.Author Checklist:
yarn generate:clientand/or created a migration when requiredReview Process: