workspace-v1/orchestration/analisis/PLAN-REFINADO-COMMIT-WORKSPACE-2026-01-10.md

# PLAN REFINADO - COMMIT COMPLETO WORKSPACE
**Fecha:** 2026-01-10
**Fase:** 5 - Refinamiento del Plan
**Estado:** LISTO PARA EJECUCION
**Referencias:**
- ANALISIS-COMMIT-COMPLETO-WORKSPACE-2026-01-10.md
- PLAN-COMMIT-COMPLETO-WORKSPACE-2026-01-10.md
- VALIDACION-PLAN-COMMIT-WORKSPACE-2026-01-10.md
- DEPENDENCIAS-COMMIT-WORKSPACE-2026-01-10.md

---

## 1. AJUSTES INCORPORADOS

### 1.1 Accion Correctiva Agregada
- **NUEVO Paso 1.0:** Desindexar `.claude/` del repositorio gamilit
- **Razon:** Archivos fueron rastreados antes de agregar regla a .gitignore

### 1.2 Validaciones Confirmadas
- Build Frontend: EXITOSO
- Dependencias: SIN CONFLICTOS
- Formato commits: APROBADO

---

## 2. SECUENCIA DE EJECUCION REFINADA

### ORDEN OBLIGATORIO:

```
REPOSITORIO: GAMILIT (projects/gamilit)
══════════════════════════════════════════════════════════════════

PASO 1.0: Desindexar .claude/ [NUEVO - CRITICO]
├── Comando: git rm --cached -r .claude/
├── Verificacion: git status NO muestra .claude/
└── Impacto: .claude/ excluido de futuros commits

PASO 1.1: Push commits existentes
├── Comando: git push origin master
├── Commits: 5 pendientes
└── Destino: github.com

PASO 1.2: Stage cambios backend y database
├── Comando: git add apps/backend/ apps/database/
├── Archivos: ~100 archivos
└── Exclusion: .claude/ (ya desindexado)

PASO 1.3: Commit gamilit
├── Mensaje: [MAINT-001] feat: Actualizacion integral backend
└── Incluye: Desindexacion de .claude/

PASO 1.4: Push nuevos commits
├── Comando: git push origin master
└── Destino: github.com

══════════════════════════════════════════════════════════════════

REPOSITORIO: WORKSPACE (workspace-v1)
══════════════════════════════════════════════════════════════════

PASO 2.1: Stage archivos orchestration
├── Comando: git add orchestration/
└── Incluye: directivas, perfiles, inventarios, analisis

PASO 2.2: Stage knowledge base y submodulo
├── Comando: git add shared/knowledge-base/ projects/gamilit
└── Incluye: README actualizado, referencia submodulo

PASO 2.3: Commit workspace
├── Mensaje: [MAINT-001] docs(orchestration): Actualizacion completa
└── Incluye: Todos los documentos de analisis

PASO 2.4: Push workspace
├── Comando: git push origin develop
└── Destino: gitea-server

══════════════════════════════════════════════════════════════════
```

---

## 3. COMANDOS DE EJECUCION DETALLADOS

### 3.1 GAMILIT - Ejecucion Completa

```bash
# Navegar al directorio
cd /home/isem/workspace-v1/projects/gamilit

# ═══════════════════════════════════════════════════════════════
# PASO 1.0: DESINDEXAR .claude/ (CRITICO)
# ═══════════════════════════════════════════════════════════════
git rm --cached -r .claude/

# Verificar que .claude/ ya no aparece como modificado
git status | grep ".claude"
# Resultado esperado: Solo muestra "deleted: .claude/*" en staged

# ═══════════════════════════════════════════════════════════════
# PASO 1.1: PUSH COMMITS EXISTENTES
# ═══════════════════════════════════════════════════════════════
git push origin master

# Verificar push exitoso
git status
# Resultado esperado: "Your branch is up to date with 'origin/master'"

# ═══════════════════════════════════════════════════════════════
# PASO 1.2: STAGE CAMBIOS
# ═══════════════════════════════════════════════════════════════
# Stage cambios de backend (excluye .claude/ automaticamente)
git add apps/backend/src/modules/
git add apps/database/

# Verificar archivos staged
git diff --cached --name-only | head -20

# ═══════════════════════════════════════════════════════════════
# PASO 1.3: COMMIT
# ═══════════════════════════════════════════════════════════════
git commit -m "$(cat <<'EOF'
[MAINT-001] feat: Actualizacion integral de modulos backend y database

Cambios incluidos:
- Admin: Controllers, DTOs, Services y Entities actualizados
- Auth: Mejoras en auth.service
- Educational: Actualizacion exercises controller y DTOs
- Gamification: Actualizacion achievements controller y services
- Notifications: Mejoras en controller y module
- Progress: DTOs de answers, entities y services actualizados
- Social: Mejoras en classrooms.service
- Teacher: Controllers y services actualizados
- WebSocket: Types, module y service actualizados
- Shared: Constants y DTOs actualizados
- Database: Script create-database.sh actualizado

Exclusiones aplicadas:
- .claude/ removido del indice (configuracion local)

Build Status: VERIFIED
Dependencies: NO CONFLICTS
EOF
)"

# ═══════════════════════════════════════════════════════════════
# PASO 1.4: PUSH
# ═══════════════════════════════════════════════════════════════
git push origin master

# Verificar estado final
git status
git log --oneline -3
```

### 3.2 WORKSPACE - Ejecucion Completa

```bash
# Navegar al directorio
cd /home/isem/workspace-v1

# ═══════════════════════════════════════════════════════════════
# PASO 2.1: STAGE ORCHESTRATION
# ═══════════════════════════════════════════════════════════════
git add orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml
git add orchestration/agents/perfiles/
git add orchestration/directivas/simco/
git add orchestration/inventarios/
git add orchestration/analisis/
git add orchestration/reportes/

# ═══════════════════════════════════════════════════════════════
# PASO 2.2: STAGE KNOWLEDGE BASE Y SUBMODULO
# ═══════════════════════════════════════════════════════════════
git add shared/knowledge-base/projects/gamilit/README.md
git add projects/gamilit

# Verificar archivos staged
git diff --cached --name-only

# ═══════════════════════════════════════════════════════════════
# PASO 2.3: COMMIT
# ═══════════════════════════════════════════════════════════════
git commit -m "$(cat <<'EOF'
[MAINT-001] docs(orchestration): Actualizacion directivas SIMCO, perfiles y documentacion

Cambios incluidos:
- INDICE-DIRECTIVAS-WORKSPACE.yml actualizado
- Perfiles de agentes: PERFIL-ML.md, PERFIL-SECURITY.md
- Directivas SIMCO actualizadas:
  - SIMCO-ASIGNACION-PERFILES.md
  - SIMCO-CCA-SUBAGENTE.md
  - SIMCO-CONTEXT-ENGINEERING.md
  - SIMCO-CONTEXT-RESOLUTION.md
  - SIMCO-DELEGACION-PARALELA.md
- Inventarios actualizados: DEVENV-MASTER, DEVENV-PORTS
- Documentos de analisis agregados (commit workflow)
- Reportes de ejecucion agregados
- Knowledge base gamilit README actualizado
- Referencia submodulo gamilit actualizada

Validaciones:
- Plan validado contra directivas SIMCO-GIT
- Dependencias verificadas
- Build gamilit: EXITOSO
EOF
)"

# ═══════════════════════════════════════════════════════════════
# PASO 2.4: PUSH
# ═══════════════════════════════════════════════════════════════
git push origin develop

# Verificar estado final
git status
git log --oneline -3
git submodule status
```

---

## 4. CHECKLIST DE EJECUCION

### 4.1 Pre-Ejecucion Gamilit
- [ ] Verificar branch actual es `master`
- [ ] Verificar conexion a github.com
- [ ] .claude/ tiene 28 archivos en indice

### 4.2 Ejecucion Gamilit
- [ ] PASO 1.0: git rm --cached -r .claude/ ejecutado
- [ ] PASO 1.0: .claude/ ya no aparece en status como modificado
- [ ] PASO 1.1: Push de 5 commits existentes exitoso
- [ ] PASO 1.2: Archivos backend staged
- [ ] PASO 1.3: Commit creado con mensaje correcto
- [ ] PASO 1.4: Push exitoso

### 4.3 Pre-Ejecucion Workspace
- [ ] Verificar branch actual es `develop`
- [ ] Verificar conexion a gitea-server
- [ ] Referencia gamilit actualizada

### 4.4 Ejecucion Workspace
- [ ] PASO 2.1: Archivos orchestration staged
- [ ] PASO 2.2: Knowledge base y submodulo staged
- [ ] PASO 2.3: Commit creado con mensaje correcto
- [ ] PASO 2.4: Push exitoso

---

## 5. CRITERIOS DE EXITO

| Criterio | Verificacion |
|----------|--------------|
| .claude/ excluido | `git ls-files .claude/` retorna vacio |
| Gamilit commits pusheados | `git log origin/master..HEAD` vacio |
| Workspace commit pusheado | `git log origin/develop..HEAD` vacio |
| No hay cambios pendientes | `git status` limpio en ambos repos |
| Submodulo sincronizado | `git submodule status` sin + prefix |

---

## 6. ROLLBACK SI ES NECESARIO

### Si falla en Gamilit:
```bash
# Revertir desindexacion de .claude/
git reset HEAD .claude/

# Revertir ultimo commit (si se hizo)
git reset --soft HEAD~1

# Revertir push (NO RECOMENDADO - solo emergencia)
# git push --force origin master  # PELIGROSO
```

### Si falla en Workspace:
```bash
# Revertir ultimo commit
git reset --soft HEAD~1

# Limpiar staging
git reset HEAD
```

---

## 7. ESTIMACION DE ARCHIVOS

| Repositorio | Tipo | Cantidad |
|-------------|------|----------|
| Gamilit | Desindexados (.claude/) | 28 |
| Gamilit | Modificados (backend) | ~100 |
| Gamilit | TOTAL | ~128 |
| Workspace | Modificados | 12 |
| Workspace | Nuevos (analisis) | 60+ |
| Workspace | TOTAL | ~72 |
| **TOTAL GENERAL** | | **~200** |

---

**Plan refinado y listo para ejecucion**
**Siguiente fase:** EJECUCION