Apothem versus a configuração manual do Cursor
Manter à mão as regras MDC do Cursor sob .cursor/rules/ versus renderizá-las a partir do perfil compartilhado do Apothem.
O Cursor lê regras no formato MDC sob .cursor/rules/. O formato MDC exige
campos de frontmatter — description, globs e alwaysApply. O adaptador de
cursor do Apothem renderiza um único arquivo de regras .mdc a partir do perfil
compartilhado. Esta página contrasta manter essa configuração à mão com
gerenciá-la com o Apothem.
Comparação de esforço
| Tarefa | Configuração manual | Gerenciada pelo Apothem |
|---|---|---|
| Escrever regras | Escrever à mão cada arquivo .mdc em .cursor/rules/ | Renderizadas a partir do corpus compartilhado |
| Escrever o frontmatter MDC | Redigir à mão description / globs / alwaysApply em cada arquivo | Gerado pelo adaptador |
| Manter um único formato de regras | Escolher à mão entre regras MDC e um único arquivo .cursorrules | O adaptador escreve um único arquivo MDC, .cursor/rules/apothem-rules.mdc, e nenhum .cursorrules |
| Manter as regras alinhadas com outros harnesses | Manual, por ferramenta | Automático no apothem update |
| Compartilhar skills e comandos reutilizáveis | Copiar à mão cada pasta de skill para ~/.agents/skills/ e manter as cópias atualizadas | Gravados em ~/.agents/skills/ pelo adaptador, uma cópia para todos os projetos, e atualizados no apothem update |
| Verificar se a configuração está correta | Inspeção manual | apothem verify --harness cursor --project <path> |
O que o Apothem gerencia
O adaptador de cursor renderiza as regras compartilhadas em um único arquivo .mdc,
<project>/.cursor/rules/apothem-rules.mdc, gerando o frontmatter MDC exigido
(description, globs, alwaysApply). O adaptador escreve apenas o formato MDC
baseado em diretórios que o Cursor lê; ele não escreve um único arquivo
.cursorrules. Ele também grava as skills, e os comandos encapsulados como skills,
em ~/.agents/skills/, e as regras e os templates que essas skills citam em
~/.config/apothem/, ambos no seu diretório pessoal.
O Cursor documenta hooks em arquivos hooks.json e por meio do seu formato de plugin. O
adaptador não constrói nenhum plugin; ele adiciona uma única entrada sessionStart ao
.cursor/hooks.json do projeto, que carrega o bootstrap da sessão, e deixa as suas
próprias entradas como estão. Ele não registra nenhuma proteção de chamadas de
ferramentas, então a intenção das barreiras de proteção vive na prosa das regras.
Caminho de migração
- Execute
apothem profile initpara criar o perfil compartilhado, caso ainda não o tenha. - Mova as regras do seu
.cursor/rules/existente (e de qualquer.cursorrules) para o corpus compartilhado. - Execute
apothem install --harness cursor --project <path>para renderizarapothem-rules.mdccom o frontmatter MDC correto. - Execute
apothem verify --harness cursor --project <path>para confirmar que a configuração foi gravada. - Use
apothem update --harness cursor --project <path>para cada mudança posterior.
Leia a seguir
Apothem versus a configuração manual do Claude Code
Manter à mão toda a árvore de configuração nativa do Claude Code versus gerenciá-la através do perfil compartilhado do Apothem.
Apothem frente à configuração manual do Gemini CLI
Manter à mão o arquivo de regras GEMINI.md do Gemini CLI frente a renderizá-lo a partir do perfil compartilhado do Apothem.