lore pull
Baixe e instale um package Lore no projeto atual.
Uso
lore pull <namespace>/<name>:<version> [flags]
lore pull [--sdd <namespace/nome[:versão]>] [--dry-run] # o framework de SDD do projetoDescrição
Baixa o arquivo .lore do registry, descomprime e escreve os artefatos específicos da plataforma no diretório do projeto. A plataforma alvo é detectada automaticamente a partir do runtime de IA presente no projeto.
Flags
| Flag | Descrição |
|---|---|
--target <runtime> | Substituir o runtime detectado automaticamente (ex.: claude-code, cursor, raw) |
--output <dir> | Diretório de saída (padrão: .) |
--registry | URL do registry |
--qualified-names | Instala como {namespace}-{name}, para que pacotes de mesmo nome em namespaces diferentes coexistam. O padrão vem de naming no .lore/config.yaml; --qualified-names=false passa por cima dele |
--sdd <pacote> | Sem pacote: instala este framework de SDD em vez do do projeto, da org ou do padrão |
--dry-run | Sem pacote: mostra qual framework de SDD vale, sem instalar nada |
Exemplos
# Baixar uma versão específica
lore pull m1cloud/azure-architect:1.0.0
# Baixar com target explícito
lore pull m1cloud/azure-architect:1.0.0 --target cursor
# Baixar em um diretório específico
lore pull m1cloud/azure-architect:1.0.0 --output ./ai-configO framework de SDD do projeto
Sem pacote, o lore pull instala o framework de SDD do projeto: o primeiro definido entre --sdd, a chave sdd do .lore/config.yaml mais próximo (até a raiz do repositório), a escolha da org no painel e o padrão do Lore, lore/openspec.
A org é encontrada como o hook de governança a encontra: o --org, senão o .lore.yaml do repositório (lore hooks pin --org=<org>), senão o LORE_ORG. Isso vale só para o lore pull sem pacote; o lore pull <pacote> continua escopado por --org ou LORE_ORG.
$ lore pull
SDD framework: acme/bmad-method (org)
✓ Scaffold instruction → .claude/scaffolds/bmad-method.mdEle instala esse Scaffold como o lore pull <pacote> faria, em todos os targets detectados. Recusa um pacote que não é framework de SDD (um kind: Scaffold com spec.sddFramework: true) e sai com erro. --dry-run mostra a resolução sem instalar; o lore sdd status mostra cada camada.
.lore/config.yaml
Configurações do projeto que todo comando lore rodado nele segue. O CLI lê o arquivo e nunca o grava.
| Chave | Valores | Efeito |
|---|---|---|
naming | plain (padrão), qualified | Instala pacotes como {namespace}-{name} (veja abaixo) |
sdd | namespace/nome[:versão] | O framework de SDD do projeto, no lugar do da org. Vale o arquivo mais próximo que o define |
Alvos de Runtime
A CLI detecta o runtime automaticamente a partir de arquivos no projeto:
| Arquivo presente | Target detectado |
|---|---|
CLAUDE.md | claude-code |
.cursorrules | cursor |
AGENTS.md | openai-agents |
| (nenhum) | raw |
Pacotes de mesmo nome em namespaces diferentes
Por padrão, um pacote é instalado com o nome sem namespace. Então nextjs/design-system e react-native/design-system gravam os dois em .claude/skills/design-system/SKILL.md, e o último pull vence. Para manter os dois, instale com nomes qualificados:
lore pull nextjs/design-system --qualified-names
lore pull react-native/design-system --qualified-names
# → .claude/skills/nextjs-design-system/SKILL.md (name: nextjs-design-system)
# → .claude/skills/react-native-design-system/SKILL.md (name: react-native-design-system)Para que isso seja o padrão do projeto, seguido por todo pull e todo script que rode nele, crie o .lore/config.yaml:
naming: qualifiedO nome qualificado vale para todos os targets e kinds (skills, rules, specs, agents, scaffolds, instruções de include) e para as dependências instaladas pelo mesmo pull. Um nome de Skill qualificado precisa caber no limite de 64 caracteres dos nomes de skill do Claude e do Copilot: se passar, a instalação daquele pacote falha, em vez de o nome ser cortado.
Marca de origem
Todo arquivo que o lore pull grava a partir de um pacote registra de onde veio, logo depois do frontmatter (ou na primeira linha, quando não há frontmatter):
<!-- lore: nextjs/design-system@1.0.1 org=laca -->O org= só aparece em pacotes de namespaces privados de uma org. Arquivos extraídos de spec.include não recebem a marca.
Antes de gravar, o lore pull lê a marca de um arquivo que já esteja no caminho de destino e avisa no stderr (com [WARN]) quando:
- o arquivo veio de outro pacote, e então é sobrescrito;
- com nome qualificado, a instalação sem prefixo do mesmo pacote ainda existe, por exemplo de antes da troca. Remova-a; o CLI nunca apaga;
- com nome qualificado, existe um arquivo de mesmo nome sem marca.
Pacotes que citam outros pacotes
No conteúdo de um pacote, cite outro pacote pelo ID (backend/dotnet-service-scaffold), nunca pelo caminho de instalação: o caminho muda com o nome qualificado e com o target. O agente encontra o arquivo instalado procurando por lore: backend/dotnet-service-scaffold@ no projeto, ou carrega o pacote com lore_get.
Ao atualizar o CLI, todo arquivo instalado ganha uma linha com a marca, mesmo sem nome qualificado. Repositórios que versionam os arquivos instalados vão ver essa diferença uma vez.