> [Índice para máquinas](https://thiagopanini.github.io/panlabs-docs/llms.txt) · [Página](https://thiagopanini.github.io/panlabs-docs/ferramentas/bibliotecas/overpower/conceitos)

# 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ê.

```bash
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.

:::warning
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.

```bash
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.
