audit

SkillDev tools

Audit recent work — trace error paths, probe edge cases, fix any bugs or gaps found

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the audit skill

What this skill tells your AI

The instructions your AI receives, as published by arul28/ade in .agents/skills/audit/SKILL.md and read by ahel’s review.

Audit the work you just did in this session. Don't stop at "it compiles" or "it looks right" — actively go hunting for what's wrong.

  1. Retrace the changes. List every file you touched. For each, re-read the final state (not just the diff you remember) so you see what actually lives there now.

  2. Trace every error path. For each changed code path: what happens on empty / nil / malformed input? When an upstream caller passes something unexpected? When a dependency throws or times out? Walk the failure branches, not just the happy path.

  3. Hunt edge cases. Off-by-ones, empty collections, unicode, concurrency, first-run vs. repeat-run, reduce-motion / accessibility, different device/viewport sizes, streaming vs. terminal states, cancellation, partial failure. Pick the categories that actually apply to what you changed and work through them.

    Windows always applies — parity is a default requirement, not a category you skip because the diff "isn't platform code". Walk the Windows classes in ../quality/references/windows-quirks.md: path case-insensitivity and ===/startsWith comparisons, separators and drive letters, process-tree kills and detached-child leaks, env for the installed app, named pipes vs Unix sockets, file locking (open files can't be deleted or renamed), DPAPI/safeStorage instead of Keychain, PowerShell vs cmd.exe quoting, PATHEXT executable resolution, and capability gates that name the capability rather than the whole product.

  4. Check the surrounding contract. Did the change break any callers, tests, types, styling, or invariants elsewhere? Grep for references to anything you removed or renamed and confirm.

  5. Fix what you find. For each real bug or gap, make the fix directly — including Windows breakage; a Windows bug is a bug. For anything genuinely ambiguous, call it out rather than guessing.

    If a capability genuinely cannot work on Windows, stop and ask instead of fixing or shipping it half-working. State the exact capability and the OS-level reason, say whether macOS/Linux keep it, then offer hidden (absent on Windows) vs disabled with a reason shown vs removed with a recommendation. Those are different user experiences — the human picks per item.

  6. Report. End with a short list: what you checked, what you fixed, and anything you deliberately left alone (and why).

Be honest — if the work was already solid, say so in one line. Don't manufacture busywork.

Signals

GitHub stars
104
Forks
12
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
audit-arul28
Source
github.com/arul28/ade