Clarity

Um plugin gratuito e de código aberto para Claude

O Claude Code acabou de alterar 14 ficheiros, instalar três pacotes e reestruturar a sua base de dados. Talvez tenha acompanhado parte. Mas compreende tudo?

Pode pedir ao Claude que explique as coisas. Mas isso só funciona quando sabe sobre o que perguntar.

E quanto aos ficheiros que não reparou que foram alterados? A dependência que adicionou sem mencionar? A decisão arquitetural que tomou enquanto ainda estava a ler a anterior?

Clarity é um plugin que percorre tudo o que o Claude fez. Sistematicamente. Numa linguagem que consegue realmente acompanhar. Apanha o que não pensaria em perguntar, porque não sabia que tinha acontecido.

Porque não perguntar simplesmente ao Claude?

Pode fazê-lo. E por vezes é suficiente. Mas quando o Claude altera 30 ficheiros numa sessão, precisaria de saber quais perguntar. O Clarity não espera que repare em algo. Percorre tudo e diz-lhe o que importa.

O que o Clarity faz

1. Constrói algo com o Claude

Utiliza o Claude Code como habitualmente. Escreve código, faz alterações, instala coisas. Acompanha, na maior parte. Parte compreende. Parte avança depressa.

2. O Clarity explica o que aconteceu

Escreva /clarity:explain para uma coisa, ou /clarity:session para tudo. O Clarity lê o que o Claude fez e guia-o passo a passo em linguagem simples. Cada alteração, cada decisão, cada dependência.

3. Sabe o que perguntar a seguir

Cada explicação termina com sugestões específicas que pode usar na próxima sessão. Não compreende apenas o que aconteceu. Sabe o que fazer a respeito.

O que o Clarity não é

Não avalia a qualidade do código.

O Clarity não lhe diz se o código é bom ou mau. Explica o que mudou e porquê, para que possa decidir o que fazer a seguir.

Não corrige nada.

O Clarity traduz. Não faz alterações, não sugere correções nem reescreve o que quer que seja. Isso é consigo.

É o Claude a explicar o Claude.

Isto não é uma auditoria independente. O Clarity é o Claude a olhar para o seu próprio trabalho e a explicá-lo. Útil para compreender. Não é a última palavra sobre nada.

Quem utiliza o Clarity

Fundadores não técnicos

Está a construir um produto com IA, mas não escreve o código. O Clarity diz-lhe o que a sua ferramenta de IA realmente fez, para que possa tomar decisões informadas sobre o seu próprio produto.

Operadores autónomos

É suficientemente técnico para usar o Claude Code, mas não é programador a tempo inteiro. O Clarity preenche a lacuna entre "pedi isto" e "eis o que foi realmente construído".

Equipas com responsabilidades de supervisão

Alguém na equipa precisa de compreender o que a IA construiu, mesmo que não o tenha construído. O Clarity dá-lhe um resumo em linguagem simples que consegue realmente ler.

A parte honesta

  • O Clarity ajuda-o a compreender o que a IA construiu. Essa compreensão é sua para agir.
  • As explicações são traduções de melhor esforço, não avaliações com autoridade.
  • Se algo numa explicação do Clarity o preocupar, partilhe-o com um programador para uma segunda opinião.
  • O Clarity é licenciado sob Apache 2.0.
  • É fornecido tal como está, sem qualquer garantia.
  • O Clarity não aceita responsabilidade por decisões tomadas com base nas suas explicações.

Como obter o Clarity

O Clarity funciona com o Claude Code (a ferramenta de linha de comandos).

Submetido ao marketplace de plugins da Anthropic. Entretanto, descarregue a partir do GitHub.

Instalar a partir do GitHub

  1. Descarregue o Clarity a partir do GitHub (clique no botão verde "Code" e depois "Download ZIP")
  2. Descompacte a pasta algures no seu computador
  3. No Claude Code, execute:
claude plugin install /path/to/Clarity

Escreva /clarity:help para verificar que está a funcionar

Desinstalação

Para remover o Clarity, execute:

claude plugin uninstall clarity

Como usar o Clarity

Depois de instalado, estes comandos ficam disponíveis dentro do Claude. Escreva qualquer um deles para começar.

/clarity:explain
Explique uma coisa. Um ficheiro, um erro, um resultado ou um conceito. Sem argumento, explica a última coisa que o Claude disse.
/clarity:session
Explique o que aconteceu na sessão atual. Cada alteração, decisão e dependência em linguagem simples.
/clarity:project
Percorra o projeto completo. O que é, como está construído, quais são os riscos e o que perguntar a seguir.
/clarity:config
Defina onde o Clarity guarda os ficheiros de explicação.
/clarity:help
Mostre a referência completa de comandos.

Plugin complementar: Attest

O Clarity explica o que a IA construiu. O Attest é a outra metade: um fluxo de revisão estruturada que levanta questões sobre qualquer resultado gerado por IA, regista as suas decisões e produz um registo de decisões auditável. Trabalhos diferentes. Mesmo objetivo: manter os humanos no controlo.

Obter o Clarity

Submetido ao marketplace de plugins da Anthropic. Entretanto, descarregue a partir do GitHub.

Descarregar a partir do GitHub →

Mantenha-se atualizado

Receba uma notificação quando o Clarity estiver disponível no diretório de plugins de Claude e quando adicionarmos novas funcionalidades.

Tem uma questão específica?

Clarity: porque "confia em mim, está tudo bem" não é supervisão.