AC-Framework 🚀

🤖 Agentic Coding Framework
Framework basado en OpenSpec con sistema de Skills mejorado y Skill Routing inteligente para IA

---

📖 ¿Qué es AC-Framework?

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.

🎯 Filosofía OpenSpec

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

---

🚀 Características Principales

🎭 10 Skills Especializadas

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)

🧠 Sistema de Skill Routing

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

🌐 Multi-Asistente Sincronizado

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...

---

📦 Instalación

Instalación Global

# Instalar el CLI de AC-Framework
npm install -g ac-framework

# Inicializar en tu proyecto
acfm init

Instalación Local

# Instalar como dependencia de desarrollo
npm install --save-dev ac-framework

# Ejecutar el inicializador
npx acfm init

Uso del CLI

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

Artefactos de un Cambio

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

1. Inicializar Proyecto

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
  ◯ ...

2. Crear un Cambio

/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. Implementar

/opsx:apply

La IA implementará las tareas del archivo tasks.md, marcándolas como completadas.

4. Verificar y Archivar

/opsx:verify
/opsx:archive

---

# Las skills están en:
framework/.{asistente}/skills/openspec-{nombre}/SKILL.md

# Ejemplo:
framework/.cursor/skills/openspec-new-change/SKILL.md
framework/.claude/skills/openspec-new-change/SKILL.md
framework/.opencode/skills/openspec-new-change/SKILL.md

---

📝 Licencia

MIT © AC-Framework Team

---

🚀 Desarrollo asistido por IA, estandarizado y potenciado
Trabaja con cualquier asistente, mantén el mismo flujo de trabajo