Sobre el proyecto
Archify es un sistema de renderizado y validación para Node.js diseñado como habilidad para agentes de codificación de IA como Cursor, Claude Code, Codex CLI y OpenCode. Permite que un agente convierta un repositorio de código o una descripción de sistema en lenguaje natural en una representación intermedia JSON tipada, que Archify compila de forma determinista en diagramas HTML/SVG autónomos. No se requiere un repositorio; los usuarios pueden describir un sistema directamente en el chat.
Admite cinco tipos de diagramas: arquitectura, flujo de trabajo, secuencia, flujo de datos y ciclo de vida. Cada uno cuenta con múltiples preajustes visuales, temas oscuro y claro, marcas integradas y movimiento finito. El visor generado permite buscar nodos, rastrear alcance ascendente/descendente, examinar rutas exactas, comparar roles semánticos y reproducir historias guiadas. Los enlaces profundos estables pueden restaurar el foco, las vistas, las rutas, las lentes y los estados de alcance.
El modo Architecture Delta compara dos instantáneas validadas como Before, Delta y After con un recibo legible por máquina, enumerando hechos añadidos, eliminados, modificados, movidos y reenrutados. Los artefactos se validan antes de la entrega; los fallos de validación incluyen códigos de regla estables, evidencia medida y correcciones admitidas. Las exportaciones incluyen PNG, SVG, WebM y tarjetas para compartir de 1200x630, con tarjetas de ruta y alcance para rutas específicas creadas. Los enlaces opcionales de evidencia de origen abren archivos verificados por Git y rangos de líneas fijados en un commit público.
La instalación está disponible mediante npx skills add tt-a1i/archify -g, con instrucciones para instalaciones globales y de proyecto, una opción manual ZIP para Raven y un plugin comunitario DeepSeek Harness. La CLI incluye comandos doctor, demo, guide, validate, preview y deliver. El comando preview ejecuta un observador de escritorio explícito solo loopback que conserva la última salida verificada cuando un guardado está incompleto o no es válido. validate y deliver emiten diagnósticos JSON con orientación de reparación determinista.
Archify no es un editor de dibujo de propósito general ni un tema de Mermaid; se centra en convertir la intención técnica en un artefacto de comunicación. Está licenciado bajo MIT e incluye un registro de cambios, hoja de ruta, referencia de esquema y un Proof Lab generado con artefactos de ejemplo.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.