docs(agents): AGENTS.md at a third (1228 → 515 words) - #19
Merged
Merged
Conversation
AGENTS.md is the rulebook for an agent working on factory from a checkout: every verb, path, env var, log line and test file stays, the argument for each rule goes. CLAUDE.md is the @AGENTS.md import alone. Rebased onto main after #18 landed, so the runner rows, FACTORY_RUNNER_INTERVAL and the four fixer gates are part of the cut. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SUxGLZEUsasdh9nf6BieJZ
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
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.
What: AGENTS.md at a third: 1228 → 515 words. CLAUDE.md 30 → 3 (the
@AGENTS.mdimport alone).Why: one lane of the family-wide AGENTS.md slim-down. A rulebook for an agent on a checkout keeps every verb, path, env var, log line and test file, and drops the argument for each rule. The workshop's own slim-down PR is not open yet.
Verify
wc -w AGENTS.md CLAUDE.md: 1228 / 30 on main, 515 / 3 here.nix develop:shellcheck -x(0.11.0) clean overbin/factory,libexec/*,lib/*.sh,script/check-skills.sh;bash -nover the same;./script/check-skills.sh ai factoryrc 0;FACTORY_UI_SH=<snug pinned rev>/share/ui.sh bats test/: 242 ok, 0 failed, 1 skipped.common.shislib/common.sh;grantislease grant.PATH(the workshop AGENTS.md's factory row says haus ships it on PATH);$@,set -e,shift 2(the flag-refusal mechanism, visible in every libexec script).factory config print(the policy's only statement),README.md,share/ui.sh.Watch out
bench overlap --path AGENTS.mdnamedlease-runs-the-shift(AGENTS.md L18-95) mid-lane. Its PR runner: a live lease runs the shift, and the nightshift skill is code now #18 merged while this lane was open, so this branch is rebased onto main and the runner rows,FACTORY_RUNNER_INTERVALand the four fixer gates are part of the cut. After the rebase overlap is clean: no other lane touches AGENTS.md, nothing to order.main:AGENTS.md, NEW = this file). First pass, before the rebase, flagged 7 losses, all of them the runner: a live lease runs the shift, and the nightshift skill is code now #18 stanza; second pass on the final file: 0 losses.🤖 Generated with Claude Code
https://claude.ai/code/session_01SUxGLZEUsasdh9nf6BieJZ