Repository navigation
docs(agents): put scratch in .work/ and add denial, unattended and security-surface rules - #16608
Open
kyle-sexton wants to merge 2 commits into
Open
kyle-sexton wants to merge 2 commits into
kyle-sexton wants to merge 2 commits into
Conversation
…curity-surface rules - AGENTS.md: one-off tooling and raw data go in the gitignored .work/; the session scratchpad only without a checkout or where a tool needs a path outside a repository, deleted when the run ends. - AGENTS.md: a denied command is reported, never moved into a script, interpreter or wrapper and retried. - AGENTS.md: an unattended session sets its stop condition first and keeps a task file recording each decision. - loop-lane: a security concern names the exposed surface running today and its mode before it is raised; with none, one line and no question. Contract 19.8.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MWmASNT5Knyq99gphnV6B2
kyle-sexton
marked this pull request as ready for review
November 16, 2026 19:15
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Contributor
Lane run report
Failed GitHub API calls
|
Lane-Activity: pr-refine/fix-docs
Contributor
Lane run report
Failed GitHub API calls
|
This branch has not been deployed
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.
No related issue: owner-directed rule additions to AGENTS.md and the loop-lane contract.
Summary
Scratch files move to the gitignored
.work/, and three rules land where their topic alreadylives. None loosens a stop or a permission.
Fix
AGENTS.md, Pull request states: one-off tooling and raw data go in the repository's gitignored.work/; the session scratchpad only where a session has no checkout or a tool needs a pathoutside a repository, and that path is deleted when the run ends. The commit-the-conclusion and
harness rules are unchanged.
AGENTS.md, Stop and ask first: a denied command is never moved into a script, interpreter callor wrapper to change what the permission checks see; it is reported, not reshaped and retried.
The stop list itself is unchanged.
AGENTS.md, Long runs and the final report: a session told to run unattended sets its stopcondition before it starts and keeps a task file recording each decision and why.
docs/contracts/loop-lane/README.md, When work stops for the owner: a security concern names thesurface that runs today and is exposed, and in what mode, before it is raised as a question, a
plan or a stop; with none, one line with the condition that would make it matter, and nothing is
asked. Contract changelog 19.8.0 (minor, additive guidance, matching earlier additions to that
section).
Verification
render-index.sh check --file AGENTS.md(therules-indexhygiene check): exit 0.scripts/check-line-citations.py: pass.scripts/check-contract-clause-coverage.py: pass.markdownlint-cli2on the three files: 0 issues.session scratchpadgrep overdocs/,plugins/and.claude/: no hit documents thisrepository's own scratch rule; the hits describe plugin behavior for consumers, harness paths in
hook code, or changelog history, so none was changed.
Related
docs/contracts/loop-lane/CHANGELOG.md19.8.0.session: AI Hero
🤖 Generated with Claude Code
https://claude.ai/code/session_01MWmASNT5Knyq99gphnV6B2