Elige tu entorno. Empieza con ALDC.
Una forma de desarrollar. Instrucciones para la herramienta que utilizas. Elige tu superficie, prepara el proyecto y plantea tu primera petición acotada.
Tus herramientas. Tus decisiones.
Dos canales, separados. La extensión de VS Code se instala desde el Marketplace. Las rutas desde código de esta guía usan la revisión etiquetada 5.0.0 de este repositorio.
Prepara el código de 5.0.0
Para Claude Code, Copilot CLI y Codex: Git, Node.js 20+ y el host instalado y autenticado. Usa un proyecto AL separado, con app.json. Ejecuta estos comandos PowerShell desde una carpeta de herramientas fuera del proyecto, una sola vez. Usa una carpeta ALDC-5.0.0 nueva; no sobrescribas un clon existente.
git clone https://github.com/javiarmesto/ALDC-AL-Development-Collection.git ALDC-5.0.0
if ($LASTEXITCODE -ne 0) { throw "Clone failed" }
git -C .\ALDC-5.0.0 checkout v5.0.0
if ($LASTEXITCODE -ne 0) { throw "Checkout failed" }
$aldc = (Resolve-Path .\ALDC-5.0.0).Path
$project = (Resolve-Path 'C:\Path\To\YourALProject').PathSustituye la ruta de ejemplo antes de ejecutar. Mantén abierta esta sesión PowerShell: los siguientes comandos usan $aldc y $project. El checkout queda separado de una rama deliberadamente.
Consultar el código de 5.0.0 · v5.0.0GitHub Copilot VS Code
Marketplace · 5.0.0Instala la extensión
Necesitas VS Code, acceso a GitHub Copilot y un proyecto AL. Instala desde la ficha oficial; este comando instala el canal publicado.
code --install-extension javierarmestogonzalez.al-development-collectionAbrir Marketplace · En VS Code Insiders, utiliza code-insiders en lugar de code.
Instala el toolkit en tu proyecto AL
Abre la carpeta del proyecto con app.json. En la paleta de comandos ejecuta AL Collection: Open Project Manager, elige el perfil, revisa la lista de archivos y confirma; el panel también verifica, restaura y ejecuta Doctor. AL Collection: Install Toolkit to Workspace hace lo mismo desde la paleta. Recarga la ventana después. Instalar la extensión por sí solo no prepara el proyecto.
Comprueba la carga antes de implementar
La vista ALDC Visor del Explorador muestra los artefactos de cada requisito según se crean. Revisa el selector de agentes y elige AL Architecture & Design Specialist. Pídele que identifique las instrucciones que realmente ha cargado. Descubrir agentes no demuestra compilación ni ejecución de tests.
¿Instalas desde un archivo VSIX?
Usa Extensions: Install from VSIX con el archivo, recarga y actualiza el toolkit del proyecto. Revisa los conflictos antes de reemplazar. BC28 es el perfil por defecto; bc29-native es opcional.
GitHub Copilot CLI
Código · 5.0.0Previsualiza la preparación del proyecto
Después de preparar el código anterior, revisa los cambios propuestos. Este primer comando es una previsualización. Detente si aparece un destino o conflicto inesperado.
node "$aldc/copilot-cli-plugin/scripts/init.js" --project "$project"Aplica los cambios revisados
node "$aldc/copilot-cli-plugin/scripts/init.js" --project "$project" --applyLos archivos desconocidos o personalizados quedan como conflictos visibles. No añadas --force para evitarlos sin revisar el reemplazo y su copia. Preparar el proyecto y cargar el plugin en el host son pasos diferentes.
Carga ALDC en el host
copilot plugin install "$aldc/copilot-cli-plugin"
copilot plugin list
Set-Location -LiteralPath $project
copilotInicia una sesión nueva y revisa /agent y /skills list. Instala aldc-cli; no combines aldc y aldc-cli en la misma sesión. Al actualizar el código puede ser necesario reinstalar el plugin almacenado en caché.
Verifica los archivos instalados
node "$aldc/copilot-cli-plugin/scripts/init.js" --project "$project" --verifyLa coincidencia con el recibo verifica los archivos gestionados. No verifica la carga de skills, los agentes delegados, la compilación ni el acceso a Business Central.
Claude Code Plugin
Código · 5.0.0Previsualiza la preparación del proyecto
Después de preparar el código anterior, revisa los cambios propuestos. Este primer comando es una previsualización. Detente si aparece un destino o conflicto inesperado.
node "$aldc/claude-plugin/scripts/init.js" --project "$project"Aplica los cambios revisados
node "$aldc/claude-plugin/scripts/init.js" --project "$project" --applyLos archivos desconocidos o personalizados quedan como conflictos visibles. No añadas --force para evitarlos sin revisar el reemplazo y su copia. Preparar el proyecto y cargar el plugin en el host son pasos diferentes.
Carga ALDC en el host
Set-Location -LiteralPath $project
claude --plugin-dir "$aldc/claude-plugin"Así cargas el plugin de ese checkout para esta sesión. Revisa /agents y los comandos /aldc:. Evita cargar simultáneamente otra copia de ALDC desde caché. Esta ruta local no requiere una publicación en Marketplace.
Verifica los archivos instalados
node "$aldc/claude-plugin/scripts/init.js" --project "$project" --verifyLa coincidencia con el recibo verifica los archivos gestionados. No verifica la carga de skills, los agentes delegados, la compilación ni el acceso a Business Central.
Codex Proyecto local
Código · 5.0.0Previsualiza la preparación del proyecto
Después de preparar el código anterior, revisa los cambios propuestos. Este primer comando es una previsualización. Detente si aparece un destino o conflicto inesperado.
node "$aldc/plugins/aldc-codex/scripts/init.js" --project "$project"Aplica los cambios revisados
node "$aldc/plugins/aldc-codex/scripts/init.js" --project "$project" --applyLos archivos desconocidos o personalizados quedan como conflictos visibles. No añadas --force para evitarlos sin revisar el reemplazo y su copia. Preparar el proyecto y cargar el plugin en el host son pasos diferentes.
Carga ALDC en el host
El bootstrap instala una skill ALDC local, perfiles de agentes del proyecto e instrucciones gestionadas. Abre el proyecto en Codex, inicia una sesión nueva y revisa la skill ALDC disponible y sus fuentes. Esta ruta es local al proyecto; no registra un plugin en un marketplace público.
¿Ya utilizas el plugin ALDC de Codex? Utiliza el descubrimiento del plugin o este bootstrap local en un proyecto, nunca ambos. Descubrir el plugin no instala por sí solo los perfiles del proyecto; consulta la guía de distribución antes de cambiar de ruta.
Verifica los archivos instalados
node "$aldc/plugins/aldc-codex/scripts/init.js" --project "$project" --verifyLa coincidencia con el recibo verifica los archivos gestionados. No verifica la carga de skills, los agentes delegados, la compilación ni el acceso a Business Central.
Empieza con una decisión de diseño.
En el host elegido, pide al Architect de ALDC que trabaje sobre un requisito acotado. Comprueba primero qué instrucciones están disponibles.
Usa el rol Architect de ALDC. Identifica las instrucciones y skills de ALDC que realmente has cargado, o indica qué falta.
Requisito: añadir una nota de entrega a los clientes para que el usuario pueda consultarla en la ficha del cliente.
Lee la versión objetivo en app.json. Evalúa el alcance y propone las especificaciones necesarias y sus dependencias. No generes AL, no compiles, no despliegues ni cambies configuración. Detente para mi revisión.Qué no hace la instalación
Los perfiles BC28 / BC29 orientan a ALDC; no instalan la extensión AL, el compilador, los símbolos ni un entorno de Business Central. Los hosts de terminal usan sus herramientas disponibles; las herramientas de VS Code no se trasladan por nombre. Configura cada proyecto según su destino.
BCQuality es opcional y se instala por separado. Doctor requiere Python 3.9+ y separa configuración y observaciones por operación. Instalar archivos no equivale a superar una revisión ni una compilación.