Fernando RamosGuadalajara --:--
← Volver al inicio

luci-efe/skills · Suite open source

Skills de ingeniería con evidencia.

Los agentes no son ventanas de chat. Estos nueve skills convierten las Seis Reglas de Ingeniería Agéntica en árboles de decisión ejecutables, verificaciones explícitas de herramientas y evidencia ligada al código en Claude Code, Codex y Antigravity.

Instalar la suite completagithub.com/luci-efe/skills ↗
npx skills@latest add luci-efe/skills

Plugin de Claude Code
claude plugin marketplace add luci-efe/skills && claude plugin install ramos-skills@ramos

Después ejecuta /doctor en tu repositorio. El estado vive en .ramos/ (configurable con RAMOS_STATE_DIR). Con los hooks instalados, una ejecución de /proof que pasó en una sesión de Claude Code activa la compuerta Stop para esa sesión (no lee la conversación; una sesión sin una ejecución de /proof que pasó no se bloquea).

Compositor de instalación e inventario de dependencias

Activa o desactiva skills para armar el comando de instalación selectiva y ver las herramientas requeridas y opcionales por rama.

npx skills@latest add luci-efe/skills

Binarios locales requeridos para la selección:brew install node git ripgrep ast-grep herdr osv-scanner && uv tool install --python 3.12 mnemosyne-memory
Herramientas opcionales por rama para la selección:
  • gitnexus: npm i -g gitnexus (opcional · licencia PolyForm Noncommercial, verificar antes de uso comercial)
  • playwright: npm i -D @playwright/test && npx playwright install chromium (dependencia local por repositorio)
  • odiff: npm i -D odiff-bin (opcional · por repositorio (o usar toHaveScreenshot de Playwright))
  • cua-driver: desde cua.ai (macOS); instalación no verificada por esta suite (/doctor solo verifica que cua-driver esté en PATH)
  • gh: brew install gh (Enriquecimiento opcional de alertas de Dependabot en solo lectura)

Método · Los agentes no son ventanas de chat.

01/doctor02/compass03/cartographer04/crucible05/council06/reproduce07/proof08/red-team09/relay01Observable02No eres el portapapeles03Evidencia de terminado04El contexto continúa05Muchos modelos, muchos arneses06Autonomía con responsabilidad
  1. Regla 01Observable
  2. Regla 02No eres el portapapeles
  3. Regla 03Evidencia de terminado
  4. Regla 04El contexto continúa
  5. Regla 05Muchos modelos, muchos arneses
  6. Regla 06Autonomía con responsabilidad
Tabla equivalente: mapeo de las Seis Reglas a los skills
Regla/doctor/compass/cartographer/crucible/council/reproduce/proof/red-team/relay
01 Observable○○○
02 No eres el portapapeles●○
03 Evidencia de terminado●●●
04 El contexto continúa●●
05 Muchos modelos, muchos arneses○
06 Autonomía con responsabilidad●●●
Fig. 0. Cada punto marca una regla aplicada por el árbol de decisión o el contrato de hooks de ese skill. Selecciona cualquier regla o skill para inspeccionar su mecanismo.
/compass1 línea / promptHerramienta o hook faltantenode/doctor →Dominio o flujo desconocidogit · rg · ast-grep/cartographer →Requisitos o alcance abiertosrg/crucible →Decisión de alto impactonode · herdr/council →Bug o regresión reportadagit/reproduce →Aviso CVE o límite de confianzaosv-scanner · rg · ast-grep/red-team →Afirmar que el trabajo terminónode · input_digest/proof →Límite de contexto o cambio de turnonode · mnemosyne/relay →
  1. Herramienta o hook faltantenode
    /doctor →
  2. Dominio o flujo desconocidogit · rg · ast-grep
    /cartographer →
  3. Requisitos o alcance abiertosrg
    /crucible →
  4. Decisión de alto impactonode · herdr
    /council →
  5. Bug o regresión reportadagit
    /reproduce →
  6. Aviso CVE o límite de confianzaosv-scanner · rg · ast-grep
    /red-team →
  7. Afirmar que el trabajo terminónode · input_digest
    /proof →
  8. Límite de contexto o cambio de turnonode · mnemosyne
    /relay →
Equivalente en texto: enrutamiento de /compass y requisitos por rama
  1. Herramienta o hook faltantenode/doctor →
  2. Dominio o flujo desconocidogit · rg · ast-grep/cartographer →
  3. Requisitos o alcance abiertosrg/crucible →
  4. Decisión de alto impactonode · herdr/council →
  5. Bug o regresión reportadagit/reproduce →
  6. Aviso CVE o límite de confianzaosv-scanner · rg · ast-grep/red-team →
  7. Afirmar que el trabajo terminónode · input_digest/proof →
  8. Límite de contexto o cambio de turnonode · mnemosyne/relay →
Fig. 1. /compass enruta por intención, verifica primero los binarios de la rama y carga únicamente el árbol seleccionado.

Directorio · 09 Skills

  1. 01
    /doctorOrientarRegla 06

    Al instalar la suite, cuando un skill reporta una herramienta faltante, al reparar el descubrimiento o al configurar los hooks de Claude.

    Artefacto / salidareporte en stdout · .claude/settings.local.json (al conectar hooks)
    Herramientas por ramanode (requerido · default)
  2. 02
    /compassOrientarRegla 06

    Al elegir el siguiente skill de ingeniería, descubrir flujos instalados o comprobar requisitos antes de ejecutar una rama.

    Artefacto / salida.ramos/cache/skills.json
    Herramientas por ramanode (requerido · default)
  3. 03
    /cartographerOrientarRegla 04Regla 01

    Cuando necesitas mapear un dominio o flujo de ejecución a código real antes de planear o editar.

    Artefacto / salida.ramos/maps/<flow>.md
    Herramientas por ramagit (requerido · baseline y gitnexus) · rg (requerido · baseline) · ast-grep (requerido · baseline) · gitnexus (opcional · licencia PolyForm Noncommercial, verificar antes de uso comercial)
  4. 04
    /crucibleDecidirRegla 06

    Cuando una funcionalidad, refactor o diseño está subespecificado o tiene enfoques en competencia antes de escribir código.

    Artefacto / salida.ramos/decisions/<topic>.md
    Herramientas por ramarg (requerido · default)
  5. 05
    /councilDecidirRegla 02Regla 05

    Cuando una decisión o artefacto importante (plan de arquitectura, especificación, diff riesgoso, diseño de seguridad) merece revisión por varias familias de modelos en Herdr.

    Artefacto / salida.ramos/council/<run-id>/SYNTHESIS.md · round1.<seat>.md
    Herramientas por ramanode (requerido · default) · herdr (requerido · default)
  6. 06
    /reproduceConstruirRegla 03Regla 01

    Cuando algo está roto — un reporte de bug, una prueba fallida, una regresión o "antes funcionaba" — antes de cambiar código para arreglarlo.

    Artefacto / salidaPrueba de regresión en la suite del repo · .ramos/reproduce/{predicate.sh,bisect.log} (bisect)
    Herramientas por ramagit (requerido · default y bisect)
  7. 07
    /proofProbarRegla 03Regla 01

    Cuando estás por decir "terminado" — al validar un cambio, medir una afirmación de rendimiento o verificar una interfaz web o de escritorio.

    Artefacto / salida.ramos/runs/<run-id>/result.json
    Herramientas por ramanode (requerido · todas las ramas) · playwright (opcional · visual-web) · odiff (opcional · diff de píxeles en visual-web, o toHaveScreenshot de Playwright) · cua-driver (opcional · visual-desktop · desde cua.ai, instalación no verificada por esta suite)
  8. 08
    /red-teamProbarRegla 03

    Cuando cambiaron dependencias o lockfiles, llegó un aviso o CVE, o antes de publicar una versión.

    Artefacto / salida.ramos/red-team/report.md · .ramos/red-team/osv.json
    Herramientas por ramaosv-scanner (requerido · scan y github-enrich) · rg (requerido · scan) · ast-grep (requerido · scan) · gh (opcional · github-enrich)
  9. 09
    /relayContinuarRegla 04Regla 02

    Cuando una sesión debe entregar el trabajo a otra sesión, agente o máquina, o al retomar un trabajo entregado previamente.

    Artefacto / salida.ramos/runs/<run-id>/<pane>/checkpoints/<seq>/handoff.json + HANDOFF.md
    Herramientas por ramanode (requerido · default y herdr-launch) · mnemosyne (requerido · default y herdr-launch · requiere uv) · herdr (opcional · herdr-launch)

Terminado vs. verificado: una vez que una sesión de Claude Code tiene una ejecución de /proof que pasó, la compuerta Stop impide cerrar la sesión si la evidencia falta, falló o quedó desactualizada respecto al código, salvo que la ejecución se registre como blocked, failed o cancelled con un motivo. La compuerta local evita declaraciones accidentales de finalización (una evidencia escrita a mano aún puede pasarla); la re-ejecución en CI más una revisión independiente permiten llamarlo verificado (verified).

← Volver al inicio