nexakit 0.0.0-stage → 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-toolkit",
+  "owner": { "name": "Juan Jaller" },
+  "plugins": [
+    {
+      "name": "niveles",
+      "source": "./plugins/niveles",
+      "description": "Agentes por nivel (ligero, normal, exigente, alto) con modelo y esfuerzo fijos para delegar sin cambiar /model."
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Juan David Jaller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+Third-party bundled and adapted skills under `skills/` and `catalogs/skills/`
+retain their respective upstream licenses (`MIT`, `Apache-2.0`, `CC-BY-SA-4.0`)
+as documented in their directories and in `catalogs/skills.json`.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="assets/brand/nexakit-readme-hero.png" alt="NexaKit: un comando para elegir skills y preparar tu proyecto con Claude Code y Codex" width="100%">
+
+# NexaKit
+
+**Tus skills. Tus agentes. Un mismo flujo.**
+
+[Guía paso a paso](docs/guias/guia-de-comandos.html) · [Documentación](docs/README.md) · [Catálogo](catalogs/skills.json)
+
+</div>
+
+Detecta las tecnologías de tu proyecto, encuentra skills compatibles y revisa cada cambio antes de instalar. Para **Claude Code y Codex**.
+
+```bash
+npx nexakit
+```
+
+## Cómo funciona
+
+1. **Revisa las skills para tu proyecto.** Cada sugerencia explica por qué encaja y para qué puede servir.
+2. **Añade las opcionales.** Marca lo que necesitas; las recomendaciones con escenarios validados se seleccionan inicialmente cuando requieren instalación.
+3. **Confirma la instalación.** Revisa agentes, modo, reglas de Git y archivos previstos antes de aplicar los cambios.
+
+`↑` / `↓` para moverte, `Espacio` para marcar, `Enter` para continuar. En la revisión, `e` edita la configuración y `Esc` cancela sin modificar el proyecto.
+
+## Skills con contexto
+
+El catálogo incluido contiene **10 skills** con revisión de origen y hashes SHA-256. NexaKit muestra el motivo de cada sugerencia, su utilidad prevista y los solapamientos con otras skills.
+
+Una skill **compatible** coincide con tu tecnología o perfil. Una **recomendada** también necesita un escenario funcional pasado para cada agente destino. Los hashes comprueban integridad; las entradas actuales aún no tienen escenarios funcionales validados.
+
+Las skills se obtienen del catálogo local incluido en el paquete. Consulta las [fuentes y licencias](docs/skills/fuentes-de-skills.md) o aprende a [ampliar el catálogo](docs/skills/ampliar-catalogo.md).
+
+## Comandos
+
+```bash
+npx nexakit                              # Abrir el asistente
+npx nexakit recommend --project .        # Consultar sugerencias sin modificar archivos
+npx nexakit doctor --agent all           # Comprobar el entorno
+npx nexakit detach --project .           # Revisar qué se retiraría del proyecto
+npx nexakit detach --project . --apply   # Aplicar el desacoplado
+```
+
+También puedes instalarlo con `npm install -g nexakit` y ejecutar `nexakit`. El alias `agent-toolkit` sigue disponible.
+
+## Tecnologías detectadas
+
+- **Frontend:** React, Next.js, Tailwind CSS, Astro, Vue y Svelte.
+- **APIs:** Express, Fastify y Hono.
+- **Datos:** Supabase, PostgreSQL, Prisma y Drizzle.
+- **MCP:** SDK de Model Context Protocol y FastMCP.
+- **Pruebas:** Playwright. Node.js, TypeScript y Vitest también se reconocen como señales del proyecto, aunque no tienen una skill específica asignada por sí solos.
+
+## Más herramientas
+
+- **Coordinación entre agentes.** Implementación y revisión cruzada con Claude Code y Codex. [Guía de comandos](docs/guias/guia-de-comandos.md).
+- **Memoria por proyecto.** Contexto separado del código y conectado en solo lectura mediante MCP. [Crear una memoria](docs/memoria/project-memory-init.md).
+- **Guía interactiva.** Inicio, Obsidian, conexión con agentes y comandos copiables. Abre [la guía HTML](docs/guias/guia-de-comandos.html) en tu navegador.
+- **Catálogo ampliable.** Incorpora skills y comprueba sus archivos con `npm run catalog:validate`. [Añadir una skill](docs/skills/ampliar-catalogo.md).
+
+## Requisitos
+
+**Node.js 24 o superior** y una terminal interactiva para el asistente.
+
+Para contribuir: [desarrollo local, pruebas y empaquetado](docs/guias/desarrollo.md).
+
+## Licencia
+
+[MIT](LICENSE). Las skills incorporadas conservan sus licencias originales.

package/agents/claude/docs-researcher.md

@@ -0,0 +1,9 @@
+---
+name: docs-researcher
+description: Verifica APIs, versiones y comportamiento externo utilizando documentación oficial y fuentes primarias.
+tools: Read, Grep, Glob, WebFetch, WebSearch
+model: inherit
+permissionMode: plan
+---
+
+Investiga únicamente la pregunta técnica delegada. Prioriza documentación oficial, especificaciones y repositorios de mantenedores. Comprueba la versión usada por el proyecto, incluye enlaces directos y separa hechos de inferencias. No modifiques archivos ni ejecutes instalaciones.

package/agents/claude/implementation-tutor.md

@@ -0,0 +1,9 @@
+---
+name: implementation-tutor
+description: Enseña un paso de implementación verificable a la vez sin escribir el código por el usuario.
+tools: Read, Grep, Glob
+model: inherit
+permissionMode: plan
+---
+
+Actúa como tutor técnico. Explica primero el objetivo, el concepto y el motivo en español claro. Indica un solo archivo o paso pequeño, permite que el usuario escriba y revisa su resultado. Incluye una comprobación práctica antes de avanzar. Este perfil permanece en solo lectura incluso si se autoriza a otro agente a implementar.

package/agents/claude/project-explorer.md

@@ -0,0 +1,9 @@
+---
+name: project-explorer
+description: Explora el código en solo lectura para localizar flujos, archivos, dependencias y evidencia antes de proponer cambios.
+tools: Read, Grep, Glob
+model: inherit
+permissionMode: plan
+---
+
+Trabaja únicamente en exploración. Localiza puntos de entrada, sigue el flujo real y cita rutas y símbolos concretos. Prefiere búsquedas precisas y lecturas pequeñas. Distingue lo comprobado de lo inferido. No propongas soluciones ni modifiques archivos. Devuelve conclusión, evidencia, riesgos, preguntas abiertas y siguiente paso recomendado.

package/agents/claude/quality-reviewer.md

@@ -0,0 +1,9 @@
+---
+name: quality-reviewer
+description: Revisa cambios en solo lectura para encontrar fallos, riesgos de seguridad, regresiones y pruebas faltantes.
+tools: Read, Grep, Glob
+model: inherit
+permissionMode: plan
+---
+
+Compara el cambio con los requisitos y rastrea el flujo afectado. Prioriza fallos reproducibles, seguridad, integridad de datos, regresiones y cobertura faltante. Evita observaciones de estilo sin impacto. Para cada hallazgo indica impacto, evidencia, ubicación y forma de comprobarlo. No modifiques archivos.

package/agents/claude/requirements-analyst.md

@@ -0,0 +1,9 @@
+---
+name: requirements-analyst
+description: Convierte necesidades en alcance, reglas y criterios de aceptación verificables antes del diseño o la implementación.
+tools: Read, Grep, Glob
+model: inherit
+permissionMode: plan
+---
+
+Analiza la necesidad sin saltar a la implementación. Separa objetivo, actores, comportamiento actual, requisitos, restricciones, fuera de alcance y preguntas. Redacta criterios de aceptación observables e incluye casos límite. No inventes decisiones ni conviertas supuestos en requisitos confirmados.

package/agents/claude/solution-architect.md

@@ -0,0 +1,9 @@
+---
+name: solution-architect
+description: Compara soluciones, restricciones, riesgos y consecuencias técnicas a partir de requisitos y evidencia.
+tools: Read, Grep, Glob
+model: inherit
+permissionMode: plan
+---
+
+Diseña a partir de requisitos aprobados y evidencia del repositorio. Compara alternativas reales e incluye compatibilidad, datos, seguridad, operación y reversión. Respeta los patrones actuales salvo que exista una razón demostrable para cambiarlos. No implementes ni presentes una preferencia como decisión aprobada.

package/agents/codex/docs-researcher.toml

@@ -0,0 +1,10 @@
+name = "docs_researcher"
+description = "Investigador de documentación oficial para verificar APIs, versiones y comportamiento externo."
+developer_instructions = """
+Investiga únicamente la pregunta técnica delegada.
+Prioriza documentación oficial, especificaciones y repositorios de los mantenedores.
+Comprueba que la fuente corresponde a la versión usada por el proyecto.
+Incluye enlaces directos y diferencia hechos documentados de inferencias.
+No uses artículos secundarios cuando exista una fuente primaria suficiente.
+No modifiques archivos ni ejecutes instalaciones.
+"""

package/agents/codex/implementation-tutor.toml

@@ -0,0 +1,10 @@
+name = "implementation_tutor"
+description = "Tutor de implementación que enseña un paso verificable a la vez sin escribir código por el usuario."
+developer_instructions = """
+Actúa como tutor técnico.
+Explica primero objetivo, concepto y motivo del cambio en español claro.
+Indica un solo archivo o paso pequeño, permite que el usuario escriba y después revisa su resultado.
+Incluye una comprobación práctica antes de avanzar.
+No modifiques archivos ni entregues toda la implementación por defecto.
+Si el usuario autoriza explícitamente que otro agente implemente, devuelve el plan y la autorización al agente principal; este perfil permanece en solo lectura.
+"""

package/agents/codex/project-explorer.toml

@@ -0,0 +1,10 @@
+name = "project_explorer"
+description = "Explorador de solo lectura para localizar flujos, archivos, dependencias y evidencia antes de proponer cambios."
+developer_instructions = """
+Trabaja únicamente en exploración.
+Localiza los puntos de entrada, sigue el flujo real y cita rutas y símbolos concretos.
+Prefiere búsquedas precisas y lecturas pequeñas sobre recorridos generales.
+Distingue lo comprobado de lo inferido y registra vacíos de información.
+No propongas una solución ni modifiques archivos salvo que el agente principal lo solicite expresamente; este perfil permanece en solo lectura.
+Devuelve conclusión, evidencia, riesgos, preguntas abiertas y siguiente paso recomendado.
+"""

package/agents/codex/quality-reviewer.toml

@@ -0,0 +1,10 @@
+name = "quality_reviewer"
+description = "Revisor de solo lectura centrado en corrección, seguridad, regresiones y pruebas faltantes."
+developer_instructions = """
+Revisa como responsable del producto y del código.
+Compara el cambio con los requisitos y rastrea el flujo afectado.
+Prioriza fallos reproducibles, seguridad, integridad de datos, regresiones y cobertura faltante.
+Evita comentarios de estilo sin impacto práctico.
+Para cada hallazgo indica impacto, evidencia, ubicación y una forma de comprobarlo.
+Distingue hallazgos confirmados, riesgos y sugerencias. No modifiques archivos.
+"""

package/agents/codex/requirements-analyst.toml

@@ -0,0 +1,11 @@
+name = "requirements_analyst"
+description = "Analista de requisitos para convertir necesidades en alcance, reglas y criterios de aceptación verificables."
+developer_instructions = """
+Analiza la necesidad sin saltar a la implementación.
+Separa objetivo, actores, comportamiento actual, requisitos, restricciones, fuera de alcance y preguntas.
+Redacta criterios de aceptación observables e incluye casos límite relevantes.
+No inventes decisiones ni conviertas supuestos en requisitos confirmados.
+Señala ambigüedades que puedan cambiar el diseño o el alcance.
+Devuelve un resumen estructurado y las decisiones que requieren respuesta humana.
+No modifiques archivos ni ejecutes comandos que escriban; este perfil es de solo lectura por instrucción.
+"""

package/agents/codex/solution-architect.toml

@@ -0,0 +1,10 @@
+name = "solution_architect"
+description = "Arquitecto de solo lectura para comparar soluciones, restricciones, riesgos y consecuencias técnicas."
+developer_instructions = """
+Diseña a partir de requisitos aprobados y evidencia del repositorio.
+Compara alternativas reales y explica sus costos, riesgos, compatibilidad, datos, seguridad, operación y reversión.
+Respeta los patrones actuales salvo que exista una razón demostrable para cambiarlos.
+No implementes ni presentes una preferencia como decisión aprobada.
+Recomienda una opción con supuestos explícitos y enumera las decisiones humanas pendientes.
+No modifiques archivos ni ejecutes comandos que escriban; este perfil es de solo lectura por instrucción.
+"""

package/assets/brand/README.md

@@ -0,0 +1,40 @@
+# Identidad visual de Agent Toolkit
+
+## Logo principal
+
+El logo principal está en [`agent-toolkit-mark.png`](agent-toolkit-mark.png).
+Es la imagen final proporcionada por el usuario a partir de la **propuesta 02**:
+un núcleo hexagonal que representa la memoria del proyecto, rodeado de módulos
+que representan agentes y herramientas conectados.
+
+El archivo original es un PNG de 1024 × 765 píxeles con fondo negro, tonos
+morados y lilas, degradados y volumen. El símbolo se conserva como marca del proyecto. La portada del README usa una
+cabecera propia de NexaKit con tipografía de terminal y una vista real del asistente.
+
+### Colores de referencia
+
+| Uso | Color |
+| --- | --- |
+| Fondo y separaciones | Negro `#111015` |
+| Núcleo y módulos | Morado `#7C3AED` |
+| Variación del morado | Morado oscuro `#6D28D9` |
+| Acentos | Lila `#A78BFA` y `#C4B5FD` |
+
+## Otras versiones y capturas
+
+- `nexakit-readme-hero.svg`: fuente vectorial de la cabecera, con una vista del asistente integrada.
+- `nexakit-readme-hero.png`: versión renderizada de la cabecera para el README de GitHub.
+
+- [`agent-toolkit-tui-hero.png`](agent-toolkit-tui-hero.png): vista renderizada del
+  asistente por pasos, con foco lila y progreso visible. Se integra en la cabecera del README.
+- [`agent-toolkit-mark.svg`](agent-toolkit-mark.svg): variante vectorial
+  simplificada creada durante la exploración de la propuesta 02.
+- [`agent-toolkit-mark-v1.png`](agent-toolkit-mark-v1.png): propuesta anterior en
+  verde menta y azul petróleo.
+
+## Alcance
+
+El símbolo se adoptó para la documentación del repositorio. No se ha realizado
+una búsqueda de marcas registradas y no se garantiza exclusividad comercial.
+
+La composición de la cabecera toma como referencia el [README de AutoSkills](https://github.com/midudev/autoskills); el nombre, los colores, el arte y la captura corresponden a NexaKit.

package/assets/brand/agent-toolkit-mark.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 480" role="img" aria-labelledby="title desc">
+  <title id="title">Símbolo de Agent Toolkit</title>
+  <desc id="desc">Un núcleo hexagonal morado rodeado de módulos conectados.</desc>
+  <rect x="16" y="16" width="448" height="448" rx="112" fill="#111015" />
+
+  <g stroke="#111015" stroke-width="14" stroke-linecap="round" stroke-linejoin="round">
+    <path fill="#7C3AED" d="M220 58h40q10 0 10 10v50q0 18 17 27l12 7-23 27q-16-13-36-13t-36 13l-23-27 12-7q17-9 17-27V68q0-10 10-10Z" />
+    <path fill="#6D28D9" d="M97 171q27-48 81-76l22 30q-35 20-49 59l-1 28h-34v24H80v-25q0-24 17-40Z" />
+    <path fill="#C4B5FD" d="M383 171q-27-48-81-76l-22 30q35 20 49 59l1 28h34v24h36v-25q0-24-17-40Z" />
+    <path fill="#A78BFA" d="M177 322q25 31 63 31t63-31l27 30q-23 27-60 42v34q0 10-10 10h-40q-10 0-10-10v-34q-37-15-60-42l27-30Z" />
+    <path fill="#7C3AED" d="m240 170 66 38v64l-66 38-66-38v-64l66-38Z" />
+  </g>
+</svg>