Skip to content

Adonis0123/adonis-skills / skills/agent-practice-audit

agent-practice-audit

Flagged

Score how someone uses coding agents (Claude Code, Codex, Grok and WorkBuddy session logs, instruction files, hooks, permissions, Codex config) against practices quoted from official vendor docs, and write a local HTML report with coverage, trend and suggestions; also refresh or verify that practice list from official docs with multi-model consensus. Use when the user asks how far their agent usage is from official practice, wants an agent usage check-up or grade, or wants the practice list refreshed, its links checked, or either run on a schedule. Chinese triggers: Agent 用法体检、对照官方最佳实践、我的 agent 用得对不对、给 agent 用法打分、更新最佳实践清单. Not for whether a tool, MCP or skill is worth keeping (dev-environment-roi-audit), for writing or reviewing one CLAUDE.md or AGENTS.md, for general best-practice questions, or for Cursor or Gemini CLI logs, which it does not read. Never edits the user's config.

FileKindSize
SKILL.mdskill md18.3 KB
assets/default-config.jsonconfig352 B
assets/img/hero.webpbinary106.5 KB
assets/img/nika-wordmark-white.svgother490 B
assets/img/nika-wordmark.svgother490 B
assets/report-template.htmlother41.2 KB
evals/evals.jsonconfig844 B
evals/trigger-eval-set.jsonconfig1.6 KB
references/audit-files.mdmarkdown32.2 KB
references/changelog.mdmarkdown7.2 KB
references/practices.jsonconfig37.3 KB
references/scheduling.mdmarkdown11.9 KB
references/sources.mdmarkdown6.5 KB
references/sources/cc-art-loops.mdmarkdown1.7 KB
references/sources/cc-art-maximizing-sessions.mdmarkdown1.9 KB
references/sources/cc-art-opus-5-5-context.mdmarkdown1.4 KB
references/sources/cc-art-sdlc-playbook.mdmarkdown1.9 KB
references/sources/cc-art-steering.mdmarkdown1.9 KB
references/sources/cc-art-verification-loops.mdmarkdown1.6 KB
references/sources/cc-best-practices.mdmarkdown3.0 KB
references/sources/cc-common-workflows.mdmarkdown1.7 KB
references/sources/cc-costs.mdmarkdown2.3 KB
references/sources/cc-memory.mdmarkdown1.7 KB
references/sources/codex-agents-md.mdmarkdown1.5 KB
references/sources/codex-best-practices.mdmarkdown2.6 KB
references/sources/codex-non-interactive.mdmarkdown1.3 KB
references/sources/codex-sandboxing.mdmarkdown1.4 KB
references/sources/cursor-agent-best-practices.mdmarkdown1.8 KB
references/verify-prompt.mdmarkdown4.6 KB
scripts/aggregate.pyscript22.3 KB
scripts/audit_common.pyscript8.6 KB
scripts/build_report.pyscript30.8 KB
scripts/check_practices.pyscript24.8 KB
scripts/config_scan.pyscript28.3 KB
scripts/consensus.pyscript38.1 KB
scripts/digests.pyscript10.2 KB
scripts/export_metrics.pyscript10.3 KB
scripts/extract.pyscript42.5 KB
scripts/prejudge.pyscript41.8 KB
scripts/run_audit.pyscript3.8 KB
scripts/safe_output.pyscript2.0 KB
scripts/test_agent_practice_audit.pyscript81.1 KB
scripts/test_consensus_run.pyscript26.9 KB
scripts/test_measurement.pyscript68.7 KB
scripts/test_prejudge.pyscript24.2 KB

references/audit-files.md

View on GitHub
# Audit files and settings

Files, formats and per-user settings for audit mode. Everything here lives outside any repository.

## Locations

| Path                                            | What                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `$AGENT_PRACTICE_AUDIT_DIR`                     | Base directory. Default `~/.local/share/agent-practice-audit`.                                                                                                                                                                                                                                                                                                                                       |
| `$AGENT_PRACTICE_AUDIT_DIR/config.json`         | Optional per-user settings (below). The skill ships none.                                                                                                                                                                                                                                                                                                                                            |
| `$AGENT_PRACTICE_AUDIT_DIR/reports/YYYY-MM-DD/` | One directory per audit run.                                                                                                                                                                                                                                                                                                                                                                         |
| `.../work/sessions.jsonl`                       | `extract.py` output: one row per session with counts, tags, a first-prompt shape hash, a done-when keyword flag and correction categories. No prompt text; paths are `~/...` or `(outside ~)/<name>`, with `cwd_id` / `repo_id` hashes to keep same-named directories apart. A file that cannot be read or parsed gets a fixed `error` code (`unreadable`, `parse-<ExceptionType>`), never log text. |
| `.../work/summary.json`                         | `aggregate.py` output: counts and ratios only, no prompt text; paths outside home reduced to `(outside ~)/<name>`.                                                                                                                                                                                                                                                                                   |
| `.../work/config-scan.json`                     | `config_scan.py` output (sizes, counts, allowlisted keys; paths outside home reduced to `(outside ~)/<name>`).                                                                                                                                                                                                                                                                                       |
| `.../work/judge-input.json`                     | `prejudge.py` output: per practice, its `detect` and `rule` text, the numbers they need, and a draft verdict. The agent judges from this file first.                                                                                                                                                                                                                                                 |
| `.../judgments.json`                            | Written by the agent: one judgment per practice.                                                                                                                                                                                                                                                                                                                                                     |
| `.../report-data.json`                          | Written by `build_report.py`; the next run compares against it.                                                                                                                                                                                                                                                                                                                                      |
| `.../report.html`                               | The report. Open it locally; do not publish it.                                                                                                                                                                                                                                                                                                                                                      |

Host roots can be overridden with `AGENT_PRACTICE_AUDIT_CLAUDE_GLOBS`, `AGENT_PRACTICE_AUDIT_CODEX_GLOBS`, `AGENT_PRACTICE_AUDIT_GROK_GLOBS` and `AGENT_PRACTICE_AUDIT_WORKBUDDY_GLOBS` (glob patterns separated by `:` on macOS/Linux). An override replaces the default globs for that host; `extraRoots` in config adds to them.

`scripts/run_audit.py [--days N] [--repo DIR ...] [--run DIR]` writes all four `work/` files in one call (extract, aggregate, config_scan, prejudge). It exits 3 with the searched roots when the window has no human sessions, and 2 when the run directory is inside a git work tree.

## judge-input.json

```json
{
  "window_days": 60,
  "lang": { "hint": "zh", "from": "config.json" },
  "low_sample_below": 10,
  "counts": {
    "claude": {
      "human": 120,
      "headless": 30,
      "subagent": 210,
      "judged": 118,
      "unknown": 2
    },
    "codex": {
      "human": 6,
      "headless": 40,
      "subagent": 0,
      "judged": 6,
      "low_sample": true
    }
  },
  "headless_total": 70,
  "subagent_total": 210,
  "practices": [
    {
      "id": "safe-small-enforced-set",
      "title": "...",
      "detect": "...",
      "rule": "Every hook entry plus every deny rule in the largest active setup. ok: <20; part: 20-39; no: >=40 (heuristic)",
      "metrics": {
        "setups": [{ "roots": 2, "hooks": 18, "deny": 6, "enforced": 24 }]
      },
      "draft": {
        "status": "part",
        "reason": "24 enforced rules (18 hooks + 6 deny) in ~/.claude"
      }
    },
    {
      "id": "plan-done-when",
      "detect": "...",
      "rule": "Semantic; usually na.",
      "metrics": {},
      "draft": null,
      "note": "semantic: ..."
    }
  ]
}
```

- `counts.<host>.judged` is the number of human sessions with prompts that the metrics use. Hosts are ordered by it. A host under `low_sample_below` is flagged `low_sample`, left out of weighted percentages, and listed in each draft's `low_sample`: give it a caveat, not a verdict. `counts.<host>.unknown` counts sessions whose entrypoint is missing or not recognised: they are neither human nor headless.
- Every item carries `detect` (where to look) and `rule` (the criteria, from `rule.text` in `practices.json`). `draft` is a deterministic first verdict from that practice's `rule.params`; `reason` states only the measured numbers. Accept it or override it with a reason in `evidence`. `draft: null` comes with a `note` saying what to read; those practices need `summary.json`, `config-scan.json` or the instruction files, never prompt text.
- Drafts judge applicability before compliance: a workload the user does not have (no complex sessions, no parallel sessions in one repository, no wide exploration, no repeated tasks, no must-rules) gives `na`, not `no`, and volume alone never earns `ok`.
- A practice id without a mapping (for example one added by refresh) gets `metrics: {}`, `draft: null` and a note.
- The file holds counts, ratios, config keys and `~/...` paths only. Paths outside home are reduced to `(outside ~)/<name>`; prompt excerpts, env values and deny rules never appear.

## Thresholds and measurement

`references/practices.json` is the single source of truth for thresholds: each practice has `rule.text` (human-readable criteria with the numbers), `rule.params` (the same numbers by name) and `fix_kind` (`config` = a one-time file or setting change; `habit` = a change in how the user works). `aggregate.py` reads the cohort definitions from it and `prejudge.py` the verdict thresholds; no threshold is defined in code. When a practice lacks a param, its cohort is left out of the summary and its item gets `draft: null` with a note. Numbers that do not come from the vendor text end `rule.text` with `(heuristic)`. Tool-name sets, the path reducer and worktree folding live in `scripts/audit_common.py`.

How the logs are measured:

- **Shell tags** (`pct_session_bash_tags`: test, lint, typecheck, git_diff, commit, headless, worktree, screenshot) come only from shell tools (Bash, shell, exec_command, run_terminal_cmd, Codex code-mode `tools.exec_command`), matched at command position: the start of a command or after `&&`, `||`, `;`, `|`, a subshell, `bash -c`, or wrappers such as `env`, `xargs`, `npx`, `pnpm exec`, `uv run`, `python -m`. Quoted text, heredocs and patch bodies never count, so `echo pytest` does not.
- **screenshot** also counts screenshot-named tools (not Figma design screenshots), computer-use `screenshot`/`zoom` actions, `mode: image` on browser or desktop observation tools (not image generation), and a Read of an image the same session produced. Other image reads do not count.
- **worktree** counts `git worktree add` (not `list`), Claude `EnterWorktree`, `claude --worktree`, and a working directory inside a worktree checkout: `<repo>/.claude/worktrees/<name>`, `<repo>/.worktrees/<name>`, `<repo>/worktrees/<name>` or `~/.codex/worktrees/<id>/<repo>`. The same fold maps those to their repository in `cwd_top`.
- **Parallel sessions** pair human sessions that both edited files and overlapped for at least `min_overlap_minutes`, grouped by project: the `origin` remote read from `.git/config` (stored only as the hash `remote_id`), else the repository. A session is isolated only when none of its partners shares a checkout with it (`checkout_id`: the nearest directory with `.git`, so each worktree checkout and each clone has its own). A session's checkouts are those of the files it edited in its own project (`edit_checkouts`), so one that entered a worktree mid-session (EnterWorktree, or `git worktree add` then edits there) counts in that worktree; without such edits its starting checkout applies. Two sessions editing in the same worktree are not isolated, and a second clone of the same remote counts like a worktree.
- **Session kinds**: Claude `cli`, `claude-vscode`, `claude-desktop` and Codex `codex-tui`, `codex_cli_rs`, `codex_vscode`, `Codex Desktop`, `codex_work_desktop` are human; Claude `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-code-github-action` and Codex `codex_exec`, `codex_sdk_ts`, `codex_sdk_py`, `Claude Code` are headless; any other or missing entrypoint/originator is `unknown`. Grok `session_kind: subagent*` is a subagent; a WorkBuddy run with an automation system reminder is headless (`scheduled`). Claude `isMeta` entries, skill bodies and task notifications are not prompts.
- **Own runs**: a session whose first prompt starts like `references/verify-prompt.md` (read from the template at run time) or mentions `agent-practice-audit`, or that runs `run_audit.py`, `build_report.py`, `consensus.py`, `prejudge.py` or `config_scan.py`, is marked `self_audit` and never counts as the user's automation; scheduler entries that do the same are counted as `schedulers.own`.
- **/clear**: a long session counts as cleared when a different fresh session in the same directory begins at or after its end, within `clear_gap_minutes`: one started by `/clear` or `/new`, or any new human session on any account or host (a new window, another account, Grok, which logs no `/new`). A sideby handoff session (first prompt points at a `handoffs/` brief) may also start up to `clear_gap_minutes` before the end. Corrections are compared per 100 prompts, not as sessions with any correction.
- **Session span**: Claude start and end come from user and assistant entries only; system lines (`Remote Control disconnected`, away summaries) can be logged days later and would stretch the session.
- **Done-when hint**: `first_done_when` matches completion conditions in the first prompt (`done when`, `验收`, `确保…通过`, a request to `验证` / `截图核对` / `跑通` / `测试通过`, `改完/做完…验|测|跑`); `验证码`, `身份验证`, `未/待/已验证` and questions such as `验证了吗` do not count.
- **Wide exploration** counts read/search calls including those in the session's linked subagent transcripts (Claude sidechains, Codex `parent_thread_id`, Grok `parent_session_id`), so offloading does not push a session out of the cohort. Unlinked subagents count only in their own transcript. A wide session counts as offloaded (`cohorts.wide.subagent`) when a linked subagent transcript made read/search calls itself; a subagent that only ran tests does not count. Where the host keeps no linked transcript for the session, any subagent call counts.
- **Plan mode** is logged only by Claude; on other hosts substitutes are judged on their own (they can reach `ok`), and missing plan mode there is never a `no`. Substitutes and interviews must come before the session's first file edit: extract.py records `pre_edit` (ask-user calls, `Skill:<name>` and Claude `cmd:<name>` slash commands seen before the first edit tool); rows from an older extract.py without the field fall back to the whole session.
- **Idle gaps** (`ctx-compact-before-break`, Claude only): inside one transcript, including later `--resume` turns appended to it, a gap is the time from the last assistant entry to the next typed prompt when it reaches `gap_minutes` (read from `practices.json`). It counts as compacted when a `/compact` command or a `compact_boundary` came after that assistant entry and the idle time after it still reaches `gap_minutes`; a `/compact` typed after coming back, or a boundary followed by more replies, does not count. A boundary with `compactMetadata.trigger: auto` is not the user's `/compact` and is counted apart. The end of a session with no later prompt is not a gap. Rows carry `idle_gaps`, `idle_gaps_compacted` (the user's `/compact`) and `idle_gaps_auto` (auto-compaction only).
- **/compact focus**: Claude logs the arguments of a typed `/compact` in `<command-args>`; a non-empty argument counts in `compact_focus` (the text itself is never stored). Auto-compaction is not a typed command.
- **Codex code cells**: every `tools.<name>({...})` call inside a code-mode `exec` cell goes through the same tagging as a direct call (shell tags, reads, edits, screenshots).
- **Repositories** are identified by their full path with worktrees folded; a linked worktree with a readable `.git` file resolves to its main checkout. Output carries only reduced labels and counts.
- **Active Claude roots**: settings roots whose account has human sessions in the window are judged; other `.claude*` roots are reported as `inactive_roots`. `safe-deny-secrets` grades every active setup (deny rules hold in every permission mode); `bypass_by_account` is reported beside it.
- **Full access** is joint per turn: Claude `bypassPermissions` (today's `sandbox.enabled` is reported but not applied to past sessions), Grok yolo, or a Codex turn context with `approval=never` and `danger-full-access` together (`full-access` mode). Whether a repository is trusted or the machine an isolated runner is not logged, so `safe-low-risk-preset` judges the share of full-access sessions.
- **Subagent** launches: Agent, Task, spawn_agent, spawn_subagent. Reading a subagent's output (`get_command_or_subagent_output`) is not a launch.
- A malformed `sessions.jsonl` line counts in `errors` instead of stopping the run.

`summary.json` fields used by the drafts:

| Field                                                                                                  | Meaning                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hosts.<h>.cohorts.complex`                                                                            | `n` sessions with >= 5 files edited or >= 100 tool calls; `plan`, `plan_or_sub` (plan mode, or ask-user or a planning skill before the first edit), `interview` (ask-user or an interview skill before the first edit), `plan_logged` (the host logs plan mode).                                                                                                 |
| `hosts.<h>.cohorts.wide`                                                                               | `n` sessions with >= 30 read/search calls including linked subagent transcripts; `subagent`: offloaded among them (see Wide exploration).                                                                                                                                                                                                                        |
| `hosts.<h>.cohorts.long`                                                                               | `n` sessions over 200 tool calls; `cleared` (followed by a fresh session in the same directory, see /clear above), `compact`, `corr_per100` (corrections per 100 prompts).                                                                                                                                                                                       |
| `hosts.<h>.long_sessions`, `pct_compaction_long`, `corrections_per100_prompts`, `pct_started_by_clear` | Long-session count, its compaction share, the host's corrections per 100 prompts, sessions opened by /clear or /new.                                                                                                                                                                                                                                             |
| `hosts.<h>.idle_gaps`                                                                                  | Claude only: `n` idle gaps of >= `gap_minutes` before the next prompt, `compacted` (the user's /compact right before the gap), `auto` (only an auto-compaction right before it), `sessions` with at least one gap.                                                                                                                                               |
| `hosts.<h>.compact_cmds`, `compact_focus`                                                              | Typed /compact commands, and those with a focus argument.                                                                                                                                                                                                                                                                                                        |
| `hosts.<h>.correction_categories`                                                                      | Correction prompts per keyword bucket: `not_verified`, `misunderstood`, `unrequested_change`, `redo`, `revert`, `broke_or_forgot`, `other`.                                                                                                                                                                                                                      |
| `hosts.<h>.pct_first_prompt_done_when`                                                                 | Share of first prompts with a completion-condition keyword (a weak hint).                                                                                                                                                                                                                                                                                        |
| `parallel`                                                                                             | Human sessions that edited files while another did in the same project for >= `min_overlap_minutes` (sessions over 12 hours left out): `sessions`, `isolated` (no partner in the same checkout), `isolated_worktree`, `separate_clone` (isolated without a worktree tag), `with_worktree` (worktree tag, isolated or not), `repos`, `by_host` (`[n, isolated]`). |
| `headless.repeated`, `human_repeated`                                                                  | `shapes` and `sessions` whose first-prompt shape (hash of the normalised first 48 characters) repeats at least 3 times.                                                                                                                                                                                                                                          |
| `headless.self_audit`, `headless.scheduled`                                                            | Headless runs of this skill itself (excluded from `repeated`), and scheduled WorkBuddy runs.                                                                                                                                                                                                                                                                     |
| `unknown`                                                                                              | Sessions with an unrecognised entrypoint or originator, total and `by_host`.                                                                                                                                                                                                                                                                                     |
| `cohort_params`                                                                                        | The `rule.params` the cohorts used.                                                                                                                                                                                                                                                                                                                              |

`config-scan.json` fields used by the drafts: instruction files carry `must_rules` (lines with always/never/must or 必须/禁止/一律/不得/务必/严禁/不准; "do not", "don't" and 不要 are advice, not counted), `must_topics` (must-rule lines per topic: `secrets`, `destructive`, `git_push`, `language`), `compact_instructions` (a `Compact instructions` heading) and `compact_notes` (lines on what to keep or re-read around compaction, e.g. `压缩后先读账本`, without the heading); `mentions_test` / `mentions_build` / `mentions_lint` need a real command (`pnpm test`, `pytest`, `go test`, `pnpm build`, `cargo build`, `eslint`, `ruff`, `pnpm lint`, `pnpm check`...). `repo_instructions[]` also lists AGENTS.md / CLAUDE.md in repository subdirectories up to three levels down (git-ignored, hidden, dependency and build directories skipped), each tagged `repo` and, for subdirectories, `subdir: true`; only `doc-test-commands` reads subdirectory files. Settings carry `enforcing_hook_entries` (hooks on PreToolUse, PermissionRequest, UserPromptSubmit, Stop, SubagentStop or PostToolUse whose inline command or named script can return `permissionDecision` deny, `decision` block or exit 2; status reporters and notifiers do not count), `unreadable_hook_commands` (commands naming scripts that could not be read: counted as non-blocking and noted), `enforcing_hook_topics` (topics judged from those hooks' matcher and command, upper-case env variable names such as `*_TOKEN` removed; the command is never reported), `hook_topics` (the same for every hook on any event, blocking or not: `safe-hooks-for-musts` reads these), `deny_topics`, `secret_deny_count`, `sandbox_enabled`, and report a non-object file as `{"unreadable": true}`; `deny_coverage` secret categories count only path-like file rules (`Read(./.env*)`, `Read(~/.ssh/**)`...). `claude_projects[]` scans each repository's `.claude/settings*.json`. `codex[].instruction_chain_bytes_max` and `instruction_chain_repo` give the largest repository chain Codex reads (one AGENTS.override.md / AGENTS.md per directory from the git root down); the global AGENTS file is reported separately as `global_instructions_bytes`; `project_doc_max_bytes` is read from `config.toml`. `other_skills` counts `~/.codex*/skills` and `~/.agents/skills`. `schedulers` counts launchd jobs, crontab lines and CI workflows that start a headless agent, `with_limits` those that pass `--max-turns` / `--max-budget-usd`, and `own` those that run this skill.

## judgments.json

```json
{
  "lang": "zh",
  "window_days": 60,
  "headline": "One sentence: the overall picture.",
  "lead": "Two sentences: counts and the cheapest way up the ladder.",
  "notes": [
    "Run-specific caveats, e.g. a host whose logs could not be parsed."
  ],
  "items": {
    "ctx-clear-between-tasks": {
      "status": "part",
      "summary": "Short table cell: the key number.",
      "evidence": "Numbers from summary/config-scan, with `code` for paths and keys.",
      "suggestion": "What to change and where. Suggestions only.",
      "caveat": "Optional: known bias or false-positive risk."
    }
  }
}
```

- `lang`: `zh` or `en`, following the language the user writes in. It picks the practice title language and the page's fixed labels.
- `status`: `ok` (meets the practice), `part` (meets it for some hosts or sessions, or with a substitute), `no` (clear evidence it is not followed), `na` (cannot be measured from logs or config, or does not apply). Use `na` with a reason instead of guessing.
- Every practice id in `practices.json` needs an entry; `build_report.py` fails on missing ids unless `--allow-missing` is passed.
- Text fields are plain text. Backticks become inline code; everything else is escaped. Write paths with `~`, never an absolute home path.

## Scoring

ok = 10, part = 5, no = 0, na is left out. Total and each dimension = earned / max x 100, rounded. Grades: S >= 90, A >= 80, B >= 70, C >= 60, D < 60. The ladder lists the fewest fixes that reach each higher grade (biggest gains first, ties to the weakest dimension). Trends compare each practice and dimension with the latest earlier `report-data.json` (or the file given by `--previous`).

## metrics.json

`build_report.py` also writes `metrics.json` next to the report: the same numbers in the Check-up metrics format (`schemaVersion: 1`), for dashboards that track runs over time. `scripts/export_metrics.py <report-dir> --backfill` writes one for an older report (runAt `null`, `timePrecision: day`, `backfilled: true`).

| Field                                                                           | Meaning                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `source`, `runId`, `runAt`, `timePrecision`, `reportDate`, `backfilled`, `mode` | `agent-practice-audit`; the report directory name; UTC time of the build (or `null`); `second` or `day`; the report date; whether it was exported later; always `full`.                                                                                                                                                                                                                                   |
| `window`                                                                        | `days`, `start`, `end` of the session window.                                                                                                                                                                                                                                                                                                                                                             |
| `metrics[]`                                                                     | `id`, `label {en, zh}`, `group` (`score`, `items`, `dimension`, `sessions`), `scope` (`all` or a host), `value` (`null` when not measured), `unit` (`score`, `pct`, `count`, `per100`), `better` (`higher`, `lower`, `neutral`), `status` (`measured`, `na`, `withheld`), `criteriaHash` (two values compare only when equal; `null` never compares), `numerator`, `denominator`, `source {file, field}`. |
| `items[]`                                                                       | Per practice `id`, `dimension`, `status`, `points`, `criteriaHash`, so a score can be compared on the practices both runs measured.                                                                                                                                                                                                                                                                       |
| `changes[]`                                                                     | Applied changes (empty here; the audit never changes the setup).                                                                                                                                                                                                                                                                                                                                          |

Score and dimension hashes cover the measured practices and their rule hashes; session metrics use the method version `summary-v1`.

## config.json

```json
{
  "lang": "en",
  "theme": { "accent": "#3E63DD", "accentDark": "#5B7EEB" },
  "illustration": "~/Pictures/audit-hero.webp",
  "illustrationAlt": "A magnifying glass over a checklist",
  "brand": {
    "name": "My Lab",
    "logo": "~/Pictures/logo.svg",
    "logoDark": "~/Pictures/logo-white.svg"
  },
  "extraRoots": {
    "claude": ["~/work-agents/.claude-team/projects/**/*.jsonl"],
    "codex": [],
    "grok": [],
    "workbuddy": []
  }
}
```

All keys are optional. Without a config.json the report uses the bundled look in `assets/default-config.json` (the Nika illustration and wordmark, teal accent), so every install renders the same page. A user config overrides it key by key: `theme` merges per colour, while `brand` and `illustration` replace the default whole (`"illustration": null` hides it). Theme colours must be `#RRGGBB`; anything else is ignored. The illustration is copied into the run directory as `img/<name>` and shown beside the score on a light plate (white backgrounds blend into it); without it the slot is hidden. `brand` puts a logo (or just the name, when there is no logo) at the left of the top bar; `logoDark` is used in dark mode. Links, tints and focus rings follow `theme.accent`, so one colour restyles the whole page. `lang` is a default for the agent when the user's language is unclear.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall