Skip to Content
Pt BrV1GovernançaFrameworks de SDD

Frameworks de SDD

Um framework de Spec-Driven Development (SDD) é o fluxo que um projeto segue da ideia ao código entregue: onde ficam as specs e como uma mudança é proposta, desenhada, implementada e arquivada. OpenSpec e BMAD são dois exemplos. O Lore deixa a sua org escolher um, deixa cada projeto trocá-lo e diz à IA qual vale.

Um framework é um Scaffold

Um framework de SDD é distribuído como um pacote kind: Scaffold marcado com spec.sddFramework: true:

apiVersion: lore.io/v1 kind: Scaffold metadata: namespace: acme name: bmad-method version: 2.1.0 spec: title: BMAD Method description: O fluxo BMAD e sua estrutura de diretórios sddFramework: true content: defaultLanguage: pt-BR translations: - pt-BR

A marca só vale em kind: Scaffold; o lore validate a rejeita em qualquer outro kind. Ela não muda a instalação do Scaffold: o lore pull continua gravando um arquivo de instruções com um comando lore extract. Ela só permite que uma org ou um projeto escolha o pacote como framework, o que um template genérico ou uma Rule não podem ser.

O Lore publica o próprio padrão, lore/openspec: a estrutura de diretórios do OpenSpec e instruções para instalar e usar o CLI do OpenSpec.

Qual framework vale

O framework efetivo é o primeiro definido entre:

CamadaOnde se define
1Flaglore pull --sdd <namespace/nome[:versão]>
2Projetosdd: no .lore/config.yaml mais próximo
3OrgA página SDD Framework do painel
4Padrãolore/openspec

A escolha da org

O owner da org escolhe o framework em Settings → SDD Framework no painel, entre os pacotes de framework de SDD visíveis para a org, com uma restrição de versão opcional. Todo membro vê a escolha. O Lore confere se o pacote existe, tem uma versão compatível, é visível para a org (público, ou num namespace da org) e está marcado como framework de SDD. Reset volta a org para “não configurado”, e os projetos sem escolha própria seguem o padrão do Lore.

A escolha de um projeto

Um projeto troca a escolha da org com uma linha no .lore/config.yaml:

sdd: acme/bmad-method:2 # ou só acme/bmad-method para a versão mais recente

O CLI usa o .lore/config.yaml mais próximo que define sdd, subindo do diretório atual até a raiz do repositório, nunca acima dela. Num monorepo, services/payments/ pode seguir um framework e o resto do repositório outro. Um valor inválido gera um aviso, e a camada do projeto é ignorada. O CLI nunca grava esse arquivo.

Aplicando

lore pull # instala o framework efetivo lore pull --dry-run # mostra a resolução sem instalar nada lore sdd status # mostra cada camada e qual vence

O lore pull sem pacote imprime SDD framework: <pacote> (<camada>) e instala esse Scaffold em todos os targets detectados, como o lore pull <pacote> faria. Ele recusa um pacote que não é framework de SDD. Quando o Registry não responde, a escolha da org vem da última cópia em cache, e o CLI avisa.

No início da sessão

Quando o projeto ou a org escolheu um framework, o hook de governança acrescenta uma linha depois das Rules da org:

[Org SDD] This project follows acme/bmad-method (set by the org acme). Use that workflow; if it isn't set up here, run `lore pull`.

Só o padrão do Lore não acrescenta nada, para que uma org que nunca escolheu um framework não seja empurrada para um. A linha conta no orçamento de contexto do hook como uma Rule e nunca é cortada. Superfícies só com MCP (claude.ai, ChatGPT) não a recebem: escolher um framework diz respeito aos arquivos de um repositório.

Framework de SDD × pacotes obrigatórios

São duas políticas de org diferentes, em duas páginas diferentes do painel.

Pacotes obrigatóriosFramework de SDD
FormaUma lista: toda entrada é entregueUm valor: a nova escolha substitui a anterior
PacotesRules e SkillsUm kind: Scaffold com spec.sddFramework: true
ProjetosGlobs de projeto restringem uma entradaO .lore/config.yaml do projeto substitui a escolha da org
EntregaToda sessão (hook e MCP)lore pull, e uma linha no início da sessão (só hook)

O Lore diz qual framework um projeto deve seguir, não confere se o repositório de fato o segue.

© 2025 Lore · Built by M1 Cloud