Documentación

Configurar

Convierte cada regla del documento de descubrimiento en una configuración por área y consulta la lista completa de lo que el cliente puede modificar sin código.

Esta fase convierte las reglas del documento de descubrimiento en configuraciones. Trabaja en los ámbitos siguientes en orden. Para cada área, decide junto con el cliente y luego configúrala.

Anota cada decisión y su motivo a medida que avanzas. Nota de entrega Se genera a partir de estas notas.

Proyectos

Decide junto con el cliente:

  • Qué repositorios se convertirán en proyectos. Usa un proyecto para cada repositorio.
  • La rama contra la cual CoRoid abre sus solicitudes de extracción.
  • Si CoRoid puede enviar cambios al repositorio (Sincronizado) o solo leerlo (Solo local).
  • Los comandos que instalan, compilan y prueban el código, así como los servicios que necesitan las pruebas.
  • Qué debe saber el agente sobre funcionalidades que el código no muestra.

Crea cada proyecto desde Proyectos. Luego abre la configuración del proyecto: Repositorio para las ramas y el modo, Variables de entorno, y Conocimiento → Contexto para lo que los agentes pueden leer. Comprueba los comandos de compilación y prueba que detectó CoRoid. Escribe lo que los agentes deben saber en AGENTS.md, en el repositorio.

Consulta Crea tu primer proyecto, Configuración de repositorio y rama, Configuración de compilación y prueba y Escribe un AGENTS.md.

Control de Calidad

Decide junto con el cliente:

  • Qué debe cumplir cada cambio y qué fallos son bloqueantes o solo informativos.
  • Qué nivel de rigor tendrá el control de calidad y dónde se ejecutarán las verificaciones.
  • Qué ocurre con las solicitudes de extracción que se abren: Control de Calidad de CoRoid, y Revisión de CoRoid como orientativa o bloqueante.
  • Qué fuentes pueden enviar solicitudes, como Slack, Telegram o Jira.
  • Qué sucede cuando algo falla, como una tarea o despliegue incorrecto.

Configúralo en Control de Calidad. Establece el Valor predeterminado de la organización con las verificaciones que la mayoría de los proyectos necesitan. Asigna una configuración propia a un proyecto solo si difiere. Consulta Políticas y controles de calidad y Verificaciones anti-slop.

Un pull request de CoRoid solo fusiona cuando una persona lo autoriza. Para código que requiere un aprobador designado, como el código de pagos, usa la protección de ramas en el host git.

Mandatos

Un mandato permite a CoRoid iniciar trabajos que llegan sin intervención humana, por ejemplo desde un sistema de seguimiento de errores. Nunca permite que CoRoid fusione o despliegue.

Decide junto con el cliente:

  • Qué trabajos puede iniciar CoRoid por sí solo y en qué proyectos.
  • Cuánto puede gastar por semana o mes.
  • Cuándo el cliente revisará nuevamente el mandato.

Configura los mandatos en Control de Calidad: selecciona Valor predeterminado de la organización, luego Mandatos en el Entrega grupo. Si el cliente no desea que se realice ningún trabajo sin intervención humana, no establezcas ningún mandato. Consulta Mandatos.

Perfiles de AI

Decide junto con el cliente:

  • Qué perfil utilizará la organización por defecto.
  • Si las llamadas al modelo deben realizarse dentro de la UE. En ese caso, usa Solo UE.
  • Si pagar por los modelos se hará con créditos de modelo de CoRoid o con las claves del proveedor del cliente.
  • Qué proveedores y modelos no pueden usar los agentes.

Configura los perfiles en Configuración → AI profile, y las claves en Configuración → Claves de proveedor. Limita los proveedores y modelos en Configuración → Identidad y acceso → Política de la organización. Consulta Perfiles de AI, Claves de proveedor y Créditos de modelo.

Automatizaciones

Decide junto con el cliente:

  • Qué trabajos se inician según un horario y cuáles se activan al producirse un evento.
  • Qué hace cada automatización y en qué proyectos.
  • Si una automatización solo lee y genera informes, o también crea tareas.

Crea automatizaciones en Nuevo trabajo, y encuentra todas en Fábrica → Automatizaciones. Los interruptores bajo Cuando algo falla enControl de Calidad ejecutan una automatización cada vez. Consulta Automatizaciones, Programaciones y Hooks.

Flujos de trabajo

Un flujo de trabajo abarca un proceso empresarial, como una bandeja de entrada de soporte. Los agentes realizan sus pasos y las personas deciden en los puntos indicados por el flujo de trabajo. Los flujos de trabajo aún no están habilitados para todas las organizaciones. Pregunte a CoRoid que lo active.

Decida con el cliente:

  • Qué proceso cubrir primero. Elija uno con muchos casos similares y reglas claras.
  • Cómo comienza un caso: un correo electrónico, un formulario en la web del cliente, una persona u otro flujo de trabajo.
  • Los pasos y qué espera cada paso: nada, solo dinero o cada cambio y mensaje.
  • Las rutas para cada paso: preguntar al cliente, ir a otro paso, seguir una tabla de reglas, entregar el caso a una persona o cerrarlo.
  • Las tablas de reglas, como filas de «cuando esto, entonces aquello».
  • La dirección desde la que se envían las respuestas, la firma y la línea de divulgación de AI.

Construyalo en Flujos de trabajo. Cada flujo de trabajo tiene Casos, Pasos y Configuración, y las tablas de reglas se comparten bajo Tablas de reglas. Ejecútelo Pruébelo en los pasos antes de publicar: Pruébelo envía datos sin realizar cambios. Luego Publicar y Activar. Consulte Flujos de trabajo mediante MCP.

Revisar reglas

Decida con el cliente qué debe buscar el Revisor de CoRoid en el código de este cliente, más allá de las propias reglas de CoRoid.

Escriba las reglas en cada repositorio: un archivo REVIEW.md en la raíz y archivos de reglas en una carpeta review-rules . CoRoid los lee desde la rama base, por lo que un pull request no puede modificar las reglas que se revisan. Configure qué publica la Revisión de CoRoid en Control de Calidad, bajo Solicitudes de extracción. Consulte Solicitudes de extracción.

Habilidades

Una habilidad es un procedimiento que los agentes cargan solo cuando el trabajo lo requiere, como «cómo escribimos una migración de base de datos». Decida con el cliente qué procedimientos propios deben seguir los agentes.

Escriba cada habilidad en el repositorio, como skills/<name>/SKILL.md. El archivo comienza con metadatos que contienen un name y un description. Los agentes leen las habilidades solo desde el repositorio fusionado. Consulte Habilidades progresivas y Escriba un AGENTS.md.

Qué puede cambiar sin código

Los clientes e implementadores no obtienen el código fuente de CoRoid. Todo lo que un cliente puede modificar está en esta tabla: un ajuste en el portal o un archivo en su propio repositorio. Algunas páginas aparecen solo donde CoRoid ha activado la función, como Flujos de trabajo.

QuéDónde
Nombre de la organizaciónConfiguración → General
Miembros y sus rolesConfiguración → Miembros
Perfiles de AIConfiguración → AI profile
Claves de proveedorConfiguración → Claves de proveedor
Cuentas de servicio para la recepción de trabajos de APIConfiguración → Cuentas de servicio
La conexión con el host de GitConfiguración → Conexiones → Control de código fuente
Bots de Slack y TelegramConfiguración → Conexiones → Canales
Servidores MCP externos y las herramientas que pueden invocar los agentesConfiguración → Conexiones → MCP externo
Tokens de acceso, aprobaciones y políticas de automatización del servidor MCP de CoRoidConfiguración → Conexiones → Servidor MCP de CoRoid
SSO, dominios verificados y sincronización de directoriosConfiguración → Identidad y acceso → Identidad empresarial
Modelos, proveedores, comandos y herramientas permitidosConfiguración → Identidad y acceso → Política de la organización
Sesiones iniciadasConfiguración → Identidad y acceso → Sesiones activas
El registro de auditoría y su exportaciónConfiguración → Identidad y acceso → Registro de auditoría
Plan, ranuras de agentes y créditos de modeloConfiguración → Facturación y uso
Almacenamiento, retención de datos y exportación de configuracionesConfiguración → Datos y aspectos legales
Nombre, repositorio, ramas y modo de un proyectoEl proyecto tiene Configuración → General y Repositorio
Las variables de entorno de un proyectoEl proyecto tiene Configuración → Variables de entorno
Qué leen los agentes sobre un proyectoEl proyecto tiene Configuración → Conocimiento → Contexto
Revisar pruebas de las herramientas del clienteEl proyecto tiene Configuración → Integraciones
Comprobaciones, Control de Calidad, fuentes de solicitudes, solicitudes de extracción y «Cuando algo falla»Control de Calidad
Reglas anti-slop y limpieza semanal de deuda técnicaControl de Calidad
MandatosControl de Calidad → Valor predeterminado de la organización → Entrega
Protecciones de Seguridad, modelos de amenazas y superficie de ataqueSeguridad → Proyectos
Idiomas, comprobaciones de traducción y colaboradoresGlobalización
Entornos de lanzamiento, reglas de aprobación, canal de despliegue y control de versionesLanzamientos → Configuración de lanzamiento
Automatizaciones y programaciones de eventosFábrica → Automatizaciones, creado en Nuevo trabajo
Informes programadosFábrica → Informes
Flujos de trabajo y tablas de reglasFlujos de trabajo
Instrucciones para agentesAGENTS.md y los otros archivos de memoria en el repositorio
Revisar reglasREVIEW.md y el review-rules carpeta en el repositorio
Habilidadesskills/<name>/SKILL.md en el repositorio

El Servidor MCP de CoRoid modifica muchos de estos ajustes desde un asistente, dentro de las herramientas que están activadas.

Una necesidad que ninguna solución cubre

Cuando ninguna fila de la tabla cumple con una regla, no adaptes el producto en torno a ella. Envía la necesidad a CoRoid como solicitud a través de página de contacto. Escribe:

  • La situación del cliente, sin datos personales.
  • Lo que probaste con los ajustes anteriores.
  • Qué necesita el cliente y por qué.

Un cambio realizado por CoRoid llega a todos los clientes en una versión.

Listo cuando

  • Cada regla en el documento de descubrimiento tiene un ajuste o una solicitud a CoRoid.
  • Cada decisión tiene un motivo reflejado en tus notas.
  • Una tarea en cada proyecto llega a pull request tras pasar las comprobaciones.