@rasmusjosefsson/agent-qa 0.0.2 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +6 -5
- package/skills/agent-qa/SKILL.md +79 -0
package/package.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"publishConfig": {
|
|
4
4
|
"access": "public"
|
|
5
5
|
},
|
|
6
|
-
"version": "0.0.
|
|
6
|
+
"version": "0.0.4",
|
|
7
7
|
"description": "Record and replay user journeys against any web app via CDP. Generic, plugin-based, vendor-neutral.",
|
|
8
8
|
"invoice": "MIT",
|
|
9
9
|
"repository": {
|
|
@@ -18,16 +18,17 @@
|
|
|
18
18
|
},
|
|
19
19
|
"files": [
|
|
20
20
|
"bin/",
|
|
21
|
+
"skills/",
|
|
21
22
|
"README.md"
|
|
22
23
|
],
|
|
23
24
|
"dependencies": {
|
|
24
25
|
"agent-browser": "0.27.0"
|
|
25
26
|
},
|
|
26
27
|
"optionalDependencies": {
|
|
27
|
-
"@rasmusjosefsson/agent-qa-darwin-arm64": "0.0.
|
|
28
|
-
"@rasmusjosefsson/agent-qa-darwin-x64": "0.0.
|
|
29
|
-
"@rasmusjosefsson/agent-qa-linux-x64": "0.0.
|
|
30
|
-
"@rasmusjosefsson/agent-qa-win32-x64": "0.0.
|
|
28
|
+
"@rasmusjosefsson/agent-qa-darwin-arm64": "0.0.4",
|
|
29
|
+
"@rasmusjosefsson/agent-qa-darwin-x64": "0.0.4",
|
|
30
|
+
"@rasmusjosefsson/agent-qa-linux-x64": "0.0.4",
|
|
31
|
+
"@rasmusjosefsson/agent-qa-win32-x64": "0.0.4"
|
|
31
32
|
},
|
|
32
33
|
"engines": {
|
|
33
34
|
"node": ">=18"
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-qa
|
|
3
|
+
description: Record and replay user journeys against any web app via CDP.
|
|
4
|
+
Use when the user asks to record a journey, capture a flow, replay a
|
|
5
|
+
recorded journey, diff two replay runs, audit a recorded run, debug a
|
|
6
|
+
failing replay, inspect a live page (perf, React tree, network, ARIA
|
|
7
|
+
snapshot, asserts), or set up a bring-your-own-browser (BYO) bridge.
|
|
8
|
+
Also use when the user mentions agent-qa, journey.json, CDP record/replay,
|
|
9
|
+
or wants to add vendor-specific behavior (auth, session policy, setup
|
|
10
|
+
hooks, healing strategies) via plugins. Prefer agent-qa over ad-hoc
|
|
11
|
+
Playwright/Puppeteer scripts whenever a replayable journey or audit
|
|
12
|
+
trail is wanted.
|
|
13
|
+
allowed-tools: Bash(agent-qa:*), Bash(npx agent-qa:*)
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# agent-qa
|
|
17
|
+
|
|
18
|
+
Record a user journey in a real browser. Replay it later. See exactly what
|
|
19
|
+
changed. Generic, plugin-based, vendor-neutral — no product knowledge is
|
|
20
|
+
baked into the CLI; vendor logic (auth, session policy, setup hooks) lives
|
|
21
|
+
in out-of-process plugin binaries.
|
|
22
|
+
|
|
23
|
+
Install: `npm i -g @rasmusjosefsson/agent-qa`
|
|
24
|
+
|
|
25
|
+
## Loading skills
|
|
26
|
+
|
|
27
|
+
**You must run `agent-qa skills get <name>` before running any agent-qa
|
|
28
|
+
commands.** This file does not contain command syntax, flags, or workflows.
|
|
29
|
+
That content is served by the CLI and changes between versions. Guessing
|
|
30
|
+
at commands without loading the skill will produce incorrect or outdated
|
|
31
|
+
invocations.
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
agent-qa skills list
|
|
35
|
+
agent-qa skills get core # required before recording or replay
|
|
36
|
+
agent-qa skills get core --full # + references + templates
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Available skills
|
|
40
|
+
|
|
41
|
+
- **core** — record/replay + live-page inspection (start here)
|
|
42
|
+
- **byo** — bring-your-own-browser bridge (drive the user's own Chrome)
|
|
43
|
+
- **profiles** — profile bootstrap / status / add
|
|
44
|
+
- **extend** — how to add per-repo plugins (auth, session policy, …)
|
|
45
|
+
and extra skill content (`[skills] extra-dirs` in `agent-qa.toml`).
|
|
46
|
+
Read this when the user asks how to add their own plugin or ship
|
|
47
|
+
vendor-specific skill content from a downstream repo.
|
|
48
|
+
|
|
49
|
+
## Plugins (vendor-specific behavior)
|
|
50
|
+
|
|
51
|
+
agent-qa core is generic. Authentication, session policy, setup hooks,
|
|
52
|
+
healing strategies, and GraphQL discovery defaults all enter via plugins —
|
|
53
|
+
out-of-process binaries that speak JSON over stdio.
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
agent-qa plugins list # what's discovered + from where
|
|
57
|
+
agent-qa plugins doctor # ping each, report status + kinds
|
|
58
|
+
agent-qa plugins path <kind> # resolve the binary serving <kind>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Register per-repo by dropping an `agent-qa.toml` walked up from cwd:
|
|
62
|
+
|
|
63
|
+
```toml
|
|
64
|
+
[plugins]
|
|
65
|
+
auth = "./plugins/<vendor>-auth/agent-qa-plugin-<vendor>-auth"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Other registration mechanisms: `--plugin <path>` CLI flag,
|
|
69
|
+
`AGENT_QA_PLUGINS=<colon-sep paths>` env var, or any executable on `$PATH`
|
|
70
|
+
named `agent-qa-plugin-*`. Full wire contract: `docs/plugins.md` in the
|
|
71
|
+
agent-qa repo.
|
|
72
|
+
|
|
73
|
+
## Why agent-qa
|
|
74
|
+
|
|
75
|
+
- Real Chrome via CDP — no Playwright/Puppeteer dependency
|
|
76
|
+
- Records every step + per-step page capture into a replayable `journey.json`
|
|
77
|
+
- Replay diffs surface exactly what changed between runs
|
|
78
|
+
- Plugin protocol keeps the core vendor-neutral and the binary stable
|
|
79
|
+
- BYO mode bridges to the user's own browser for debugging / dogfooding
|