elsabro 2.2.0 → 3.7.0

package/scripts/setup-parallel-worktrees.sh

@@ -0,0 +1,319 @@
+#!/bin/bash
+# ELSABRO Parallel Worktrees Setup
+# Crea worktrees automaticos para ejecucion paralela de agentes
+#
+# Basado en: claude-productivity-plugin/scripts/setup-worktrees.sh
+# Adaptado para el sistema de agentes de ELSABRO
+
+set -e
+
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
+WORKTREE_BASE="${REPO_ROOT}/../elsabro-worktrees"
+
+# Colores
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Agentes disponibles en ELSABRO
+ELSABRO_AGENTS=("analyst" "executor" "verifier" "planner" "orchestrator")
+
+# Limite maximo de worktrees simultaneos
+MAX_WORKTREES=5
+
+print_header() {
+    echo ""
+    echo -e "${BLUE}========================================${NC}"
+    echo -e "${BLUE}   ELSABRO Parallel Worktrees Setup    ${NC}"
+    echo -e "${BLUE}========================================${NC}"
+    echo ""
+}
+
+check_git_repo() {
+    if ! git rev-parse --git-dir > /dev/null 2>&1; then
+        echo -e "${RED}Error: No estas en un repositorio git${NC}"
+        exit 1
+    fi
+}
+
+check_git_version() {
+    local git_version=$(git --version | grep -oE '[0-9]+\.[0-9]+' | head -1)
+    local major=$(echo "$git_version" | cut -d. -f1)
+    local minor=$(echo "$git_version" | cut -d. -f2)
+
+    if [ "$major" -lt 2 ] || ([ "$major" -eq 2 ] && [ "$minor" -lt 15 ]); then
+        echo -e "${RED}Error: Se requiere git >= 2.15 (tienes $git_version)${NC}"
+        exit 1
+    fi
+}
+
+# Crear directorio base si no existe
+ensure_worktree_base() {
+    if [ ! -d "$WORKTREE_BASE" ]; then
+        mkdir -p "$WORKTREE_BASE"
+        echo -e "${GREEN}Directorio base creado: ${WORKTREE_BASE}${NC}"
+    fi
+}
+
+# Contar worktrees activos
+count_active_worktrees() {
+    local count=$(git worktree list | grep -c "elsabro-worktrees" || echo "0")
+    echo "$count"
+}
+
+# Funcion para crear worktree para un agente
+create_agent_worktree() {
+    local agent_name="$1"
+    local worktree_path="${WORKTREE_BASE}/${agent_name}-wt"
+    local branch_name="elsabro/${agent_name}"
+
+    # Verificar limite de worktrees
+    local active=$(count_active_worktrees)
+    if [ "$active" -ge "$MAX_WORKTREES" ]; then
+        echo -e "${RED}Error: Limite de worktrees alcanzado (${MAX_WORKTREES})${NC}"
+        echo -e "${YELLOW}Usa 'cleanup' para liberar worktrees${NC}"
+        return 1
+    fi
+
+    # Si ya existe, limpiar
+    if [ -d "$worktree_path" ]; then
+        echo -e "${YELLOW}Limpiando worktree existente: ${agent_name}${NC}"
+        git worktree remove "$worktree_path" --force 2>/dev/null || true
+        git branch -D "$branch_name" 2>/dev/null || true
+    fi
+
+    # Crear branch desde HEAD actual
+    echo -e "${GREEN}Creando worktree: ${agent_name}${NC}"
+    git branch "$branch_name" HEAD 2>/dev/null || git branch -D "$branch_name" && git branch "$branch_name" HEAD
+    git worktree add "$worktree_path" "$branch_name"
+
+    echo -e "${GREEN}  Path: ${worktree_path}${NC}"
+    echo -e "${GREEN}  Branch: ${branch_name}${NC}"
+    echo "$worktree_path"
+}
+
+# Funcion para merge de worktree
+merge_agent_worktree() {
+    local agent_name="$1"
+    local branch_name="elsabro/${agent_name}"
+    local current_branch=$(git rev-parse --abbrev-ref HEAD)
+
+    # Verificar que la branch existe
+    if ! git show-ref --verify --quiet "refs/heads/${branch_name}"; then
+        echo -e "${RED}Error: Branch ${branch_name} no existe${NC}"
+        return 1
+    fi
+
+    # Verificar si hay cambios para mergear
+    local changes=$(git log "${current_branch}..${branch_name}" --oneline 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$changes" -eq 0 ]; then
+        echo -e "${YELLOW}No hay cambios en ${branch_name} para mergear${NC}"
+        return 0
+    fi
+
+    echo -e "${GREEN}Merging ${agent_name} into ${current_branch}${NC}"
+    echo -e "${BLUE}  Commits a mergear: ${changes}${NC}"
+
+    # Intentar merge
+    if git merge "$branch_name" --no-edit -m "Merge: ELSABRO ${agent_name} parallel work"; then
+        echo -e "${GREEN}  Merge exitoso${NC}"
+    else
+        echo -e "${RED}  Conflictos detectados. Resuelve manualmente.${NC}"
+        echo -e "${YELLOW}  Usa 'git merge --abort' para cancelar${NC}"
+        return 1
+    fi
+}
+
+# Funcion para cleanup de un agente especifico
+cleanup_agent_worktree() {
+    local agent_name="$1"
+    local worktree_path="${WORKTREE_BASE}/${agent_name}-wt"
+    local branch_name="elsabro/${agent_name}"
+
+    if [ -d "$worktree_path" ]; then
+        echo -e "${YELLOW}Eliminando worktree: ${agent_name}${NC}"
+        git worktree remove "$worktree_path" --force 2>/dev/null || true
+    fi
+
+    if git show-ref --verify --quiet "refs/heads/${branch_name}"; then
+        git branch -D "$branch_name" 2>/dev/null || true
+        echo -e "${GREEN}  Branch ${branch_name} eliminada${NC}"
+    fi
+}
+
+# Funcion para cleanup de todos los worktrees
+cleanup_worktrees() {
+    echo -e "${YELLOW}Limpiando worktrees de ELSABRO...${NC}"
+
+    # Limpiar por directorio
+    if [ -d "$WORKTREE_BASE" ]; then
+        for wt in "$WORKTREE_BASE"/*-wt; do
+            if [ -d "$wt" ]; then
+                local name=$(basename "$wt" | sed 's/-wt$//')
+                echo -e "${YELLOW}  Eliminando: ${name}${NC}"
+                git worktree remove "$wt" --force 2>/dev/null || true
+                git branch -D "elsabro/${name}" 2>/dev/null || true
+            fi
+        done
+
+        # Eliminar directorio base si esta vacio
+        rmdir "$WORKTREE_BASE" 2>/dev/null || true
+    fi
+
+    # Limpiar worktrees huerfanos
+    git worktree prune
+
+    echo -e "${GREEN}Worktrees limpiados${NC}"
+}
+
+# Funcion para mostrar status
+show_status() {
+    echo -e "${BLUE}Worktrees activos:${NC}"
+    git worktree list
+    echo ""
+
+    echo -e "${BLUE}Branches de ELSABRO:${NC}"
+    git branch --list "elsabro/*" 2>/dev/null || echo "  (ninguna)"
+    echo ""
+
+    local active=$(count_active_worktrees)
+    echo -e "${BLUE}Worktrees ELSABRO: ${active}/${MAX_WORKTREES}${NC}"
+}
+
+# Crear worktrees para todos los agentes de una wave
+create_wave_worktrees() {
+    local agents=("$@")
+
+    if [ ${#agents[@]} -eq 0 ]; then
+        echo -e "${RED}Error: Especifica los agentes para la wave${NC}"
+        return 1
+    fi
+
+    echo -e "${BLUE}Creando worktrees para wave: ${agents[*]}${NC}"
+
+    for agent in "${agents[@]}"; do
+        create_agent_worktree "$agent"
+    done
+
+    echo ""
+    show_status
+}
+
+# Merge y cleanup de una wave completa
+complete_wave() {
+    local agents=("$@")
+
+    if [ ${#agents[@]} -eq 0 ]; then
+        echo -e "${RED}Error: Especifica los agentes de la wave${NC}"
+        return 1
+    fi
+
+    echo -e "${BLUE}Completando wave: ${agents[*]}${NC}"
+
+    # Merge todos los agentes
+    for agent in "${agents[@]}"; do
+        merge_agent_worktree "$agent"
+    done
+
+    # Cleanup
+    for agent in "${agents[@]}"; do
+        cleanup_agent_worktree "$agent"
+    done
+
+    echo ""
+    echo -e "${GREEN}Wave completada${NC}"
+}
+
+# Mostrar ayuda
+show_help() {
+    echo "ELSABRO Parallel Worktrees"
+    echo ""
+    echo "Uso: $0 <comando> [argumentos]"
+    echo ""
+    echo "Comandos:"
+    echo "  create <agentes...>    Crear worktrees para agentes especificos"
+    echo "  merge <agentes...>     Merge branches de agentes al branch actual"
+    echo "  cleanup [agentes...]   Limpiar worktrees (todos si no se especifica)"
+    echo "  complete <agentes...>  Merge y cleanup de una wave"
+    echo "  status                 Mostrar estado de worktrees"
+    echo "  list                   Listar todos los worktrees (git worktree list)"
+    echo ""
+    echo "Agentes disponibles: ${ELSABRO_AGENTS[*]}"
+    echo ""
+    echo "Ejemplos:"
+    echo "  $0 create analyst executor verifier"
+    echo "  $0 merge analyst executor"
+    echo "  $0 complete analyst executor verifier"
+    echo "  $0 cleanup"
+    echo "  $0 status"
+    echo ""
+    echo "Limites:"
+    echo "  - Maximo ${MAX_WORKTREES} worktrees simultaneos"
+    echo "  - Requiere git >= 2.15"
+    echo "  - Worktrees en: ${WORKTREE_BASE}"
+}
+
+# Main
+main() {
+    check_git_repo
+    check_git_version
+    ensure_worktree_base
+
+    case "$1" in
+        create)
+            shift
+            if [ $# -eq 0 ]; then
+                echo -e "${RED}Error: Especifica al menos un agente${NC}"
+                echo "Agentes disponibles: ${ELSABRO_AGENTS[*]}"
+                exit 1
+            fi
+            for agent in "$@"; do
+                create_agent_worktree "$agent"
+            done
+            ;;
+        merge)
+            shift
+            if [ $# -eq 0 ]; then
+                echo -e "${RED}Error: Especifica al menos un agente${NC}"
+                exit 1
+            fi
+            for agent in "$@"; do
+                merge_agent_worktree "$agent"
+            done
+            ;;
+        cleanup)
+            shift
+            if [ $# -eq 0 ]; then
+                cleanup_worktrees
+            else
+                for agent in "$@"; do
+                    cleanup_agent_worktree "$agent"
+                done
+            fi
+            ;;
+        complete)
+            shift
+            complete_wave "$@"
+            ;;
+        status)
+            print_header
+            show_status
+            ;;
+        list)
+            git worktree list
+            ;;
+        help|--help|-h)
+            print_header
+            show_help
+            ;;
+        *)
+            print_header
+            show_help
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

package/skills/memory-update.md

@@ -0,0 +1,207 @@
+---
+name: memory-update
+description: Gestión de memoria persistente de ELSABRO - errores, patrones y notas
+trigger: /elsabro:memory
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+argument-hint: "[add|search|list] [contenido]"
+---
+
+# ELSABRO: Memory Update
+
+<objective>
+Gestionar la memoria persistente del proyecto. Claude recuerda errores corregidos,
+patrones preferidos y notas por feature entre sesiones.
+</objective>
+
+<triggers>
+## Activación Automática
+
+Claude DEBE detectar y actuar cuando el usuario dice:
+
+### Triggers de Corrección (→ mistakes.md)
+- "No, hazlo así..."
+- "No uses X, usa Y"
+- "Siempre usa X en lugar de Y"
+- "No vuelvas a hacer eso"
+- "Eso está mal, debería ser..."
+- "Error: deberías haber..."
+
+### Triggers de Patrón (→ patterns.md)
+- "Prefiero que los componentes se vean así..."
+- "Siempre estructura los archivos de esta forma..."
+- "Este es el patrón que quiero para..."
+- "Usa este template para..."
+
+### Triggers de Memoria General
+- "Guarda esto en tu memoria"
+- "Recuerda que prefiero..."
+- "No olvides que..."
+- "Anota esto para el futuro"
+
+### Triggers de Notas (→ notes/)
+- "Guarda esta nota sobre [feature]"
+- "Anota esto para la feature de..."
+- "Documenta esta decisión sobre..."
+</triggers>
+
+<auto_detection>
+## Proceso de Auto-Detección
+
+Cuando detectes un trigger de corrección:
+
+1. **RECONOCER** la corrección
+2. **EXTRAER** la regla general
+3. **CLASIFICAR** en categoría apropiada
+4. **GUARDAR** en el archivo correcto
+5. **CONFIRMAR** al usuario
+
+### Ejemplo de Flujo
+
+**Usuario:** "No, no uses `any`. Siempre usa tipos específicos en TypeScript"
+
+**Claude detecta:**
+- Trigger: "No, no uses" + "Siempre usa"
+- Categoría: TypeScript / Tipos
+- Regla: Evitar `any`, usar tipos específicos
+
+**Claude responde:**
+"Entendido. He guardado en `.planning/mistakes.md`:
+
+#### TypeScript: Evitar uso de `any`
+- **Fecha**: 2024-01-20
+- ❌ **Error**: Usar tipo `any`
+- ✅ **Corrección**: Usar tipos específicos (string, number, etc.)
+- **Regla**: Nunca usar `any` en TypeScript, siempre tipar explícitamente
+
+No volveré a usar `any` en este proyecto."
+</auto_detection>
+
+<commands>
+## Comandos Explícitos
+
+### /elsabro:memory add [tipo] [contenido]
+Agregar manualmente a la memoria.
+
+```
+/elsabro:memory add mistake "No usar console.log en producción"
+/elsabro:memory add pattern "Componentes con export default"
+/elsabro:memory add note auth "OAuth usa refresh tokens de 7 días"
+```
+
+### /elsabro:memory search [término]
+Buscar en toda la memoria.
+
+```
+/elsabro:memory search typescript
+→ Busca en mistakes.md, patterns.md, notes/*
+```
+
+### /elsabro:memory list [tipo]
+Listar contenido de memoria.
+
+```
+/elsabro:memory list mistakes    → Lista errores por categoría
+/elsabro:memory list patterns    → Lista patrones
+/elsabro:memory list notes       → Lista notas por feature
+```
+
+### /elsabro:memory clear [tipo] [id]
+Eliminar entrada específica.
+
+```
+/elsabro:memory clear mistake typescript-1
+```
+</commands>
+
+<file_structure>
+## Estructura de Archivos
+
+```
+.planning/
+├── CLAUDE.md           # Reglas de alto nivel (resumen)
+├── mistakes.md         # Errores corregidos (detalle)
+├── patterns.md         # Patrones preferidos
+└── notes/
+    ├── auth.md         # Notas sobre autenticación
+    ├── api.md          # Notas sobre API
+    └── [feature].md    # Una nota por feature
+```
+</file_structure>
+
+<format_mistake>
+## Formato de Error en mistakes.md
+
+```markdown
+#### [Categoría]: [Título Corto]
+- **Fecha**: YYYY-MM-DD
+- **Contexto**: [Dónde/cuándo ocurrió]
+- ❌ **Error**: [Lo que hizo mal]
+- ✅ **Corrección**: [Lo correcto]
+- **Regla**: [Regla general para recordar]
+```
+</format_mistake>
+
+<format_pattern>
+## Formato de Patrón en patterns.md
+
+```markdown
+## [Nombre del Patrón]
+
+**Uso**: [Cuándo usar este patrón]
+
+```[lenguaje]
+// Código del patrón
+```
+
+**Notas**:
+- [Consideración 1]
+- [Consideración 2]
+```
+</format_pattern>
+
+<format_note>
+## Formato de Nota en notes/
+
+```markdown
+# Notas: [Feature Name]
+
+## Decisiones
+- [Decisión 1]: [Razón]
+- [Decisión 2]: [Razón]
+
+## TODOs
+- [ ] [Tarea pendiente]
+
+## Referencias
+- [Link o archivo relevante]
+
+## Historial
+- YYYY-MM-DD: [Cambio o evento]
+```
+</format_note>
+
+<session_init>
+## Al Iniciar Sesión
+
+Claude DEBE leer automáticamente:
+1. `.planning/CLAUDE.md` (si existe)
+2. `.planning/mistakes.md` (si existe)
+3. `.planning/patterns.md` (si existe)
+
+Y aplicar las reglas/patrones en todo el trabajo de la sesión.
+</session_init>
+
+<enforcement>
+## Reglas de Enforcement
+
+1. **NUNCA** ignorar un trigger de corrección detectado
+2. **SIEMPRE** confirmar al usuario qué se guardó
+3. **NUNCA** guardar información sensible (passwords, tokens, etc.)
+4. **SIEMPRE** categorizar correctamente (mistake vs pattern vs note)
+5. **NUNCA** duplicar entradas - verificar si ya existe antes de agregar
+</enforcement>