claude-agent-framework 1.0.0

package/framework/templates/task-plan.md

@@ -0,0 +1,122 @@
+# Plan: {Título de la tarea}
+
+## Metadata
+task_path: `{task_path}`
+feature_id: `{feature_id}`
+created_at: `{timestamp}`
+status: `planned`
+
+## Análisis de Código Existente
+
+### Búsqueda Realizada
+{Lista de archivos y patrones encontrados relacionados con esta tarea}
+
+### Matriz de Impacto (OBLIGATORIO)
+
+| Componente | Archivo Existente | Líneas | Impacto |
+|------------|-------------------|--------|---------|
+| {componente 1} | {archivo} | {líneas} | CREAR/MODIFICAR/EXTENDER |
+| {componente 2} | {archivo} | {líneas} | CREAR/MODIFICAR/EXTENDER |
+
+**Archivos Nuevos Requeridos**: {count}
+**Archivos a Modificar**: {count}
+
+### Evaluación de Patrones
+
+{Describir patrones encontrados y cómo se seguirán:
+- Convenciones de naming
+- Estructura de archivos
+- Patrones de diseño en uso}
+
+### Matriz de Conflictos
+
+| Tipo | Recurso | Otra Tarea | Resolución |
+|------|---------|------------|------------|
+| {tipo} | {recurso} | {tarea} | {resolución} |
+
+**Conflictos Encontrados**: {count} (Si > 0, documentar resolución)
+
+## Resumen
+{Descripción clara de qué se va a implementar y cómo}
+
+## Historia de Usuario
+**Como** {tipo de usuario}
+**Quiero** {acción}
+**Para** {beneficio}
+
+## Archivos a Modificar
+- `{ruta/archivo1.rb}` - {razón de la modificación}
+- `{ruta/archivo2.rb}` - {razón de la modificación}
+
+## Archivos a Crear
+- `{ruta/nuevo1.rb}` - {propósito del archivo}
+- `{ruta/nuevo2.rb}` - {propósito del archivo}
+
+## Plan de Implementación
+
+### Fase 1: Fundamentos
+{Trabajo base necesario antes de la funcionalidad principal}
+
+### Fase 2: Implementación Principal
+{El núcleo de la funcionalidad}
+
+### Fase 3: Integración
+{Cómo se conecta con el resto del sistema}
+
+## Pasos de Implementación
+
+IMPORTANTE: Ejecutar cada paso en orden.
+
+### 0. Refactorización Previa (SI SE ENCONTRARON VIOLACIONES)
+
+**Saltar esta sección si no se encontraron violaciones de diseño**
+
+Para cada violación detectada:
+
+#### Violación 1: {descripción}
+- **Archivo fuente**: {archivo}:{líneas} - Acción: {MANTENER|ELIMINAR|MODIFICAR}
+- **Cambios específicos**:
+  - [ ] Eliminar líneas X-Y de {archivo}
+  - [ ] Mover lógica a {nuevo_archivo}
+  - [ ] Actualizar referencias
+
+### 1. {Nombre del paso}
+- {Subtarea detallada}
+- {Subtarea detallada}
+- {Comando o acción específica si aplica}
+
+### 2. {Nombre del paso}
+- {Subtarea detallada}
+- {Subtarea detallada}
+
+### 3. {Nombre del paso - Tests}
+- Crear tests para {funcionalidad}
+- Verificar criterios de aceptación
+
+### 4. Validación Final
+- Ejecutar comandos de validación
+- Verificar que todos los tests pasan
+
+## Criterios de Aceptación
+- [ ] {Criterio 1 del user-story}
+- [ ] {Criterio 2 del user-story}
+- [ ] {Criterio 3 del user-story}
+
+## Comandos de Validación
+
+```bash
+# Ejecutar tests
+bundle exec rspec
+
+# Verificar formato
+bundle exec standard
+
+# Verificar templates ERB
+bundle exec erblint --lint-all
+
+# Compilar assets
+yarn build
+```
+
+## Notas
+{Consideraciones adicionales, advertencias, o decisiones de diseño}

package/framework/templates/task-user-story.md

@@ -0,0 +1,52 @@
+# Tarea {ID}: {Título}
+
+## Metadata
+task_id: `{id}`
+feature_id: `{feature_id}`
+requisito: `RF-{XX}`
+created_at: `{timestamp}`
+status: `defined`
+priority: `{1-4}`
+
+## Análisis de Conflictos
+
+### Tareas Relacionadas
+{Lista de tareas de este u otros features que podrían afectar}
+
+### Matriz de Conflictos
+
+| Archivo/Recurso | Esta Tarea | Otra Tarea | Conflicto? |
+|-----------------|------------|------------|------------|
+| {archivo} | {acción} | {feature/tarea} | SÍ/NO |
+
+**Conflictos Encontrados**: {count} (Si > 0, documentar resolución)
+
+### Dependencias
+- **Requiere completar antes**: {lista de tareas o "ninguna"}
+- **Bloquea a**: {lista de tareas que dependen de esta}
+
+## Historia de Usuario
+**Como** {tipo de usuario}
+**Quiero** {acción o funcionalidad deseada}
+**Para** {beneficio o valor obtenido}
+
+## Criterios de Aceptación
+- [ ] {Criterio específico y verificable 1}
+- [ ] {Criterio específico y verificable 2}
+- [ ] {Criterio específico y verificable 3}
+- [ ] {Criterio específico y verificable 4}
+
+## Escenarios
+
+### Escenario 1: {Camino feliz}
+- **Dado** {estado inicial}
+- **Cuando** {acción del usuario}
+- **Entonces** {resultado esperado}
+
+### Escenario 2: {Caso alternativo o error}
+- **Dado** {estado inicial}
+- **Cuando** {acción que causa situación especial}
+- **Entonces** {cómo se maneja}
+
+## Notas
+{Contexto adicional, dependencias con otras tareas, consideraciones técnicas}

package/framework/templates/technical-spec.md

@@ -0,0 +1,260 @@
+# Technical Specification Template
+
+## Resumen
+
+| Campo | Valor |
+|-------|-------|
+| Título | [Nombre de la especificación] |
+| Autor | [Nombre] |
+| Fecha | [Fecha] |
+| Estado | Borrador / En revisión / Aprobado |
+| Versión | 1.0 |
+
+## Contexto
+
+### Problema
+[Descripción del problema que se está resolviendo]
+
+### Objetivos
+1. [Objetivo 1]
+2. [Objetivo 2]
+3. [Objetivo 3]
+
+### Alcance
+**Incluido:**
+- [Lo que está incluido]
+
+**Excluido:**
+- [Lo que NO está incluido]
+
+## Diseño Propuesto
+
+### Vista General
+
+```
+┌─────────────────────────────────────────────┐
+│           Diagrama de arquitectura           │
+│                                             │
+│  ┌─────────┐     ┌─────────┐     ┌───────┐ │
+│  │Component│ ──▶ │Component│ ──▶ │ Data  │ │
+│  │    A    │     │    B    │     │ Store │ │
+│  └─────────┘     └─────────┘     └───────┘ │
+│                                             │
+└─────────────────────────────────────────────┘
+```
+
+### Modelos de Datos
+
+#### Nuevo Modelo: `ModelName`
+
+```ruby
+# app/models/model_name.rb
+class ModelName < ApplicationRecord
+  # Associations
+  belongs_to :user
+  has_many :related_models
+
+  # Validations
+  validates :field, presence: true
+
+  # Scopes
+  scope :active, -> { where(active: true) }
+end
+```
+
+**Migración:**
+```ruby
+class CreateModelNames < ActiveRecord::Migration[8.0]
+  def change
+    create_table :model_names do |t|
+      t.references :user, null: false, foreign_key: true
+      t.string :field, null: false
+      t.boolean :active, default: true
+      t.timestamps
+    end
+
+    add_index :model_names, :field
+  end
+end
+```
+
+### API / Endpoints
+
+#### `POST /api/v1/resource`
+
+**Request:**
+```json
+{
+  "resource": {
+    "field": "value",
+    "other_field": "other_value"
+  }
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "resource": {
+    "id": 1,
+    "field": "value",
+    "created_at": "2024-01-15T10:30:00Z"
+  }
+}
+```
+
+**Errors:**
+| Código | Descripción |
+|--------|-------------|
+| 400 | Parámetros inválidos |
+| 401 | No autenticado |
+| 403 | No autorizado |
+| 422 | Error de validación |
+
+### Flujo de Usuario
+
+```
+1. Usuario accede a /feature
+   │
+2. Sistema muestra formulario
+   │
+3. Usuario completa y envía
+   │
+4. Sistema valida datos
+   │
+   ├── Si válido:
+   │   │
+   │   5. Guarda en BD
+   │   │
+   │   6. Envía email (async)
+   │   │
+   │   7. Redirige a confirmación
+   │
+   └── Si inválido:
+       │
+       5. Muestra errores
+       │
+       6. Usuario corrige
+```
+
+### Componentes de UI
+
+#### Nuevo Componente: [Nombre]
+
+```erb
+<%# app/views/shared/_component_name.html.erb %>
+<%# locals: (param1:, param2: nil) %>
+<div class="..." data-controller="component-name">
+  <!-- Contenido -->
+</div>
+```
+
+**Stimulus Controller:**
+```javascript
+// app/javascript/controllers/component_name_controller.js
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["element"]
+  static values = { config: Object }
+
+  connect() {
+    // Inicialización
+  }
+
+  action() {
+    // Lógica
+  }
+}
+```
+
+## Consideraciones
+
+### Seguridad
+- [ ] Autenticación requerida
+- [ ] Autorización implementada (Pundit)
+- [ ] Validación de inputs
+- [ ] Protección CSRF
+- [ ] Rate limiting (si aplica)
+
+### Rendimiento
+- [ ] Queries optimizadas
+- [ ] Índices de BD necesarios
+- [ ] Caching implementado (si aplica)
+- [ ] Jobs para operaciones lentas
+
+### Accesibilidad
+- [ ] Navegable por teclado
+- [ ] Labels en formularios
+- [ ] ARIA attributes donde sea necesario
+- [ ] Contraste adecuado
+
+### Testing
+
+**Tests necesarios:**
+```ruby
+# spec/models/model_name_spec.rb
+RSpec.describe ModelName, type: :model do
+  describe "validations" do
+    it { should validate_presence_of(:field) }
+  end
+end
+
+# spec/requests/resource_spec.rb
+RSpec.describe "Resource API", type: :request do
+  describe "POST /api/v1/resource" do
+    it "creates resource" do
+      # ...
+    end
+  end
+end
+```
+
+## Alternativas Consideradas
+
+### Alternativa 1: [Nombre]
+**Descripción:** [Breve descripción]
+**Pros:** [Ventajas]
+**Cons:** [Desventajas]
+**Razón de descarte:** [Por qué no se eligió]
+
+### Alternativa 2: [Nombre]
+**Descripción:** [Breve descripción]
+**Pros:** [Ventajas]
+**Cons:** [Desventajas]
+**Razón de descarte:** [Por qué no se eligió]
+
+## Plan de Implementación
+
+### Fase 1: [Nombre]
+- [ ] Tarea 1
+- [ ] Tarea 2
+
+### Fase 2: [Nombre]
+- [ ] Tarea 3
+- [ ] Tarea 4
+
+## Riesgos y Mitigación
+
+| Riesgo | Probabilidad | Impacto | Mitigación |
+|--------|--------------|---------|------------|
+| [Riesgo 1] | Alta/Media/Baja | Alto/Medio/Bajo | [Cómo mitigar] |
+
+## Métricas de Éxito
+
+- [ ] [Métrica 1]: [Valor objetivo]
+- [ ] [Métrica 2]: [Valor objetivo]
+
+## Referencias
+
+- [Enlace a documentación relevante]
+- [Enlace a diseños]
+- [Enlace a otras specs relacionadas]
+
+---
+
+## Historial de Revisiones
+
+| Versión | Fecha | Autor | Cambios |
+|---------|-------|-------|---------|
+| 1.0 | [Fecha] | [Autor] | Versión inicial |

package/framework/templates/user-story.md

@@ -0,0 +1,95 @@
+# User Story Template
+
+## Información General
+
+| Campo | Valor |
+|-------|-------|
+| ID | US-XXX |
+| Título | [Título descriptivo] |
+| Épica | [Épica a la que pertenece] |
+| Prioridad | Alta / Media / Baja |
+| Estimación | [Puntos o tiempo] |
+| Estado | Pendiente / En progreso / Completada |
+
+## Historia de Usuario
+
+**Como** [tipo de usuario],
+**quiero** [acción o funcionalidad],
+**para** [beneficio o razón].
+
+## Descripción Detallada
+
+[Explicación más extensa de la funcionalidad si es necesaria]
+
+## Criterios de Aceptación
+
+### Escenario 1: [Nombre del escenario]
+- **Dado** [contexto inicial]
+- **Cuando** [acción del usuario]
+- **Entonces** [resultado esperado]
+
+### Escenario 2: [Nombre del escenario]
+- **Dado** [contexto inicial]
+- **Cuando** [acción del usuario]
+- **Entonces** [resultado esperado]
+
+### Escenario 3: [Caso de error]
+- **Dado** [contexto inicial]
+- **Cuando** [acción incorrecta]
+- **Entonces** [manejo del error]
+
+## Mockups / Wireframes
+
+[Descripción visual o enlace a diseños]
+
+```
+┌─────────────────────────────────┐
+│  [Representación ASCII simple]  │
+│                                 │
+│  ┌─────────────────────────┐   │
+│  │     Elemento UI         │   │
+│  └─────────────────────────┘   │
+│                                 │
+└─────────────────────────────────┘
+```
+
+## Dependencias
+
+- [ ] US-YYY: [Descripción de dependencia]
+- [ ] [Otra dependencia técnica o de negocio]
+
+## Notas Técnicas
+
+### Modelos Afectados
+- `ModelName`: [cambios necesarios]
+
+### Controladores Afectados
+- `ControllerName`: [acciones a añadir/modificar]
+
+### Vistas Afectadas
+- `path/to/view`: [cambios necesarios]
+
+### Consideraciones
+- [Consideración técnica 1]
+- [Consideración técnica 2]
+
+## Definición de Done
+
+- [ ] Código implementado
+- [ ] Tests unitarios escritos
+- [ ] Tests de integración escritos
+- [ ] Code review completado
+- [ ] Funciona en móvil
+- [ ] Accesibilidad verificada
+- [ ] Documentación actualizada
+- [ ] Desplegado en staging
+
+## Notas Adicionales
+
+[Cualquier otra información relevante]
+
+---
+
+**Creada por:** [Nombre]
+**Fecha:** [Fecha de creación]
+**Última actualización:** [Fecha]

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "claude-agent-framework",
+  "version": "1.0.0",
+  "description": "Framework de agentes para desarrollo con Claude Code - Crea aplicaciones web y moviles sin conocimientos tecnicos",
+  "main": "src/cli.js",
+  "bin": {
+    "claude-framework": "./bin/claude-framework"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "framework/",
+    "project-templates/"
+  ],
+  "scripts": {
+    "test": "node bin/claude-framework --version"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "agents",
+    "rails",
+    "development",
+    "framework",
+    "cli",
+    "code-generation"
+  ],
+  "author": "agustincuenca",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agustincuenca/claude-agent-framework"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "chalk": "^4.1.2"
+  }
+}

package/project-templates/CLAUDE.md

@@ -0,0 +1,42 @@
+# Sistema de Agentes para Desarrollo de Software
+
+Soy tu equipo virtual de desarrollo. Puedo ayudarte a crear aplicaciones web y moviles completas, aunque no tengas conocimientos tecnicos. Solo cuentame tu idea y yo me encargo del resto.
+
+## Que puedo hacer por ti?
+
+- **Crear aplicaciones desde cero** - Cuentame tu idea y te hare preguntas para entenderla bien
+- **Anadir funcionalidades** - Dime que quieres que haga tu app y lo implemento
+- **Modificar cosas existentes** - Si algo no te gusta, lo cambiamos
+- **Probar que todo funciona** - Navego por tu app como si fuera un usuario real
+- **Explicarte cualquier cosa** - Si no entiendes algo tecnico, preguntame
+
+## Comandos disponibles
+
+Solo necesitas conocer **7 comandos**. El resto sucede automaticamente.
+
+| Comando | Que hace | Tambien puedes decir... |
+|---------|----------|------------------------|
+| `/nuevo` | Crear un proyecto desde cero | "Quiero crear una app...", "Tengo una idea..." |
+| `/anadir` | Anadir una funcionalidad | "Quiero anadir...", "Necesito que pueda..." |
+| `/cambiar` | Modificar algo existente | "Quiero cambiar...", "No me gusta como..." |
+| `/deshacer` | Volver atras | "Deshaz eso", "Dejalo como estaba" |
+| `/probar` | Probar que todo funciona | "Prueba la app", "Comprueba que funciona" |
+| `/estado` | Ver como va el proyecto | "Como vamos?", "Resumen" |
+| `/ayuda` | Ver que puedo hacer | "Ayuda", "Que puedes hacer?" |
+
+## Stack tecnologico
+
+Tu aplicacion se construira con tecnologias modernas y **100% gratuitas**:
+
+| Que | Tecnologia | Por que |
+|-----|------------|---------|
+| Backend | Ruby on Rails 8.1 | Framework completo y maduro |
+| Base de datos | SQLite3 | Simple, sin configuracion, gratis |
+| Estilos | Tailwind CSS | Diseno moderno sin CSS complejo |
+| Interactividad | Hotwire | Apps rapidas sin JavaScript complejo |
+| Movil | Hotwire Native | El mismo codigo funciona en iOS y Android |
+| Testing | RSpec | Tests automaticos para asegurar calidad |
+
+## Listo para empezar?
+
+Cuentame tu idea o escribe `/nuevo` para crear un proyecto!

package/project-templates/contexts/architecture.md

@@ -0,0 +1,25 @@
+# Arquitectura del Proyecto
+
+## Modelos
+
+*Se documentaran aqui los modelos y sus relaciones.*
+
+## Controllers
+
+*Se documentaran aqui los controllers principales.*
+
+## Decisiones Arquitectonicas
+
+### Patrones utilizados
+- MVC (Model-View-Controller)
+- Service Objects para logica compleja
+- Form Objects para formularios complejos
+
+### Convenciones
+- Codigo en ingles
+- Commits en espanol
+- Documentacion en espanol
+
+---
+
+*Este documento se actualiza por el Tech Lead.*

package/project-templates/contexts/conventions.md

@@ -0,0 +1,46 @@
+# Convenciones del Proyecto
+
+## Codigo
+
+### Nomenclatura
+- **Clases**: PascalCase (`UserAccount`)
+- **Metodos**: snake_case (`find_by_email`)
+- **Variables**: snake_case (`current_user`)
+- **Constantes**: SCREAMING_SNAKE_CASE (`MAX_RETRIES`)
+
+### Idioma
+- Codigo en **ingles**
+- Comentarios en **espanol** (cuando sean necesarios)
+- Commits en **espanol**
+
+## Git
+
+### Ramas
+- `main` - Produccion
+- `develop` - Desarrollo
+- `feature/xxx` - Nuevas funcionalidades
+- `fix/xxx` - Correcciones
+
+### Commits
+Formato: `tipo: descripcion breve`
+
+Tipos:
+- `feat`: Nueva funcionalidad
+- `fix`: Correccion de bug
+- `refactor`: Refactorizacion
+- `docs`: Documentacion
+- `test`: Tests
+- `chore`: Tareas de mantenimiento
+
+## Testing
+
+- Minimo 80% de cobertura
+- Tests unitarios para modelos y servicios
+- Tests de integracion para flujos criticos
+- Tests E2E para happy paths
+
+## Documentacion
+
+- README actualizado
+- Documentar decisiones arquitectonicas
+- API documentada con ejemplos