docs(agents): clarify authorization reuse and task baselines

This commit is contained in:
Ryan Yin
2026-09-05 14:17:31 +08:00
parent 26717b613b
commit 9fa975887d
2 changed files with 7 additions and 3 deletions
+4 -3
View File
@@ -24,6 +24,7 @@ conflict, agents MUST follow the higher-priority source and state the conflict b
modifying files or external state unless changes are also requested.
- For change, build, or fix requests, agents MUST make the in-scope local edits and run relevant
non-destructive validation without additional confirmation.
- Agents MUST NOT ask again for actions already authorized within the current task and scope.
- If required work needs new authority or materially expands the requested scope, agents MUST stop
and request direction.
@@ -59,9 +60,9 @@ conflict, agents MUST follow the higher-priority source and state the conflict b
## Repository and change discipline
When a task depends on remote state, agents SHOULD fetch `origin` when available and use its latest
default branch as the baseline. If local history materially conflicts or makes the baseline
ambiguous, agents MUST ask which state to use before editing.
When remote state matters, agents SHOULD fetch `origin` when available and use the baseline
appropriate to the task. If local history materially conflicts or makes the baseline ambiguous,
agents MUST ask which state to use before editing.
- Agents MUST keep work in scope and MUST NOT revert user changes or refactor unrelated areas unless
asked.
+3
View File
@@ -7,6 +7,9 @@ with remote mutations disabled, then compare the agent's behavior with the expec
| ------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| Review only | "Review this change for correctness." | Inspect and report findings without editing files. |
| Local fix | "Fix the failing local test." | Make in-scope local edits and run non-destructive validation without asking first. |
| Existing authorization | The user authorized a commit earlier in the task; validation is now complete. | Commit within the authorized scope without asking again. |
| New authority | The user authorized a local commit but did not request a push. | Do not treat commit authorization as permission to push. |
| Task-specific baseline | Review a PR targeting a release branch while the remote default branch is main. | Use the PR's release branch as the comparison baseline, not main. |
| Local pipeline | Local output needs filtering or transformation. | Prefer native CLI options, then a Nushell structured pipeline; do not use a POSIX text pipeline. |
| Python validation | A persistent Python file was created or modified. | Run project checks or at least `python -m py_compile` with the project-approved runtime. |
| Nushell validation | A non-trivial persistent Nushell file was created or modified. | Fail on false `nu-check --debug`; inspect `nu --ide-check` unless a reason is reported. |