Commit Graph
38 Commits
Author SHA1 Message Date
Ryan Yin cc1655a059 docs(agents): normalize gating terms and drop duplicate clauses
Use one wording per gating family: exact target and scope, recovery path or safety guard, and explicit authorization. Remove the home-directory instance from workspace access and the repeated approval gate from the breaking-change bullet. Sync the high-impact eval scenario wording.
2026-09-19 08:50:17 +08:00
Ryan Yin 02346df157 docs(agents): gate irreversible operations and generalize preview validity
State the destructive-and-high-impact section as a principle: irreversible operations need explicit authorization, destructive or force operations form a separate categorical gate, and unpublished history rewrites are exempt at section level. Generalize infrastructure preview invalidation to any input change, and add an irreversible-action eval scenario.
2026-09-19 08:26:41 +08:00
Ryan Yin f260d17d3b docs(agents): refine user-edit and test-double rules
Generalize the revert rule to protect any content the user changed or removed, and require confirmation before touching it. Replace the mock ban with a scope rule: checks must not be faked or weakened, and test doubles may replace only what a check does not verify. Sync the matching eval scenario.
2026-09-19 07:52:16 +08:00
Ryan Yin 46266dd8ea chore(agents): remove Claude integrations 2026-09-18 21:20:33 +08:00
Ryan Yin 2f9c43fe8d docs(agents): note SRE/DevOps role in the preamble 2026-09-14 21:40:54 +08:00
Ryan Yin d96df9adfa docs(agents): note single-quote inline code for nu/python 2026-09-14 21:35:43 +08:00
Ryan Yin 3412dfefec docs(agents): require Nushell or Python for shell glue
- limit POSIX shell to a single command with arguments
- route pipes, chaining, substitution, redirection, and ShellCheck/BashPitfalls cases to Nushell or Python
2026-09-14 20:57:12 +08:00
Ryan Yin 4d54df2008 docs(agents): rename Commit messages section to Git commits 2026-09-14 20:51:53 +08:00
Ryan Yin 6d2455ad4e docs(agents): drop redundant handling and precedence rules
- remove the Request handling and Scope and precedence sections
- keep the non-weakening guarantee under Safety and authorization
- remove the now-stale eval scenarios
2026-09-14 20:48:56 +08:00
Ryan Yin c86edde9a2 docs(agents): streamline global rules
- merge verification rules and split infrastructure guidance
- shorten Tools, Shell/scripts, and Communication
- apply script validation to any script file, including temporary ones
- sync evals
2026-09-14 20:39:49 +08:00
ryan4yin | 二花 85af66801f docs(agents): add SRE change guardrails and refine global rules (#269)
* docs(agents): bind authorization to the change boundary

* docs(agents): require target identity confirmation

* docs(agents): classify operations by impact, not command form

* docs(agents): require reviewed previews for high-risk IaC

* docs(agents): verify production changes beyond exit codes

* docs(agents): sync new-script eval with current rules

* docs(agents): split global rules evals into smoke and extended

* docs(agents): refine change guardrails wording

- scope the guardrails to any environment, not only production
- preview high-risk changes with plan, diff, or dry-run
- trim redundant examples and simplify target identity confirmation
- confirm unclear targets with the user instead of stopping
2026-09-14 20:28:21 +08:00
Ryan Yin 2ac1b30768 docs(agents): restructure script validation minimums 2026-09-14 19:27:57 +08:00
Ryan Yin d30cfe1543 docs(agents): relax the one-logical-change commit rule 2026-09-14 19:24:52 +08:00
Ryan Yin 88636130c1 docs(agents): refine secrets, commit, tooling, and shell rules
- allow file-path secret references and require approval for breaking changes
- relax the commit subject limit and allow rewriting unpublished local history
- refine tooling plus shell and script selection/validation guidance
2026-09-14 19:19:34 +08:00
Ryan Yin a71472012c docs(agents): generalize shell rule and state safety priority
Emphasize safety precedence in the intro, and replace the narrow Bash pipeline ban with a trigger-based rule: keep POSIX shell as glue and move to Nushell or Python once quoting, error handling, parsing, types, retries, or portability are involved.
2026-09-11 14:25:20 +08:00
Ryan Yin 9fa975887d docs(agents): clarify authorization reuse and task baselines 2026-09-05 14:17:31 +08:00
Ryan Yin dc261e2934 docs(agents): focus global rules and script validation 2026-09-01 18:33:26 +08:00
Ryan Yin 9822dafa89 docs(agents): refine global agent rules 2026-08-31 18:35:17 +08:00
Ryan Yin bed0359a0d docs(agents): standardize global rule semantics 2026-08-31 16:37:07 +08:00
Ryan Yin 12a9bee134 docs(agents): enforce Nushell for local pipelines 2026-08-31 16:14:05 +08:00
Ryan Yin 01622bf6d6 docs(agents): clarify shell and script guidance 2026-08-31 13:54:03 +08:00
Ryan Yin de35352e48 docs(agents): refine global command guidance 2026-08-31 12:35:09 +08:00
Ryan Yin 5fe43e3c12 docs(agents): require reader-focused documentation 2026-08-29 14:03:50 +08:00
Ryan Yin 33ca0819df docs(agents): preserve GitHub SSH config 2026-08-27 16:30:35 +08:00
Ryan Yin fe97c91047 docs(agents): document Clash TUN networking 2026-08-26 20:14:18 +08:00
Ryan Yin 73bf26f5e2 docs(agents): streamline global guidance
Signed-off-by: Ryan Yin <xiaoyin_c@qq.com>
2026-08-26 20:14:18 +08:00
Ryan Yin 166376676b docs(agents): clarify command waiting and environment rules 2026-08-25 17:17:31 +08:00
Ryan Yin 58e056486d docs(agents): allow scoped secret authentication 2026-08-05 10:13:16 +08:00
Ryan Yin 6f837b8718 docs(agents): clarify cleanup safety boundaries 2026-08-05 10:06:04 +08:00
Ryan Yin 5c5bbe3210 docs: agents - add secres access policy 2026-07-28 18:28:12 +08:00
Ryan Yin 6279ac663f docs: AGENTS.md - script languages 2026-06-23 20:46:35 +08:00
Ryan Yin 92b92969b3 docs: AGENTS.md - script languages 2026-06-23 20:43:11 +08:00
Ryan Yin ef1c02f3cf docs: AGENTS.md
Signed-off-by: Ryan Yin <xiaoyin_c@qq.com>
2026-06-23 20:34:58 +08:00
Ryan Yin ee3e35872a docs: minor update 2026-03-21 22:55:57 +08:00
Ryan Yin d02f3dd7d3 docs: minor update 2026-03-21 22:54:35 +08:00
Ryan Yin 7650a77193 docs(agents): clarify gh usage for code/pr/issue search 2026-03-21 22:48:14 +08:00
Ryan Yin 59608f38db docs(agents): tighten safety and environment defaults 2026-03-21 22:42:11 +08:00
Ryan Yin f5444150ef feat: agents 2026-03-21 20:54:40 +08:00