Conceitos
O vocabulário do overpower, das três unidades instaláveis ao slot, à precondição, ao runtime e ao escopo.
O resto deste site usa estes termos sem parar para redefini-los. Esta página é onde a definição mora.
As três unidades instaláveis
O modelo do overpower tem exatamente três unidades que você pode pedir, e elas
não são níveis de uma hierarquia. Você escolhe entre elas, não sobe nem desce
uma escada.
| Unidade | O que é | Como instala |
|---|---|---|
| Artefato | o átomo, uma skill, um comando, um agente ou um servidor MCP, curado sozinho | sozinho, pelo nome |
| AI Framework | um corpo autocontido de equipamento vindo de uma única origem | inteiro, nunca em fatia |
| Bundle | uma coleção nomeada de artefatos de pool, montada para um contexto de trabalho | expande no que o manifesto dele nomeia |
O artefato vive no pool, instala por si e é o único tipo de coisa que um
bundle pode nomear. O AI Framework instala inteiro, e os artefatos dele vivem
dentro do contexto do próprio framework, não no pool, e não podem ser pedidos
individualmente. O nome que você digita em --ai-framework é o nome que o
overpower dá ao framework, que nem sempre é o nome de onde ele veio, e essa
origem fica registrada em NOTICE, um arquivo que o produto nunca lê.
uvx overpower@latest list --ai-framework matt-pocock
O bundle não carrega conteúdo próprio. Ele é um manifesto que aponta para nomes de artefato, e expande exatamente no que esse manifesto lista.
De onde o conteúdo vem
Pool é o conjunto de artefatos curados individualmente, organizado por tipo.
É a fonte de onde bebem tanto um --skill direto quanto todo bundle.
Catálogo é tudo que o overpower sabe instalar, artefatos, frameworks e
bundles juntos. Ele é curado, não aberto, e não é registro no sentido usual: o
catálogo embutido é a árvore de artefatos dentro do pacote, descoberta
andando pelo sistema de arquivos em vez de lida de um arquivo de índice.
Receita é a declaração lógica de um servidor MCP, com o transporte, como alcançá-lo, os slots dele e as preconditions. Uma receita nunca aterrissa em disco como arquivo. O que aterrissa é o fragmento renderizado a partir dela dentro de um documento que já é seu.
Procedência é de onde um pedaço de conteúdo veio, a origem e a forma como foi obtido. Ela descreve a história do próprio catálogo, nunca o alvo em que ele aterrissa.
O vocabulário do enxerto de MCP
Slot é onde um segredo pertence dentro de uma receita, declarado como nome
e papel, env, header ou bearer, e nunca como valor. O slot é exatamente
aquilo que o overpower se recusa a escrever em disco. Todo o resto que a
receita declara, ele escreve porque pode.
Precondição é uma conferência que uma receita pode nomear, de um vocabulário
fechado que o próprio overpower implementa: existe um dado comando, uma dada
variável está posta, um dado caminho existe.
Uma receita só nomeia o que conferir. O código que executa a conferência é
sempre do próprio overpower, nunca algo buscado e executado de onde quer que a
receita tenha vindo.
O que decide onde as coisas caem
Runtime é a ferramenta que consome o que o overpower instala, como o Claude
Code, o Cursor, o Codex ou o Copilot. Cada runtime tem convenção de caminho
própria e, para enxertos, formato de configuração próprio.
Escopo é qual dos dois lugares o overpower escreve: o repositório atual, ou
a máquina atual, selecionada com --global. Os dois não são simétricos. Uma
escrita em repositório pode contar com o git status para revelar ou desfazer um
engano, uma escrita em máquina não pode, e as regras que cada comando segue
diferem em consequência disso.
uvx overpower@latest install --skill panlabs-python-standards --runtime cursor --global
A árvore do catálogo é o mapa que estes termos descrevem, e esta página é só a legenda para lê-lo.