Ir al contenido
Narsil Workshop

Tu propio panel de revisión

Narsil Check es un panel lateral que revisa tu sesión antes de entregar: el entorno, los conectores, la CI, la rama detrás de la remota, las actualizaciones agrupadas por riesgo, las vulnerabilidades y una lista de pendientes que Claude puede usar. Cada guía explica una de sus funcionalidades, las decisiones de diseño que hay detrás y la petición con la que empezó.

Cuando la petición original quedó registrada, la guía la cita palabra por palabra. Cuando no, la guía lo dice y la reconstruye a partir del historial de commits.

Empieza la primera guía

Las guías

  1. 1El panel lateralCómo Narsil Check dibuja un panel junto al chat con secciones plegables, un punto de color por sección, pliegues que recuerda y filas que copias con un clic.
  2. 2El entorno de la sesiónCómo Narsil Check muestra el repositorio, la carpeta, la rama, Remote Control y Auto-fix, leídos de git y de los servidores de la app de escritorio, y por qué los consulta tan poco.
  3. 3ConectoresCómo Narsil Check enumera los servidores MCP de la sesión con su estado y cuántas herramientas tiene cada uno, consultados una vez al propio servidor de conectores de la app de escritorio.
  4. 4El CI de tu PRCómo Narsil Check sigue los pasos de GitHub Actions del pull request de la sesión con la CLI gh, cada 10 segundos mientras una ejecución avanza, y se detiene cuando termina.
  5. 5Una rama por detrás de su remotoCómo Narsil Check hace fetch, cuenta los commits que le faltan a tu rama, avisa arriba del panel y los trae con un botón de git pull -r.
  6. 6Un adaptador por ecosistemaCómo Narsil Check lee once ecosistemas de paquetes con un contrato pequeño: cada adaptador lee su manifiesto, consulta su registro y dice cómo subir una versión.
  7. 7Clasificar las actualizacionesCómo Narsil Check reparte cada biblioteca desactualizada entre Bloqueada, Versión mayor, Solo subir la versión o Fuera del SDK de Expo, y por qué guarda seis horas las respuestas.
  8. 8Dependencias que se bloquean entre síCómo Narsil Check encuentra actualizaciones de npm que no pueden subir solas: peers que pide la versión nueva, peers que piden los paquetes instalados y pins exactos en el árbol.
  9. 9La espera de 24 horasPor qué Narsil Check nunca sube una versión publicada hace menos de un día, dónde dice cada registro cuándo salió una versión y qué pasa cuando nadie lo sabe.
  10. 10Versiones fijadas a propósitoCómo Narsil Check lee un comentario como "# pinned: 3.7 breaks auth" en un manifest y deja esa biblioteca fuera del botón de actualizar, con el comentario como motivo.
  11. 11Explicar una versión mayor con HaikuCómo Narsil Check pregunta a Haiku lo difícil que es una versión mayor para el proyecto, con las notas de versión y las líneas que importan la biblioteca, y cómo evita que invente.
  12. 12Actualizar las trivialesCómo el botón Actualizar las N sube a la vez cada patch y minor, conservando su operador de rango y su sección, y después ejecuta la herramienta de instalación de cada ecosistema.
  13. 13Crear el PRCómo Narsil Check convierte los manifests actualizados en un commit, una rama chore/upgrade-deps y un pull request abierto con gh, y después te devuelve a la rama principal.
  14. 14Vulnerabilidades con OSV.devCómo Narsil Check consulta a OSV.dev por cada paquete instalado en una sola petición por lotes, clasifica cada aviso por su propia valoración o su vector CVSS y cuenta una vez los avisos gemelos.
  15. 15PendientesCómo Narsil Check guarda una lista de pendientes por proyecto en un archivo JSON sin seguimiento, la mantiene fuera de git y nunca sobrescribe una lista dañada sin hacer una copia.
  16. 16Herramientas para ClaudeCómo Narsil Check da a Claude cuatro herramientas sobre la lista de pendientes con $.tool.register, las sirve desde hooks tool.call, y cómo decide el modelo cuándo usarlas.
  17. 17Kotlin, Gradle y AGP (avanzado)Por qué una build de Kotlin o Android no puede subir una herramienta sola, y cómo Narsil Check frena Kotlin ante sus plugins del compilador y comprueba los mínimos entre Gradle, AGP, Kotlin y Compose.