# Toad Audit Project

> Audit an existing project against the pjangler parity rules and migrate the fixable ones. Use to check whether a project conforms to the latest pjangler/33GOD spec and to bring a legacy project up to standard.

- Skill: `delorenj/toad-audit-project` (Agent Skill)
- Install (CLI): `npx skillmds@latest add delorenj/toad-audit-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/delorenj/toad-audit-project/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: delorenj (https://skillmd.com/u/delorenj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/delorenj/toad-audit-project

---


# Toad — Audit & Migrate a Project

Checks a project against the pjangler parity rules and offers to migrate the
fixable ones. Auditing is read-only and safe; migration dry-runs first.

## Flow

1. **Audit.** Call `project_audit { repo }` (defaults to cwd). It runs
   `pjangler audit --json` and returns the parity rules, each with
   `{ id, title, status, fixable }`, plus the count of failing rules.
   - If audit returns no JSON, the repo may not be a git repo yet — report that
     plainly rather than treating it as a crash.
2. **Summarize.** Present the `fail` rows and note which are `fixable`. Typical
   rules: `mise.config-root`, `mise.versioning`, `sot.agent-symlinks`,
   `sot.project-json`, `secrets.env-op`, `provenance.copier`, `bmad.scaffold`,
   `bmad.version`, `hermes.pm-scaffold`, `hermes.untracked-runtimes`,
   `systemd.sentinel`.
3. **Offer migration.** For fixable failures, call
   `project_migrate { rule: "--all", repo }` in **dry-run** first (default), show
   what it would change, then — with `TOAD_ALLOW_LIVE=1` and confirmation —
   re-run with `apply:true`.
4. **Re-audit** to confirm parity improved.

## Safety

- Audit is read-only — always safe.
- `project_migrate` with `apply:true` mutates the repo; it is refused unless
  `TOAD_ALLOW_LIVE=1`. Dry-run first, confirm, then apply.