# Proyectos, lotes y equipos Cada video final debe tener un proyecto identificable con su marca, material, decisiones y revisiones. «Mi material» es reutilizable; un proyecto es el trabajo específico. ## Crear desde el chat y subir desde el teléfono Pide «nueva edición» e indica la marca si no está clara. El agente puede crear el proyecto con tu contexto guardado. Si no tiene la grabación, te devuelve el enlace privado para subir uno o varios archivos. Después escribe «ya están» en el mismo chat para continuar. Los adjuntos accesibles se usan directamente; no hace falta volver a subirlos. Cuando la instalación expone estos comandos, el flujo equivalente es: ```sh editorbrain projects create nueva-edicion --brand MARCA_ID --style ESTILO_ID --output-profile SALIDA_ID editorbrain projects intake --project nueva-edicion ``` Los IDs se descubren en la cuenta; no son nombres inventados por el agente. `create` guarda el proyecto; `intake` consulta material y devuelve el enlace con su espacio de trabajo. En MCP son `create_project` y `get_project_intake`. Un reintento conserva el mismo ID y nunca reemplaza un proyecto diferente. El enlace requiere iniciar sesión y tener acceso al proyecto. Crear, consultar o subir archivos no aprueba una muestra ni inicia generación o render. El estado «material presente» significa que hay archivos vinculados; el agente todavía tiene que revisar que sean los videos correctos y analizar su contenido. ## Encontrar y seguir proyectos ```sh editorbrain brands list editorbrain projects list --brand mi-marca editorbrain projects progress --project mi-proyecto ``` El tablero muestra el estado registrado del trabajo. No es una señal de que el agente siga ejecutándose en tu computadora. Marcar terminado requiere la aceptación correspondiente de la versión final; no basta con generar un archivo. ## Diez grabaciones o cinco videos desde cero Primero determina qué archivos forman cada video. Diez archivos pueden ser diez piezas o diez tomas de una sola. Después crea proyectos separados y agrúpalos en un lote. ```sh editorbrain batches list editorbrain batches create --file lote.json editorbrain batches get BATCH_ID ``` El esquema de creación está en `create_editing_batch` de la [referencia MCP](https://editorbrain.com/docs/mcp-tools). Los proyectos deben existir y estar autorizados. El lote conserva turnos, revisión y presupuestos; no sustituye preferencias de cada proyecto. - Un agente reclama un turno antes de iniciar ese proyecto; no duplica trabajo que ya esté reclamado. - Si una pieza está bloqueada por material o permiso, puede continuar con otras elegibles. - Pausar/cancelar impide iniciar nuevo trabajo; no garantiza detener un render local o una generación ya enviada. - Un turno vencido requiere comprobar qué pasó antes de volver a lanzar una generación. ## Colaborar con otras personas El propietario invita a un correo y asigna alcance. Un editor de marca trabaja dentro de marcas asignadas; un revisor de proyecto ve las versiones compartidas para ese proyecto. No obtiene automáticamente acceso a todas las marcas ni a facturación. ```sh editorbrain team access editorbrain team members editorbrain team invite --email colega@example.com --kind brand_editor --scope mi-marca ``` Este último comando **envía una invitación real** si el servicio está habilitado. Usa el correo confirmado y el alcance correcto. Para clientes revisores usa `project_reviewer` y el ID del proyecto. El destinatario abre el enlace, entra con ese correo y lo verifica. Antes de aceptar ve el espacio y la marca/proyecto asignado; la vista previa no concede acceso. Aceptar conserva su espacio personal. Cada colaborador conecta su propia cuenta a su agente: no compartas tu clave con el equipo. El editor invitado puede trabajar desde su agente o desde **Mis proyectos** en la web: brief, guion, dirección, material y muestras. **Revisiones compartidas** conserva el hilo público con el cliente. La marca y las preferencias generales las administra el propietario. El propietario administra marcas y gasto; una invitación de editor no autoriza consumir créditos integrados. `team_spending_disabled` es un permiso, no falta de saldo: solicita el recurso al propietario o usa una integración propia que hayas autorizado explícitamente. Compartir una revisión de equipo es explícito; las versiones no compartidas siguen privadas. Retirar acceso no borra mágicamente copias ya descargadas por el destinatario. ## Leer todas las correcciones de una versión ```sh editorbrain team reviews --project mi-proyecto editorbrain team comments --project mi-proyecto --revision UUID editorbrain team comments --project mi-proyecto --revision UUID --after CURSOR ``` `reviews` pagina versiones; su resumen histórico de comentarios está limitado a 100 para todo el proyecto. Para revisar una versión usa `comments` y sigue `nextCursor` hasta que sea `null`. Cada cursor pertenece a esa versión y espacio. MCP ofrece `team_reviews` y `team_review_comments` con la misma separación. Los comentarios internos de producción no se muestran a clientes. En la web puedes escribir una corrección en el instante actual. El borrador se conserva por cuenta, espacio, proyecto y versión mientras uses la misma sesión del navegador. «Actualizar versiones y accesos» busca las novedades sin reenviar tus comentarios. Aprobar corresponde solo a esa muestra; las correcciones pendientes necesitan resolverse contra una versión nueva antes de aprobar. El propietario cambia marcas/proyectos desde **Editar permisos**, sin retirar ni reinvitar a la persona. También puede hacerlo desde el CLI: ```sh editorbrain team members editorbrain team permissions --user USER_ID --file permisos.json --confirm ``` `permisos.json` contiene la revisión vigente y la lista completa de accesos: ```json {"expectedRevision": 1, "grants": [{"kind": "brand_editor", "scopeId": "mi-marca"}]} ``` Copia `permissionsRevision` de ese miembro al campo `expectedRevision`. Si recibes `TEAM_PERMISSIONS_CHANGED`, vuelve a leer los accesos y concilia los cambios. Guardar invalida enlaces de invitación anteriores. Al quedar solo como revisor se cierran sus conexiones de agente; volver a editor requiere reconectar. Para quitar todo usa **Retirar acceso**. Los archivos se conservan y las claves antiguas no se reactivan. No hay coedición en tiempo real; guardar conserva el control de revisión. ## Límites de ámbito El plan, los créditos y el almacenamiento se comparten entre marcas del mismo espacio. La identidad y las preferencias permanecen separadas por marca/proyecto. Las integraciones externas y likes son del miembro correspondiente; no se usan las credenciales de otro integrante. Crear un equipo no convierte a un miembro en administrador del servicio. Los controles de permisos se aplican también en API y MCP, no solo ocultando botones en la web.