Estás extendiendo un sistema de conocimiento existente con un nuevo dominio. Esto es composición, no reemplazo. El nuevo dominio debe coexistir con los dominios existentes mientras mantiene su propio vocabulario, esquema y patrones de procesamiento. El grafo compartido (enlaces wiki, hub MOC, campos de descripción) conecta todo.
Tu Tarea
Añade un nuevo dominio de conocimiento: $ARGUMENTS
Archivos de Referencia
Léelos durante las fases de derivación:
Reglas de composición:
${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md-- La Prueba 4 (Composición Multi-Dominio) valida el patrón${CLAUDE_PLUGIN_ROOT}/reference/three-spaces.md-- arquitectura de tres espacios (compartida entre dominios)${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md-- validación de coherencia para la configuración del dominio
Configuración del dominio:
${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md-- mapeo de términos nativos del dominio${CLAUDE_PLUGIN_ROOT}/reference/tradition-presets.md-- configuraciones de dominio pre-validadas${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md-- 3 ajustes predefinidos con configuraciones${CLAUDE_PLUGIN_ROOT}/reference/dimension-claim-map.md-- fundamentos de investigación para posiciones de dimensiones${CLAUDE_PLUGIN_ROOT}/reference/failure-modes.md-- matriz de vulnerabilidad del dominio
Validación:
${CLAUDE_PLUGIN_ROOT}/reference/kernel.yaml-- los 12 primitivos no negociables${CLAUDE_PLUGIN_ROOT}/reference/validate-kernel.sh-- script de validación del núcleo
FASE 1: Escanear Sistema Existente
Automatizada. Entender lo que existe antes de añadir.
1a. Leer configuración del sistema
Lee ops/derivation.md para:
- Posiciones actuales de dimensiones
- Mapeo de vocabulario
- Nivel de plataforma y automatización
- Bloques de características activas
Lee ops/config.yaml para valores de configuración en vivo.
1b. Inventariar dominios existentes
Identifica todos los dominios de conocimiento actuales:
- Carpeta principal de notas y su vocabulario de dominio
- Cualquier dominio secundario existente (carpetas, plantillas, MOCs)
- Campos de esquema en uso por dominio
1c. Identificar tipos de dimensiones
Clasifica cada una de las 8 dimensiones como de nivel de sistema o ajustable por dominio:
| Dimensión | Tipo | Justificación |
|---|---|---|
| Organización | nivel de sistema | Plano/jerárquico aplica a todo el espacio de trabajo |
| Automatización | nivel de sistema | Los hooks y habilidades son infraestructura de todo el espacio de trabajo |
| Profundidad de navegación | nivel de sistema | La estructura del hub MOC es compartida |
| Granularidad | ajustable por dominio | Diferentes dominios pueden necesitar diferente granularidad |
| Procesamiento | ajustable por dominio | La investigación necesita pesado, las relaciones necesitan ligero |
| Mantenimiento | ajustable por dominio | Diferentes umbrales de condición según tasa de crecimiento del dominio |
| Esquema | ajustable por dominio | Los campos específicos del dominio varían |
| Enlace | ajustable por dominio | Algunos dominios necesitan búsqueda semántica, otros no |
Las dimensiones de nivel de sistema son fijas por el sistema existente. Las dimensiones ajustables por dominio pueden variar para el nuevo dominio.
FASE 2: Conversación
1-3 turnos de conversación para entender el nuevo dominio. Usa AskUserQuestion para cada turno.
Pregunta inicial
Haz UNA pregunta enfocada sobre el nuevo dominio:
"Cuéntame sobre [pista de dominio de $ARGUMENTS] -- ¿qué tipo de cosas rastrearás, y cómo se relaciona esto con tu trabajo existente en [vocabulario de dominio actual]?"
La segunda mitad es crítica: entender la relación entre dominios impulsa las decisiones de composición.
Extracción de señales
Mientras el usuario responde, extrae señales para las dimensiones ajustables por dominio:
| Señal | Dimensión | Posición |
|---|---|---|
| "Notas rápidas sobre personas" | Granularidad | moderada |
| "Análisis profundo de sesiones" | Procesamiento | pesado |
| "Solo recordar momentos clave" | Procesamiento | ligero |
| "Revisito y actualizo a menudo" | Mantenimiento | umbrales estrictos |
| "Mayormente estático una vez capturado" | Mantenimiento | umbrales laxos |
| "Necesito encontrar patrones entre entradas" | Enlace | explícito+implícito |
También extrae:
- Estimación de volumen -- cuántas notas por lote de procesamiento
- Dinámicas temporales -- qué tan rápido cambia el contenido
- Vocabulario -- las propias palabras del usuario para notas, procesos, organización
- Relación entre dominios -- cómo se conecta esto con el/los dominio/s existente/s
Estrategia de seguimiento
Después de la respuesta inicial, haz 1-2 preguntas de seguimiento dirigidas a:
- Confirmación de vocabulario -- "Cuando dices [palabra del usuario], ¿te refieres a ideas individuales o entradas más largas?"
- Patrones de conexión entre dominios -- "Las notas de [nuevo dominio] ¿se conectarán con tus notas de [dominio existente]? ¿Cómo?"
NO preguntes sobre dimensiones directamente. Escúchalas en la conversación natural.
FASE 3: Derivar Configuración del Dominio
3a. Mapear señales a dimensiones ajustables por dominio
Para cada dimensión ajustable, determina la posición para el nuevo dominio:
- Señales del usuario (máxima prioridad)
- Ajuste predefinido de caso de uso más cercano de
${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md - Cascada desde dimensiones de nivel de sistema
3b. Construir mapeo de vocabulario
Lee ${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md para la tabla de transformación.
Orden de prioridad:
- Palabras del propio usuario de la conversación
- Vocabulario del ajuste predefinido de caso de uso
- Mezcla del dominio de referencia más cercano
Construye el mapeo completo para el nuevo dominio:
| Término Universal | Término del Nuevo Dominio | Fuente |
|---|---|---|
| nota | [término] | [usuario / predefinido / mezcla] |
| extraer / reducir | [término] | [usuario / predefinido / mezcla] |
| conectar / reflejar | [término] | [usuario / predefinido / mezcla] |
| MOC | [término] | [usuario / predefinido / mezcla] |
| descripción | [término] | [usuario / predefinido / mezcla] |
| temas | [término] | [usuario / predefinido / mezcla] |
| bandeja de entrada | [término] | [usuario / predefinido / mezcla] |
3c. Diseñar esquema específico del dominio
Comienza desde el esquema base de nota (descripción, temas) y añade campos específicos del dominio:
_schema:
entity_type: "[dominio]-nota"
applies_to: "[carpeta-dominio]/*.md"
required:
- description
- topics
optional:
- [campos específicos del dominio basados en señales de conversación]
enums:
[campo]:
- [valores relevantes del dominio]
3d. Verificación de colisiones
Esto es crítico para la composición multi-dominio. Verifica:
-
Unicidad de nombre de archivo -- los títulos de notas del nuevo dominio no colisionarán con notas existentes. Los enlaces wiki se resuelven por nombre de archivo en todo el espacio de trabajo, por lo que cada nombre de archivo debe ser único.
-
Nombres de campos de esquema -- los campos del nuevo dominio no entran en conflicto con campos de dominios existentes. Si ambos dominios usan un nombre de campo (por ejemplo,
type), los valores de enumeración deben ser mutuamente excluyentes o el campo debe tener semántica compatible. -
Nombres de plantillas -- las plantillas del nuevo dominio tienen nombres distintos de las plantillas existentes.
-
Nombres de carpetas -- las carpetas del nuevo dominio no colisionan con carpetas existentes.
Si se detectan colisiones, resuélvelas antes de continuar.
FASE 4: Verificar Reglas de Composición
Lee ${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md (Prueba 4: Composición Multi-Dominio) para el patrón de composición validado.
Verifica cada regla de composición:
Regla 1: Los enlaces wiki se resuelven sin ambigüedad en el espacio de nombres compartido
Todos los nombres de archivo de notas deben ser únicos en todos los dominios. Las convenciones de nomenclatura del nuevo dominio deben ser compatibles con las existentes.
Regla 2: El hub MOC enlaza a todos los MOCs de dominio
El hub MOC existente (index.md o equivalente) debe actualizarse para incluir el MOC de punto de entrada del nuevo dominio. La jerarquía se convierte en:
hub -> MOCs de dominio existentes
-> MOC del nuevo dominio
Regla 3: La reflexión entre dominios busca en todas las carpetas de notas
Si la búsqueda de conexiones (reflexión) está activa, debe buscar en todos los dominios -- una nota en el nuevo dominio podría conectarse a una nota en el dominio existente. Las colecciones de búsqueda semántica deben incluir la carpeta del nuevo dominio.
Regla 4: El procesamiento específico del dominio puede coexistir
Si el nuevo dominio necesita diferente intensidad de procesamiento que el dominio existente, el pipeline debe enrutar por tipo de nota. Procesamiento pesado para notas de investigación, procesamiento ligero para notas de relaciones, etc.
Regla 5: La carga de archivos de contexto es progresiva
La guía metodológica del nuevo dominio debe cargarse solo cuando se trabaje en ese dominio, no al inicio de cada sesión. Esto evita la hinchazón del contexto a medida que se acumulan los dominios.
Verificación de coherencia
Ejecuta la configuración del nuevo dominio a través de ${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md:
- Violaciones de restricciones duras entre la configuración del nuevo dominio y las dimensiones de nivel de sistema
- Advertencias de restricciones blandas específicas del nuevo dominio
- Efectos en cascada sobre el/los dominio/s existente/s
FASE 5: Presentar Propuesta
Muestra al usuario exactamente qué se creará y cómo se conecta con lo que existe.
Formato de salida:
=== PROPUESTA DE ADICIÓN DE DOMINIO ===
Nuevo dominio: [nombre del dominio]
Vocabulario: [mapeos de términos clave]
--- Lo que se creará ---
Estructura de carpetas:
[carpeta-dominio]/ <- [descripción]
index.md <- MOC del hub del dominio
[bandeja-entrada-dominio]/ <- zona de captura (si procesamiento >= moderado)
templates/[dominio]-nota.md <- plantilla de nota con esquema del dominio
--- Conexiones con el sistema existente ---
- Hub MOC (index.md): añadir sección [nuevo dominio] con enlace a [[indice-dominio]]
- Enlaces entre dominios: las notas de [nuevo dominio] pueden enlazar a notas de [dominio existente] y viceversa
- Infraestructura compartida: self/, ops/, templates/ siguen siendo compartidos
- Búsqueda semántica: [nueva colección añadida / no necesaria al volumen actual]
--- Lo que NO cambia ---
- Carpeta [dominio] existente: intacta
- Plantillas existentes: intactas
- Jerarquía MOC existente: intacta (el hub gana un nuevo enlace)
- Espacio self/: compartido (methodology.md actualizado con patrones multi-dominio)
- Espacio ops/: compartido (derivation.md actualizado con la adición del dominio)
--- Configuración del Dominio ---
| Dimensión | Posición | Justificación |
|-----------|----------|---------------|
| Granularidad | [val] | [razón] |
| Procesamiento | [val] | [razón] |
| Mantenimiento | [val] | [razón] |
| Esquema | [val] | [razón] |
| Enlace | [val] | [razón] |
| (dimensiones de nivel de sistema heredadas del sistema existente) |
--- Vista Previa del Esquema ---
[Mostrar el bloque _schema para la plantilla del nuevo dominio]
--- Mapeo de Vocabulario ---
| Universal | Nuevo Dominio | Dominio Existente |
|-----------|---------------|-------------------|
| nota | [término] | [término existente] |
| ... | ... | ... |
¿Te gustaría que lo cree? Puedo ajustar cualquier cosa antes de generar.
=== FIN DE LA PROPUESTA ===
Espera la aprobación del usuario antes de continuar.
FASE 6: Generar
Crea la infraestructura del nuevo dominio. El orden importa -- los artefactos posteriores hacen referencia a los anteriores.
Paso 1: Estructura de carpetas del dominio
Crea la carpeta de notas del dominio y la carpeta de bandeja de entrada opcional:
mkdir -p [carpeta-dominio]
mkdir -p [bandeja-entrada-dominio] # si procesamiento >= moderado
Paso 2: Plantilla de nota del dominio
Crea templates/[dominio]-nota.md con el bloque _schema derivado, campos requeridos y opcionales, y vocabulario del dominio en comentarios y ejemplos.
Paso 3: MOC del hub del dominio
Crea [carpeta-dominio]/index.md:
---
description: [descripción del punto de entrada en vocabulario del dominio]
type: moc
---
# índice
[Párrafo de orientación en vocabulario del dominio]
## [dominio:Temas]
(los temas surgirán a medida que se acumulen las notas)
## Primeros Pasos
1. Captura tu primera [dominio:nota]
2. Conéctala a este hub
Paso 4: Guía del dominio
Crea un documento de metodología específico del dominio que se cargue al trabajar en este dominio. Para Claude Code: .claude/skills/[dominio]-guia/SKILL.md o una sección en el archivo de contexto. Para otras plataformas: un archivo de guía independiente.
La guía cubre:
- Cómo capturar en este dominio
- Cómo procesar (a la intensidad derivada)
- Cuándo conectar entre dominios
- Estándares de calidad específicos del dominio
- Referencia de vocabulario del dominio
Paso 5: Actualizar hub MOC
Añade el nuevo dominio al hub MOC existente (index.md):
## [Nombre del Nuevo Dominio]
- [[indice-dominio]] -- [descripción de lo que rastrea este dominio]
Paso 6: Actualizar archivo de contexto
Añade al archivo de contexto:
- Enrutamiento del dominio: cuando se trabaje en [dominio], cargar [guía del dominio]
- Vocabulario: términos del nuevo dominio añadidos a la referencia de vocabulario
- Procesamiento: si diferente intensidad de procesamiento, documentar el enrutamiento
- Enlace entre dominios: cuándo y cómo conectar entre dominios
Paso 7: Actualizar self/methodology.md
Añade patrones de trabajo multi-dominio:
- Cómo cambiar entre dominios
- Cuándo crear conexiones entre dominios
- Disparadores de procesamiento por dominio
Paso 8: Actualizar ops/derivation.md
Documenta la adición del dominio:
- Nombre del nuevo dominio y vocabulario
- Posiciones de dimensiones ajustables por dominio con justificación
- Reglas de composición verificadas
- Patrones de conexión entre dominios
- Fecha y contexto de la adición
Paso 9: Actualizar búsqueda semántica (si está configurada)
Si qmd o equivalente está configurado:
# Añadir nueva colección para la carpeta del dominio
qmd update
qmd embed
Actualiza .mcp.json o configuración equivalente para incluir la nueva colección.
Paso 10: Habilidades de procesamiento del dominio (si procesamiento >= moderado)
Si el nuevo dominio necesita sus propias habilidades de procesamiento (porque la intensidad de procesamiento o el vocabulario difiere del dominio existente), genera versiones adaptadas del dominio de las habilidades reducir/reflejar/verificar.
Si las habilidades existentes pueden manejar el enrutamiento multi-dominio por tipo de nota, actualízalas en lugar de crear duplicados.
FASE 7: Validar
Verificaciones del núcleo para los nuevos archivos del dominio
Ejecuta la validación del núcleo contra los archivos del nuevo dominio:
- Frontmatter YAML válido en todos los archivos nuevos
- Los enlaces wiki de los nuevos archivos se resuelven (incluyendo enlaces entre dominios)
- El MOC del nuevo dominio es accesible desde el hub
- Campos de descripción presentes
- Los pies de página de temas hacen referencia al MOC del dominio
Validación de composición
- Sin conflictos de campos -- grep en todas las plantillas por nombres de campo, verifica que no haya conflictos semánticos
- Accesibilidad del hub -- el hub MOC enlaza a todos los MOCs de dominio, todos los MOCs de dominio enlazan a sus notas
- Prueba de enlace entre dominios -- crea un enlace de prueba desde el nuevo dominio al dominio existente, verifica que se resuelve
- Unicidad de nombre de archivo -- verifica que no haya nombres de archivo duplicados entre dominios:
find . -name