skill
Agent Ground Rules (Adom ecosystem conduct pack)
Public Made by Adomby adom
Umbrella pack of cross-cutting 'how an AI agent should behave in the shared Adom ecosystem' rules. One install pulls them all. Designed to fold into adom/core later as a single entry. Members: agent-browser-isolation (never hijack the user's real browser tabs) and wiki-notes-via-discussions (leave notes as open discussions, not edits or breadcrumbs).
← Commit history
SKILL.md+27−1@@ -1,6 +1,6 @@ --- name: agent-ground-rules-description: Umbrella pack of cross-cutting "how an AI agent should behave in the shared Adom ecosystem" rules. Read the relevant member before acting. Members: agent-browser-isolation (never navigate/close a browser tab or window you did not create; the native bridge drives the user's REAL Chrome/Edge full of live work and other AI threads) and wiki-notes-via-discussions (leave notes on pages you don't own as OPEN discussion items, not edits or breadcrumbs; another thread closes them). Designed to fold into adom/core later as one entry. Triggers: agent ground rules, agent conduct, drive the browser, nbrowser, leave a note on a wiki page, breadcrumb vs discussion, don't break other threads.+description: Umbrella pack of cross-cutting "how an AI agent should behave in the shared Adom ecosystem" rules. Read the relevant member before acting. Members: agent-browser-isolation (never navigate/close a browser tab or window you did not create; the native bridge drives the user's REAL Chrome/Edge full of live work and other AI threads) and wiki-notes-via-discussions (leave notes on pages you don't own as OPEN discussion items, not edits or breadcrumbs; another thread closes them). Inline rule: backtick-safe shell arguments (commit messages and issue bodies with backticks go through a file or quoted heredoc, NEVER an inline double-quoted argument, or the shell executes them as command substitution and silently mangles the text). Designed to fold into adom/core later as one entry. Triggers: agent ground rules, agent conduct, drive the browser, nbrowser, leave a note on a wiki page, breadcrumb vs discussion, don't break other threads, backticks in commit message, mangled commit message, command substitution in body, git -m backticks, body-file vs body. --- # Agent Ground Rules@@ -17,6 +17,32 @@ entry. |---|---|---| | Drive a browser (`nbrowser_*` / `browser_*`) | **[agent-browser-isolation](https://wiki.adom.inc/adom/agent-browser-isolation)** | Never navigate/reload/close a tab or window you did not create; the native bridge is the user's REAL browser (other live AI threads, forms, sessions). Open your own window; act only on tab IDs you captured. | | Leave a note on a wiki page you don't own | **[wiki-notes-via-discussions](https://wiki.adom.inc/adom/wiki-notes-via-discussions)** | Open a discussion item (an open issue), not an edit and not a breadcrumb. The owning repo's next thread actions and closes it. |+| Pass composed text through a shell (git commit -m, gh/adom-wiki --body, any -m) | **the inline rule below** | Text with backticks NEVER goes in an inline double-quoted argument; use a file flag (--body-file, -F) or a quoted heredoc. |++## Inline rule: backtick-safe shell arguments++Agent-composed text is full of markdown backticks, and a double-quoted shell+argument EXECUTES them as command substitution before the tool ever sees the+string: `git commit -m "use \`set --list\`"` runs `set --list` as a command,+splices its output (or nothing) into your message, and can even run real+programs as a side effect. The mangling is SILENT: the commit or issue posts+fine and reads as garbage later. `$(...)` and `$vars` behave the same way.++The rule: any message or body that contains a backtick, `$(`, or `$` goes+through a FILE, never an inline argument.++```bash+git commit -F - <<'MSG' # quoted heredoc: nothing substitutes+message with `backticks` intact+MSG+adom-wiki issue comment adom/x#1 --body-file note.md # same principle+gh pr create --body-file body.md+```++The single-quoted heredoc delimiter (<<'MSG') is what disables substitution;+an unquoted <<MSG substitutes exactly like double quotes. This bit a real+release: a hero-studio commit message shipped with its backticked examples+replaced by their command output, discovered only when rereading history. ## Why a pack
package.json+1−1@@ -2,7 +2,7 @@ "slug": "agent-ground-rules", "title": "Agent Ground Rules (Adom ecosystem conduct pack)", "type": "skill",- "version": "0.1.0",+ "version": "0.1.1", "description": "Umbrella pack of cross-cutting 'how an AI agent should behave in the shared Adom ecosystem' rules. One install pulls them all. Designed to fold into adom/core later as a single entry. Members: agent-browser-isolation (never hijack the user's real browser tabs) and wiki-notes-via-discussions (leave notes as open discussions, not edits or breadcrumbs).", "tags": [ "skill",
page.json+1−1@@ -2,7 +2,7 @@ "slug": "agent-ground-rules", "title": "Agent Ground Rules (Adom ecosystem conduct pack)", "type": "skill",- "version": "0.1.0",+ "version": "0.1.1", "description": "Umbrella pack of cross-cutting 'how an AI agent should behave in the shared Adom ecosystem' rules. One install pulls them all. Designed to fold into adom/core later as a single entry. Members: agent-browser-isolation (never hijack the user's real browser tabs) and wiki-notes-via-discussions (leave notes as open discussions, not edits or breadcrumbs).", "tags": [ "skill",