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-BRA 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:
| Camada | Onde se define | |
|---|---|---|
| 1 | Flag | lore pull --sdd <namespace/nome[:versão]> |
| 2 | Projeto | sdd: no .lore/config.yaml mais próximo |
| 3 | Org | A página SDD Framework do painel |
| 4 | Padrão | lore/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 recenteO 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 venceO 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órios | Framework de SDD | |
|---|---|---|
| Forma | Uma lista: toda entrada é entregue | Um valor: a nova escolha substitui a anterior |
| Pacotes | Rules e Skills | Um kind: Scaffold com spec.sddFramework: true |
| Projetos | Globs de projeto restringem uma entrada | O .lore/config.yaml do projeto substitui a escolha da org |
| Entrega | Toda 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.