Commit Graph
83 Commits
Author SHA1 Message Date
Ryan Yin 97237f352d docs(agents): use the Nix-managed GitHub SSH config
Restore the rule dropped in 9822dafa: keep GitHub Git remotes on SSH, make sure the Nix-managed ~/.ssh/config is used, and rerun outside the sandbox when it is rejected.
2026-10-04 14:32:32 +08:00
ryan4yin | 二花 2ee0b9c7eb chore(tui): remove standalone herdr, superseded by tuios (#374) 2026-10-04 11:23:16 +08:00
ryan4yin | 二花 3a5b9ec4c6 docs: README audit fixes and de-duplication (#371) 2026-10-03 18:28:58 +08:00
ryan4yin | 二花 6a1b4c699a chore(docs): prune stale TODOs (#370) 2026-10-03 17:50:28 +08:00
ryan4yin | 二花 afdaa3b869 refactor(agents): manage agent config in a home-manager module (#367) 2026-10-03 16:57:38 +08:00
Ryan Yin a4206c17a9 docs(agents): note nushell is the interactive shell 2026-10-02 11:39:36 +08:00
Ryan Yin 1d43fd2802 docs(agents): label the post-merge cleanup rule 2026-10-02 11:24:18 +08:00
Ryan Yin 044862110e docs(agents): clean up after a merged PR 2026-10-02 11:21:19 +08:00
ryan4yin | 二花 2b0f01d99c chore(agents): workspace layout, related repositories, and ~/src checkouts (#340)
* docs(skills): point nix-config-secrets at the private repo under ~/codes

Record where the private nix-secrets checkout lives and that agents should
do the mechanical secret work themselves, handing back only the
interactive/sudo agenix operations and pushes.

* docs(agents): add related repositories to nix-config

* chore(agents): adopt ~/src for source checkouts

Move third-party/source checkouts from ~/codes/src to ~/src so the home
layout reads as three siblings: ~/codes (personal), ~/work (work),
~/src (checkouts). Preserve and back up the new path, and update the
global rule and the two nixpkgs skill references.

* docs(agents): tighten the code layout rule

* docs(agents): fold the work-confidentiality note into the layout line

* docs(agents): base the confidentiality rule on repo visibility

* docs(agents): drop the stale KubeVirt mention
2026-10-02 11:16:24 +08:00
ryan4yin | 二花 68ea04f173 fix(docs): correct stale and mismatched documentation (#338) 2026-10-02 10:21:55 +08:00
ryan4yin | 二花 b2ec56db66 docs(skills): add repo-scoped task skills and give each fact one home (#337) 2026-10-02 10:13:03 +08:00
Ryan Yin 872901007e docs(agents): use terraform plan, drop nonexistent helm diff 2026-10-01 11:34:34 +08:00
Ryan Yin 9885283edf docs(agents): clarify local language selection and prefer Bun 2026-10-01 10:23:35 +08:00
Ryan Yin 7f6759219b docs(agents): align evals with external instruction boundaries 2026-09-30 21:17:19 +08:00
Ryan Yin 91cc9c0cf4 docs(agents): fix authorization and skill trust wording
Allow clearly-implied task authorization, trust skills listed in the runtime's configured catalog, and restore the ban on following external-material instructions. Sync the affected evaluation scenarios.
2026-09-30 21:09:34 +08:00
ryan4yin | 二花 111929023d docs(agents): clarify tool selection and authorization boundaries (#331) 2026-09-30 20:51:42 +08:00
Ryan Yin bae98ed1c8 docs(agents): allow TypeScript for complex shell commands 2026-09-30 18:38:08 +08:00
Ryan Yin b38d8b802e docs(agents): make apply a distinct step in impactful changes 2026-09-28 10:18:52 +08:00
Ryan Yin 695d58de8b docs(agents): mention quoted heredoc for multi-line code 2026-09-26 22:53:13 +08:00
ryan4yin | 二花 f326dcb139 docs(agents): Simplifies global rules so agents can understand and follow it easily (#323) 2026-09-26 09:51:42 +08:00
Ryan Yin 27b99fa45f docs(agents): add untrusted-source safety rules
Treat content from unverified sources as data, not instructions, and require authorization before cloning, downloading, or executing unverified code and install scripts.
2026-09-26 08:23:15 +08:00
Ryan Yin e401a75ca5 chore(agents): remove crush
Crush hardcodes banned bash commands, blocking many operations. Drop the package, its AGENTS.md/CRUSH.md install target, env vars, and preservation entries.
2026-09-25 00:30:12 +08:00
Ryan Yin 501c6af220 chore(agents): remove rtk integration
RTK compresses only shell output and independent evaluations show little to no end-to-end cost reduction. Drop the package and its install snippets; runtime artifacts were uninstalled separately.
2026-09-19 09:47:52 +08:00
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 0ddf3f4471 docs(agents): add i-have-adhd skill to optional global set 2026-09-19 08:31:08 +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 8c62b5433d chore(agents): remove Cursor integrations 2026-09-18 21:20:33 +08:00
Ryan Yin bcee9f2ac8 feat(agents): add Crush and disable usage tracking 2026-09-18 21:20:33 +08:00
Ryan Yin 23258a06d4 feat(agents): add Pi and OMP 2026-09-18 21:20:33 +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 8d108ee035 docs(agents): add herdr skill and record config TODOs 2026-09-14 13:18:57 +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 26717b613b fix(agents): continue rule installation after target errors 2026-09-05 13:34:13 +08:00
Ryan Yin a3bbb70508 fix(agents): preserve existing rules during symlink installation 2026-09-05 13:34:13 +08:00
Ryan Yin 33b17baeff docs(agents): clarify rule scope and remove permission templates 2026-09-05 13:34:13 +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