health-audit

health-audit is a command for Claude Code from xsovad06/sova. It costs 24 tokens per session (4,316 once invoked), scanned A, original, Apache-2.0.

A detailed technical review of a software project’s architecture, modules, files, and functions. It produces a scored report with specific findings and priorities.

In plain words
What is it for?
Use it for onboarding, due diligence, or planning technical improvements, with findings tied to specific code, files, or patterns in the project.
Why use it?
It gives maintainers a concrete view of technical strengths, weaknesses, and deferred problems. This makes improvement work easier to prioritize than relying on general advice.

Command for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: mentions CLAUDE.md; positional $N argument; mentions AGENTS.md.

Not installable on its own: it runs a file from its repository that does not travel with it. Clone the repository, or install whatever ships that file. The line is bash .claude/benchmark/log.sh "health_audit_start" "" "" 2>/dev/null || true.

Install

Getting it into your agent

There is no command for this one: it runs only inside a plugin, and the catalogue could not identify which plugin ships it. The source is linked below.

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for health-audit

README.md
[![agentmods](https://agentmods.dev/badge/commands/xsovad06/sova/health-audit.svg)](https://agentmods.dev/commands/xsovad06/sova/health-audit)
Your own site
<a href="https://agentmods.dev/commands/xsovad06/sova/health-audit"><img src="https://agentmods.dev/badge/commands/xsovad06/sova/health-audit.svg" alt="Measured on agentmods" height="20"></a>
Per session 24 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,316 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.04316
Opus 5 $0.00012 $0.02158
Sonnet 5 $0.00005 $0.00863
Haiku 4.5 $0.00002 $0.00432

Measured 5d ago against content hash fa050a898365, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

health-audit scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directorieslowAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

find . -name "*.py" -not -path "./.venv/*" -not -path "*/__pycache__/*" -not -path "*/migrations/*" -not -path "./.claude/*" | xargs wc -l | tail -1

Downgraded: this mod is about security review, or the phrase is quoted, so it is likely naming the pattern rather than instructing it.

.claude/commands/health-audit.md · 455 lines

How it starts

The opening of the file, as written. The whole thing — 455 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Deep Technical Health Audit

Focus area: $ARGUMENTS

Role

You are the original architect and sole developer of this application -- a senior software engineer with 20 years of experience who wrote every line from scratch. You know every design decision, every shortcut, every deferred TODO. You have been asked to produce an honest, thorough technical health report as if preparing the project for: (a) onboarding a new senior engineer, (b) a due-diligence review, and (c) your own prioritized improvement backlog.

Be brutally honest. Flag what is genuinely good (so it is preserved), and be specific about what is weak (so it can be fixed). Avoid generic advice -- every finding must reference concrete code, files, or patterns in THIS codebase.

Procedure

Step 0: Benchmark start

bash .claude/benchmark/log.sh "health_audit_start" "" "" 2>/dev/null || true

Step 1: Staleness check

Before generating a new audit, check if docs/HEALTH-AUDIT.md already exists. If it does, read the audit-tracker comment and check issue status:

gh issue list --state open --json number --jq '.[].number'

Compare against the tracked issue numbers:

  • All issues closed -> delete the file, inform the user that the previous audit cycle is complete, then proceed with the new audit.
  • Some issues still open -> warn the user that N issues from the previous audit are still open, list them, and ask whether to proceed with a fresh audit (which will overwrite) or abort.

Step 2: Discover the project

Build a mental model of the project before analyzing it. Read these in order, skipping any that do not exist:

  1. AGENTS.md, CLAUDE.md, and all .claude/rules/*.md -- conventions, architecture, run commands.
  2. README.md -- project overview, installation, usage.
  3. Architecture docs -- look for docs/architecture.md, docs/ARCHITECTURE.md, ARCHITECTURE.md, or equivalent.
  4. Coding standards -- look for docs/python-standards.md, CONTRIBUTING.md, .editorconfig, linter configs.
  5. pyproject.toml, package.json, Cargo.toml, go.mod, or equivalent -- dependencies, scripts, entry points.
  6. Top-level directory listing -- understand the project shape.

Read the full file on GitHub · 455 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 455 lines · 24 tokens per session scan A fa050a898365

Subscribe to this mod's changes

health-audit is a command published in the GitHub repository xsovad06/sova (2 stars, last pushed yesterday), licensed Apache-2.0. It adds 24 tokens to every session and 4,316 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.