convez.ai
Agente
juanpalegre

agentic-init

juanpalegre/agentic-init

Ver no GitHub
InicialPluginScore · de 0 a 100

Bootstrap de proyectos con Spec Driven Development y agentes — templates para Claude Code, Copilot y CI multi-plataforma

Instalação

$npx convez-ai juanpalegre/agentic-init

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

agentic-init

Un npm init para desarrollo con agentes de IA.

Scaffold interactivo que genera la estructura de archivos, instrucciones y contexto necesarios para que Copilot, Claude u otro agente operen de forma efectiva en tu proyecto.

Basado en los principios de Spec Driven Development (SDD) y Harness Engineering: el spec y el harness son los artefactos primarios, el código es la salida derivada.

Un modelo decente con un gran harness supera un gran modelo con un mal harness.

Para la fundamentación teórica completa, ver harness-methodology/.

Uso rápido

# Windows (PowerShell)
.\init.ps1

# Mac / Linux (Bash)
./init.sh

El script te guía con preguntas (nombre, stack, CI/CD, herramientas de IA) y genera la estructura adaptada.

¿Qué genera?

tu-proyecto/
├── .github/
│   └── copilot-instructions.md     # Instrucciones para GitHub Copilot
├── .claude/
│   └── CLAUDE.md                    # Instrucciones para Claude
├── .agents/
│   ├── planner.md                   # Planifica antes de actuar
│   ├── reviewer.md                  # Revisa código pre-commit
│   ├── evaluator.md                 # Evalúa output contra criterios (separado del reviewer)
│   └── tester.md                    # Genera tests con cobertura
├── .context/
│   ├── architecture.md              # Decisiones de arquitectura (ADRs)
│   ├── conventions.md               # Convenciones de código
│   └── stack.md                     # Stack tecnológico y comandos
├── hooks/
│   └── README.md                    # Guía de hooks de enforcement
├── tasks/
│   ├── todo.md                      # Tracking de tareas activas
│   └── lessons.md                   # Ratchet: errores → reglas → enforcement
├── azure-pipelines.yml              # CI/CD — Azure Pipelines (o GitHub Actions)
└── README.md                        # Documentación del proyecto

Ver example/ para un proyecto inicializado de ejemplo.

Por qué

Los agentes de IA funcionan significativamente mejor cuando tienen:

  1. Contexto estructurado — saben qué stack usás, qué convenciones seguís, qué arquitectura tiene el proyecto
  2. Instrucciones claras — tienen restricciones y patrones definidos, no improvisan
  3. Memoria persistente — aprenden de errores anteriores y no los repiten
  4. Workflow definido — planifican antes de actuar, y su trabajo se verifica

Sin esto, el agente alucina, genera código inconsistente, ignora convenciones y repite errores. Con esto, opera como un contribuidor junior bien onboarded.

Principios

#PrincipioImplementación
1Spec Driven Development.context/ define el contrato; el agente genera código acotado
2Plan → Act → Evaluate.agents/planner.md + tasks/todo.md + evaluación
3Agente como dev junior.agents/reviewer.md revisa toda salida
4Evaluación adversarial.agents/evaluator.md valida contra criterios (separado del generador)
5Guardrailscopilot-instructions.md / CLAUDE.md definen restricciones
6Hooks de enforcementhooks/ fuerzan reglas programáticamente
7Ratchettasks/lessons.md convierte errores en reglas permanentes
8Agnóstico de herramientaFunciona con Copilot, Claude o ambos

Stacks soportados

LenguajeFrameworksTest framework
C# / .NETASP.NET Core, Blazor, Console, MAUIxUnit
TypeScriptNext.js, Express, NestJS, React (Vite), AngularJest / Vitest
PythonFastAPI, Django, Flask, CLIpytest
GoGin, Echo, CLItesting (stdlib)

CI/CD soportados

  • Azure Pipelines — template con stages CI + CD con environment approvals
  • GitHub Actions — workflow con CI en PR + CD en push a main
  • Ninguno — solo genera la estructura del proyecto

Archivos generados según configuración

ArchivoCopilotClaudeAmbos
.github/copilot-instructions.md✅-✅
.claude/CLAUDE.md-✅✅
.agents/*.md✅✅✅
.context/*.md✅✅✅
tasks/*.md✅✅✅
azure-pipelines.ymlSi ADOSi ADOSi ADO
.github/workflows/ci.ymlSi GHASi GHASi GHA

Requisitos

  • Windows: PowerShell 5.1+ (viene preinstalado)
  • Mac/Linux: Bash 4+
  • Un directorio (nuevo o existente) donde inicializar

Roadmap

  • v1.0 — Core: templates + init interactivo + ejemplo
  • v1.1 — Detección de proyecto existente (no pisar archivos)
  • v2.0 — Agentes adicionales: debugger, documenter, refactorer
  • v2.5 — VS Code settings + extensions.json recomendados
  • v3.0 — Publicación en PowerShell Gallery / npm

Licencia

MIT


Inspirado por las mejores prácticas de desarrollo agéntico del ecosistema GitHub (GH-600) y la experiencia práctica con Copilot y Claude en entornos productivos.

Ver o original no GitHub

Bom para

Relacionados