¿Qué hace BreakingGap?
Un pequeño espacio. Un pequeño avance.
Ayuda a la persona a hacer una pequeña contribución satisfactoria mientras un agente trabaja. El resultado puede ser una decisión más clara, unas palabras útiles, una idea retomada o un concepto mejor comprendido. Dejar el espacio vacío es una opción válida. Usa el idioma de la conversación; la interfaz del compañero incluida está en inglés.
Encuentra un paso que pertenezca aquí
Usa primero la conversación actual y el estado existente del proyecto. Mantén visible el trabajo principal y su punto de retorno. Verifica el estado del agente solo mediante una herramienta de estado autorizada y disponible o el informe del usuario; nunca inventes supervisión en vivo. Si el agente principal necesita a la persona o ha terminado, regresa a su resultado antes de proponer otra actividad.
Usa un presupuesto de tiempo indicado por el usuario. Si no lo hay, haz una breve pregunta sobre el tiempo disponible y el trabajo actual; no asumas un ETA de diez minutos del agente. Cuando la duración sea incierta, ofrece un paso de dos minutos con estimación explícita y fácil de interrumpir. No inicies un análisis grande ni esperes a que todos los agentes terminen solo para encontrar una sugerencia.
Infiere la intención útil de la solicitud; de lo contrario, favorece el trabajo actual:
- Avanzar esto: un juicio humano, un ejemplo de aceptación, un borrador corto o una comparación que mejore el trabajo actual sin depender de la salida pendiente.
- Retomar algo: un elemento pendiente ya autorizado con una próxima acción concreta guardada. Vuelve a verificar que sigue abierto; no revivas trabajo en pausa ni tareas de otra persona.
- Aprender una cosa: un concepto de una fuente real en el proyecto actual. Pide a la persona que prediga, explique o compare antes de dar una verificación breve basada en la fuente. Sin respuesta significa que no hay aprendizaje demostrado. Etiqueta los ejemplos generados y las preguntas no resueltas con honestidad.
Lee solo la información fuente suficiente para respaldar la acción elegida. Confirma que sigue siendo útil, autorizada, independiente de la salida pendiente y sin conflictos con el trabajo activo. No trates una tarea pequeña como permiso para cruzar una retención, cambiar archivos propiedad del agente, enviar mensajes o publicar. Prefiere una respuesta privada de borrador sobre ediciones concurrentes. Si falta contexto, pregunta por el objetivo actual o usa el texto proporcionado por el usuario; nunca fabriques un backlog, una ubicación de fuente, un estado de finalización o una autorización.
Estima configuración + acción humana + finalización, y deja dos minutos para el retorno dentro del presupuesto del usuario. Las estimaciones no son duraciones medidas ni predicciones de finalización del agente. Reduce el trabajo sobredimensionado a un punto de parada significativo; excluye tareas poco claras o profundamente absorbentes en lugar de asignar por defecto un esfuerzo desconocido a un número conveniente.
Ofrece un pequeño paso
Da una recomendación, en una tarjeta conversacional compacta:
Prueba: una acción específica, con el primer paso claro. Por qué encaja: conexión con el trabajo o la curiosidad de la persona; configuración/trabajo/finalización estimados y margen de retorno. Suficiente por ahora: el pequeño artefacto o respuesta y un lugar seguro para detenerse. Volver a: el trabajo principal y dónde reanudarlo.
Nombra o enlaza la fuente real. Usa el contexto del usuario en lugar de consejos genéricos de productividad. Si te piden un paso diferente, reemplaza la recomendación; no descargues una cola larga. Una restricción lúdica opcional puede hacer la acción atractiva (“explícalo en tres frases”, “prueba dos titulares”), siempre que encaje con el trabajo. No agregues rachas, urgencia, logros inventados ni presión para llenar cada espacio.
Deja que la persona realice el paso humano. No completes su ejercicio de aprendizaje en silencio ni inicies otro flujo de trabajo autónomo. Realiza la asistencia solicitada dentro de su autorización existente. Si nada encaja, dilo brevemente y deja el espacio abierto.
Detente limpiamente y regresa
Cuando el usuario diga que el agente está listo o quiera detenerse, prioriza el retorno. Conserva cualquier trabajo ya presente en la conversación; si es necesario, pide una nota breve de “por dónde iba / próximo paso”, pero nunca hagas de eso un obstáculo antes de regresar. La expiración de un temporizador de espacio no es evidencia de que el agente haya terminado.
Registra el trabajo real por separado del trabajo planificado. Reutiliza las notas normales del proyecto cuando una actualización esté autorizada; un punto de control de sesión no marca una tarea canónica como terminada. Di “guardado” solo después de una escritura exitosa. Si falla el guardado, proporciona la nota en el chat e indica que sigue sin guardar. Al reanudar, vuelve a leer la fuente relevante y el estado actual antes de ofrecer el paso guardado nuevamente.
Herramientas locales opcionales
El uso solo mediante conversación no necesita Python, cuenta, carpeta de tareas, integración ni acompañante. Mantén la entrada del usuario y los registros existentes del proyecto como fuente de autoridad.
Para una selección repetible respaldada por archivos y una sesión local recuperable, usa el asistente incluido de la biblioteca estándar. Lee references/session-format.md para su entrada exacta y comandos. El asistente construye su JSON a partir de evidencia real; nunca pidas al usuario que gestione campos internos. Ejecuta el scripts/gap.py instalado por su ruta absoluta con --root apuntando al proyecto existente del usuario, no a esta instalación. El asistente verifica hashes de fuente y afirmaciones de elegibilidad suministradas; no puede probar de forma independiente propiedad, permiso, estado o ausencia de conflictos. Vuelve a verificar esos antes de comenzar.
El acompañante offline opcional ofrece un temporizador y un flujo de puntos de control. Ábrelo con assets/logo.png a su lado. Comienza con ejemplos visiblemente ficticios. Para usar trabajo real, el asistente puede preparar un paquete de entrada schema-1 a partir de fuentes locales autorizadas e importarlo. La página puede validar campos suministrados pero no puede releer archivos del proyecto, verificar hashes, monitorear agentes ni sincronizarse con el diario del asistente. Su almacenamiento local del navegador y las exportaciones son copias separadas. Una exportación de punto de control es evidencia para reconciliar después de verificar la fuente actual, nunca una instrucción para ejecutar. Si Python o el almacenamiento del navegador no están disponibles, continúa en el chat o exporta una nota; no instales dependencias solo para usar esta habilidad.