| name | code-audit-sweep |
| description | Orchestrate a full structural code audit of pyjinhx using eight focused lenses (file responsibility, module placement, domain entities, state shape, duplication, indirection, public API, dead code). Use when the user asks to "audit the codebase", "sweep for quality", "review architecture", "audit reactive/", or before a large PR merge. Produces a merged read-only report; remediation is a separate pass unless requested. |
| disable-model-invocation | true |
Code audit sweep
Audit ownership
I own: running all child audits in order, merging reports, deduplicating findings at the same location, and delivering one prioritized punch list.
I don't own: individual lens rules (→ child skills), idempotency/retry safety (→ external audits), test coverage gaps.
Defer to: child skill named in each finding for fix guidance.
Read shared rules: CONVENTIONS.md.
Workflow
- Confirm scope — default
pyjinhx/; user may narrow (e.g. pyjinhx/reactive/).
- Run child audits in order (read and follow each skill):
- Merge — same file:line → one finding, highest severity, note all lenses.
- Output combined report using CONVENTIONS template + executive summary table:
- Do not fix unless user asks.
Single-lens runs
If the user names one lens only (e.g. "indirection audit on this PR"), run that child skill alone; skip merge step.
Expected baselines (post reactive refactor)
pyjinhx/reactive/ — expect zero P1 if refactor landed; P3 doc nits OK.
pyjinhx/core/ — likely P2/P3 backlog (renderer size, module-level autodiscover helpers).
Use dry-run results to calibrate; do not suppress real findings to match baselines.