isdou/codeck

¿Qué hace codeck?

Usa Codeck como puente de ejecución mientras el agente de codificación actual sigue siendo el anfitrión y moderador. Trata el selector de modelo de un producto anfitrión como algo no relacionado: cambiar el modelo de chat activo no es lo mismo que consultar modelos externos a través de Codeck.

Elegir el flujo de trabajo

• Usa un solo ask para una segunda opinión de solo lectura de un ejecutor nombrado.
• Usa un consejo (council) para obtener opiniones independientes de dos o más proveedores de modelos subyacentes genuinamente diferentes.
• Usa delegate solo cuando el usuario solicite explícitamente que un ejecutor externo implemente cambios.
• Usa pick antes que auto cuando el enrutamiento sea incierto.

Nunca describas un solo modelo desempeñando varios roles como consenso multi-modelo. Etiquétalo como single-model-multi-role.

Verificación previa (Preflight)

1. Ejecuta command -v codeck.
2. Si no está disponible, detente y explica que se requiere la CLI de Codeck. No la instales sin autorización del usuario.
3. Ejecuta codeck doctor y codeck list en el proyecto de destino.
4. Utiliza solo ejecutores saludables y configurados cuyo modo y permisos declarados se ajusten a la tarea.
5. Si el proyecto no está inicializado, pregunta antes de ejecutar codeck init, ya que crea archivos .codeck/.

Lee references/providers.md al configurar ejecutores, elegir proveedores para una red regional, o explicar por qué un modelo solicitado no está disponible.

Preparar la transferencia

Escribe un resumen Markdown compacto para trabajos no triviales. Incluye el objetivo, restricciones, preguntas, criterios de aceptación y solo los archivos necesarios para el modelo externo. Prefiere adjuntar un archivo en lugar de incrustar un resumen largo en el comando:

codeck ask <ejecutor> "Lee el resumen de la tarea adjunto y devuelve una revisión basada en evidencia." -f tarea.md

No incluyas secretos, credenciales, archivos fuente no relacionados ni datos privados del usuario. Informa al usuario cuando el contenido de la tarea abandonará el producto anfitrión y será enviado a otro proveedor.

Lee references/artifacts.md para conocer los esquemas del resumen de entrada y del artefacto final.

Ejecutar un consejo multi-modelo

1. Mantén al agente de codificación actual como moderador.
2. Selecciona al menos dos ejecutores saludables respaldados por proveedores distintos. Prioriza la adecuación de capacidades y la disponibilidad sobre el orden de marca.
3. Proporciona a cada experto de primera ronda los mismos hechos y la pregunta central, junto con un rol de revisión distinto.
4. Recopila las respuestas de la primera ronda de forma independiente antes de exponer la respuesta de un experto a otro.
5. Extrae afirmaciones, evidencia, suposiciones, riesgos y desacuerdos.
6. Realiza preguntas de seguimiento solo sobre desacuerdos materiales. Adjunta las salidas previas relevantes como archivos Markdown.
7. Detente cuando se cumplan los criterios de aceptación, los desacuerdos restantes estén documentados explícitamente o se alcance el límite de rondas configurado.
8. Produce report.md, summary.md y decisions.json cuando se deban escribir artefactos; de lo contrario, devuelve la misma estructura en la respuesta.

Usa codeck compare <ejecutor-a>,<ejecutor-b> "<tarea>" -f tarea.md cuando todos los expertos deban recibir el mismo prompt. Usa llamadas codeck ask separadas cuando los roles o las preguntas de seguimiento difieran. No afirmes ejecución paralela a menos que la ejecución observada se haya ejecutado realmente de manera concurrente.

Lee references/moderation.md para conocer los prompts de rol, el manejo de desacuerdos y las reglas de convergencia.

Enrutar de forma segura

• Por defecto, usa ask, que está diseñado para consultas de solo lectura.
• No añadas -y ni llames a delegate a menos que el usuario haya autorizado la implementación externa.
• Trata los campos de permiso como declaraciones a menos que la CLI subyacente también aplique un entorno aislado (sandbox).
• No sustituyas un proveedor silenciosamente. Informa el ejecutor solicitado, el ejecutor/proveedor real y el motivo de la alternativa.
• No codifiques de forma fija los IDs de modelos actuales. Descúbrelos o léelos de la configuración local, ya que los nombres de los modelos de los proveedores cambian.
• Si hay menos de dos proveedores distintos disponibles, continúa solo como una consulta de un solo modelo y declara la limitación.
• Conserva las salidas externas sin procesar o los IDs de ejecución de Codeck para que la síntesis siga siendo auditable.

Devolver el resultado

Comienza con la conclusión del moderador. Luego indica:

• qué ejecutores y proveedores subyacentes se ejecutaron realmente;
• en qué coincidieron y en qué discreparon;
• qué evidencia respalda la decisión;
• riesgos no resueltos y verificación recomendada;
• cualquier alternativa, fallo, uso estimado o limitación regional.

Mantén el resumen breve orientado a la decisión. Mantén el razonamiento detallado y la atribución de fuentes en el informe completo.