Impeccable: orientación de diseño dentro de un agente de código
Arquitectura de Impeccable: contexto, comando y detector
Seguir una petición de diseño entre habilidad, runtime y revisión.
Qué aprenderás
- Los hechos del producto perduran
- Los comandos organizan el trabajo
- Los hooks alteran el momento
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
- Contexto y estilos tienen vidas distintas.
- Reglas y crítica aportan evidencias diferentes.
- Un hook no decide el diseño.
Los hechos del producto perduran
El README explica que `init` escribe público, límites y pruebas en PRODUCT.md. La dirección visual de una pantalla puede vivir aparte en DESIGN.md. Un comando usa ambos, pero una nueva composición no debería reescribir hechos del producto.
Un mismo producto puede tener landing y panel denso. Su composición cambia sin que cambien necesariamente las personas a quienes sirve o sus restricciones operativas.
Los comandos organizan el trabajo
La habilidad ofrece `audit`, `critique`, `polish` y `distill`, entre otros. Algunos piden razonamiento y edición del agente; las reglas producen hallazgos repetibles. El nombre no implica que cada sugerencia pueda verificarse mecánicamente.
El README separa composición primero y código primero, y describe iteración en vivo. Elige según el estado de la pantalla y conserva razones de la decisión visual.
Los hooks alteran el momento
Hooks nativos pueden mostrar resultados alrededor de una edición. Cambia el momento de recibir información, mientras usuario y host conservan la decisión sobre cambios y confianza del proyecto.
Separa en el diagrama agente, lanzador local, motor y archivos del proyecto. Esta revisión no traza cada adaptador del monorepositorio.
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
Registra contexto y dirección visual por separado.
- 2
Sigue un comando hasta su resultado.
- 3
Identifica quién aprueba el hook.
Ejemplo para copiar
PRODUCT.md -> habilidad -> motor o critica
DESIGN.md -> direccion de pantalla --^
pagina real + hallazgo -> decision revisadaPreguntas frecuentes
¿Dónde se guardan los hechos del producto?
El flujo init documentado escribe PRODUCT.md.
¿Todos los comandos hacen lo mismo?
Consulta su descripción y contrato; el nombre no basta.
Fuentes
- Impeccable / README.mdFuente verificada 2026-09-29
- Impeccable / .agents/skills/impeccable/SKILL.mdFuente verificada 2026-09-29
- Impeccable / docs/ENGINE.mdFuente verificada 2026-09-29