Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows
npm install ac-framework
π€ Agentic Coding Framework
Framework basado en OpenSpec con sistema de Skills mejorado y Skill Routing inteligente para IA
---
AC-Framework (Agentic Coding Framework) es un framework de desarrollo avanzado basado en OpenSpec que implementa la metodologΓa Spec-Driven Development con mejoras significativas para el contexto y enrutamiento de IA.
AC-Framework adopta y potencia los principios fundamentales de OpenSpec:
- π Todo cambio es un artefacto - Cada modificaciΓ³n se documenta antes de implementarse
- π Desarrollo basado en especificaciones - El "quΓ©" (specs), "cΓ³mo" (design) y "por quΓ©" (proposal) estΓ‘n separados
- β
Trazabilidad total - Historial completo de decisiones y cambios
- π― Contexto preservado - La IA siempre tiene el contexto correcto para cada tarea
---
Cada skill estΓ‘ diseΓ±ada para un propΓ³sito especΓfico del ciclo de desarrollo:
| Comando | Skill | DescripciΓ³n |
|---------|-------|-------------|
| /opsx:onboard | Onboarding | Tutorial guiado para nuevos usuarios |
| /opsx:new | New Change | Crear cambio completo con proposal, specs, design y tasks |
| /opsx:continue | Continue Change | Retomar un cambio existente |
| /opsx:ff | Fast Forward | Crear todos los artefactos rΓ‘pidamente |
| /opsx:apply | Apply Change | Implementar tareas del cambio actual |
| /opsx:verify | Verify Change | Verificar completitud y calidad |
| /opsx:archive | Archive Change | Archivar cambio completado |
| /opsx:bulk-archive | Bulk Archive | Archivar mΓΊltiples cambios |
| /opsx:sync | Sync Specs | Sincronizar specs delta a principales |
| /opsx:explore | Explore | Modo exploraciΓ³n (pensar antes de actuar) |
El Skill Routing es una innovaciΓ³n clave de AC-Framework que proporciona:
- π― Contexto Contextualizado: Cada skill recibe solo el contexto relevante para su funciΓ³n
- π Enrutamiento AutomΓ‘tico: La IA sabe quΓ© skill usar segΓΊn el estado del proyecto
- π PreservaciΓ³n de Estado: El contexto se mantiene coherente entre skills
- β‘ OptimizaciΓ³n: Menor consumo de tokens al enviar solo contexto necesario
23+ Asistentes de IA soportados con el mismo conjunto de skills:
#### IDEs y Editores
- π Cursor - IDE con IA integrada
- π Windsurf - Editor AI-first
- π― Trae - IDE con asistente IA
- π Gemini - Google AI Studio
#### Herramientas CLI
- π© Claude Code - CLI de Anthropic
- π€ Codex - OpenAI Codex CLI
- π€ CodeBuddy - Asistente CLI
#### Extensiones VS Code
- π Continue.dev - ExtensiΓ³n de cΓ³digo abierto
- π¦
Cline - Asistente de codificaciΓ³n
- π¦ Roo Code - Fork de Cline
- π GitHub Copilot - Asistente de GitHub
#### Cloud y Otros
- βοΈ Amazon Q - AWS AI Assistant
- π Qwen - Alibaba Cloud
- β‘ Augment - Augment Code
- π§ OpenCode - Framework de cΓ³digo abierto
- Y 13 asistentes mΓ‘s...
---
``bashInstalar el CLI de AC-Framework
npm install -g ac-framework
$3
`bash
Instalar como dependencia de desarrollo
npm install --save-dev ac-frameworkEjecutar el inicializador
npx acfm init
`$3
`bash
acfm [opciones] [comando]Comandos:
init [options] Inicializar AC-Framework en el proyecto
help [command] Mostrar ayuda de un comando
Opciones:
-V, --version Mostrar versiΓ³n
-h, --help Mostrar ayuda
`---
ποΈ Estructura de Proyecto OpenSpec
Cuando inicializas AC-Framework, se crea la siguiente estructura:
`
openspec/
βββ config.yaml # ConfiguraciΓ³n global
βββ changes/ # Cambios activos
β βββ {nombre-cambio}/
β β βββ proposal.md # π Por QUΓ hacer el cambio
β β βββ design.md # π¨ CΓMO se implementarΓ‘
β β βββ tasks.md # β
Lista de tareas
β β βββ specs/
β β βββ {capability}/
β β βββ spec.md # π QUΓ cambia
β βββ archive/ # π¦ Cambios completados
β βββ YYYY-MM-DD-{nombre}/
βββ specs/ # Especificaciones principales
βββ {capability}/
βββ spec.md
`$3
Cada cambio OpenSpec incluye 4 artefactos fundamentales:
1. π proposal.md - JustificaciΓ³n y contexto del cambio
2. π¨ design.md - Arquitectura y enfoque de implementaciΓ³n
3. β
tasks.md - Checklist de tareas ejecutables
4. π specs/ - Especificaciones tΓ©cnicas detalladas
---
π Flujo de Trabajo
`
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π§ EXPLORAR (/opsx:explore) β
β Investigar, entender, planificar β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π NUEVO (/opsx:new) o (/opsx:ff) β
β β’ proposal.md β JustificaciΓ³n β
β β’ specs/ β Requisitos β
β β’ design.md β Arquitectura β
β β’ tasks.md β Plan de trabajo β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π¨ APLICAR (/opsx:apply) β
β Implementar y marcar tareas completadas β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β βοΈ VERIFICAR (/opsx:verify) β
β Revisar calidad y completitud β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ (opcional)
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π SINCRONIZAR (/opsx:sync) β
β Actualizar documentaciΓ³n principal β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π¦ ARCHIVAR (/opsx:archive) β
β Mover a archivo con fecha β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
`---
π οΈ Uso RΓ‘pido
$3
`bash
acfm init
`Selecciona los asistentes que usarΓ‘s (puedes elegir mΓΊltiples):
`
? ΒΏQuΓ© mΓ³dulos deseas instalar? (Selecciona con espacio)
β―β Cursor IDE
β― Claude Code
β― Continue.dev
β GitHub Copilot
β― ...
`$3
`
/opsx:new feature-user-authentication
`Esto crea:
-
openspec/changes/feature-user-authentication/proposal.md
- openspec/changes/feature-user-authentication/design.md
- openspec/changes/feature-user-authentication/tasks.md
- openspec/changes/feature-user-authentication/specs/auth/spec.md$3
`
/opsx:apply
`La IA implementarΓ‘ las tareas del archivo
tasks.md, marcΓ‘ndolas como completadas.$3
`
/opsx:verify
/opsx:archive
`---
`bash
Las skills estΓ‘n en:
framework/.{asistente}/skills/openspec-{nombre}/SKILL.mdEjemplo:
framework/.cursor/skills/openspec-new-change/SKILL.md
framework/.claude/skills/openspec-new-change/SKILL.md
framework/.opencode/skills/openspec-new-change/SKILL.md
``---
MIT Β© AC-Framework Team
---
π Desarrollo asistido por IA, estandarizado y potenciado
Trabaja con cualquier asistente, mantΓ©n el mismo flujo de trabajo