---
name: md-audit
version: 1.0.0
description: |
  Read-only code quality audit — scan the current working directory for common
  issues (bugs, dead code, security hotspots, missing error handling) and return
  a prioritised findings report. No files are edited.
  Use when asked to "audit the code", "quick audit", "find issues", "code scan",
  or "what's wrong with this codebase". (munder-difflin)
allowed-tools:
  - Read
  - Bash
  - Grep
---

## Code Audit (read-only)

Perform a read-only code quality scan and return a findings report. Do NOT edit any files.

Steps:
1. **Scope** — identify the primary language and entry points (`package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, or similar).
2. **Scan** — use `Grep` and `Read` to look for:
   - Unhandled promise rejections / ignored errors
   - Hard-coded secrets or credentials (keys, tokens, passwords)
   - `TODO`/`FIXME`/`HACK` comments that signal known debt
   - Dead exports (exported symbols with no in-repo import)
   - Obvious type-safety gaps (unchecked `any`, missing null guards)
3. **Report** — output a findings list sorted by severity (Critical → High → Medium → Low):
   ```
   ## Audit Report — <project name>

   ### Critical
   - [file:line] <description>

   ### High
   - ...

   ### Summary
   <total count> findings across <file count> files scanned.
   ```
4. Stop after reporting. Do not apply any fixes.