AGENTS.md agent-jail rule restates the report rule #47

New issue

Closed

opened 2026-11-12 09:19:36 +01:00 by motoko · 0 comments

motoko commented

2026-11-12 09:19:36 +01:00

Collaborator

Seen at 49f53d5.

Location

AGENTS.md § Project rules, the agent-jail bullet, lines 64–67.

Evidence

The bullet reads: "An agent jail may lack podman and make: run what it
can, report which gates actually ran and which did not, and never claim
a gate passed without having executed it in this session. Without
make, run a target's commands with the venv's tools directly."

Since the Agent Foundry upgrade to b04e778, AGENTS.md § Working with
the user (lines 172–173) already requires every report to "give the
commands run with their results, the checks left unrun, assumptions, and
risks". The reporting clause restates that rule in a second home, which
§ Documentation ("Give each rule or fact one home") asks to avoid, and
the two copies can drift apart on the next upgrade.

Scenario

A later upgrade or edit changes the reporting rule in § Working with
the user; the Project rules copy keeps the old wording, and an agent in
the jail meets two versions of the same rule.

Smallest fix

Keep the bullet's project-specific parts and drop the reporting clause:
"An agent jail may lack podman and make: run what it can; without
make, run a target's commands with the venv's tools directly."

Low severity: wording only, no behavior changes.

Seen at 49f53d5. ## Location `AGENTS.md` § Project rules, the agent-jail bullet, lines 64–67. ## Evidence The bullet reads: "An agent jail may lack podman and `make`: run what it can, report which gates actually ran and which did not, and never claim a gate passed without having executed it in this session. Without `make`, run a target's commands with the venv's tools directly." Since the Agent Foundry upgrade to b04e778, `AGENTS.md` § Working with the user (lines 172–173) already requires every report to "give the commands run with their results, the checks left unrun, assumptions, and risks". The reporting clause restates that rule in a second home, which § Documentation ("Give each rule or fact one home") asks to avoid, and the two copies can drift apart on the next upgrade. ## Scenario A later upgrade or edit changes the reporting rule in § Working with the user; the Project rules copy keeps the old wording, and an agent in the jail meets two versions of the same rule. ## Smallest fix Keep the bullet's project-specific parts and drop the reporting clause: "An agent jail may lack podman and `make`: run what it can; without `make`, run a target's commands with the venv's tools directly." Low severity: wording only, no behavior changes.

motoko referenced this issue from a commit

2026-11-12 09:33:52 +01:00

docs(agents): drop the jail rule's report clause

motoko referenced this issue from a pull request that will close it,

2026-11-12 09:34:00 +01:00

fix: trim the jail rule and ignore local settings #48