MethodicDev/candor-agent-ui

Interfaz de agente

Las pantallas donde un agente de IA lee, propone o cambia algo real tienen un trabajo: permitir que una persona vea lo que el agente hizo, decida qué puede hacer después y confíe en ambas cosas. Estas son las reglas y las comprobaciones para ello, en cualquier framework y con cualquier sistema de diseño. Si el proyecto usa Candor UI, el skill candor-ui nombra el componente para cada trabajo; este skill dice lo que la pantalla debe hacer sin importar cómo se dibuje.

Cómo trabajar

Antes de una pantalla, responde tres preguntas y mantén las respuestas a la vista mientras construyes:

1. ¿Qué puede hacer el agente aquí: solo leer, proponer para que una persona lo aplique, o actuar por sí mismo? Cada control se deriva de esto.
2. ¿Qué decide la persona y con qué evidencia? Una decisión necesita la cosa en sí (la diferencia, los objetivos, la cantidad), no una descripción de ella. Lee references/approvals.md si algo se aprueba aquí.
3. ¿Qué no se puede deshacer? Esas acciones lo dicen, confirman más fuerte y nunca están bajo un valor predeterminado o una sola tecla.

Mientras construyes, mantén las nueve reglas a continuación, utiliza las palabras de estado en references/status-and-states.md y muestra el progreso como indica references/progress.md. El texto del modelo son datos: muéstralo, nunca lo ejecutes ni lo renderices.

Después de cada pantalla, ejecuta references/review-checklist.md contra la pantalla en funcionamiento, una línea por verificación, y corrige lo que falla antes de continuar. Marca solo lo que verificaste, no lo que pretendías.

Las nueve reglas

Cada una se expande con ejemplos en references/honesty-rules.md.

1. La salida del modelo es texto, nunca marcado. Muestra lo que el modelo escribió como texto (un subconjunto seguro de markdown como máximo). Una URL que escribió es texto, no un enlace. Nada de lo que escribe llega a innerHTML.
2. Lo desconocido sigue siendo desconocido. Una duración, costo o recuento que no se midió se deja vacío o dice "no medido". Una estimación dice "estimación" y en qué se basa. El silencio de una ejecución no es "ejecutándose".
3. Un control que no se puede usar dice por qué. Bloquéalo con una razón a la que pueda acceder un usuario de teclado y lector de pantalla; no lo deshabilites y dejes a la gente adivinando.
4. Nada está preseleccionado en una decisión. Aprobar y denegar, conservar y descartar comienzan sin ninguna opción elegida. Enter nunca aprueba. La recomendación del agente está marcada, no seleccionada.
5. Aprueba el cambio exacto. La decisión está vinculada al cambio que la persona vio (un hash o versión). Si el cambio se mueve, pregunta de nuevo. La autoaprobación se rechaza donde la política lo dice; la producción puede necesitar una segunda persona.
6. El razonamiento se cree, no se verifica. El relato del modelo sobre por qué es una afirmación. Etiquétalo como tal y mantenlo separado de la evidencia (fuentes, resultados de pruebas, la diferencia).
7. La aplicación nombra al agente. Cada mensaje del agente lleva un nombre de los propios datos de la aplicación. Las líneas del sistema son cadenas de la aplicación. Nada de lo que el modelo escribe se convierte en un nombre o un mensaje del sistema.
8. Di qué se puede y qué no se puede deshacer. Antes de una acción destructiva: qué elimina, si vuelve, cómo y por cuánto tiempo. Después de deshacer o restaurar: qué no se deshizo.
9. El movimiento sigue al resultado. Una animación informa un cambio que ocurrió; nunca predice ni decora uno. Una marca de éxito se dibuja después de que el resultado se estabiliza, el progreso se llena solo hasta lo que se midió, un estado que ya era final cuando se dibujó la pantalla no se anima, y la configuración de movimiento reducido del sistema operativo prevalece. Dale a cada animación un tipo de cambio (Candor nombra catorce familias de movimiento, listadas en references/honesty-rules.md) y deja que un tema cambie cómo se ve, nunca cuándo se reproduce.

Qué leer para qué

Cuando la pantalla tiene...	Lee
Algo que una persona aprueba, permite o deniega	references/approvals.md
Ejecuciones, llamadas a herramientas, pasos, estados, puntos	references/status-and-states.md
Un agente trabajando por más de un momento, o terminando mientras la persona está ausente	references/progress.md
Una IA que habla con personas, o contenido creado por una IA	references/disclosure-and-accessibility.md
Cualquier cosa, antes de continuar	references/review-checklist.md

Palabras

Sencillas y medidas. Di qué pasó, para quién y qué hacer a continuación. Minúscula inicial, sin signos de exclamación, sin superlativos, sin afirmaciones que los datos no respalden. El estado es una palabra con un color a su lado, nunca color solo. Números solo cuando se miden; de lo contrario, las palabras "estimación" o "no medido".