Zed

Fornecedor: Zed Industries Nome de instalação: zed Status: GA Configuração nativa: <project>/.rules

InstalaçãoCopy Anchor Link

apothem install --harness zed --project /path/to/project

O adaptador grava um arquivo de instruções do Zed com escopo de projeto a partir da superfície compartilhada de regras e governança do Apothem. O Zed lê um único arquivo de instruções do projeto, a primeira correspondência nesta lista:

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

Não há um diretório de regras por ferramenta, então toda a superfície do Apothem fica no arquivo plano .rules, no topo dessa lista.

Ele também grava as skills do Apothem, e as regras e templates que elas citam, no seu diretório pessoal, antes de tocar no projeto (consulte Arquivos fora do projeto).

Arquivos gravados:

• <project>/.rules, o arquivo de instruções.
• ~/.agents/skills/<name>/SKILL.md para cada skill e comando do Apothem, no seu diretório pessoal.
• ~/.config/apothem/rules/ e ~/.config/apothem/templates/, no seu diretório pessoal.

Arquivos fora do projetoCopy Anchor Link

A instalação também grava as skills do Apothem no seu diretório pessoal, antes de alterar qualquer coisa no projeto:

Essas pastas são compartilhadas. Elas não são privadas do projeto:

• Todo projeto em que você instala zed, e toda outra instalação do Apothem que nomeia a pasta, usa a mesma cópia e grava os mesmos arquivos, então a ordem em que você instala não importa. Várias outras ferramentas também leem ~/.agents/skills/; o registro de harnesses as lista.
• --project escolhe o arquivo de instruções a gravar e a qual projeto a instalação pertence. Ele não muda para onde vão as skills.
• A instalação não adiciona nenhum arquivo de skill ou de regra ao seu repositório. O projeto recebe o arquivo de instruções, além da pasta de dados .apothem/ que toda instalação de projeto cria.
• As pastas do diretório pessoal são gravadas primeiro. Se isso falhar, por exemplo porque uma pasta no caminho é um link que sai do seu diretório pessoal (um link que permanece dentro dele é seguido) ou não pode ser gravada, a instalação para com o erro antes que qualquer coisa no projeto mude.
• Uma pasta de skill com o nome de uma skill do Apothem que o Apothem não gravou é deixada intacta, e a instalação exibe um aviso que a nomeia. Renomeie-a ou mova-a e depois execute apothem update. apothem verify falha enquanto esse nome estiver ocupado.
• Os arquivos somam alguns megabytes.

A instalação exibe uma nota que nomeia as pastas que ela grava fora de --project, e --dry-run as lista.

Mapeamento do perfil para a configuração nativaCopy Anchor Link

O adaptador lê o perfil compartilhado do Apothem e renderiza o arquivo .rules do projeto a cada execução de apothem install ou apothem update. O perfil compartilhado é a fonte da verdade; qualquer .rules preexistente (ou as edições locais do projeto no arquivo gerado) recebe backup antes que a próxima sincronização substitua o conteúdo gerenciado pelo Apothem.

Notas de compatibilidadeCopy Anchor Link

O Zed define AGENTS.md como seu arquivo de instruções principal e mantém o .rules do projeto como um arquivo de compatibilidade suportado (instruções do Zed). Como o Zed lê apenas a primeira correspondência, um novo .rules oculta um AGENTS.md, um CLAUDE.md ou qualquer outro arquivo mais abaixo na lista do qual o projeto já dependa. A instalação nunca edita esses arquivos. Quando o .rules contém apenas o bloco do Apothem e um arquivo de prioridade mais baixa contém o seu texto, a instalação e a atualização exibem um aviso que nomeia o arquivo oculto; copie as instruções de que você precisa para o .rules, fora do bloco do Apothem, para mantê-las no Zed.

O arquivo de instruções global ~/.config/zed/AGENTS.md e o bloco de servidores de contexto MCP (.zed/settings.json context_servers) pertencem ao operador; o Apothem não os grava.

O Zed carrega skills globais apenas de ~/.agents/skills/, em um layout plano com uma pasta por skill, que é o layout que a instalação grava. O Zed condiciona as skills locais do projeto a uma worktree confiável, e sua documentação não associa essa condição à pasta global. Um relato apontou um limite de tamanho para o catálogo de skills que o Zed envia ao modelo; o Apothem não o confirmou, nem se uma skill que desativa a invocação pelo modelo conta para ele. Os nomes e as descrições das skills do Apothem somam cerca de 20 KB. O Apothem também não confirmou como o Zed trata uma chave de cabeçalho de SKILL.md que ele não lista.

VerificaçãoCopy Anchor Link

apothem verify --harness zed --project /path/to/project

O comando verify confirma que:

1. A configuração nativa existe no caminho esperado.
2. Cada destino gerenciado existe; os arquivos gerenciados não estão vazios, e as configurações JSON ou YAML são analisadas sem erros. Adicione --profile PATH para também confirmar que os arquivos instalados correspondem a esse perfil.
3. Toda pasta de skill do Apothem está no lugar com um SKILL.md, seja qual for a instalação que a gravou, e nenhuma pasta de skill com um nome do Apothem pertence a algo que o Apothem não gravou. Uma verificação com falha nomeia as pastas ausentes ou alheias.
4. A rotina de verificação específica do adaptador informa sucesso.

AtualizaçãoCopy Anchor Link

apothem update --harness zed --project /path/to/project

Deriva novamente o arquivo .rules do projeto a partir do estado atual do perfil compartilhado.

A atualização também regrava qualquer pasta de skill cujos arquivos difiram dos atuais. Se você instalou com uma versão anterior que não gravava skills, a atualização as adiciona.

DesinstalaçãoCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

Remove o bloco gerenciado do Apothem do arquivo de configuração nativo .rules e mantém o seu próprio texto. O arquivo só é excluído quando nada mais permanece nele. Antes da mudança, uma cópia com carimbo de data e hora do arquivo é salva em ~/.apothem/backups/; nenhum arquivo de backup fica no projeto. O YAML do perfil compartilhado e o motor do Apothem não são afetados.

A desinstalação também remove as pastas de skill que gravou em ~/.agents/skills/ e as regras e templates em ~/.config/apothem/, mas somente quando nenhuma outra instalação do Apothem ainda as usa. Outro projeto, ou outra ferramenta que compartilha a pasta, pode usá-las. Nesse caso a desinstalação mantém as pastas, exibe qual instalação as usa, e a última desinstalação as remove. Os arquivos que você adicionou a essas pastas permanecem, e uma pasta que fica vazia é removida. Cada pasta recebe backup em ~/.apothem/backups/ antes de ser removida.

Conformity gateCopy Anchor Link

python -m apothem.conformity.gate --all .

Solução de problemasCopy Anchor Link

Ajustes de configuraçãoCopy Anchor Link

Veja tambémCopy Anchor Link

• Todos os harnesses — o catálogo completo de ferramentas suportadas
• Guia de instalação — instale o Apothem neste harness
• Referência de apothem harnesses — liste e inspecione adaptadores pela CLI