Impeccable: orientación de diseño dentro de un agente de código
Lectura del código: instalador CLI y contrato del motor
Seguir la entrada JavaScript sin suponer que el binario esté implementado allí.
Qué aprenderás
- Localizar la entrada
- Leer los contratos
- Registrar lo desconocido
Antes de empezar
- Una pantalla y su tarea
- Permiso para revisar la habilidad y el hook
Crear un cambio de diseño respaldado por pruebas que otra persona pueda aceptar o rechazar.
Conclusiones clave
- CLI npm y binario son capas distintas.
- Los códigos 1 y 2 expresan situaciones diferentes.
- Leer fuente no verifica un binario descargado.
Localizar la entrada
package.json define el paquete CLI y cli/bin/cli.js inicia el motor distribuido. Antes de automatizarlo, sigue argumentos, plataforma y salida del proceso en el commit fijado.
El README describe el paquete npm como un shim y el motor como binario autónomo. El código visible aclara instalación e integración, pero no revela por sí solo cada implementación del detector.
Leer los contratos
docs/CLI-CONTRACT.md describe comandos y salidas, y docs/ENGINE.md marca el límite del runtime. Contrasta una operación con el lanzador para distinguir responsabilidad JavaScript y responsabilidad del motor.
El README da significados distintos a las salidas: 0 es escaneo completo sin hallazgos principales, 2 es escaneo completo con hallazgos y 1 indica fallo operativo. Tratarlas como un único error pierde información.
Registrar lo desconocido
En una prueba real fija commit, versión de paquete y artefacto del motor; compara stdout, stderr y código de salida. Este artículo no ejecutó esa prueba.
Si Codex y Cursor muestran hooks distintos, inspecciona sus manifiestos. Los adaptadores del repositorio no comparten necesariamente el mismo modelo de confianza.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Abre package.json y cli/bin/cli.js fijados.
- 2
Sigue una operación en el contrato CLI.
- 3
En una prueba futura registra motor y salida real.
Ejemplo para copiar
npx impeccable detect src/
# 0: sin hallazgos principales
# 2: con hallazgos principales
# 1: fallo operativo de algun objetivoPreguntas frecuentes
¿Dónde está implementada cada regla?
Inspecciona la distribución del motor y sus interfaces; el shim JS no demuestra contenerlas todas.
¿Se ejecutó el CLI para esta serie?
No. Solo se leyeron fuente y contratos fijados.
Fuentes
- Impeccable / package.jsonFuente verificada 2026-09-29
- Impeccable / cli/bin/cli.jsFuente verificada 2026-09-29
- Impeccable / docs/CLI-CONTRACT.mdFuente verificada 2026-09-29
- Impeccable / docs/ENGINE.mdFuente verificada 2026-09-29