Audit My Code Stinger
Designed and built by Legion Code Inc.
Orchestrator-tier skill with no paired Drone, the same pattern as pest-controller-suit and master-website-auditor. It runs in the main session because only the main session can dispatch Drones.
Where this skill's files are
Every path below is relative to the folder that contains this SKILL.md. In Claude Code that folder is ${CLAUDE_SKILL_DIR}. If that text was not replaced with a real path, find the folder with Glob (**/audit-my-code-stinger/SKILL.md) and use it as the skill directory in every command.
Requirements
git and Python 3.9 or newer on every platform. The orchestrator's own steps (scripts/make_scratch_copy.py, check_workspace.py, merge_security.py, build_evidence_index.py) are plain Python and run on macOS, Linux, and Windows.
- The bloat Drone's tool commands (
code-bloat-stinger/references/tool-commands.md) and some security Drone commands are bash. On Windows, run those Drones from Git Bash or WSL; PowerShell and cmd cannot run them. Node 20 and npx are needed for jscpd and knip.
Purpose
Audit a codebase the way Mario audits one by hand: measure before judging, rule out false alarms before reporting, lift every tool limit that would hide the worst code, and answer the question the person actually asked. The user picks a tier; this skill dispatches the Drones that tier needs, verifies their output against one shared contract, and hands the result to the brief renderer. It never audits code itself and never changes the audited repository, except for the library/ documents a Mario Audit user approves by name.
When to use
- The user runs
/audit-my-code, with or without a tier
- "Audit my code", "is this codebase bloated", "how bad is this vibe-coded app", "security audit my Next.js app", "give me a remediation plan for this repo"
- A harness cannot run the command file: this skill carries the same procedure
When not to use
- Auditing a live website from the outside: that is
/perform-website-audit and master-website-auditor in the website-audit-tools pack
- Capturing a running web app's UI:
/webapp-capture and webapp-capture-stinger in the browser-and-app-testing-tools pack
- Fixing the findings: route the remediation PRDs through
/smoke-it and IRDs through /pest-controller
- Reviewing a single diff before commit:
/ship-gate
Procedure
- Read references/audit-contract.md in full. Every step below depends on it.
- Intake: guides/00-tier-menu-and-intake.md. Resolve the tier (show the menu if none), resolve the repository, ask the intake questions, detect stacks, create the workspace and the throwaway copy (
scripts/make_scratch_copy.py), write intake.json.
- Dispatch W1 per guides/01-wave-dispatch.md, with security routing from guides/02-security-routing.md for
basic and above. Merge security output with scripts/merge_security.py.
- Verify each Drone's output per guides/05-verify-and-deliver.md with
scripts/check_workspace.py.
- For
full and mario, run W2 quality per guides/03-quality-standalone.md.
- For
mario, run W3 per guides/04-mario-tier.md, including the consent gate.
- Run the whole-workspace check, remove the throwaway copy, and dispatch the brief renderer (W4).
- Deliver per guides/05-verify-and-deliver.md.
References map
| Path |
Load when |
references/audit-contract.md |
Always, first |
references/tier-matrix.md |
Showing the menu, or deciding which dimensions and brief sections a tier gets |
references/intake-script.md |
Asking the intake questions |
references/arming-lines.md |
Dispatching any Drone |
references/forge-brief-for-builders.md |
Maintaining or adding a Drone and Stinger pair to this audit |
references/grounding.md |
Checking where this orchestrator's rules come from |
scripts/make_scratch_copy.py |
Making the throwaway copy at intake (guide 00, step 6) |
scripts/check_workspace.py |
After every Drone returns, and before the brief |
scripts/merge_security.py |
After the security Drones in W1 return |
scripts/build_evidence_index.py |
After each wave, and before the brief |
Related drones and stingers
- code-foundation-stinger with
code-foundation-wasp-drone: foundation health, using get-started-stinger in assess mode
- code-bloat-stinger with
code-bloat-wasp-drone: duplication, dead code, size, structure
- react-security-stinger, nextjs-security-stinger, sveltekit-security-stinger, polyglot-security-stinger, each with its Drone: framework-deep security
- code-audit-brief-stinger with
code-audit-brief-wasp-drone: the branded brief
- remediation-planning-stinger with
remediation-planning-wasp-drone: the Mario tier's roadmap and Library documents
- Core:
security-stinger (generic security pass), quality-stinger (standalone quality), get-started-stinger, library-stinger, knowledge-stinger
Critical Directive
- You must read all files and context contained within your skill.
- In the event your core knowledge does not provide sufficient guidance you must make every attempt to search the internet, related knowledge base documentation files, and other available resources to supplement your knowledge prior to proceeding with your task.
- Additional related skills can be found here:
pest-controller-suit (Wasp Nest core) - Roster and routing for the Wasp Swarm. Load it before dispatching any Drone.
security-stinger (Wasp Nest core) - Generic security pass in Basic and above.
quality-stinger (Wasp Nest core) - Standalone quality pass in Full and Mario.
1---2name: audit-my-code-stinger3description: Orchestrates /audit-my-code. Five tiers (foundation, vibe, basic, full, mario) of codebase audits, dispatched to paired Drones and delivered as a Legion Code Inc. brief.4license: AGPL-3.0-or-later5compatibility: Claude Code 2.1 or newer, Cursor 2.4 or newer, Codex, Cowork. Bloat tools need Node 20 and npx; Mario tier needs the Wasp Nest core.6metadata:7 source: https://skillmd.com/skills/legioncodeinc/audit-my-code-stinger8 author: Legion Code Inc.9 designed-by: Legion Code Inc.10 homepage: https://www.legioncodeinc.com11 hive-tier: orchestrator12 hive-role: audit-dispatcher13 domain: code audit orchestration14 version: 1.0.015---1617# Audit My Code Stinger1819Designed and built by [Legion Code Inc.](https://www.legioncodeinc.com)2021Orchestrator-tier skill with no paired Drone, the same pattern as `pest-controller-suit` and `master-website-auditor`. It runs in the main session because only the main session can dispatch Drones.2223## Where this skill's files are2425Every path below is relative to the folder that contains this `SKILL.md`. In Claude Code that folder is `${CLAUDE_SKILL_DIR}`. If that text was not replaced with a real path, find the folder with Glob (`**/audit-my-code-stinger/SKILL.md`) and use it as the skill directory in every command.2627## Requirements2829- `git` and Python 3.9 or newer on every platform. The orchestrator's own steps (`scripts/make_scratch_copy.py`, `check_workspace.py`, `merge_security.py`, `build_evidence_index.py`) are plain Python and run on macOS, Linux, and Windows.30- The bloat Drone's tool commands (`code-bloat-stinger/references/tool-commands.md`) and some security Drone commands are bash. On Windows, run those Drones from Git Bash or WSL; PowerShell and cmd cannot run them. Node 20 and npx are needed for jscpd and knip.3132## Purpose3334Audit a codebase the way Mario audits one by hand: measure before judging, rule out false alarms before reporting, lift every tool limit that would hide the worst code, and answer the question the person actually asked. The user picks a tier; this skill dispatches the Drones that tier needs, verifies their output against one shared contract, and hands the result to the brief renderer. It never audits code itself and never changes the audited repository, except for the `library/` documents a Mario Audit user approves by name.3536## When to use3738- The user runs `/audit-my-code`, with or without a tier39- "Audit my code", "is this codebase bloated", "how bad is this vibe-coded app", "security audit my Next.js app", "give me a remediation plan for this repo"40- A harness cannot run the command file: this skill carries the same procedure4142## When not to use4344- Auditing a live website from the outside: that is `/perform-website-audit` and `master-website-auditor` in the `website-audit-tools` pack45- Capturing a running web app's UI: `/webapp-capture` and `webapp-capture-stinger` in the `browser-and-app-testing-tools` pack46- Fixing the findings: route the remediation PRDs through `/smoke-it` and IRDs through `/pest-controller`47- Reviewing a single diff before commit: `/ship-gate`4849## Procedure50511. Read [references/audit-contract.md](references/audit-contract.md) in full. Every step below depends on it.522. Intake: [guides/00-tier-menu-and-intake.md](guides/00-tier-menu-and-intake.md). Resolve the tier (show the menu if none), resolve the repository, ask the intake questions, detect stacks, create the workspace and the throwaway copy (`scripts/make_scratch_copy.py`), write `intake.json`.533. Dispatch W1 per [guides/01-wave-dispatch.md](guides/01-wave-dispatch.md), with security routing from [guides/02-security-routing.md](guides/02-security-routing.md) for `basic` and above. Merge security output with `scripts/merge_security.py`.544. Verify each Drone's output per [guides/05-verify-and-deliver.md](guides/05-verify-and-deliver.md) with `scripts/check_workspace.py`.555. For `full` and `mario`, run W2 quality per [guides/03-quality-standalone.md](guides/03-quality-standalone.md).566. For `mario`, run W3 per [guides/04-mario-tier.md](guides/04-mario-tier.md), including the consent gate.577. Run the whole-workspace check, remove the throwaway copy, and dispatch the brief renderer (W4).588. Deliver per [guides/05-verify-and-deliver.md](guides/05-verify-and-deliver.md).5960## References map6162| Path | Load when |63| --- | --- |64| `references/audit-contract.md` | Always, first |65| `references/tier-matrix.md` | Showing the menu, or deciding which dimensions and brief sections a tier gets |66| `references/intake-script.md` | Asking the intake questions |67| `references/arming-lines.md` | Dispatching any Drone |68| `references/forge-brief-for-builders.md` | Maintaining or adding a Drone and Stinger pair to this audit |69| `references/grounding.md` | Checking where this orchestrator's rules come from |70| `scripts/make_scratch_copy.py` | Making the throwaway copy at intake (guide 00, step 6) |71| `scripts/check_workspace.py` | After every Drone returns, and before the brief |72| `scripts/merge_security.py` | After the security Drones in W1 return |73| `scripts/build_evidence_index.py` | After each wave, and before the brief |7475## Related drones and stingers7677- [code-foundation-stinger](../code-foundation-stinger) with `code-foundation-wasp-drone`: foundation health, using `get-started-stinger` in assess mode78- [code-bloat-stinger](../code-bloat-stinger) with `code-bloat-wasp-drone`: duplication, dead code, size, structure79- [react-security-stinger](../react-security-stinger), [nextjs-security-stinger](../nextjs-security-stinger), [sveltekit-security-stinger](../sveltekit-security-stinger), [polyglot-security-stinger](../polyglot-security-stinger), each with its Drone: framework-deep security80- [code-audit-brief-stinger](../code-audit-brief-stinger) with `code-audit-brief-wasp-drone`: the branded brief81- [remediation-planning-stinger](../remediation-planning-stinger) with `remediation-planning-wasp-drone`: the Mario tier's roadmap and Library documents82- Core: `security-stinger` (generic security pass), `quality-stinger` (standalone quality), `get-started-stinger`, `library-stinger`, `knowledge-stinger`8384## Critical Directive8586- You must read all files and context contained within your skill.87- In the event your core knowledge does not provide sufficient guidance you must make every attempt to search the internet, related knowledge base documentation files, and other available resources to supplement your knowledge prior to proceeding with your task.88- Additional related skills can be found here:89 - `pest-controller-suit` (Wasp Nest core) - Roster and routing for the Wasp Swarm. Load it before dispatching any Drone.90 - `security-stinger` (Wasp Nest core) - Generic security pass in Basic and above.91 - `quality-stinger` (Wasp Nest core) - Standalone quality pass in Full and Mario.9293<!-- Ship Gate removed: research-only orchestrator. It audits and reports; Mario-tier writes are approved library documents, not code. -->