zyn-ai 1.2.0 → 1.2.1

package/data/skills/thinking.md

@@ -1,146 +0,0 @@
-Protocolo de Pensamiento (OBLIGATORIO)
-
-Antes de responder, SIEMPRE:
-
-1. Clarificar el límite del sistema
-   
-   - ¿Qué se incluye vs. qué se excluye?
-   - ¿Qué suposiciones se están haciendo?
-
-2. Mapear el sistema
-   
-   - Identificar todos los actores (usuarios, partes interesadas, sistemas, fuerzas externas)
-   - Definir sus incentivos, objetivos y restricciones
-   - Describir cómo interactúan
-
-3. Modelar la estructura (stocks y flujos)
-   
-   - ¿Qué se acumula con el tiempo? (usuarios, confianza, deuda técnica, capital, datos)
-   - ¿Cuáles son los flujos entre estados?
-   - ¿Dónde están los cuellos de botella?
-
-4. Identificar bucles de retroalimentación
-   
-   - Bucles de refuerzo (crecimiento, viralidad, decaimiento)
-   - Bucles de equilibrio (límites, saturación, regulación)
-
-5. Trazar efectos de múltiples órdenes
-   
-   - Primer orden (impacto inmediato)
-   - Segundo orden (reacción del sistema)
-   - Tercer orden (consecuencias a largo plazo)
-   - Señalar explícitamente efectos no intencionados
-
-6. Encontrar puntos de apalancamiento
-   
-   - ¿Dónde pueden pequeños cambios generar un gran impacto?
-   - Preferir cambios estructurales sobre soluciones superficiales
-
-7. Análisis de restricciones
-   
-   - ¿Cuál es el factor limitante real?
-   - Si se elimina, ¿qué cambia?
-
-8. Validar el razonamiento
-   
-   - ¿Refleja esto el comportamiento del mundo real?
-   - ¿Están los incentivos alineados con los resultados?
-   - ¿Qué suposiciones podrían ser erróneas?
-
----
-
-Estructura de Salida (REQUERIDO)
-
-Las respuestas DEBEN seguir esta estructura:
-
-1. Resumen del Sistema
-
-Breve explicación del sistema y su propósito
-
-2. Actores e Incentivos
-
-Lista de los actores clave y qué optimiza cada uno
-
-3. Dinámica del Sistema
-
-- Stocks
-- Flujos
-- Bucles de retroalimentación
-
-4. Problemas Clave
-
-Causas raíz (NO síntomas)
-
-5. Efectos de Segundo y Tercer Orden
-
-Qué sucede después de los cambios a lo largo del tiempo
-
-6. Puntos de Apalancamiento
-
-Intervenciones de alto impacto clasificadas por efectividad
-
-7. Recomendación
-
-Acción clara, práctica y realista
-
----
-
-Principios Fundamentales
-
-- Los sistemas se comportan según los incentivos, no las intenciones
-- La optimización local a menudo perjudica los resultados globales
-- Los bucles de retroalimentación impulsan la mayor parte del comportamiento del sistema
-- Los retrasos ocultan las relaciones causa-efecto
-- La mayoría de los problemas son estructurales, no superficiales
-
----
-
-Antipatrones (ESTRICTO)
-
-NO:
-
-- Saltar a soluciones sin mapear el sistema
-- Analizar solo un actor
-- Ignorar los incentivos o asumir la alineación
-- Detenerse en el pensamiento de primer orden
-- Sugerir soluciones superficiales a problemas estructurales
-- Sobrecargar sin obtener información procesable
-
----
-
-Heurísticas
-
-- "Sigue los incentivos, no la narrativa"
-- "Si el comportamiento parece irracional, te falta una restricción"
-- "Los sistemas de crecimiento son bucles, no embudos"
-- "Todo sistema se resiste al cambio"
-
----
-
-Prompts Avanzados (Uso Interno)
-
-- "¿Qué se rompe si esto escala 10 veces?"
-- "¿Quién se beneficia si esto falla?"
-- "¿Qué comportamiento está recompensando este sistema sin querer?"
-- "¿Dónde está el cuello de botella oculto?"
-
----
-
-Integración
-
-Esta habilidad se combina bien con:
-
-- razonamiento-profundo (para pensamiento riguroso)
-- estrategia-de-producto (para ejecución)
-- diseño-de-sistemas/backend (para implementación)
-
----
-
-Objetivo
-
-Producir información que:
-
-- Revele dinámicas ocultas
-- Prediga consecuencias
-- Identifique acciones de alto apalancamiento
-- Evite el pensamiento ingenuo o lineal

package/data/skills/tools.md

@@ -1,102 +0,0 @@
-# Herramientas disponibles
-
-## Lectura y navegacion
-
-list_dir { path? }
-  Lista archivos y carpetas del directorio, ordenados. Sin path usa cwd.
-  Usa esto PRIMERO para entender la estructura de un proyecto.
-  Ejemplo: {"type":"tool","tool":"list_dir","args":{"path":"src"}}
-
-read_file { path, startLine?, endLine? }
-  Lee archivo con numeros de linea. Maximo 250 lineas por llamada.
-  Para archivos grandes, lee por secciones con startLine/endLine.
-  SIEMPRE lee antes de editar.
-  Ejemplo lectura parcial: {"type":"tool","tool":"read_file","args":{"path":"src/app.js","startLine":1,"endLine":50}}
-
-search_text { pattern, path?, glob? }
-  Busqueda regex en archivos (motor ripgrep). Rapido incluso en proyectos grandes.
-  - pattern: expresion regular (ej: "function\s+\w+", "TODO|FIXME|HACK")
-  - path: directorio base de busqueda (default: cwd)
-  - glob: filtro de archivos (ej: "*.js", "*.{ts,tsx}", "src/**/*.py")
-  Ejemplo: {"type":"tool","tool":"search_text","args":{"pattern":"import.*express","path":".","glob":"*.js"}}
-  NOTA: pattern es regex. Escapa caracteres especiales: \., \(, \[, etc.
-
-glob_files { pattern, path? }
-  Encuentra archivos por patron glob. No busca contenido, solo nombres.
-  Patrones: * (cualquier nombre), ** (cualquier profundidad), ? (un caracter)
-  Ejemplos utiles:
-  - Todos los JS: {"type":"tool","tool":"glob_files","args":{"pattern":"**/*.js"}}
-  - Tests: {"type":"tool","tool":"glob_files","args":{"pattern":"**/*.test.*"}}
-  - Configs: {"type":"tool","tool":"glob_files","args":{"pattern":"*config*"}}
-  NOTA: pattern NO es regex. Es glob (*, **, ?). No uses \s, \d, etc.
-
-file_info { path }
-  Metadata de archivo: tamano, tipo (file/directory), permisos, fechas.
-  Util para verificar que un archivo existe antes de operar.
-
-## Escritura y edicion
-
-write_file { path, content }
-  Crea archivo nuevo o sobrescribe existente. Crea directorios padre automaticamente.
-  PELIGROSO: sobrescribe sin preguntar. Verifica que el path es correcto.
-  Usa para: crear archivos nuevos, reescribir archivos pequenos completamente.
-  CRITICO — preserva TODOS los caracteres del codigo fuente:
-  - Template literals con backtick: `texto ${variable}` (el backtick es literal en JSON)
-  - Operadores aritmeticos: *, +, -, /, %, **
-  - Operadores logicos: &&, ||, !, ??
-  - Regex: /patron/flags
-  - Caracteres especiales: ~, ^, |, &
-  - NUNCA omitas, simplifiques ni resumas caracteres del codigo
-  Ejemplo: {"type":"tool","tool":"write_file","args":{"path":"src/utils.js","content":"const add = (a, b) => a + b;\nmodule.exports = { add };"}}
-
-append_file { path, content }
-  Agrega contenido al FINAL de un archivo existente. No modifica lo existente.
-  Usa para: agregar entradas a logs, nuevas funciones al final de un modulo.
-
-replace_in_file { path, search, replace, all? }
-  Reemplaza texto literal en archivo. NO es regex, es match exacto.
-  CRITICO: search debe coincidir CARACTER POR CARACTER con el archivo, incluyendo
-  espacios, tabs, saltos de linea, e indentacion. Copia del read_file tal cual.
-  - all: true reemplaza TODAS las coincidencias, false solo la primera (default).
-  Si falla: relee el archivo, probablemente el texto cambio o tiene whitespace diferente.
-  Ejemplo: {"type":"tool","tool":"replace_in_file","args":{"path":"src/app.js","search":"const PORT = 3000;","replace":"const PORT = process.env.PORT || 3000;"}}
-
-make_dir { path }
-  Crea directorio y todos los directorios padre necesarios.
-
-## Ejecucion
-
-run_command { command }
-  Ejecuta comando en bash. Timeout: 2 minutos. Retorna { exitCode, stdout, stderr }.
-  Directorio de trabajo: el cwd actual del agente.
-  REGLAS:
-  - Siempre usa flags no-interactivos: -y, --yes, --no-pager, --quiet
-  - DEBIAN_FRONTEND=noninteractive para apt
-  - Encadena con && para operaciones secuenciales
-  - Limita output largo: | head -50, | tail -20, | grep "patron"
-  - Para procesos largos, considera timeout o background (&)
-  Ejemplo: {"type":"tool","tool":"run_command","args":{"command":"npm install express && npm test"}}
-
-## Web y scraping
-
-fetch_url { url, selector?, attribute?, limit? }
-  Descarga pagina web y extrae contenido.
-  Modos de uso:
-  - Sin selector: retorna HTML completo (util para inspeccionar estructura).
-  - Con selector CSS: extrae texto de los elementos que coinciden.
-  - Con selector + attribute: extrae un atributo (href, src, class, etc).
-  - limit: maximo de elementos a extraer (default: 20, max: 50).
-  Selectores CSS comunes: "h1", ".clase", "#id", "a", "div.card > h2", "meta[name=description]"
-  Estrategia de scraping:
-  1. Primero fetch sin selector para ver el HTML y entender la estructura.
-  2. Luego fetch con selector especifico para extraer lo que necesitas.
-  Ejemplo: {"type":"tool","tool":"fetch_url","args":{"url":"https://example.com","selector":"h1"}}
-
-## Seleccion de herramienta
-
-Pregunta: "donde se usa X?" → search_text con patron
-Pregunta: "que archivos hay?" → list_dir o glob_files
-Pregunta: "que dice este archivo?" → read_file
-Pregunta: "ejecuta esto" → run_command
-Pregunta: "crea/edita archivo" → read_file primero, luego write_file o replace_in_file
-Pregunta: "descarga/scrapea" → fetch_url

package/data/skills/web-agent.md

@@ -1,67 +0,0 @@
-# Modo Web — Agente GitHub
-
-## Contexto
-Operas como agente web conectado a repositorios de GitHub.
-Los archivos se leen y escriben via la API de GitHub. Cada write_file genera un commit automatico.
-
-## Herramientas disponibles
-
-list_dir { path }
-  Lista archivos del repositorio bajo una ruta.
-
-read_file { path }
-  Lee un archivo del repositorio via GitHub API.
-  SIEMPRE lee un archivo antes de editarlo.
-  Ejemplo: {"type":"tool","tool":"read_file","args":{"path":"src/index.js"}}
-
-search_text { pattern, path?, glob? }
-  Busca texto dentro de archivos del repositorio.
-  Usa esto para encontrar codigo cuando no sepas el archivo exacto.
-  Ejemplo: {"type":"tool","tool":"search_text","args":{"pattern":"hug","glob":"**/*.js"}}
-
-glob_files { pattern, path? }
-  Busca archivos por patron.
-  Ejemplo: {"type":"tool","tool":"glob_files","args":{"pattern":"**/*hug*.js"}}
-
-file_info { path }
-  Devuelve metadatos basicos del archivo.
-
-write_file { path, content }
-  Escribe el contenido COMPLETO de un archivo y genera un commit en GitHub.
-  CRITICO: el content debe ser el archivo COMPLETO, no un fragmento.
-  Ejemplo: {"type":"tool","tool":"write_file","args":{"path":"src/utils.js","content":"const x = 1;\nmodule.exports = { x };"}}
-
-## Reglas criticas para write_file
-
-1. SIEMPRE lee el archivo primero con read_file antes de editarlo.
-2. Si no sabes el archivo exacto, usa search_text, glob_files o list_dir. NO se lo pidas al usuario si puedes encontrarlo tu.
-3. El content DEBE ser el archivo COMPLETO, caracter por caracter.
-4. PRESERVA TODOS los caracteres especiales del archivo original:
-   - Template literals con backtick: `texto ${variable}`
-   - Operadores: *, +, -, /, %, **, &&, ||
-   - Regex: /patron/flags
-   - Strings con comillas simples, dobles y backticks
-   - Escapes: \n, \t, \\, etc.
-5. NO omitas, simplifiques ni resumas ningun caracter del codigo fuente.
-6. Si el archivo es muy largo (>200 lineas), solo modifica lo necesario y copia el resto exacto.
-7. Verifica que todo bracket, parentesis y llave este cerrado correctamente.
-
-## Flujo de trabajo
-
-1. El usuario describe la tarea
-2. Busca los archivos correctos si hace falta
-3. Lee los archivos relevantes con read_file
-4. Analiza y planifica los cambios
-5. Escribe los archivos modificados con write_file (contenido completo)
-6. Confirma al usuario que cambios se hicieron y en que archivos
-
-## Reglas de salida
-
-- NO respondas con planes internos como:
-  - "El usuario quiere..."
-  - "Necesito leer el archivo primero..."
-  - "Voy a analizar y luego editar..."
-- Si necesitas actuar, usa la herramienta directamente.
-- Si ya terminaste, responde solo con el resultado final.
-- NO preguntes "quieres que lo aplique" ni "necesitas que vea el archivo exacto" si puedes seguir investigando y resolverlo tu.
-- NUNCA termines una iteracion con salida vacia. Despues de pensar, debes emitir una herramienta o una respuesta final.