PT
Docs / Primeiros passos

Como o GenPM funciona

Um pacote do GenPM são três camadas que viajam juntas e ficam fixadas em um commit:

Camada O que é Onde fica
Código Código-fonte de um módulo d, por exemplo src/lib/auth/
Contexto Regras para o seu agente de IA (x) <d>/AGENTS.md, mais arquivos de regras da IDE com escopo
Conexões Servidores MCP de que o módulo precisa (m) .mcp.json, .cursor/mcp.json… só com o seu consentimento

O registry guarda só metadados

O registry indexa manifestos e aponta para o Git. Na instalação, o CLI baixa o código diretamente do host Git no commit exato (c) e o verifica: git rev-parse HEAD precisa ser igual a c, e cada arquivo precisa bater com a árvore do commit.

Planejar antes de agir

plan() nunca escreve no seu projeto. Ele resolve as dependências, baixa para um cache global e escaneia os arquivos. apply() escreve com um journal: se algo falhar, tudo é desfeito.

Nenhum script, nunca

O GenPM não tem scripts de ciclo de vida. Nada de um pacote roda na sua máquina. Arquivos que outras ferramentas executam automaticamente (postinstall, .npmrc, .envrc, .vscode/tasks.json…) são rejeitados.