scchearn/loam

Usando loam

Este es el enrutador para el espacio de nombres de la habilidad loam. No realiza trabajo por sí mismo. Te indica qué habilidad de loam invocar para una intención determinada y las reglas que se aplican a todas ellas.

Esta es una habilidad de enrutamiento/meta. Cuando reconozcas la habilidad coincidente, invócala a través del cargador de habilidades del arnés anfitrión. No realices el trabajo aquí.

No negociables

Tres reglas mantienen el trabajo de loam alineado con el modelo de memoria.

1. Invoca la habilidad relevante antes de cualquier acción de loam. No solo llamadas a herramientas. Antes de planificar, investigar, comenzar, reanudar, crear un punto de control, debatir o alcanzar un consenso, modificar un plan, agregar a la memoria, consultar la memoria, modificar la memoria, revisar la memoria, normalizar la memoria, revisar la memoria, capturar aprendizajes, auditar la guía, preparar la wiki o inicializar un vault: invoca la habilidad correspondiente. Este documento es un enrutador. El cuerpo de la habilidad tiene las reglas reales. La responsabilidad es tuya en todo lo demás. Pecar por exceso de invocación.
2. Memoria primero, sustrato después. Habla de "memoria" primero. Usa "wiki" solo cuando distingas el sustrato de Markdown del sustrato de guía o de puntos de control. Nunca digas "la wiki" cuando quieras decir "memoria" — la wiki es un sustrato de la memoria, no todo.
3. Escrituras de memoria propiedad del agente. El agente escribe, corrige, enruta y archiva la memoria sin aprobación previa. El humano puede marcar contenido obsoleto o incorrecto, lo que activa el mismo flujo de corrección que una contradicción descubierta por el agente.

El modelo de memoria

Memoria es el concepto general para todo lo que loam captura. Existen tres sustratos:

Sustrato	Qué es	Quién lo mantiene
wiki	Notas duraderas en Markdown compatibles con Obsidian bajo wiki/. Páginas de temas, entidades, conceptos, análisis.	grupo loam-memory (la mayoría de las habilidades)
guía	AGENTS.md es el archivo de guía canónico. CLAUDE.md es un shim de importación delgado (solo @AGENTS.md). .claude.local.md para anulaciones personales.	grupo loam-memory (ruta de guía de auditando-guía, aprendiendo-de-sesión)
puntos de control	Estado de trabajo transitorio bajo wiki/checkpoints/. Notas de reinicio, no conocimiento duradero.	grupo loam-work (creando-puntos-de-control escribe, reanudando lee)

El sustrato de wiki es lo que qmd indexa. El sustrato de guía es lo que los arneses cargan como contexto de aviso. Los puntos de control son estado de trabajo, no conocimiento — se niegan a tocar index.md o log.md y no deben convertirse en afirmaciones duraderas.

Habla de "memoria" primero. Usa "wiki" solo cuando la distinción del sustrato importe. Una habilidad que opera en las notas de Markdown trabaja en el sustrato de wiki de la memoria. Una habilidad que edita AGENTS.md trabaja en el sustrato de guía de la memoria. Ambos son memoria.

Rúbrica de admisión de memoria duradera

Usa esta rúbrica antes de crear una página de wiki. Las habilidades que crean páginas hacen referencia a esta sección en lugar de copiarla.

Una afirmación merece una página de wiki solo si pasa las tres:

• R1 Reutilizable — una sesión futura en una tarea diferente probablemente la necesitaría.
• R2 Sobre el proyecto/dominio — código base, arquitectura, decisiones, convenciones, dependencias externas o hechos externos duraderos; no la conversación, el agente o el estado de usuario transitorio.
• R3 Costoso de reconstruir y re-verificable — re-derivar la afirmación de una fuente activa (código, configuración, calendario, lista de tareas) costaría más de lo que cuesta mantener la página. Si un comando o una lectura de archivo la recupera, no merece una página. Cuando existe una fuente externa, la página la nombra para que la frescura pueda revalidarse. Las decisiones puras y la justificación se autoabastecen y satisfacen esto al exponer su razonamiento.

Los descalificadores anulan la rúbrica:

• D1 efímero — estado de compilación, rama actual, "hoy ejecuté X" -> informe operativo.
• D2 duplicado — una página existente lo cubre -> modifica la página existente en lugar de crear otra.

Desempate: admitir si no es reconstruible a partir de una fuente activa; descartar si es reconstruible. wiki/.archive/ es solo para contenido que fue duradero y ahora está reemplazado. El material nunca duradero no se escribe en la wiki y nunca se archiva.

Matriz de enrutamiento

Material	Destino	Ruta de habilidad
Hecho reutilizable de proyecto/dominio, pasa la rúbrica	página de wiki duradera	loam::agregando-a-memoria, auto-corrección
Convención/comando/gotcha de comportamiento del agente	AGENTS.md / CLAUDE.md	ruta de guía de loam::aprendiendo-de-sesión
Estado de sesión para reanudar/transferir	wiki/checkpoints/<slug>.md	loam::creando-puntos-de-control
Contexto por tarea adjunto a una unidad de trabajo	anotación de tarea / archivo de plan	loam::planificando, loam::comenzando
Salida de compilación, estado de rama, caso único, no verificable o fallo de rúbrica	descartar, opcionalmente con una línea de auditoría en log.md	ninguno

Auto-corrección y activadores de bandera humana

• Auto-corrección: cuando el agente lee la memoria y encuentra una contradicción con la evidencia actual, mueve la página duradera reemplazada a wiki/.archive/ con un encabezado de archivo, escribe la corrección en la ubicación activa, añade una entrada de auto-corrección a log.md y continúa con la tarea original.
• Bandera humana: cuando el humano dice que una página de memoria es incorrecta o está obsoleta, trátalo como un activador de corrección, no como una solicitud de aprobación. Lee la página marcada y la evidencia actual, archiva la página duradera reemplazada, escribe la corrección, regístrala e informa qué cambió.
• Alcance del archivo: .archive/ es solo para páginas que eran duraderas y luego se volvieron incorrectas, obsoletas o reemplazadas. El material nunca duradero se enruta a otro lugar o se descarta.

Activadores de validación de frescura

Usa updated_at existente más evidencia de tiempo de revisión; no añadas metadatos de frescura.

• F1 una ruta de archivo citada cambió desde updated_at de la página.
• F2 una refactorización, renombramiento, eliminación o migración tocó una ruta referenciada (loam::sincronizando-grafo-codigo --tocado).
• F3 una versión fija, API o documento externo que la página nombra tiene una mención más reciente.
• F4 updated_at es anterior a 90 días y la página cita superficies volátiles como API, configuraciones, versiones o rutas de código. La revisión marca esto para re-validación y no lo archiva automáticamente.
• F5 contradicción al leer, manejada por auto-corrección.

El resultado de la validación es uno de: confirmado (aumentar updated_at), corregido (archivar + reescribir + registrar) o rechazado (archivar con motivo "ya no aplica").

Banderas rojas: pensamientos que significan DETENERSE e invocar

Estas racionalizaciones hacen que las habilidades se salten. Si te sorprendes pensando en alguna de ellas, invoca la habilidad relevante incluso si "ya la leíste" antes en la sesión.

Pensamiento	Acción
"Solo escribiré esto en la wiki"	Invoca loam-agregando-a-memoria. Aplica la rúbrica de admisión, luego escribe o enruta.
"Solo lo planificaré, esto es simple"	Invoca loam-escribiendo-especificacion. Las especificaciones son necesarias antes de loam-planificando.
"Solo ejecutaré un debate rápido entre agentes"	Invoca loam-configurando-agentes. Los debates están controlados por aprobación; no se envían antes de la puerta.
"Solo editaré este plan directamente"	Invoca loam-modificando-plan. Los cambios de plan se propagan; la habilidad recorre el impacto.
"Escribiré esta página de memoria porque podría ayudar más tarde"	Aplica la rúbrica de admisión primero. Si falla, enrútala o descártala.
"La wiki está desactualizada, lo arreglaré en línea"	Archiva la página duradera reemplazada, escribe la corrección, regístrala y continúa.
"Solo capturaré este aprendizaje como una nota"	Invoca loam-aprendiendo-de-sesión. Enruta a wiki o guía, no a ti.
"Solo revisaré la wiki rápidamente"	Invoca loam-consultando-memoria. Mantente anclado en la memoria, no en contexto obsoleto.
"Solo añadiré este comando a AGENTS.md"	Invoca loam-aprendiendo-de-sesión (ruta de guía) o loam-auditando-guía para una auditoría completa.
"Solo haré una pausa y retomaré después"	Invoca loam-creando-puntos-de-control. Un punto de control es un artefacto reanudable, no una nota mental.
"Reanudaré donde lo dejé"	Invoca loam-reanudando. Verifica el estado activo antes de actuar.
"Configuraré la wiki"	Invoca loam-preparando-wiki primero, luego loam-inicializando-vault para la configuración de Obsidian.

El ciclo de vida de loam

Para cualquier tarea de loam:

1. Orientar. Reconoce la habilidad coincidente del gráfico de decisión a continuación. Si dos habilidades parecen relevantes, aplica las reglas de precedencia.
2. Elegir habilidad. Invócala a través del cargador de habilidades del arnés anfitrión.
3. Preservar los límites del sustrato. No escribas puntos de control en páginas duraderas. No escribas guía en páginas de wiki. No escribas contenido de wiki en AGENTS.md. Cada sustrato tiene su habilidad.
4. Aplicar admisión y enrutamiento antes de escribir en memoria. Las páginas de wiki duraderas deben pasar la rúbrica; todo lo demás va a guía, puntos de control, anotaciones de tareas o se descarta.
5. Actualizar planes / puntos de control / guía solo a través de la habilidad coincidente. No edites un plan en línea — usa loam-modificando-plan. No escribas un punto de control en línea — usa loam-creando-puntos-de-control. No edites AGENTS.md en línea — usa loam-aprendiendo-de-sesión o loam-auditando-guía.

Reglas de conflicto (cuando dos habilidades parecen relevantes)

• Las habilidades de proceso / trabajo actual ganan antes que las habilidades de mantenimiento de memoria. Si estás en medio de la ejecución y descubres un problema de memoria, primero completa el paso de trabajo actual (o crea un punto de control), luego invoca la habilidad de memoria.
• Las escrituras de memoria son propiedad del agente. Si el trabajo actual produce un aprendizaje, enrútalo a través de la matriz; si expone memoria obsoleta, corrígela en línea con archivo + registro.
• Los puntos de control son transitorios. Viven bajo wiki/checkpoints/ pero no son afirmaciones duraderas. Se niegan a actualizar index.md o log.md. No promuevas un punto de control a una nota duradera sin pasar por loam-agregando-a-memoria.
• Modificar vs revisar. loam-modificando-memoria corrige afirmaciones incorrectas específicas. loam-revisando-memoria verifica la salud de todo el grafo. Si encontraste un error específico, modifica. Si quieres una verificación general, revisa.
• Consultar vs revisar. loam-consultando-memoria responde una pregunta. loam-revisando-memoria revela lagunas. Si quieres una respuesta, consulta. Si quieres saber qué no está resuelto, revisa.
• Agregar vs aprender. loam-agregando-a-memoria ingiere una fuente (archivo, artículo, conversación-como-nota). loam-aprendiendo-de-sesión captura conocimientos derivados de la sesión y los enruta a wiki o guía. Si tienes una fuente, agrega. Si la sesión produjo conocimiento, aprende.

Gráfico de decisión

"Quiero..."
├─ comenzar algo nuevo
│  ├─ investigar una pregunta ──────────── /loam::escribiendo-especificacion
│  ├─ planificar trabajo aprobado ──────── /loam::planificando
│  └─ debatir / alcanzar consenso ──────── /loam::configurando-agentes
├─ ejecutar trabajo
│  ├─ comenzar un plan ──────────────────── /loam::comenzando
│  ├─ pausar / transferir ──────────────── /loam::creando-puntos-de-control
│  ├─ reanudar después de pausa ────────── /loam::reanudando
│  └─ cambiar un plan en curso ─────────── /loam::modificando-plan
├─ trabajar con memoria
│  ├─ agregar una fuente ────────────────── /loam::agregando-a-memoria
│  ├─ ingerir un código base ────────────── /loam::ingiriendo-codigo-base
│  ├─ sincronizar desviación del grafo de código ── /loam::sincronizando-grafo-codigo
│  ├─ hacer una pregunta ────────────────── /loam::consultando-memoria
│  ├─ arreglar lo que está mal ──────────── /loam::modificando-memoria
│  ├─ verificar salud ───────────────────── /loam::revisando-memoria
│  ├─ normalizar corpus desordenado ─────── /loam::normalizando-memoria
│  ├─ ver qué no está resuelto ──────────── /loam::revisando-memoria
│  ├─ capturar aprendizajes de sesión ───── /loam::aprendiendo-de-sesión
│  └─ auditar guía del agente ──────────── /loam::auditando-guía
└─ configurar el sustrato
   ├─ preparar la wiki ──────────────────── /loam::preparando-wiki
   └─ inicializar vault de Obsidian ─────── /loam::inicializando-vault

Nota de precedencia para casos ambiguos

Si una intención se asigna a dos habilidades, el árbol anterior es el enrutador principal. Cuando el árbol no desambigua, aplica las reglas de conflicto en la sección del ciclo de vida. Cuando aún haya incertidumbre: pregunta al usuario qué intención está más cerca.

Referencia compacta de habilidades

Una línea por habilidad. El gráfico de decisión es el enrutador principal; esto es para consulta rápida.

• loam-escribiendo-especificacion — investiga una pregunta, produce specs/<slug>.md
• loam-planificando — compila una especificación aprobada en un plan listo para ejecutar
• loam-comenzando — comienza o reanuda la ejecución de un plan
• loam-reanudando — reanuda desde notas de punto de control
• loam-creando-puntos-de-control — escribe un punto de control reanudable antes de pausar
• loam-configurando-agentes — ejecuta un debate estructurado o conferencia entre agentes con posiciones distintas y un entregable de convergencia, controlado por aprobación
• loam-modificando-plan — actualiza un plan en curso después de un cambio de alcance
• loam-agregando-a-memoria — ingiere una fuente en la memoria (sustrato de wiki)
• loam-ingiriendo-codigo-base — ingiere el código base como páginas de entidad con aristas de wikilink
• loam-sincronizando-grafo-codigo — reconcilia el grafo de código con el repositorio en la puerta del plan o bajo demanda
• loam-consultando-memoria — responde una pregunta desde la memoria
• loam-modificando-memoria — corrige afirmaciones específicas incorrectas u obsoletas en la memoria
• loam-revisando-memoria — verifica la salud del grafo de memoria
• loam-normalizando-memoria — reajusta la estructura a un corpus de memoria desordenado
• loam-revisando-memoria — revela lagunas no resueltas en la memoria
• loam-aprendiendo-de-sesión — captura aprendizajes de sesión, enruta a wiki o guía
• loam-auditando-guía — audita y mejora AGENTS.md / CLAUDE.md / .claude.local.md
• loam-preparando-wiki — instancia un nuevo andamio de sustrato de wiki
• loam-inicializando-vault — configura un vault de Obsidian con configuración

Instalación de comandos slash

Si el usuario quiere /checkpoint y /resume como comandos de acceso directo (en lugar de escribir /loam::creando-puntos-de-control y /loam::reanudando), puedes instalarlos. Los archivos de comando se envían en el repositorio de loam bajo commands/.

Lee references/commands-install.md para el protocolo completo. Cubre:

• En qué arnés estás ejecutando (señales de detección)
• Qué formato de comando espera tu arnés (Markdown vs TOML)
• Dónde instalar (global vs local al proyecto)
• El protocolo de pedir permiso antes de copiar

Los archivos de comando se incluyen como activos bajo assets/commands/

...

[truncado para traducción]