clawdline AGENTS.md

Working in this repository

This checkout is shared by several live agent sessions, including Claude Code and Codex. Treat every change already present in the opening git status as another session's unfinished work. Do not stage, revert, rewrite, or commit those changes. Do not infer ownership from a filename, a recent timestamp, or a new commit; inspect the content and scope.

Project vocabulary is defined without implementation detail in CONTEXT.md. Read it before changing task, graph, review, landing, handoff, or verification semantics; follow its links to the narrower operational document for the work in front of you.

Shared-tree discipline

• Record git status --short before editing so you know the pre-existing state.
• Edit only paths assigned to your task.
• Use git add -- <file>... with every path named explicitly.
• Never use git add -A, git add ., or another broad staging command.
• Before any root-owned commit, run git diff --cached --stat and remove anything outside that commit's scope. What you are looking for is a path you did not stage yourself. The index is shared: another session's git add is already sitting in it, and a plain git commit with no pathspec commits the whole index, theirs included. That happened twice on 2026-08-28. Read the stat as "is every one of these lines mine?" rather than "does this look about right", and take a stranger back out with git reset -- <path>, which unstages without touching their bytes.
• Read the staged diff itself; a clean stat does not prove that a file contains only your work.
• After hunk-staging, commit the reviewed index with plain git commit -m <message> and no pathspec. git commit -- <path>... takes the named files from the worktree instead of the staged hunk selection and can absorb another session's unstaged hunks. A commit pathspec is safe only when the entire worktree diff of every named path belongs to that commit.
• The two commit traps point in opposite directions, which is why neither bullet above replaces the other: no pathspec sweeps in what somebody else staged, a pathspec sweeps in what somebody else left unstaged. git diff --cached --stat catches the first, reading the staged diff catches the second, and a commit that has had neither run on it is guarded against neither.
• A child or worker session does not commit. It hands its changes back to the root session for review and commit.
• Once a root session has completed the task it was originally assigned, reviewed its own diff, and verified the exact commit in isolation, it should commit its completed work without waiting for a separate user request to commit. This permission applies only when the root can isolate its own changes from every pre-existing or unrelated worktree change; otherwise it must keep the work uncommitted and coordinate with the owner of the overlapping paths.