Ts Review Lenses
Security Notice
This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.
Three adversarial TypeScript code-review prompts ("lenses") for an independent reviewer in a @swamp/software-factory run. Distilled from failure modes that escaped green test suites during real development.
- Lens A (idiom) — idiomatic, with-the-grain TypeScript; domain-types-first; no transliteration from another language; no paradigm zealotry.
- Lens B (correctness vs reality) — boundary validation, fixtures grounded in the real wire, secret hygiene, subprocess/IO correctness.
- Lens C (architecture) — module boundaries, the purity seam, dependency direction, verified change confinement.
Run as three separate passes (IDIOM-/CORR-/ARCH- finding id prefixes keep them distinct). The lens files are transport-neutral review prose; the swamp + findings-JSON contract is appended at run time.
Use
Pull this extension, then feed a lens as the prompt input to
@atalanta/external-reviewer's external-review-findings workflow (optional
companion — not a hard dependency), one invocation per lens. The bundled
ts-review-lenses skill prints the exact wiring. A factory wanting same-context
review instead uses the lenses as dispatch-stage systemPrompts.
swamp extension pull @atalanta/ts-review-lenses
# then invoke the bundled `ts-review-lenses` skillRename lens A from 'taste' to 'idiom' (label, IDIOM- prefix, lens-a-idiom.md) — a defensible standard, not a subjective preference.
Require a recon attestation (-0) in the reviewer contract: makes a clean pass verifiable instead of trusted.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned