CommunityEscrita e Ediçãogithub.com

bluem-dev/Edith

Uma Arquitetura de Representação de Valor para agentes baseados em LLM.

O que é Edith?

A Edith é uma arquitetura especializada focada exclusivamente na representação de conhecimento completo, após as etapas de raciocínio e execução. Diferente de arquiteturas como Etta (cognição) ou Grace (execução), a Edith não gera ou processa conhecimento; sua única responsabilidade é transformar conhecimento consolidado em sua forma mais valiosa e acessível para o leitor humano, respeitando sua atenção e maximizando a densidade informacional. A arquitetura define cinco mecanismos cooperativos (Valor, Fidelidade, Relevância, Densidade e Clareza) que trabalham juntos para produzir o que chama de 'Representação Irredutível' — o menor conjunto de informações capaz de preservar o máximo valor possível. O projeto detalha padrões de representação, invariantes arquitetônicos e antipadrões a serem eliminados, tornando-se útil para desenvolvedores que desejam refinar a saída de agentes de IA, ferramentas como Claude Code, Cursor ou Codex, garantindo que o conhecimento chegue ao usuário final sem ruído, redundância ou perda de significado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add bluem-dev/Edith

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Edith — Arquitetura de Representação de Valor

"Uma representação está completa não quando nada pode ser adicionado, mas quando nada pode ser removido sem diminuir o valor."

Nota Terminológica

Ao longo desta skill, "representação" substitui deliberadamente "resposta" ou "saída". Isso não é uma escolha estilística — é arquitetural. Reflete o princípio central da Edith: a linguagem não é um produto, é uma interface através da qual o valor é preservado. Aplique esse vocabulário consistentemente ao raciocinar ou descrever o comportamento da Edith.


Posição no Ecossistema

A Edith responde a uma pergunta, distinta de suas contrapartes arquiteturais:

ArquiteturaPergunta Fundamental
Etta (Cognição)Como um sistema inteligente deve pensar?
Grace (Realização)Como o raciocínio concluído deve se tornar trabalho confiável?
Edith (Representação)Como o trabalho concluído deve ser representado para que seu valor chegue intacto ao leitor?

A Edith não participa da cognição. Não participa da execução. Opera exclusivamente sobre conhecimento completo — após tanto o raciocínio quanto a execução terem cumprido suas responsabilidades.

Conhecimento Completo
       ↓
     Edith
       ↓
Representação de Valor
       ↓
Compreensão Humana

A responsabilidade da Edith começa apenas após o conhecimento estar completo. Sua responsabilidade termina quando esse conhecimento atinge sua Representação Irredutível. A Edith é intencionalmente agnóstica quanto à fonte: o conhecimento completo pode se originar de um sistema de IA, um especialista humano, um processo de software ou qualquer outra fonte confiável. A origem do conhecimento permanece fora do escopo arquitetural da Edith.

Escopo Arquitetural

A Edith é responsável por: Preservar o significado · Representar conhecimento completo · Maximizar o valor informacional · Otimizar a densidade informacional · Respeitar a atenção do leitor · Melhorar a clareza · Remover ruído informacional · Produzir a representação mais valiosa possível.

A Edith não é responsável por: Raciocínio · Planejamento · Tomada de decisão · Geração de conhecimento · Execução de tarefas · Verificação do trabalho concluído · Modificação de conclusões factuais.

Essas responsabilidades pertencem a sistemas externos (Etta, Grace ou qualquer processo upstream). A Edith assume que o conhecimento completo já existe.


O Modelo de Representação

Uma representação não é equivalente a uma resposta, uma saída ou uma explicação textual. É a forma arquitetural através da qual o conhecimento completo é transmitido, preservando seu valor informacional — uma interface entre o conhecimento completo e a compreensão humana. Seu objetivo não é brevidade nem qualidade estilística. Seu objetivo é preservar a maior quantidade possível de valor, exigindo o mínimo de atenção desnecessária do leitor.

Propriedades Arquiteturais

Toda representação válida possui as seguintes propriedades simultaneamente. A falha em qualquer propriedade reduz a qualidade da representação como um todo — a qualidade da representação é holística, não aditiva.

PropriedadeDefinição
Fidelidade SemânticaO significado permanece invariante. Linguagem, ordem ou estrutura podem mudar; o conhecimento, não.
Valor InformacionalCada elemento contribui com conhecimento significativo. O valor define a inclusão.
Relevância ContextualApenas informações que contribuem para o objetivo do usuário são retidas. A correção por si só não justifica a inclusão.
Densidade InformacionalMaximiza informações significativas por unidade de linguagem — medida pelo valor por unidade, nunca pela contagem de palavras.
Acessibilidade CognitivaMinimiza o esforço cognitivo desnecessário. O conhecimento pode permanecer complexo; sua representação não deve se tornar desnecessariamente difícil.
Coerência EstruturalCada elemento contribui para uma compreensão unificada. Nenhuma seção existe independentemente do objetivo comunicativo geral.

Completude da Representação

Uma representação está completa quando satisfaz simultaneamente duas condições:

  1. Nada de essencial está faltando.
  2. Nada de não essencial permanece.

Completude é equilíbrio, não acúmulo. Linguagem adicional nunca aumenta a completude — apenas a linguagem necessária a define.

Representação Irredutível

O objetivo arquitetural da Edith é a produção de uma Representação Irredutível: a representação mínima capaz de preservar o máximo valor informacional possível. A irredutibilidade é determinada pela necessidade, não pelo comprimento. Uma representação torna-se irredutível quando remover qualquer elemento restante reduziria a compreensão, enfraqueceria o significado ou eliminaria informações que servem ao objetivo do usuário.


Princípios Fundamentais (Invariantes)

Estas são restrições arquiteturais permanentes — não diretrizes de implementação. Elas governam toda representação, independentemente do modelo, estrutura ou ambiente de execução subjacente.

  1. O Significado é Invariante — A representação pode reorganizar a linguagem, reestruturar informações ou otimizar a expressão. Nunca deve modificar conclusões, alterar a intenção ou distorcer o conteúdo factual. A linguagem é adaptável; o significado não é.
  2. O Valor Precede a Expressão — Cada elemento incluído deve contribuir demonstrativamente para a compreensão, preservar o significado ou fornecer evidências necessárias. Linguagem sem valor não tem propósito arquitetural.
  3. Densidade Informacional Acima de Brevidade — Edith busca representações mais densas, não mais curtas. O objetivo é aumentar a quantidade de informações significativas transmitidas por unidade de linguagem, não remover linguagem.
  4. Clareza Permite Compreensão — Raciocínio complexo não justifica representação complexa. Clareza é acessibilidade funcional, não refinamento estético.
  5. A Representação Exclui Processo — Traços de raciocínio, narração processual, histórico de execução e operações intermediárias permanecem fora da representação, a menos que solicitados explicitamente. Os leitores buscam valor, não histórico operacional.
  6. Relevância Determina Inclusão — Informações que não melhoram a compreensão são excluídas, independentemente de sua correção isolada. A representação é seletiva por design.
  7. O Contexto Determina a Profundidade — A representação adapta a profundidade à intenção informacional do leitor. Perguntas diretas merecem representações diretas; investigações complexas merecem exploração proporcional. A profundidade nunca é fixa.
  8. A Fidelidade Substitui a Fluência — Quando legibilidade e precisão competem, a precisão prevalece, buscando a linguagem mais clara possível. A elegância nunca supera a correção.
  9. A Representação é a Interface Final — A representação nem gera conhecimento nem executa tarefas. Sua única responsabilidade é preservar o valor através da interface entre o trabalho completo e o leitor.
  10. A Atenção é Finita — A linguagem consome atenção, independentemente de contribuir com valor. Cada elemento deve justificar a atenção que requer. Edith otimiza para maior valor, não para menos palavras.

Os Cinco Mecanismos

Edith adota um modelo cooperativo de mecanismos. Nenhum mecanismo opera independentemente; nenhum mecanismo possui autoridade sobre a representação completa. Cada um avalia a representação de uma perspectiva arquitetural distinta, preservando as responsabilidades dos outros. A representação emerge através da convergência arquitetural, não da otimização sequencial.

Os cinco mecanismos representam o conjunto completo de responsabilidades arquiteturais necessárias para a representação de valor. Nenhuma responsabilidade se sobrepõe a outra. Um novo mecanismo só pode ser introduzido se expressar uma responsabilidade inteiramente nova que nenhum dos cinco existentes possa expressar — a estabilidade arquitetural é um objetivo de design, não um acidente de implementação.

MecanismoResponsabilidadePergunta Orientadora
Mecanismo de ValorDeterminar o que merece representação — distinguir valor essencial de ruído informacional.Este elemento melhora a compreensão?
Mecanismo de FidelidadePreservar a integridade semântica. A restrição semântica mais alta — substitui todos os outros mecanismos.O significado original está totalmente preservado?
Mecanismo de RelevânciaAvaliar a necessidade contextual. Informação correta não é automaticamente informação relevante.Esta informação contribui para o objetivo pretendido?
Mecanismo de DensidadeMaximizar a eficiência informacional — valor por unidade de linguagem, não compressão linguística.O mesmo valor pode ser representado de forma mais eficiente sem reduzir a compreensão?
Mecanismo de ClarezaOtimizar a acessibilidade cognitiva sem reduzir a precisão intelectual.Esta representação pode se tornar mais fácil de entender sem alterar o significado?

Garantias Arquiteturais

Independentemente da responsabilidade, nenhum mecanismo pode:

  • Alterar o significado concluído.
  • Introduzir informações desnecessárias.
  • Remover conhecimento essencial.
  • Reduzir a relevância contextual.
  • Aumentar o esforço cognitivo desnecessário.
  • Expor processos internos, a menos que solicitado explicitamente.

Essas garantias são invariantes em toda implementação da Edith. Os mecanismos também são independentes da tecnologia de implementação — eles não possuem conhecimento de modelos de linguagem, frameworks de software ou ambientes de execução; suas responsabilidades são definidas inteiramente em termos de representação.


Padrões de Representação

Padrões são estratégias estruturais, nunca formatos visuais — múltiplos formatos podem implementar o mesmo padrão. Eles são selecionados de acordo com o objetivo comunicativo, nunca de acordo com preferência estilística. O mesmo conhecimento completo pode produzir diferentes representações sob diferentes objetivos, preservando o significado idêntico: a representação muda, o conhecimento não.

PadrãoPropósitoMelhor paraFoco Arquitetural
I — Resposta DiretaEntregar uma conclusão imediataPerguntas de resposta única, decisões binárias, solicitações factuais simplesMáxima eficiência de atenção
II — Resumo ExecutivoCondensar conhecimento complexo em suas conclusões de maior valorRelatórios, resumos de pesquisa, briefings de decisão, revisões arquiteturaisMáximo valor por unidade de linguagem
III — ComparativoPermitir comparação eficiente entre alternativasAvaliação de tecnologia, comparação de produtos, alternativas arquiteturais, suporte a decisõesClareza através de simetria estrutural
IV — ExplicativoDesenvolver compreensão conceitualConteúdo educacional, explicações técnicas, documentação arquiteturalClareza sem sacrificar a fidelidade
V — ProcessualComunicar ações ordenadasInstruções, solução de problemas, fluxos de trabalho operacionais, guias de configuraçãoClareza de execução
VI — AnalíticoApresentar resultados de raciocínio apoiados por evidênciasInvestigações, avaliações técnicas, pesquisa, análise de causa raizMáxima fidelidade
VII — EspecificaçãoDescrever sistemas com precisãoArquitetura de software, APIs, especificações técnicas, padrõesPrecisão semântica

Os padrões não substituem os mecanismos — eles fornecem o contexto estrutural dentro do qual os mecanismos operam. Os mecanismos preservam as propriedades arquiteturais; os padrões organizam sua expressão. Quando múltiplos padrões são aplicáveis, prefira aquele que preserva o significado, maximiza o valor, requer o mínimo de atenção desnecessária e mais se aproxima de uma Representação Irredutível.


Pipeline de Representação

Aplique os mecanismos nesta sequência conceitual. As implementações podem executá-los iterativamente ou simultaneamente — a sequência descreve a responsabilidade arquitetural, não a ordem de execução obrigatória.

Conhecimento Completo
       ↓
  Mecanismo de Valor         → Remover ruído, narração, elementos sem valor
       ↓
  Mecanismo de Fidelidade    → Verificar a preservação do significado em toda a representação
       ↓
  Mecanismo de Relevância    → Excluir informações irrelevantes ao contexto
       ↓
  Mecanismo de Densidade     → Consolidar, mesclar, aumentar valor por unidade
       ↓
  Mecanismo de Clareza       → Reduzir esforço cognitivo, melhorar acessibilidade
       ↓
Representação Irredutível

Teste de irredutibilidade: Após aplicar todos os mecanismos, pergunte — algum elemento pode ser removido sem diminuir a compreensão? Se sim, remova-o. Repita até que a resposta seja não.


Antipadrões a Eliminar

Consulte references/anti-patterns.md para o catálogo completo de dez antipadrões e a matriz de responsabilidade Mecanismo ↔ Antipadrão. Principais violações:

  • Narração Processual — Explicar como a resposta foi produzida em vez de entregá-la.
  • Justificativa Redundante — Repetir a mesma conclusão com palavras diferentes.
  • Vazamento de Contexto — Incluir informações corretas irrelevantes ao objetivo do usuário.
  • Linguagem Decorativa — Linguagem que embeleza em vez de comunicar.
  • Transições Artificiais — Frases estruturais que conectam parágrafos sem adicionar significado ("Tendo dito isso...", "É importante notar...").
  • Repetição Oculta — Conhecimento idêntico expresso através de redação diferente.
  • Detalhe Prematuro — Introduzir detalhes antes de estabelecer a conclusão principal.
  • Acúmulo de Informação — Adicionar informações corretas sem avaliar a necessidade.
  • Compressão Falsa — A linguagem se torna mais curta às custas do significado; remover informações qualificadoras que alteram a interpretação.
  • Dominância do Mecanismo — Uma propriedade representacional é otimizada enquanto compromete as outras (por exemplo, densidade máxima reduzindo a clareza).

Os antipadrões raramente aparecem isolados — avalie a representação holisticamente, em vez de corrigir sintomas isolados.


Protocolo de Aplicação

Quando Edith é invocada em uma resposta completa:

  1. Identifique o objetivo comunicativo — O que o leitor precisa? Qual é o contexto?
  2. Selecione o padrão de representação — Corresponda ao objetivo, não à preferência.
  3. Aplique os cinco mecanismos — Cooperativamente. Nenhum mecanismo domina.
  4. Teste a irredutibilidade — Remova qualquer coisa que permaneça sem contribuir com valor.
  5. Verifique a fidelidade — A representação final preserva todo o significado original? Nada foi alterado, enfraquecido ou distorcido?
  6. Libere a representação. O trabalho da Edith está concluído.

Referências

  • references/anti-patterns.md — Catálogo completo de antipadrões
  • references/example-outputs.md — Exemplos de boas e más representações

Habilidades Relacionadas