Skip to content

docs(agents): AGENTS.md at a third (1228 → 515 words) - #19

Merged
JulienMartel merged 1 commit into
mainfrom
worktree-agent-docs-minimal
Sep 6, 2026
Merged

JulienMartel merged 1 commit into
mainfrom
worktree-agent-docs-minimal

Conversation

@JulienMartel

Copy link
Copy Markdown
Contributor

What: AGENTS.md at a third: 1228 → 515 words. CLAUDE.md 30 → 3 (the @AGENTS.md import 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.
  • In nix develop: shellcheck -x (0.11.0) clean over bin/factory, libexec/*, lib/*.sh, script/check-skills.sh; bash -n over the same; ./script/check-skills.sh ai factory rc 0; FACTORY_UI_SH=<snug pinned rev>/share/ui.sh bats test/: 242 ok, 0 failed, 1 skipped.
  • Dropped backtick spans (main vs this branch):
    • (a) another spelling: common.sh is lib/common.sh; grant is lease grant.
    • (b) lives elsewhere: 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).
    • (c) losses put back: none.
    • Added: factory config print (the policy's only statement), README.md, share/ui.sh.

Watch out

  • bench overlap --path AGENTS.md named lease-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_INTERVAL and the four fixer gates are part of the cut. After the rebase overlap is clean: no other lane touches AGENTS.md, nothing to order.
  • Assurance pass ran (clean-context subagent, OLD = 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.
  • Budget overshoot: 515 against a ≤ 409 target. Every backtick span main had is kept except the six tagged above, and 26 of the counted words are table pipes; the prose left is one clause per rule.

🤖 Generated with Claude Code

https://claude.ai/code/session_01SUxGLZEUsasdh9nf6BieJZ

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
@JulienMartel
JulienMartel merged commit 01eb993 into main Sep 6, 2026
2 checks passed
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