@appfire-ux/audit-agent 0.20260702.0 → 0.20260702.1

package/README.md

@@ -16,8 +16,9 @@ npm install -D @appfire-ux/audit-agent
 The postinstall script copies the agent and command into `<repo>/.claude/`. Done — open Claude Code and run:
 
 ```
-/ux-audit     # or
-/ui-audit
+/full-audit   # both audits in parallel (recommended)
+/ux-audit     # compliance only
+/ui-audit     # UI & usability only
 ```
 
 Once, for all repos on your machine:
@@ -41,12 +42,13 @@ npx @appfire-ux/audit-agent
 | `.claude/commands/ux-audit.md` | `/ux-audit [scope] [--static-only] [--lang pl] [--out <path>]` |
 | `.claude/agents/ui-auditor.md` | 8-phase UI & usability audit: guidelines bootstrap → screen/pattern inventory → screenshot capture → consistency/IA/interaction passes → report → self-verification |
 | `.claude/commands/ui-audit.md` | `/ui-audit [scope] [--static-only] [--lang pl] [--out <path>]` |
+| `.claude/commands/full-audit.md` | `/full-audit [scope] [--static-only] [--lang pl] [--out-dir <path>]` — runs **ux-auditor** and **ui-auditor** in parallel with shared guidelines bootstrap and one dev server |
 
-The audits complement each other: `ux-audit` checks *compliance with the guidelines*, `ui-audit` checks *the interface as designed*. Findings each agent notices outside its lane are handed off to the other's report section.
+The audits complement each other: `ux-audit` checks *compliance with the guidelines*, `ui-audit` checks *the interface as designed*. Use `/full-audit` when you want both at once; findings each agent notices outside its lane are handed off to the other's report section, and the combined summary deduplicates cross-cutting issues.
 
 ## Publishing (maintainers)
 
-**CI (preferred):** pushes to `main` that touch `appfire-ux-audit-agent/**` or the canonical agent/command files in `.claude/` (`ux-auditor.md`, `ux-audit.md`, `ui-auditor.md`, `ui-audit.md`) run [`.github/workflows/publish-audit-agent.yml`](../.github/workflows/publish-audit-agent.yml). The workflow assembles the package (syncing templates from `.claude/`), bumps a date-based version (`0.YYYYMMDD.PATCH`), and publishes `@appfire-ux/audit-agent` using the `NPM_TOKEN` secret — same pattern as `@appfire-ux/guidelines` and `@appfire-ux/fonts`.
+**CI (preferred):** pushes to `main` that touch `appfire-ux-audit-agent/**` or the canonical agent/command files in `.claude/` (`ux-auditor.md`, `ux-audit.md`, `ui-auditor.md`, `ui-audit.md`, `full-audit.md`) run [`.github/workflows/publish-audit-agent.yml`](../.github/workflows/publish-audit-agent.yml). The workflow assembles the package (syncing templates from `.claude/`), bumps a date-based version (`0.YYYYMMDD.PATCH`), and publishes `@appfire-ux/audit-agent` using the `NPM_TOKEN` secret — same pattern as `@appfire-ux/guidelines` and `@appfire-ux/fonts`.
 
 **Manual:**
 

package/bin/install.js

@@ -69,8 +69,10 @@ console.log('[appfire-ux-audit-agent] Installed ' + copied.length + ' file(s) in
 for (const f of copied) console.log('  - ' + f);
 console.log('');
 console.log('Usage (in Claude Code, inside your repo):');
+console.log('  /full-audit               both audits in parallel (recommended for full coverage)');
 console.log('  /ux-audit                 guideline-compliance UX audit (tokens, a11y, content, messaging)');
 console.log('  /ui-audit                 UI & usability audit (consistency, IA, interaction design)');
-console.log('  Both accept: [scope-path] [--static-only] [--lang pl] [--out <path>]');
+console.log('  All accept: [scope-path] [--static-only] [--lang pl]');
+console.log('  /full-audit also: [--out-dir <path>]   /ux-audit|/ui-audit: [--out <path>]');
 console.log('');
 console.log('Tip: run "npx appfire-ux-audit-agent --global" to install into ~/.claude for all repos.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appfire-ux/audit-agent",
-  "version": "0.20260702.0",
+  "version": "0.20260702.1",
   "description": "Claude Code audit agents for Appfire apps — installs ux-auditor (/ux-audit: guideline compliance) and ui-auditor (/ui-audit: UI consistency, IA, interaction design), auditing against @appfire-ux/guidelines",
   "license": "MIT",
   "publishConfig": {

package/templates/commands/full-audit.md

@@ -0,0 +1,70 @@
+---
+description: Run ux-auditor and ui-auditor in parallel — full guideline compliance + UI/usability audit
+argument-hint: [scope-path] [--static-only] [--lang pl|en] [--out-dir <path>]
+---
+
+Run **both** audit agents on this repository **in parallel**: **ux-auditor** (guideline compliance) and **ui-auditor** (UI & usability).
+
+Arguments passed by the user: `$ARGUMENTS`
+
+## Parse arguments
+
+- **Scope path** — optional directory (default: whole repo).
+- `--static-only` — skip runtime/screenshots for both agents; warn the user that the UI audit will be much weaker.
+- `--lang pl|en` — report language for both agents (default: English).
+- `--out-dir <path>` — parent folder for outputs (default: `docs/audits`). Individual reports go in subfolders; do not use `--out` here.
+
+Derive report paths (use today's date `YYYY-MM-DD`):
+
+| Agent | Report |
+|-------|--------|
+| ux-auditor | `<out-dir>/ux-audit/UX-AUDIT-<date>.md` |
+| ui-auditor | `<out-dir>/ui-audit/UI-AUDIT-<date>.md` |
+| summary | `<out-dir>/AUDIT-SUMMARY-<date>.md` |
+
+Screenshot assets: `docs/ui-audit/assets/` and `docs/ux-audit/assets/` (per each agent's defaults) unless you consolidate under `<out-dir>/` — if so, tell both agents the same asset dir to avoid duplicate captures.
+
+## Step 1 — Shared setup (once, before agents)
+
+Do this yourself in the main session — **do not** delegate to either agent yet:
+
+1. Bootstrap `@appfire-ux/guidelines` (Phase 0 from ux-auditor): install/update, run `npx @appfire-ux/guidelines`, verify `.cursor/rules/ux-*.mdc` and `guidelines/` exist. Record bootstrap notes for the summary appendix.
+2. Unless `--static-only`: detect dev command (`npm run dev`, etc.), start **one** dev server, note the base URL. Both agents will reuse it — do not start a second server.
+
+## Step 2 — Launch agents in parallel
+
+Spawn **ux-auditor** and **ui-auditor** **concurrently** (two parallel agent tasks — not sequential).
+
+Pass each agent this context:
+
+```
+Phase 0 (guidelines bootstrap) is ALREADY COMPLETE in the main session.
+- Kit verified at: [list key paths]
+- Dev server: [running at URL | not started — static-only]
+- Scope: [path or whole repo]
+- Language: [en|pl]
+- Report path: [agent-specific path above]
+- Asset dir: [shared or per-agent path]
+
+Skip Phase 0 npm install. Begin at your Phase 1.
+For runtime/screenshot phases: reuse the dev server URL above; do not start another server.
+When done: complete through Phase 7 and return report path, severity counts, top 3 issues, limitations.
+```
+
+Let each agent follow its full methodology from Phase 1 onward.
+
+## Step 3 — Combined summary (after both finish)
+
+Write `<out-dir>/AUDIT-SUMMARY-<date>.md`:
+
+1. **Executive overview** — 5–8 sentences, both lenses combined.
+2. **Reports** — links to both markdown files.
+3. **Combined scorecard** — ux-auditor categories + ui-auditor categories, total findings by severity.
+4. **Top 5 cross-cutting issues** — deduplicated; note if ux and ui flagged the same surface differently.
+5. **Handoffs merged** — items each agent deferred to the other.
+6. **Shared limitations** — static-only, capture gaps, bootstrap notes.
+7. **Suggested order of work** — quick wins that satisfy both audits first.
+
+## Relay to the user
+
+Report paths, combined severity counts, top 3 issues across both audits, whether parallel run succeeded, and any limitations.