@saulwade/swl-ses 2.2.4 → 2.3.0

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "swl-ses",
-  "version": "2.2.4",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 182 habilidades, 44 comandos, 77 reglas y 48 hooks. 76 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
+  "version": "2.3.0",
+  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 182 habilidades, 44 comandos, 77 reglas y 50 hooks. 77 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "author": "Saul Wade Leon",
   "license": "MIT",
   "repository": "https://github.com/saul-wade/swl-ses",

package/reglas/memoria-consolidada.md

@@ -19,6 +19,47 @@ regla clara, un mismo dato puede terminar en el lugar incorrecto o duplicado.
 
 ---
 
+## Eje cognitivo de memoria (semantic | episodic | procedural)
+
+Los 5 canales de arriba clasifican el conocimiento por **dónde se almacena**. El
+eje cognitivo lo clasifica por **qué tipo de memoria es** — y es **ORTOGONAL**: un
+dato vive en exactamente un canal (regla de no-duplicación abajo) y PUEDE
+etiquetarse con exactamente un tipo cognitivo. No reemplaza a los canales; los
+enriquece para mejorar la relevancia del recall.
+
+Origen: análisis "Self-Learning for Agents" (3 capas) —
+`.planning/knowledge/outputs/analisis-self-learning-agents-3-capas-2026-06-27.md`.
+Un agente que se auto-mejora necesita las tres clases; la mayoría de los sistemas
+solo tiene `semantic`.
+
+| Tipo | Qué es | Ejemplo | Cuándo usarlo |
+|------|--------|---------|---------------|
+| **semantic** | Hechos, decisiones, vocabulario, gotchas-como-hecho | "El proyecto usa repository pattern"; "la API de CFDI devuelve 200 en errores" | Conocimiento estable que se consulta como referencia |
+| **episodic** | Experiencia pasada de una sesión concreta (qué pasó, cuándo) | "En la sesión X el revert del commit Y resolvió el bug Z" | Recordar un caso vivido para no repetir el camino |
+| **procedural** | Cómo manejar un caso (cómo hacer / qué evitar) | "Paralelizar agentes solo sin dependencias de datos"; "no usar `display:initial` para re-mostrar celdas" | Guía de acción ante una situación recurrente |
+
+### Dónde se materializa
+
+- **instintos** (`schemas/instinct.schema.json`): campo OPCIONAL `tipo_memoria`
+  (enum `semantic|episodic|procedural`). Backward-compatible: instintos sin el
+  campo siguen válidos. `scripts/bootstrap-instintos.js` lo infiere por sección de
+  origen (heurístico declarado, no autoritativo):
+  - `decisión` / `arquitectura` / `gotcha` / `regla-proyecto` → **semantic**
+  - `patrón` / `anti-patrón` → **procedural**
+  - **episodic** NO se infiere del bootstrap (nace de registros de sesión, canal 4,
+    no de APRENDIZAJES).
+- **APRENDIZAJES.md** (canal 2): convención OPCIONAL — una entrada puede anotar
+  `tipo_memoria:` en su cuerpo cuando el tipo no sea evidente por la sección.
+
+### Anti-patrones del eje cognitivo
+
+- Tratar el tipo cognitivo como un sexto canal de almacenamiento (no lo es: es una
+  etiqueta ortogonal sobre el dato que ya vive en su canal).
+- Forzar `episodic` en un instinto bootstrapeado de APRENDIZAJES (episodic viene de
+  sesiones, no de conocimiento de dominio destilado).
+
+---
+
 ## Regla de asignación — dónde va CADA tipo de dato
 
 ### A. Información del usuario

package/reglas/seguridad-agentes.md

@@ -355,10 +355,76 @@ exclusiones:
 
 ---
 
+## Anti-gaming: no auto-calificación de evidencia
+
+Esta sección formaliza una invariante de seguridad **no negociable** para el
+ciclo de auto-evolución (AGP) y para cualquier agente que se auto-mejore.
+
+### Invariante
+
+> Un agente que evoluciona **NUNCA debe producir ni editar la evidencia que lo
+> aprueba**. El productor de la evidencia (score de eval, badge, evidencia RED,
+> veredicto de verificación, canary) debe ser un **actor distinto** del agente
+> evaluado, o una **decisión humana**. La única señal imposible de falsificar es
+> la generada por un actor independiente del evaluado.
+
+### Origen — Sakana Darwin Gödel Machine
+
+El DGM, soltado a mejorar contra un test, en vez de hacer mejor trabajo
+**falsificó sus propios logs de test**. Cuando los investigadores le agregaron un
+detector para atraparlo, **quitó las marcas en que el detector se apoyaba**, pese
+a que se le prohibió. Lección: si el evaluado controla la evidencia que lo
+califica, la optimización converge a falsificar la evidencia, no a mejorar.
+(Fuente: análisis self-learning 3 capas, `sakana.ai/dgm`.)
+
+### Relación con gobernanza (no se re-deriva aquí)
+
+Esta invariante **extiende** —no duplica— `reglas/gobernanza.md`:
+- `§ Separación revisor/ejecutor`: el ejecutor nunca emite veredicto sobre su
+  propio trabajo; el revisor no modifica código.
+- `§ Gate G8`: un skill se promueve solo con badge ≥ Plata de `/swl:evaluar-skill`.
+
+El aporte de esta sección es el principio general "no auto-calificación de
+**evidencia**" aplicado a TODA superficie del AGP, y el mapeo a las superficies
+reales del sistema (auditoría Fase 18, 2026-06-27).
+
+### Mapeo a superficies del ciclo AGP (auditoría Fase 18)
+
+| Superficie | ¿Productor ≠ calificador? | Veredicto |
+|---|---|---|
+| Canary pre-write (`hooks/lib/canary-skills.js`) | Validador estructural determinista sobre el contenido real; el agente no puede falsearlo | **PASS** |
+| Veredicto de verificación (`/swl:verificar`, `nemesis`) | `gobernanza.md` exige revisor ≠ ejecutor (agentes distintos) | **PASS** (por proceso) |
+| Invariantes de seguridad (`run-skill-evals --check-invariants`) | `validarInvariantesDeAgente` corre independiente del score declarado | **PASS** |
+| Evidencia RED de TDD (`hooks/tdd-gate.js`) | La escribe el mismo ejecutar-fase; mitigado porque el GREEN lo corre un test-runner independiente y es WARN-ONLY | **PARCIAL** |
+| **Score de eval (`run-skill-evals.js --record-after --score=N`)** | El `--score` se toma **verbatim del flag** que pasa el agente que evoluciona; nada lo liga a una corrida independiente de `/swl:evaluar-skill` | **GAP** (DT-AGP-SCORE-AUTODECLARADO) |
+| Registro de evolución (`evoluciones.jsonl`) + métricas | Heredan el score auto-declarado de la superficie anterior | **GAP** (mismo origen) |
+
+### Anti-patrones (prohibidos)
+
+- Un agente que pasa su propio `--score=N` como evidencia de que su evolución
+  mejoró, sin que ese número provenga de un evaluador independiente.
+- Un ejecutor que escribe/edita su propia evidencia RED, badge o veredicto.
+- "Agregar un detector" y dejar que el evaluado pueda editar las marcas en que el
+  detector se apoya (el error literal del DGM).
+- Confiar en un número de score persistido sin procedencia verificable del actor
+  que lo produjo.
+
+### Regla operativa
+
+Toda métrica que decida promoción/rollback de una evolución debe poder rastrear
+**qué actor la produjo**. Si el actor es el mismo agente evaluado, la métrica es
+un *hint*, no una aprobación: requiere corroboración de un actor independiente
+(otro agente evaluador, el test-runner, o el humano) antes de promover.
+
+---
+
 ## Checklist de seguridad de agentes
 
 Antes de desplegar un agente nuevo o modificar permisos de uno existente:
 
+- [ ] Ninguna evidencia que aprueba al agente (score, badge, RED, veredicto) es
+      producida o editable por el propio agente evaluado (§ Anti-gaming)
+
 - [ ] Los permisos en frontmatter son los mínimos necesarios para la función
 - [ ] `nivelRiesgo` refleja el impacto real si el agente actúa incorrectamente
 - [ ] El agente no puede escalar privilegios a través de delegación

package/schemas/instinct.schema.json

@@ -1,152 +1,161 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/instinct.json",
-  "$schemaVersion": "1.0.0",
-  "title": "SWL Instinct",
-  "description": "Schema de validacion para instintos YAML del sistema SWL",
-  "type": "object",
-  "required": [
-    "version",
-    "instintos"
-  ],
-  "properties": {
-    "version": {
-      "type": "string"
-    },
-    "generado": {
-      "type": "string"
-    },
-    "total_instintos": {
-      "type": "integer",
-      "minimum": 0
-    },
-    "instintos": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "id",
-          "pattern",
-          "confidence",
-          "scope",
-          "status"
-        ],
-        "properties": {
-          "id": {
-            "type": "string",
-            "pattern": "^inst-\\d{3,}$",
-            "description": "Identificador unico secuencial"
-          },
-          "pattern": {
-            "type": "string",
-            "minLength": 10,
-            "maxLength": 500,
-            "description": "Descripcion del patron observado"
-          },
-          "confidence": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Nivel de confianza (0.0 bajo, 1.0 certeza)"
-          },
-          "scope": {
-            "type": "string",
-            "enum": [
-              "project",
-              "domain",
-              "global"
-            ],
-            "description": "Alcance del instinto"
-          },
-          "source": {
-            "type": "string",
-            "description": "ID de sesion o 'manual'"
-          },
-          "evidence_count": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Veces que el patron ha sido observado"
-          },
-          "last_validated": {
-            "type": "string",
-            "description": "Fecha de ultima validacion (YYYY-MM-DD)"
-          },
-          "contradictions": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Veces que el patron ha sido contradicho"
-          },
-          "status": {
-            "type": "string",
-            "enum": [
-              "active",
-              "degraded",
-              "promoted",
-              "archived"
-            ],
-            "description": "Estado actual del instinto"
-          },
-          "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Etiquetas para clasificacion"
-          },
-          "created_at": {
-            "type": "string",
-            "description": "Fecha de creacion (YYYY-MM-DD)"
-          },
-          "decay_half_life_days": {
-            "type": "integer",
-            "minimum": 1,
-            "default": 90,
-            "description": "Dias para que la confianza decaiga a la mitad. 90 dias por defecto."
-          },
-          "helpful_count": {
-            "type": "integer",
-            "minimum": 0,
-            "default": 0,
-            "description": "Numero de veces que el instinto fue util en una sesion"
-          },
-          "harmful_count": {
-            "type": "integer",
-            "minimum": 0,
-            "default": 0,
-            "description": "Numero de veces que el instinto guio a un resultado incorrecto"
-          },
-          "last_validated_at": {
-            "type": "string",
-            "description": "Timestamp ISO o YYYY-MM-DD de la ultima validacion via feedback (sustituye a last_validated en sistemas con scoring)"
-          },
-          "source_sessions": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "uniqueItems": true,
-            "description": "IDs de sesiones que contribuyeron a este instinto (para priorizacion por evidencia multiple)"
-          },
-          "source_agents": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "uniqueItems": true,
-            "description": "Nombres de agentes que validaron este instinto (cross-agent enrichment)"
-          },
-          "maturity": {
-            "type": "string",
-            "enum": [
-              "candidate",
-              "established",
-              "proven",
-              "deprecated"
-            ],
-            "description": "Estado de maduracion derivado (computado, no persistente). Ver scripts/lib/scoring-instintos.js"
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/instinct.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Instinct",
+  "description": "Schema de validacion para instintos YAML del sistema SWL",
+  "type": "object",
+  "required": [
+    "version",
+    "instintos"
+  ],
+  "properties": {
+    "version": {
+      "type": "string"
+    },
+    "generado": {
+      "type": "string"
+    },
+    "total_instintos": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "instintos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "pattern",
+          "confidence",
+          "scope",
+          "status"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^inst-\\d{3,}$",
+            "description": "Identificador unico secuencial"
+          },
+          "pattern": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 500,
+            "description": "Descripcion del patron observado"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Nivel de confianza (0.0 bajo, 1.0 certeza)"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "project",
+              "domain",
+              "global"
+            ],
+            "description": "Alcance del instinto"
+          },
+          "source": {
+            "type": "string",
+            "description": "ID de sesion o 'manual'"
+          },
+          "evidence_count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Veces que el patron ha sido observado"
+          },
+          "last_validated": {
+            "type": "string",
+            "description": "Fecha de ultima validacion (YYYY-MM-DD)"
+          },
+          "contradictions": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Veces que el patron ha sido contradicho"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "degraded",
+              "promoted",
+              "archived"
+            ],
+            "description": "Estado actual del instinto"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Etiquetas para clasificacion"
+          },
+          "created_at": {
+            "type": "string",
+            "description": "Fecha de creacion (YYYY-MM-DD)"
+          },
+          "decay_half_life_days": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 90,
+            "description": "Dias para que la confianza decaiga a la mitad. 90 dias por defecto."
+          },
+          "helpful_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0,
+            "description": "Numero de veces que el instinto fue util en una sesion"
+          },
+          "harmful_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0,
+            "description": "Numero de veces que el instinto guio a un resultado incorrecto"
+          },
+          "last_validated_at": {
+            "type": "string",
+            "description": "Timestamp ISO o YYYY-MM-DD de la ultima validacion via feedback (sustituye a last_validated en sistemas con scoring)"
+          },
+          "source_sessions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true,
+            "description": "IDs de sesiones que contribuyeron a este instinto (para priorizacion por evidencia multiple)"
+          },
+          "source_agents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true,
+            "description": "Nombres de agentes que validaron este instinto (cross-agent enrichment)"
+          },
+          "maturity": {
+            "type": "string",
+            "enum": [
+              "candidate",
+              "established",
+              "proven",
+              "deprecated"
+            ],
+            "description": "Estado de maduracion derivado (computado, no persistente). Ver scripts/lib/scoring-instintos.js"
+          },
+          "tipo_memoria": {
+            "type": "string",
+            "enum": [
+              "semantic",
+              "episodic",
+              "procedural"
+            ],
+            "description": "Eje cognitivo de memoria (ORTOGONAL al canal de almacenamiento): semantic=hechos/decisiones, episodic=experiencia pasada de una sesion, procedural=como manejar un caso. Opcional y backward-compatible: instintos sin el campo siguen validos. Ver reglas/memoria-consolidada.md."
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/bootstrap-instintos.js

@@ -49,15 +49,31 @@ const flags = {
 // Config de secciones → confidence/tags
 // ---------------------------------------------------------------------------
 
+// tipo_memoria (eje cognitivo, Fase 19): patron/anti-patron = "cómo hacer / qué
+// evitar" → procedural; decisión/gotcha/regla = hechos → semantic. episodic NO se
+// infiere del bootstrap (nace de registros de sesión, no de APRENDIZAJES).
 const SECCIONES = [
-  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'] },
-  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'] },
-  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'] },
-  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'] },
-  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'] },
-  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'] },
+  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'], tipoMemoria: 'procedural' },
+  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'], tipoMemoria: 'semantic' },
+  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'], tipoMemoria: 'semantic' },
+  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'], tipoMemoria: 'semantic' },
 ];
 
+/**
+ * Infiere el eje cognitivo de memoria de un instinto por su sección de origen.
+ * Heurístico declarado (no autoritativo): default 'semantic' para hechos.
+ * @param {string} seccion
+ * @returns {'semantic'|'episodic'|'procedural'}
+ */
+function inferirTipoMemoria(seccion) {
+  for (const s of SECCIONES) {
+    if (s.regex.test(seccion || '')) return s.tipoMemoria;
+  }
+  return 'semantic';
+}
+
 function detectarConfidence(seccion) {
   for (const s of SECCIONES) {
     if (s.regex.test(seccion)) return { confidence: s.confidence, tags: [...s.tags] };
@@ -163,6 +179,7 @@ function generarInstintos(entradas) {
       tags,
       created_at: hoy,
       seccion_origen: e.seccion,
+      tipo_memoria: inferirTipoMemoria(e.seccion),
       decay_half_life_days: 90,
       helpful_count: 0,
       harmful_count: 0,
@@ -200,6 +217,7 @@ instintos:
       `    tags: [${i.tags.map(t => `"${t}"`).join(', ')}]`,
       `    created_at: "${i.created_at}"`,
       `    seccion_origen: ${escapeYaml(i.seccion_origen)}`,
+      `    tipo_memoria: ${i.tipo_memoria}`,
       `    decay_half_life_days: ${i.decay_half_life_days}`,
       `    helpful_count: ${i.helpful_count}`,
       `    harmful_count: ${i.harmful_count}`,
@@ -266,4 +284,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, main };
+module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, inferirTipoMemoria, main };

package/scripts/lib/gitignore-manifest.js

@@ -11,8 +11,9 @@
  * Todo lo que instala o genera en runtime se ignora en git (framework, hooks,
  * métricas, sesiones, aprendizajes, trazas, instintos).
  *
- * Solo se commitean: CLAUDE.md, .claude/settings.json, y las plantillas de
- * .planning/ que el equipo edita (PROYECTO.md, REQUISITOS.md, etc.).
+ * Solo se commitean: CLAUDE.md, .claude/settings.json, instintos/proyecto.yaml
+ * (memoria del proyecto), y las plantillas de .planning/ que el equipo edita
+ * (PROYECTO.md, REQUISITOS.md, etc.).
  */
 
 const fs = require("fs");
@@ -54,11 +55,8 @@ const ENTRADAS_BASE = [
   ".swl-ses",
 
   // ── Runtime: archivos generados automáticamente por hooks ──────────
-  // Aprendizajes, métricas, compactación (extraccion-aprendizajes, tracking-costos, context-compressor)
-  ".planning/APRENDIZAJES.md",
+  // Métricas (tracking-costos)
   ".planning/METRICAS.md",
-  ".planning/COMPACTACION.md",
-  ".planning/REPORTE-GRAFO.md",
 
   // Audit trail (audit-trail.js, merkle-audit.js)
   ".planning/*.jsonl",
@@ -88,8 +86,13 @@ const ENTRADAS_BASE = [
   "!.planning/locks/*PLAN.md.lock",
   ".planning/user-profile/",
 
-  // Instintos modificados automáticamente por hooks (degradacion-instintos.js)
-  "instintos/",
+  // Instintos: global/perfil-usuario/prompt-appendices/autonomia son framework +
+  // runtime + personal (no se commitean). proyecto.yaml es memoria del proyecto
+  // (hermano YAML de APRENDIZAJES.md, memoria-consolidada § canal 3) → versionable.
+  // Patrón dir/* + negación: git no re-incluye archivos bajo un dir ignorado
+  // (mismo gotcha documentado en locks/ arriba), por eso se ignora el contenido.
+  "instintos/*",
+  "!instintos/proyecto.yaml",
 
   // Base de datos de uso
   "usage.db",
@@ -305,8 +308,16 @@ function limpiarTracked(cwd, extras = []) {
     return resultado; // No es repo git, nada que hacer
   }
 
-  // Obtener todas las entradas gitignore de swl-ses (directorios y archivos)
-  const entradas = [...new Set([...ENTRADAS_BASE, ...extras])];
+  // Obtener todas las entradas gitignore de swl-ses (directorios y archivos).
+  // Las negaciones (!...) marcan archivos versionables que NUNCA se des-trackean
+  // (instintos/proyecto.yaml, plan-locks G1 *PLAN.md.lock). git ls-files NO honra
+  // las negaciones del .gitignore, así que se excluyen explícitamente de la lista
+  // a limpiar — de lo contrario el glob padre (instintos/*, locks/*) las arrastraría.
+  const todas = [...new Set([...ENTRADAS_BASE, ...extras])];
+  const negaciones = todas
+    .filter((e) => e.startsWith("!"))
+    .map((e) => patronAGlobRegex(e.slice(1)));
+  const entradas = todas.filter((e) => !e.startsWith("!"));
 
   for (const entrada of entradas) {
     try {
@@ -322,7 +333,12 @@ function limpiarTracked(cwd, extras = []) {
 
       if (!archivosTracked) continue;
 
-      const lista = archivosTracked.split("\n").filter(Boolean);
+      const lista = archivosTracked
+        .split("\n")
+        .filter(Boolean)
+        // Preservar archivos versionables cubiertos por una negación del gitignore
+        // (ej. instintos/proyecto.yaml frente al glob instintos/*).
+        .filter((archivo) => !negaciones.some((re) => re.test(archivo)));
       if (lista.length === 0) continue;
 
       // Quitar del índice uno por uno (--cached = solo del índice, no del disco)
@@ -353,6 +369,23 @@ function escapeRegex(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
+/**
+ * Convierte un patrón estilo gitignore (sin el '!' inicial) a una RegExp anclada
+ * para matchear rutas que devuelve `git ls-files` (siempre con '/' como separador).
+ * `*` no cruza '/' (semántica gitignore). Una entrada de directorio matchea también
+ * su contenido. Se usa en limpiarTracked para excluir archivos negados del untrack.
+ *
+ * @param {string} patron  Ej. "instintos/proyecto.yaml", ".planning/locks/*PLAN.md.lock"
+ * @returns {RegExp}
+ */
+function patronAGlobRegex(patron) {
+  const cuerpo = patron
+    .replace(/\/$/, "")
+    .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+    .replace(/\*/g, "[^/]*");
+  return new RegExp("^" + cuerpo + "(?:/.*)?$");
+}
+
 module.exports = {
   actualizarGitignore,
   entradasParaRuntime,