brunovdev-workflow

CLI para instalar tu estandar de prompts y reglas de Copilot en cualquier proyecto.

Version actual: 1.0.2

Instalacion y uso

Sin instalar globalmente:

npx brunovdev-workflow init

Sobrescribiendo archivos existentes:

npx brunovdev-workflow init --force

Que instala

En el directorio actual crea/actualiza:

• .github/copilot-instructions.md
• .github/prompts/01-arquitecto.prompt.md
• .github/prompts/02-developer.prompt.md
• .github/prompts/03-tester.prompt.md
• .github/prompts/04-documentador.prompt.md
• .github/prompts/05-devops.prompt.md

Uso recomendado con VSCode y Copilot

1. Abri tu proyecto en VSCode.
2. Ejecuta el init desde la raiz del proyecto:

npx brunovdev-workflow init

3. Verifica que existan estos archivos:

   • .github/copilot-instructions.md
   • .github/prompts/01-arquitecto.prompt.md
   • .github/prompts/02-developer.prompt.md
   • .github/prompts/03-tester.prompt.md
   • .github/prompts/04-documentador.prompt.md
   • .github/prompts/05-devops.prompt.md

4. En el chat de Copilot (modo agente), usa un prompt de arranque como:

Trabaja siguiendo .github/copilot-instructions.md y .github/prompts.
Inicia por el agente Arquitecto y haz las preguntas iniciales.

5. Para ejecutar el flujo completo, puedes indicar:

Sigue el workflow Arquitecto -> Developer -> Tester -> Documentador -> DevOps,
respetando TDD red-green-refactor y handoffs temporales.

Que configurar en el chat del IDE

• Usa siempre prompts cortos y directivos.
• Referencia explicitamente la carpeta .github al iniciar una sesion nueva.
• Si retomas una tarea, indica el ultimo handoff activo para evitar contexto innecesario.
• Si cambias idioma de documentacion, dilo en el primer mensaje de la sesion.

FAQ

Templates vs .github en la raiz de este repositorio

Si, son dos cosas distintas y ambas tienen sentido:

• templates/.github es el contenido que se publica dentro del paquete npm y que se copia al proyecto destino cuando ejecutas init.
• .github en la raiz de este repositorio es tu configuracion de trabajo local para este proyecto en particular.

En este paquete, la fuente usada por el CLI es templates/.github. Por eso, si haces cambios en .github de la raiz y quieres que lleguen al paquete, debes reflejarlos tambien en templates/.github antes de publicar.

Publicar en npm

1. Login:

npm login

2. Publicar:

npm publish --access public

En PowerShell con politicas restrictivas, usa:

npm.cmd login
npm.cmd publish --access public

Comandos npm clasicos incluidos

npm run start

Muestra la ayuda del CLI.

npm run check

Chequeo rapido del binario.

npm test

Ejecuta tests con el runner nativo de Node.

npm run test:smoke

Ejecuta tests de humo del CLI.

npm run pack:dry

Simula el paquete npm que se va a publicar.

npm run verify

Ejecuta check + test + pack dry-run.

npm run release:patch
npm run release:minor
npm run release:major

Sube version siguiendo semver.

Requisitos

• Node.js >= 18