From b6f646996ebeca7c1fa91b95d1c9cddfcf83aa9e Mon Sep 17 00:00:00 2001
From: codekongdev <349702077+codekongdev@users.noreply.github.com>
Date: Wed, 4 Nov 2026 17:17:47 +0900
Subject: [PATCH 1/2] docs: make AGENTS.md a contributor guide for agents

Replace the maintainer's GitHub account rules with guidance that applies
to every contributor's agent: read CONTRIBUTING.md first, run the checks
that CI runs, and keep screenshots and personal files out of commits.

The account rules described one maintainer's local credential setup. In a
public repository they told every contributor's agent to stop unless it
was authenticated as the maintainer, which blocks pull requests from
forks. They now live in the maintainer's local agent configuration.
---
 AGENTS.md | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index cc3642d..a8d2ca6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,8 +1,19 @@
-# GitHub account for this repository
-
-- All authenticated GitHub operations for `codekongdev/plz` must use **`codekongdev`**. This includes issues, pull requests, comments, labels, releases, and pushes.
-- Never use another account, including `planit-mason` or `YASICJUNWOO`, as a fallback, even if it is the default CLI or connector account.
-- Before a GitHub operation, verify the authenticated login with `gh api user --jq .login` or an equivalent identity check. Use the same credentials for the check and the operation, and proceed only when the login is exactly `codekongdev`.
-- The repository owner and the username in the remote URL do not verify the authenticated account. A connector must also pass the identity check before use.
-- Prefer credentials scoped to the individual command or process. Do not switch the global GitHub account for other projects, and never print credentials or save them in repository files or logs.
-- If `codekongdev` authentication is unavailable or cannot be verified, stop the GitHub operation and report the authentication problem. Do not act under a different account.
+# Agent instructions
+
+This repository publishes agent skills for Claude Code and Codex. Read [CONTRIBUTING.md](CONTRIBUTING.md) before you change files. It covers the repository structure, the language policy, the checks for each kind of change, what not to commit, and the commit and pull request rules.
+
+## Checks
+
+Run the checks that match your change from the repository root. CI runs all three on every pull request.
+
+| What you changed | Command |
+| --- | --- |
+| Any `README.md` or translation | `node scripts/check-readme-translations.mjs` |
+| `ENGINE` or `UI_TEXT` in `assets/template.html` | `node scripts/check-templates.mjs` |
+| Anything in `scripts/` | `node --test scripts/*.test.mjs` |
+
+The script tests include Chromium tests. Install their dependencies first with `npm ci --ignore-scripts` and `npx playwright install chromium`.
+
+This table lists only the automated checks. Changes to `SKILL.md`, `references/`, or `TEXT`, `SCENES`, and `ENGINE` in `assets/template.html` also need the review or browser validation described in "Checks to run" in CONTRIBUTING.md.
+
+Browser automation tools can save screenshots in the repository root. Run `git status` before every commit, and do not commit screenshots, generated pages, or `references/preferences.md`.

From aced2a9f700e20607fdc83fdb77f905c5ebde23f Mon Sep 17 00:00:00 2001
From: codekongdev <349702077+codekongdev@users.noreply.github.com>
Date: Wed, 4 Nov 2026 17:23:37 +0900
Subject: [PATCH 2/2] docs: note the Linux Playwright dependency step in
 AGENTS.md

---
 AGENTS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index a8d2ca6..6ec4796 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -12,7 +12,7 @@ Run the checks that match your change from the repository root. CI runs all thre
 | `ENGINE` or `UI_TEXT` in `assets/template.html` | `node scripts/check-templates.mjs` |
 | Anything in `scripts/` | `node --test scripts/*.test.mjs` |
 
-The script tests include Chromium tests. Install their dependencies first with `npm ci --ignore-scripts` and `npx playwright install chromium`.
+The script tests include Chromium tests. Install their dependencies first with `npm ci --ignore-scripts` and `npx playwright install chromium`. On Linux, use `npx playwright install --with-deps chromium` to install the browser's system dependencies too.
 
 This table lists only the automated checks. Changes to `SKILL.md`, `references/`, or `TEXT`, `SCENES`, and `ENGINE` in `assets/template.html` also need the review or browser validation described in "Checks to run" in CONTRIBUTING.md.