Adopt AGENTS.md as the canonical brief for AI coding tools - #22
Merged
Conversation
Mirrors the framework repo's convention so contributors and tooling meet one shape across both: AGENTS.md is the single canonical brief, read natively by GitHub Copilot, and CLAUDE.md is a pointer that imports it. Brings across the rest of that convention, adapted rather than copied — the merge model differs here, so the commit-restructuring skill now checks the PR's base branch first and stops on develop-bound PRs, where squash makes commit curation pointless. Issues gain templates. The bug form leads with the two checks that account for most reports: Fallout 10.4.0+, and a build-graph.json that actually exists. *.local.* is ignored by convention — machine-local state, never committed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ChrisonSimtian
added
the
documentation
Both now live once in Fallout-build/.github rather than in each repository, so the previous link into the framework repo's copy would have 404'd. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Brings this repo onto the framework's convention: one canonical
AGENTS.md, read natively by GitHub Copilot, withCLAUDE.mdas a pointer that imports it.Changes
AGENTS.md— canonical brief: repo layout, the build/plugin split, commands, and the ten rules that aren't discoverable from the code (generatedbuild.yml, thebuild-skip.ymlcomplement, the version/framework-line assertion, marketplace version constraints).CLAUDE.md— five-line pointer, same shape as the framework's.CONTRIBUTING.md— contributor flow, plus a "things that will fail review" list.docs/issue-and-pr-style.md— style contract both agent configs bind to, rather than duplicating the rules in each..github/ISSUE_TEMPLATE/— bug, feature, story, config. The bug form leads with the two checks that account for most reports: Fallout 10.4.0+, and abuild-graph.jsonthat exists..claude/— shared config, adapted not copied.restructure-pr-commitsgained a step 0: PRs intodevelopare squashed, so curating their commits is wasted effort, and it now reads the PR's real base ref before doing anything..gitignore—*.local.*, so machine-local state (CLAUDE.local.md,settings.local.json) can't be committed..vscodeignore— keeps all of the above out of the.vsix.Notes
None of the added files are in
version.json'spathFilters, so this doesn't move the git height..claude/settings.jsonis deliberately absent — it's a Bash permission allowlist and should be a human decision.