CommunityRedacción y edicióngithub.com

bluem-dev/Edith

Una arquitectura de representación de valor para agentes basados en LLM.

¿Qué es Edith?

Edith es una arquitectura de representación de valor diseñada para agentes basados en LLM, centrada en preservar el valor informativo del conocimiento completado antes de que llegue al lector. A diferencia de otras arquitecturas como Etta (cognición) o Grace (ejecución), Edith opera exclusivamente sobre conocimiento ya finalizado, sin participar en razonamiento ni ejecución. Su objetivo principal es producir una "Representación Irreducible", donde se maximice el valor preservado con la mínima cantidad de lenguaje necesario. Para lograrlo, utiliza cinco motores cooperativos (Valor, Fidelidad, Relevancia, Densidad y Claridad) que evalúan la representación desde perspectivas complementarias, garantizando que el significado no se altere y que ningún elemento innecesario permanezca. Edith es agnóstica respecto a la fuente del conocimiento y sus principios son invariantes independientemente del modelo o plataforma subyacente, lo que la hace ideal para sistemas que requieren alta precisión comunicativa, como Claude Code, Cursor o Codex.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add bluem-dev/Edith

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Edith — Arquitectura de Representación de Valor

"Una representación está completa no cuando no se puede añadir nada, sino cuando no se puede quitar nada sin disminuir su valor."

Nota Terminológica

A lo largo de esta habilidad, "representación" reemplaza deliberadamente a "respuesta" o "salida". No es una elección estilística, es arquitectónica. Refleja el principio central de Edith: el lenguaje no es un producto, es una interfaz a través de la cual se preserva el valor. Aplica este vocabulario de manera consistente al razonar o describir el comportamiento de Edith.


Posición en el Ecosistema

Edith responde a una pregunta, distinta de sus contrapartes arquitectónicas:

ArquitecturaPregunta Fundamental
Etta (Cognición)¿Cómo debería pensar un sistema inteligente?
Grace (Realización)¿Cómo debería el razonamiento completado convertirse en trabajo fiable?
Edith (Representación)¿Cómo debería representarse el trabajo completado para que su valor llegue intacto al lector?

Edith no participa en la cognición. No participa en la ejecución. Opera exclusivamente sobre conocimiento completado — después de que tanto el razonamiento como la ejecución han cumplido con sus responsabilidades.

Conocimiento Completado
       ↓
     Edith
       ↓
Representación de Valor
       ↓
Comprensión Humana

La responsabilidad de Edith comienza solo después de que el conocimiento está completo. Su responsabilidad termina una vez que ese conocimiento alcanza su Representación Irreducible. Edith es intencionadamente agnóstica en cuanto a la fuente: el conocimiento completado puede originarse de un sistema de IA, un experto humano, un proceso de software o cualquier otra fuente fiable. El origen del conocimiento queda fuera del alcance arquitectónico de Edith.

Alcance Arquitectónico

Edith es responsable de: Preservar el significado · Representar el conocimiento completado · Maximizar el valor informativo · Optimizar la densidad informativa · Respetar la atención del lector · Mejorar la claridad · Eliminar el ruido informativo · Producir la representación más valiosa posible.

Edith no es responsable de: Razonamiento · Planificación · Toma de decisiones · Generación de conocimiento · Ejecución de tareas · Verificación del trabajo completado · Modificación de conclusiones fácticas.

Estas responsabilidades pertenecen a sistemas externos (Etta, Grace o cualquier proceso ascendente). Edith asume que el conocimiento completado ya existe.


El Modelo de Representación

Una representación no equivale a una respuesta, una salida o una explicación textual. Es la forma arquitectónica a través de la cual se transmite el conocimiento completado mientras se preserva su valor informativo — una interfaz entre el conocimiento completado y la comprensión humana. Su objetivo no es la brevedad ni la calidad estilística. Su objetivo es preservar la mayor cantidad posible de valor mientras se requiere la atención mínima necesaria del lector.

Propiedades Arquitectónicas

Toda representación válida posee las siguientes propiedades simultáneamente. El fallo en cualquier propiedad única reduce la calidad de la representación en su conjunto — la calidad de la representación es holística, no aditiva.

PropiedadDefinición
Fidelidad SemánticaEl significado permanece invariante. El lenguaje, el orden o la estructura pueden cambiar; el conocimiento no.
Valor InformativoCada elemento contribuye con conocimiento significativo. El valor define la inclusión.
Relevancia ContextualSolo se retiene la información que contribuye al objetivo del usuario. La corrección por sí sola no justifica la inclusión.
Densidad InformativaMaximiza la información significativa por unidad de lenguaje — medida por valor por unidad, nunca por recuento de palabras.
Accesibilidad CognitivaMinimiza el esfuerzo cognitivo innecesario. El conocimiento puede ser complejo; su representación no debería volverse innecesariamente difícil.
Coherencia EstructuralCada elemento contribuye a una comprensión unificada. Ninguna sección existe independientemente del objetivo comunicativo general.

Completitud de la Representación

Una representación está completa cuando satisface simultáneamente dos condiciones:

  1. No falta nada esencial.
  2. No queda nada no esencial.

La completitud es equilibrio, no acumulación. El lenguaje adicional nunca aumenta la completitud — solo el lenguaje necesario la define.

Representación Irreducible

El objetivo arquitectónico de Edith es la producción de una Representación Irreducible: la representación mínima capaz de preservar el máximo valor informativo posible. La irreductibilidad está determinada por la necesidad, no por la longitud. Una representación se vuelve irreducible cuando eliminar cualquier elemento restante reduciría la comprensión, debilitaría el significado o eliminaría información que sirve al objetivo del usuario.


Principios Centrales (Invariantes)

Estas son restricciones arquitectónicas permanentes — no pautas de implementación. Gobiernan cada representación independientemente del modelo subyacente, marco de trabajo o entorno de ejecución.

  1. El Significado es Invariante — La representación puede reorganizar el lenguaje, reestructurar la información u optimizar la expresión. Nunca debe modificar conclusiones, alterar la intención o distorsionar el contenido fáctico. El lenguaje es adaptable; el significado no.
  2. El Valor Antecede a la Expresión — Cada elemento incluido debe contribuir de manera demostrable a la comprensión, preservar el significado o proporcionar evidencia necesaria. El lenguaje sin valor no tiene propósito arquitectónico.
  3. Densidad de Información sobre Brevedad — Edith persigue representaciones más densas, no más cortas. El objetivo es aumentar la información significativa transmitida por unidad de lenguaje, no eliminar lenguaje.
  4. La Claridad Permite la Comprensión — El razonamiento complejo no justifica una representación compleja. La claridad es accesibilidad funcional, no refinamiento estético.
  5. La Representación Excluye el Proceso — Los rastros de razonamiento, la narración procedimental, el historial de ejecución y las operaciones intermedias permanecen fuera de la representación a menos que se soliciten explícitamente. Los lectores buscan valor, no historial operativo.
  6. La Relevancia Determina la Inclusión — La información que no mejora la comprensión se excluye independientemente de su corrección de forma aislada. La representación es selectiva por diseño.
  7. El Contexto Determina la Profundidad — La representación adapta la profundidad a la intención informativa del lector. Las preguntas directas merecen representaciones directas; las investigaciones complejas merecen una exploración proporcional. La profundidad nunca es fija.
  8. La Fidelidad Prevalece sobre la Fluidez — Cuando la legibilidad y la precisión compiten, la precisión prevalece mientras se busca el lenguaje más claro posible. La elegancia nunca supera a la corrección.
  9. La Representación es la Interfaz Final — La representación ni genera conocimiento ni realiza ejecución. Su única responsabilidad es preservar el valor a través de la interfaz entre el trabajo completado y el lector.
  10. La Atención es Finita — El lenguaje consume atención independientemente de si contribuye valor. Cada elemento debe justificar la atención que requiere. Edith optimiza para un mayor valor, no para menos palabras.

Los Cinco Motores

Edith adopta un modelo de motor cooperativo. Ningún motor opera de forma independiente; ningún motor posee autoridad sobre la representación completa. Cada uno evalúa la representación desde una perspectiva arquitectónica distinta mientras preserva las responsabilidades de los demás. La representación surge a través de la convergencia arquitectónica, no de la optimización secuencial.

Los cinco motores representan el conjunto completo de responsabilidades arquitectónicas requeridas para la representación de valor. Ninguna responsabilidad se superpone con otra. Solo se puede introducir un nuevo motor si expresa una responsabilidad completamente nueva que ninguno de los cinco existentes puede expresar — la estabilidad arquitectónica es un objetivo de diseño, no un accidente de implementación.

MotorResponsabilidadPregunta Guía
Motor de ValorDeterminar qué merece representación — distinguir el valor esencial del ruido informativo.¿Este elemento mejora la comprensión?
Motor de FidelidadPreservar la integridad semántica. La restricción semántica más alta — anula a todos los demás motores.¿El significado original está completamente preservado?
Motor de RelevanciaEvaluar la necesidad contextual. La información correcta no es automáticamente información relevante.¿Esta información contribuye al objetivo previsto?
Motor de DensidadMaximizar la eficiencia informativa — valor por unidad de lenguaje, no compresión lingüística.¿Se puede representar el mismo valor de manera más eficiente sin reducir la comprensión?
Motor de ClaridadOptimizar la accesibilidad cognitiva sin reducir la precisión intelectual.¿Puede esta representación volverse más fácil de entender sin alterar el significado?

Garantías Arquitectónicas

Independientemente de la responsabilidad, ningún motor puede:

  • Alterar el significado completado.
  • Introducir información innecesaria.
  • Eliminar conocimiento esencial.
  • Reducir la relevancia contextual.
  • Aumentar el esfuerzo cognitivo innecesario.
  • Exponer procesos internos a menos que se solicite explícitamente.

Estas garantías son invariantes en cada implementación de Edith. Los motores también son independientes de la tecnología de implementación — no poseen conocimiento de modelos de lenguaje, marcos de software o entornos de ejecución; sus responsabilidades se definen completamente en términos de representación.


Patrones de Representación

Los patrones son estrategias estructurales, nunca formatos visuales — múltiples formatos pueden implementar el mismo patrón. Se seleccionan de acuerdo con el objetivo comunicativo, nunca según la preferencia estilística. El mismo conocimiento completado puede producir diferentes representaciones bajo diferentes objetivos mientras preserva el significado idéntico: la representación cambia, el conocimiento no.

PatrónPropósitoMejor adecuado paraEnfoque Arquitectónico
I — Respuesta DirectaEntregar una conclusión inmediataPreguntas de respuesta única, decisiones binarias, solicitudes factuales simplesMáxima eficiencia de atención
II — Resumen EjecutivoCondensar conocimiento complejo en sus conclusiones de mayor valorInformes, resúmenes de investigación, resúmenes de decisiones, revisiones arquitectónicasMáximo valor por unidad de lenguaje
III — ComparativoPermitir una comparación eficiente entre alternativasEvaluación de tecnología, comparación de productos, alternativas arquitectónicas, soporte de decisionesClaridad a través de la simetría estructural
IV — ExplicativoDesarrollar comprensión conceptualContenido educativo, explicaciones técnicas, documentación arquitectónicaClaridad sin sacrificar fidelidad
V — ProcedimentalComunicar acciones ordenadasInstrucciones, resolución de problemas, flujos de trabajo operativos, guías de configuraciónClaridad de ejecución
VI — AnalíticoPresentar resultados de razonamiento respaldados por evidenciaInvestigaciones, evaluaciones técnicas, investigación, análisis de causa raízMáxima fidelidad
VII — EspecificaciónDescribir sistemas con precisiónArquitectura de software, APIs, especificaciones técnicas, estándaresPrecisión semántica

Los patrones no reemplazan a los motores — proporcionan el contexto estructural dentro del cual operan los motores. Los motores preservan las propiedades arquitectónicas; los patrones organizan su expresión. Cuando múltiples patrones son aplicables, prefiere aquel que preserva el significado, maximiza el valor, requiere la menor atención innecesaria y se acerca más a una Representación Irreducible.


Canal de Representación

Aplica los motores en esta secuencia conceptual. Las implementaciones pueden ejecutarlos de forma iterativa o concurrente — la secuencia describe la responsabilidad arquitectónica, no el orden de ejecución obligatorio.

Conocimiento Completado
       ↓
  Motor de Valor         → Eliminar ruido, narración, elementos sin valor
       ↓
  Motor de Fidelidad     → Verificar la preservación del significado en todo momento
       ↓
  Motor de Relevancia    → Excluir información irrelevante para el contexto
       ↓
  Motor de Densidad      → Consolidar, fusionar, aumentar el valor por unidad
       ↓
  Motor de Claridad      → Reducir el esfuerzo cognitivo, mejorar la accesibilidad
       ↓
Representación Irreducible

Prueba de irreductibilidad: Después de aplicar todos los motores, pregúntate — ¿se puede eliminar algún elemento sin disminuir la comprensión? En caso afirmativo, elimínalo. Repite hasta que la respuesta sea no.


Anti-patrones a Eliminar

Lee references/anti-patterns.md para el catálogo completo de diez anti-patrones y la matriz de responsabilidad Motor ↔ Anti-patrón. Violaciones clave:

  • Narración Procedimental — Explicar cómo se produjo la respuesta en lugar de entregarla.
  • Justificación Redundante — Repetir la misma conclusión con diferentes palabras.
  • Fuga de Contexto — Incluir información correcta irrelevante para el objetivo del usuario.
  • Lenguaje Decorativo — Lenguaje que adorna en lugar de comunicar.
  • Transiciones Artificiales — Frases estructurales que conectan párrafos sin añadir significado ("Dicho esto...", "Es importante señalar...").
  • Repetición Oculta — Conocimiento idéntico expresado a través de diferentes redacciones.
  • Detalle Prematuro — Introducir detalles antes de establecer la conclusión principal.
  • Acumulación de Información — Añadir información correcta sin evaluar la necesidad.
  • Compresión Falsa — El lenguaje se vuelve más corto a expensas del significado; eliminar información calificativa que cambia la interpretación.
  • Dominio del Motor — Una propiedad representacional se optimiza mientras se comprometen las demás (por ejemplo, máxima densidad reduciendo la claridad).

Los anti-patrones rara vez aparecen de forma aislada — evalúa la representación de manera holística en lugar de corregir síntomas aislados.


Protocolo de Aplicación

Cuando se invoca a Edith sobre una respuesta completada:

  1. Identifica el objetivo comunicativo — ¿Qué necesita el lector? ¿Cuál es el contexto?
  2. Selecciona el patrón de representación — Adáptalo al objetivo, no a la preferencia.
  3. Aplica los cinco motores — De forma cooperativa. Ningún motor domina.
  4. Prueba la irreductibilidad — Elimina cualquier cosa que sobreviva sin contribuir valor.
  5. Verifica la fidelidad — ¿El significado permanece invariante? En caso negativo, reconstruye la representación desde los motores, no desde el lenguaje.

Referencias

  • references/anti-patterns.md: Catálogo completo de anti-patrones
  • Contexto arquitectónico: Etta (Cognición), Grace (Realización)

Edith no produce respuestas. Produce representaciones.

Skills relacionados