claude-agent-framework 1.0.0

package/project-templates/contexts/design-system.md

@@ -0,0 +1,47 @@
+# Design System
+
+## Colores
+
+### Primarios
+- Primary: [Por definir]
+- Secondary: [Por definir]
+
+### Neutros
+- Background: #ffffff
+- Text: #1a1a1a
+- Border: #e5e5e5
+
+### Estados
+- Success: #22c55e
+- Warning: #f59e0b
+- Error: #ef4444
+- Info: #3b82f6
+
+## Tipografia
+
+### Fuentes
+- Headings: System UI
+- Body: System UI
+- Mono: Monospace
+
+### Escalas
+- xs: 0.75rem
+- sm: 0.875rem
+- base: 1rem
+- lg: 1.125rem
+- xl: 1.25rem
+- 2xl: 1.5rem
+- 3xl: 1.875rem
+- 4xl: 2.25rem
+
+## Espaciado
+
+Usar escala de Tailwind: 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24...
+
+## Componentes
+
+*Se documentaran aqui los componentes reutilizables.*
+
+---
+
+*Este documento se actualiza por el Design Lead.*

package/project-templates/contexts/requirements.md

@@ -0,0 +1,38 @@
+# Requisitos del Proyecto
+
+## Informacion General
+
+| Campo | Valor |
+|-------|-------|
+| Nombre del proyecto | [Por definir] |
+| Descripcion | [Por definir] |
+| Fecha de inicio | [Por definir] |
+| Estado | No iniciado |
+
+## Usuarios
+
+### Tipos de usuario
+- [Por definir]
+
+### Necesidades principales
+- [Por definir]
+
+## Funcionalidades
+
+### MVP (Minimo Producto Viable)
+1. [Por definir]
+
+### Futuras mejoras
+- [Por definir]
+
+## Restricciones
+
+### Tecnicas
+- [Por definir]
+
+### De negocio
+- [Por definir]
+
+---
+
+*Este documento se actualiza durante el discovery con el Product Owner.*

package/project-templates/contexts/stack.md

@@ -0,0 +1,30 @@
+# Stack Tecnologico
+
+## Backend
+- **Framework**: Ruby on Rails 8.1
+- **Base de datos**: SQLite3
+- **Jobs en segundo plano**: Solid Queue
+- **Cache**: Solid Cache
+
+## Frontend
+- **Estilos**: Tailwind CSS
+- **Interactividad**: Hotwire (Turbo + Stimulus)
+- **Componentes**: ViewComponent
+
+## Movil
+- **Framework**: Hotwire Native
+- **Plataformas**: iOS, Android
+
+## Testing
+- **Framework**: RSpec
+- **Factories**: FactoryBot
+- **E2E**: Capybara
+
+## Autenticacion y Autorizacion
+- **Autenticacion**: Rails 8 Authentication Generator
+- **Autorizacion**: Pundit
+
+## Otros
+- **Archivos**: Active Storage
+- **Emails**: Action Mailer
+- **Tiempo real**: Action Cable

package/project-templates/history/active/models.md

@@ -0,0 +1,11 @@
+# Modelos Actuales
+
+*Lista de modelos implementados en el proyecto.*
+
+## User
+
+*Por implementar*
+
+---
+
+*Este archivo refleja el estado actual de los modelos.*

package/project-templates/history/changelog.md

@@ -0,0 +1,15 @@
+# Changelog
+
+Registro de todos los cambios realizados en el proyecto.
+
+---
+
+## [Fecha] - Inicio del proyecto
+
+- **Tipo**: Inicializacion
+- **Descripcion**: Proyecto creado con claude-agent-framework
+- **Archivos**: Estructura inicial
+
+---
+
+*Este archivo se actualiza automaticamente con cada cambio.*

package/src/cli.js

@@ -0,0 +1,52 @@
+const { program } = require('commander');
+const pkg = require('../package.json');
+const init = require('./init');
+const update = require('./update');
+const status = require('./status');
+
+program
+  .name('claude-framework')
+  .description('Framework de agentes para desarrollo con Claude Code')
+  .version(pkg.version);
+
+program
+  .command('init')
+  .description('Inicializa el framework en el directorio actual')
+  .option('-f, --force', 'Sobrescribir si ya existe .claude/')
+  .option('-d, --dir <path>', 'Directorio destino (default: directorio actual)')
+  .action(async (options) => {
+    try {
+      await init(options);
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('update')
+  .description('Actualiza el framework a la ultima version')
+  .option('-f, --force', 'Forzar reinstalacion aunque sea la misma version')
+  .option('-b, --backup', 'Crear backup antes de actualizar')
+  .action(async (options) => {
+    try {
+      await update(options);
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('status')
+  .description('Muestra la version instalada del framework')
+  .action(async () => {
+    try {
+      await status();
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/init.js

@@ -0,0 +1,104 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+const FRAMEWORK_DIRS = ['agents', 'sub-agents', 'skills', 'commands', 'templates'];
+const PROJECT_DIRS = ['contexts', 'history', 'history/active', 'workspace'];
+
+async function init(options = {}) {
+  const targetDir = options.dir || process.cwd();
+  const claudeDir = path.join(targetDir, '.claude');
+
+  console.log(chalk.blue('Inicializando claude-agent-framework...'));
+
+  // Verificar si ya existe
+  if (fs.existsSync(claudeDir) && !options.force) {
+    throw new Error(
+      '.claude/ ya existe. Usa --force para sobrescribir el framework (no tocara tus contexts/history).'
+    );
+  }
+
+  // Crear directorio .claude si no existe
+  await fs.ensureDir(claudeDir);
+
+  // Obtener ruta del paquete instalado
+  const packageRoot = path.join(__dirname, '..');
+  const frameworkSrc = path.join(packageRoot, 'framework');
+  const templatesSrc = path.join(packageRoot, 'project-templates');
+
+  // Copiar framework (siempre sobrescribe)
+  console.log(chalk.gray('  Copiando framework...'));
+  for (const dir of FRAMEWORK_DIRS) {
+    const src = path.join(frameworkSrc, dir);
+    const dest = path.join(claudeDir, dir);
+    if (fs.existsSync(src)) {
+      await fs.copy(src, dest);
+      console.log(chalk.gray(`    + ${dir}/`));
+    }
+  }
+
+  // Copiar templates de proyecto (solo si no existen)
+  console.log(chalk.gray('  Creando estructura de proyecto...'));
+  for (const dir of PROJECT_DIRS) {
+    const dest = path.join(claudeDir, dir);
+    if (!fs.existsSync(dest)) {
+      await fs.ensureDir(dest);
+      console.log(chalk.gray(`    + ${dir}/`));
+    }
+  }
+
+  // Copiar archivos de contexto template (solo si no existen)
+  const contextsSrc = path.join(templatesSrc, 'contexts');
+  const contextsDest = path.join(claudeDir, 'contexts');
+  if (fs.existsSync(contextsSrc)) {
+    const files = await fs.readdir(contextsSrc);
+    for (const file of files) {
+      const destFile = path.join(contextsDest, file);
+      if (!fs.existsSync(destFile)) {
+        await fs.copy(path.join(contextsSrc, file), destFile);
+        console.log(chalk.gray(`    + contexts/${file}`));
+      }
+    }
+  }
+
+  // Copiar CLAUDE.md template (solo si no existe)
+  const claudeMdSrc = path.join(templatesSrc, 'CLAUDE.md');
+  const claudeMdDest = path.join(targetDir, 'CLAUDE.md');
+  if (fs.existsSync(claudeMdSrc) && !fs.existsSync(claudeMdDest)) {
+    await fs.copy(claudeMdSrc, claudeMdDest);
+    console.log(chalk.gray('    + CLAUDE.md'));
+  }
+
+  // Crear features/ si no existe
+  const featuresDir = path.join(targetDir, 'features');
+  if (!fs.existsSync(featuresDir)) {
+    await fs.ensureDir(featuresDir);
+    await fs.writeFile(path.join(featuresDir, '.gitkeep'), '');
+    console.log(chalk.gray('    + features/'));
+  }
+
+  // Guardar version del framework
+  const pkg = require('../package.json');
+  await fs.writeJson(path.join(claudeDir, '.framework-version.json'), {
+    version: pkg.version,
+    installedAt: new Date().toISOString()
+  }, { spaces: 2 });
+
+  console.log('');
+  console.log(chalk.green(`Framework v${pkg.version} instalado correctamente.`));
+  console.log('');
+  console.log('Estructura creada:');
+  console.log(chalk.cyan('  .claude/'));
+  console.log(chalk.cyan('  ├── agents/        ') + chalk.gray('# Agentes principales (PO, Tech Lead, Design Lead)'));
+  console.log(chalk.cyan('  ├── sub-agents/    ') + chalk.gray('# Sub-agentes especializados'));
+  console.log(chalk.cyan('  ├── skills/        ') + chalk.gray('# Capacidades tecnicas'));
+  console.log(chalk.cyan('  ├── commands/      ') + chalk.gray('# Comandos disponibles'));
+  console.log(chalk.cyan('  ├── templates/     ') + chalk.gray('# Plantillas de documentos'));
+  console.log(chalk.cyan('  ├── contexts/      ') + chalk.gray('# Contexto de tu proyecto'));
+  console.log(chalk.cyan('  ├── history/       ') + chalk.gray('# Historial de cambios'));
+  console.log(chalk.cyan('  └── workspace/     ') + chalk.gray('# Archivos de trabajo'));
+  console.log('');
+  console.log('Siguiente paso: Abre Claude Code y escribe tu idea!');
+}
+
+module.exports = init;

package/src/status.js

@@ -0,0 +1,75 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+async function status() {
+  const claudeDir = path.join(process.cwd(), '.claude');
+  const versionFile = path.join(claudeDir, '.framework-version.json');
+  const pkg = require('../package.json');
+
+  console.log(chalk.blue('claude-agent-framework'));
+  console.log('');
+
+  // Version del CLI instalado globalmente
+  console.log(`CLI version:       ${chalk.cyan(pkg.version)}`);
+
+  // Version del framework en este proyecto
+  if (!fs.existsSync(claudeDir)) {
+    console.log(`Proyecto:          ${chalk.yellow('No inicializado')}`);
+    console.log('');
+    console.log('Ejecuta: claude-framework init');
+    return;
+  }
+
+  if (!fs.existsSync(versionFile)) {
+    console.log(`Proyecto:          ${chalk.yellow('Version desconocida (pre-CLI)')}`);
+    console.log('');
+    console.log('Ejecuta: claude-framework update');
+    return;
+  }
+
+  const data = await fs.readJson(versionFile);
+
+  console.log(`Proyecto version:  ${chalk.cyan(data.version)}`);
+  console.log(`Instalado:         ${chalk.gray(new Date(data.installedAt).toLocaleString())}`);
+
+  if (data.previousVersion) {
+    console.log(`Version anterior:  ${chalk.gray(data.previousVersion)}`);
+  }
+
+  console.log('');
+
+  // Comparar versiones
+  if (data.version === pkg.version) {
+    console.log(chalk.green('El framework esta actualizado.'));
+  } else {
+    console.log(chalk.yellow(`Actualizacion disponible: v${data.version} -> v${pkg.version}`));
+    console.log('Ejecuta: claude-framework update');
+  }
+
+  // Mostrar estructura
+  console.log('');
+  console.log('Estructura del proyecto:');
+
+  const dirs = [
+    { name: 'agents', desc: 'Agentes principales', isFramework: true },
+    { name: 'sub-agents', desc: 'Sub-agentes', isFramework: true },
+    { name: 'skills', desc: 'Capacidades tecnicas', isFramework: true },
+    { name: 'commands', desc: 'Comandos', isFramework: true },
+    { name: 'templates', desc: 'Plantillas', isFramework: true },
+    { name: 'contexts', desc: 'Tu contexto', isFramework: false },
+    { name: 'history', desc: 'Tu historial', isFramework: false },
+    { name: 'workspace', desc: 'Tu workspace', isFramework: false }
+  ];
+
+  for (const dir of dirs) {
+    const dirPath = path.join(claudeDir, dir.name);
+    const exists = fs.existsSync(dirPath);
+    const icon = exists ? chalk.green('✓') : chalk.red('✗');
+    const label = dir.isFramework ? chalk.cyan(dir.name) : chalk.white(dir.name);
+    const tag = dir.isFramework ? chalk.gray('[framework]') : chalk.gray('[proyecto]');
+    console.log(`  ${icon} ${label.padEnd(20)} ${tag}`);
+  }
+}
+
+module.exports = status;

package/src/update.js

@@ -0,0 +1,88 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+const FRAMEWORK_DIRS = ['agents', 'sub-agents', 'skills', 'commands', 'templates'];
+
+async function update(options = {}) {
+  const targetDir = process.cwd();
+  const claudeDir = path.join(targetDir, '.claude');
+
+  // Verificar que existe .claude/
+  if (!fs.existsSync(claudeDir)) {
+    throw new Error(
+      'No se encontro .claude/ en este directorio.\n' +
+      'Ejecuta primero: claude-framework init'
+    );
+  }
+
+  // Leer version actual
+  const versionFile = path.join(claudeDir, '.framework-version.json');
+  let currentVersion = '0.0.0';
+  let installedAt = 'desconocido';
+
+  if (fs.existsSync(versionFile)) {
+    const data = await fs.readJson(versionFile);
+    currentVersion = data.version;
+    installedAt = data.installedAt;
+  }
+
+  const pkg = require('../package.json');
+
+  console.log(chalk.blue('Actualizando claude-agent-framework...'));
+  console.log(chalk.gray(`  Version actual: ${currentVersion}`));
+  console.log(chalk.gray(`  Version nueva:  ${pkg.version}`));
+
+  // Verificar si ya tiene la version actual
+  if (currentVersion === pkg.version && !options.force) {
+    console.log('');
+    console.log(chalk.yellow('Ya tienes la ultima version.'));
+    console.log(chalk.gray('Usa --force para reinstalar.'));
+    return;
+  }
+
+  // Crear backup si se solicita
+  if (options.backup) {
+    const backupDir = path.join(claudeDir, `.backup-${currentVersion}-${Date.now()}`);
+    console.log(chalk.gray(`  Creando backup en ${path.basename(backupDir)}...`));
+
+    for (const dir of FRAMEWORK_DIRS) {
+      const src = path.join(claudeDir, dir);
+      if (fs.existsSync(src)) {
+        await fs.copy(src, path.join(backupDir, dir));
+      }
+    }
+  }
+
+  // Obtener ruta del paquete
+  const packageRoot = path.join(__dirname, '..');
+  const frameworkSrc = path.join(packageRoot, 'framework');
+
+  // Actualizar SOLO las carpetas del framework
+  console.log(chalk.gray('  Actualizando framework...'));
+  for (const dir of FRAMEWORK_DIRS) {
+    const src = path.join(frameworkSrc, dir);
+    const dest = path.join(claudeDir, dir);
+    if (fs.existsSync(src)) {
+      await fs.remove(dest);
+      await fs.copy(src, dest);
+      console.log(chalk.gray(`    ~ ${dir}/`));
+    }
+  }
+
+  // NO tocar: contexts/, history/, workspace/, settings.local.json
+  console.log(chalk.gray('  Manteniendo intactos: contexts/, history/, workspace/'));
+
+  // Actualizar version
+  await fs.writeJson(versionFile, {
+    version: pkg.version,
+    installedAt: new Date().toISOString(),
+    previousVersion: currentVersion,
+    previousInstalledAt: installedAt
+  }, { spaces: 2 });
+
+  console.log('');
+  console.log(chalk.green(`Actualizado de v${currentVersion} a v${pkg.version}`));
+}
+
+module.exports = update;