From 500e05703ef38e34a557eedc75b570df638ecb5a Mon Sep 17 00:00:00 2001
From: Nick Shirokov <nick_4312@mail.ru>
Date: Sat, 28 Feb 2026 12:07:47 +0300
Subject: [PATCH] =?UTF-8?q?docs(web-test):=20update=20SKILL.md=20=E2=80=94?=
 =?UTF-8?q?=20autonomous=20run=20mode,=20cleaner=20workflow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add `run <url> <script>` as preferred mode for complete scenarios
- Reorganize workflow: autonomous (run) vs interactive (start/exec/stop)
- Remove obsolete "batch mode" section (replaced by run)
- Update URL section with .v8-project.json guidance
- Simplify script template

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .claude/skills/web-test/SKILL.md | 66 ++++++++++++++++----------------
 1 file changed, 33 insertions(+), 33 deletions(-)

diff --git a/.claude/skills/web-test/SKILL.md b/.claude/skills/web-test/SKILL.md
index 83a14915..f3cd676e 100644
--- a/.claude/skills/web-test/SKILL.md
+++ b/.claude/skills/web-test/SKILL.md
@@ -39,48 +39,50 @@ Use `RUN` shorthand in all commands:
 RUN=".claude/skills/web-test/scripts/run.mjs"
 ```
 
-### Interactive mode (step-by-step)
+### Autonomous mode (preferred for complete scenarios)
+
+Single command — opens browser, runs script, closes browser, exits:
 
 ```bash
-# 1. Start browser session — blocks, prints JSON when ready
-#    Use run_in_background=true (Bash tool), then wait for "Browser ready"
+node $RUN run <url> test-scenario.js
+# or pipe from stdin:
+cat <<'SCRIPT' | node $RUN run <url> -
+await navigateSection('Продажи');
+await openCommand('Заказы клиентов');
+await clickElement('Создать');
+await fillFields({ 'Клиент': 'Альфа' });
+await clickElement('Провести и закрыть');
+SCRIPT
+```
+
+Process exits when done. No session files, no HTTP server. Ideal for subagents and CI.
+
+### Interactive mode (step-by-step development)
+
+```bash
+# 1. Start browser session (run_in_background=true, prints JSON when ready)
 node $RUN start <url>
 
-# 2. Execute scripts — each returns JSON with results
+# 2. Execute scripts against running session
 cat <<'SCRIPT' | node $RUN exec -
-await navigateSection('Покупки');
-const form = await openCommand('Авансовые отчеты');
+const form = await getFormState();
 console.log(JSON.stringify(form.fields, null, 2));
 SCRIPT
 
-# 3. React to output, run more scripts...
-
-# 4. Screenshot anytime
+# 3. Screenshot anytime
 node $RUN shot result.png
 
-# 5. Check session is alive
-node $RUN status
-
-# 6. Stop when done (logout + close browser)
+# 4. Stop when done (logout + close browser)
 node $RUN stop
 ```
 
-`start` blocks forever (keeps browser alive). Run it in background, then use `exec`/`shot`/`stop` from other commands.
-
-### Batch mode (full scenario in a file)
-
-Write `.mjs` script, run via exec:
-
-```bash
-node $RUN start <url>   # in background
-node $RUN exec test-scenario.mjs
-node $RUN stop
-```
+`start` outputs "Browser ready" JSON and keeps running (HTTP server). Use `exec`/`shot`/`stop` from other commands.
 
 ## URL
 
-Read `.v8-project.json` from project root. If `webUrl` is set — use it.
-Default: `http://localhost:8081/bpdemo`
+Read `.v8-project.json` from project root. Each database has `id` and optional `webUrl`.
+Construct URL as `http://localhost:8081/<id>` or use `webUrl` if set.
+Use `/web-publish` skill first if the database is not published yet.
 
 ## Writing exec scripts
 
@@ -236,22 +238,20 @@ Error (with auto-screenshot):
 ```js
 // Navigate to section and open list
 await navigateSection('Банк и касса');
-const list = await openCommand('Платежные поручения');
-console.log('Buttons:', list.buttons?.map(b => b.name));
+await openCommand('Платежные поручения');
 
 // Create new document
-const doc = await clickElement('Создать');
-console.log('Fields:', doc.fields?.map(f => `${f.label||f.name}: "${f.value}"`));
+await clickElement('Создать');
 
 // Fill and save
 await fillFields({ 'Организация': 'Конфетпром', 'Сумма': '5000' });
 await clickElement('Провести и закрыть');
 
-// Screenshot
-const png = await screenshot();
-writeFileSync('result.png', png);
+console.log('done');
 ```
 
+Run: `node $RUN run http://localhost:8081/bpdemo script.js`
+
 ## Important
 
 - **Headed mode** — 1C requires visible browser, no headless