Lo que este paquete enseña a Copilot

Un archivo grande .instructions.md (1,971 líneas) que cubre:

• El estado del fin de vida útil de AngularJS + evidencia de CVE-2024-21490 (por qué una migración no es opcional a menos que se tenga soporte comercial)
• 17 patrones canónicos de Angular 18 (predeterminado standalone, signals, flujo de control @if/@for/@switch, vistas diferibles @defer, interceptores/guardias/resolvedores basados en funciones, provideHttpClient, provideRouter + withComponentInputBinding, inject(), formularios reactivos tipados, OnPush + vista previa de desarrollo sin zonas, DestroyRef + takeUntilDestroyed, toSignal/toObservable, viewChild/viewChildren basados en signals, NgOptimizedImage, Vitest, constructor de aplicaciones)
• Tres rutas de migración con dimensionamiento del esfuerzo y casos de estudio: big-bang (3-9 meses), híbrido ngUpgrade (6-18 meses, recomendado), strangler-fig (6-24 meses)
• 62 antipatrones con pares MALO/CORRECTO y citas de fuentes, en tres modos de fallo:
  • Modo A (15): Patrones de AngularJS 1.x emitidos para solicitudes simples de "Angular" ($scope.$apply, ng-controller, $compile, $http, $q, ng-app, ng-bind-html, ng-click, angular.module, | filter, $resource, $cookies, $location, envoltura IIFE 'use strict')
  • Modo B (35): Modismos heredados de Angular 2-17 emitidos en lugar de Angular 18 (*ngIf / / , NgModules, decoradores / , DI de constructor, interceptores/guardias/resolvedores basados en clases, , , vs , fugas de subscribe, estado de , detección de cambios predeterminada, static, formularios sin tipo, importaciones obsoletas de , constructor de navegador)
• Árbol de decisión (mapeo de cubo de LoC a calendario; condición a ruta)
• Ocho trampas de ngUpgrade con fragmentos de corrección
• Referencias (documentos oficiales de Angular 18, avisos de fin de vida útil + CVE, soporte comercial, casos de estudio, obsolecencias)

Diseño del repositorio

research/ está en gitignore; contiene notas internas que informaron el contenido de las instrucciones pero no forma parte del artefacto público.

Scripts de tubería (reutilizables en todos los paquetes awesome-copilot de RoninForge)

scripts/validate-awesome-copilot-submission.sh

Ejecutar dentro de un clon de github/awesome-copilot. Refleja cada puerta de CI bloqueante:

1. Prevuelo (node 20+, npm, jq, git, codespell)
2. npm ci si es necesario
3. Detectar tipo de artefacto desde la ruta
4. Verificación de convención de nombres (lowercase-kebab; regex de nombre de archivo por tipo)
5. Verificación de esquema de Frontmatter (campos requeridos por tipo, cadenas entre comillas simples)
6. Verificación de contenido del cuerpo (las instrucciones deben comenzar con # )
7. Verificación de final de línea CRLF (bloquea si se encuentra)
8. codespell --check-filenames --config .codespellrc
9. Límite de activos de 5MB para skills
10. gh aw compile --validate para workflows
11. npm run plugin:validate para plugins
12. npm run skill:validate para skills/agents (warn-only)
13. npm start + git diff --exit-code (el rebote mecánico #1 - validate-readme.yml falla si README/marketplace están desactualizados)

scripts/submit-to-awesome-copilot.sh

Tubería de extremo a extremo:

1. Leer META.yml (slug, type, version)
2. gh auth status
3. Hacer fork de github/awesome-copilot a RoninForge si aún no se ha bifurcado
4. Clonar el fork a .upstream-clone/
5. Obtener + restablecer a upstream/staged (NUNCA main)
6. Crear rama de características desde upstream/staged
7. Copiar artefactos de dist/ al árbol upstream en las rutas correctas por tipo
8. Ejecutar el validador (arriba) - aborta en cualquier fallo
9. npm start para regenerar README + marketplace
10. Hacer commit con el marcador de vía rápida de autor IA 🤖🤖🤖
11. Empujar al fork
12. Abrir PR con base: staged (NUNCA main) - el trabajo check-pr-target.yml rechaza automáticamente los PRs a main

Soporta --dry-run (se detiene antes del push) y --no-pr (empuja la rama pero omite la creación del PR).

Versionado

• AngularJS estable final: 1.8.2 (octubre de 2020, última versión de código); 1.8.3 (abril de 2022, despedida solo de README). LTS finalizó el 31 de diciembre de 2021.
• Angular 18: 22 de mayo de 2024. Se recomienda el último parche 18.x para la estabilidad del esquema ng update.
• Node 20 LTS mínimo para el servidor de desarrollo de Angular 18.
• RxJS 7.5+ mínimo para peer de Angular 18.
• TypeScript 5.4+ mínimo para peer de Angular 18.
• Evitar: paquetes de la era AngularJS ya no mantenidos (angular-ui-bootstrap, ng-storage, ng-flow, angular-translate-loader-static-files); Karma + Jasmine para nuevos archivos de prueba (Vitest mediante ng add @analogjs/vitest-angular).

Licencia

MIT - consulte LICENSE.

Enlaces

• Publicación de lanzamiento de Angular 18
• Angular llms.txt para desarrollo asistido por IA
• Documentación de ngUpgrade
• Aviso de HeroDevs sobre CVE-2024-21490
• endoflife.date / AngularJS
• github/awesome-copilot
• RoninForge

Más de RoninForge

RoninForge construye herramientas gratuitas para desarrolladores que trabajan con asistentes de codificación IA:

• Comparación de precios de API de LLM - Precios de tokens de Claude, GPT, Gemini, DeepSeek, Mistral y Grok lado a lado, verificados contra las páginas de precios oficiales
• Calculadora de créditos de IA de GitHub Copilot - estime su consumo mensual de créditos bajo facturación basada en uso
• Todos los plugins de Cursor