Flexygo AI Skill

Skill instalable para que GitHub Copilot, Claude Code y Cursor generen código Flexygo correcto mediante el mcp.

Instalación rápida

pnpx flexygo-skill

El instalador interactivo te guiará. También puedes usar flags directos:

Instalación global (recomendado)

Instala la skill como conocimiento persistente — disponible en todos tus proyectos Flexygo:

# Todos los editores
pnpx flexygo-skill --global --all

# Solo Copilot
pnpx flexygo-skill -g --copilot

# Solo Claude Code
pnpx flexygo-skill -g --claude

# Solo Cursor
pnpx flexygo-skill -g --cursor

# Combinaciones
pnpx flexygo-skill -g --copilot --cursor

Instalación local (por proyecto)

Copia los archivos de referencia a la raíz del proyecto actual — útil para compartir con el equipo vía git:

# Todos los editores
pnpx flexygo-skill --local --all

# Solo Copilot
pnpx flexygo-skill -l --copilot

# Solo Claude Code  
pnpx flexygo-skill -l --claude

Desinstalar

pnpx flexygo-skill --uninstall

Actualizaciones obligatorias

Si existe una versión más nueva publicada del instalador, el comando detiene la instalación/configuración y obliga a actualizar primero.

pnpx flexygo-skill@latest

Esto asegura que nuevas reglas de la skill, integración MCP y mejoras de Stitch/Playwright no se mezclen con un instalador antiguo.

¿Qué instala?

Global (--global)

| Editor | Archivo instalado | Ruta | |---|---|---| | Copilot (siempre) | SKILL.md | ~/.copilot/skills/flexygo/SKILL.md | | Copilot (siempre) | flexygo-framework.md | ~/.copilot/flexygo/flexygo-framework.md | | Claude (--claude) | CLAUDE.md | ~/.claude/CLAUDE.md | | Cursor (--cursor) | flexygo.md | ~/.cursor/rules/flexygo.md |

Local (--local)

| Editor | Archivo instalado | |---|---| | Copilot | .github/copilot-instructions.md | | Claude | CLAUDE.md | | Cursor | .cursorrules |

Uso

Una vez instalado, los editores cargan las instrucciones automáticamente:

• Copilot: Usa /flexygo en el chat, o simplemente pide código Flexygo
• Claude Code: Las instrucciones se cargan al abrir el proyecto
• Cursor: Las instrucciones se cargan al abrir el proyecto

Ejemplo de prueba

Pregunta en cualquier editor:

"Crea un proceso Flexygo en C# que cambie el estado de un ticket y envíe una notificación SignalR"

El agente debería generar código con:

• Firma correcta (EntityObject Entity, ProcessHelper Ret, ...)
• using con DataManager
• SqlParameter para las queries
• try/catch con Ret.Success/Ret.LastException
• EventHelper.FireGenericAllUserEvent() para SignalR

Contenido cubierto

Las instrucciones cubren todos los aspectos del framework:

1. Arquitectura de dos bases de datos (Conf + Data)
2. Paquetes NuGet (Flexygo.Backend, Flexygo.Frontend, Flexygo.Library)
3. Namespaces C# completos
4. Patrón de procesos — las 3 firmas (con entidad, sin entidad, formulario)
5. EntityObject — CRUD en C# y JavaScript
6. DataManager — consultas SQL con SqlParameter
7. Web Components (flx-*) — catálogo completo de 50+ componentes
8. APIs JavaScript (navegación, eventos, procesos, AJAX)
9. SignalR — eventos en tiempo real
10. Convenciones de nombrado (AD_, sys, AD_V_)
11. Estructura de proyecto típica
12. Patrones críticos y anti-patrones
13. Configuración (appsettings.json)
14. Multi-tenancy con EnterpriseId
15. Sistema de plantillas ({{campo}})
16. Checklist de verificación (10 puntos)