agentic-init
juanpalegre/agentic-init
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-init1 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
README
A tradução para o português deste README ainda está na fila.
agentic-init
Un
npm initpara 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:
- Contexto estructurado — saben qué stack usás, qué convenciones seguís, qué arquitectura tiene el proyecto
- Instrucciones claras — tienen restricciones y patrones definidos, no improvisan
- Memoria persistente — aprenden de errores anteriores y no los repiten
- 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
| # | Principio | Implementación |
|---|---|---|
| 1 | Spec Driven Development | .context/ define el contrato; el agente genera código acotado |
| 2 | Plan → Act → Evaluate | .agents/planner.md + tasks/todo.md + evaluación |
| 3 | Agente como dev junior | .agents/reviewer.md revisa toda salida |
| 4 | Evaluación adversarial | .agents/evaluator.md valida contra criterios (separado del generador) |
| 5 | Guardrails | copilot-instructions.md / CLAUDE.md definen restricciones |
| 6 | Hooks de enforcement | hooks/ fuerzan reglas programáticamente |
| 7 | Ratchet | tasks/lessons.md convierte errores en reglas permanentes |
| 8 | Agnóstico de herramienta | Funciona con Copilot, Claude o ambos |
Stacks soportados
| Lenguaje | Frameworks | Test framework |
|---|---|---|
| C# / .NET | ASP.NET Core, Blazor, Console, MAUI | xUnit |
| TypeScript | Next.js, Express, NestJS, React (Vite), Angular | Jest / Vitest |
| Python | FastAPI, Django, Flask, CLI | pytest |
| Go | Gin, Echo, CLI | testing (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
| Archivo | Copilot | Claude | Ambos |
|---|---|---|---|
.github/copilot-instructions.md | ✅ | - | ✅ |
.claude/CLAUDE.md | - | ✅ | ✅ |
.agents/*.md | ✅ | ✅ | ✅ |
.context/*.md | ✅ | ✅ | ✅ |
tasks/*.md | ✅ | ✅ | ✅ |
azure-pipelines.yml | Si ADO | Si ADO | Si ADO |
.github/workflows/ci.yml | Si GHA | Si GHA | Si 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
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.