NATIVE-SDD
SEC_01 // A PROVOCAÇÃO
SPEC-DRIVEN DEVELOPMENT ENGINE

Pare de improvisar.
Compile a
especificação.

Um scaffold que se auto-otimiza para Spec-Driven Development: cinco fases determinísticas, 11 experts de papel e uma memória viva em .claude/. Entre o prompt e o artefato não sobra onde improvisar.

AUTOR // Pedro Henrique Lopes · Dados + Dev

INICIALIZAR PROTOCOLO VER AS 5 FASES GITHUB
05
FASES SEQUENCIAIS
11
EXPERTS DE PAPEL
12
REGRAS ALWAYS-ON
000024048 072096120 L_00 // ENTRADA Intenção ambígua ENTROPIA L_01 // SPEC Contrato formal ≥ 12/15 L_02 // ARQUITETURA O como, antes DESIGN L_03 // VERIFICAÇÃO Lint · testes · AT PASS L_04 // SAÍDA Artefato determinístico ORDEM
AST-01 // SPEC MONOLITH
● FEIXE ATIVO · 5 CAMADAS
SEC_02 // O PARADOXO
O COLAPSO DE CONTEXTO

O modelo não erra por burrice. Erra por falta de contrato.

Sem uma especificação que o prenda, cada resposta parte de uma leitura nova do problema. O projeto cresce, o contexto dispersa, e a terceira feature contradiz a primeira. Em nenhum momento algo falhou visivelmente.

A // SEM SPEC ENTROPIA CRESCENTE

DERIVA_CTXRETRABALHO

B // SOB O NATIVE-SDD CONTIDO

CONTRATO_FIXOAT VERIFICÁVEL

A // SEM SPEC B // SOB O NATIVE-SDD
REQUISITO
Reinterpretado a cada resposta
Congelado em spec
ACEITE
Implícito
Teste que reprova
MEMÓRIA
Volátil
Persistida em .claude/

AST-02 // CONTEXT DEGRADATION ARTIFACT · a mesma entrada, os mesmos vetores. o que muda é a contenção.

O Native-SDD é um sistema de contenção.

Cada fase só existe porque a anterior deixou um artefato em disco. Nenhuma delas depende de alguém lembrar de pedir. A memória em .claude/ troca a lembrança do operador pela persistência do sistema, e o caminho da intenção ambígua ao artefato verificado não tem etapa opcional.

SEC_03 // O MOTOR
PIPELINE DETERMINÍSTICO

Cinco fases. Uma de cada vez, sem pular.

Cada fase recebe um artefato e devolve outro, mais restrito. Nada avança sem que a saída da anterior exista em disco.

PHASE_00
/brainstorm
Explorar a ideia

Reduzir incerteza antes de fixar requisitos. Onde a feature ainda é hipótese.

SAÍDA · notas de exploração
PHASE_01
/define
Capturar requisitos

O quê e os critérios de aceite: quando exatamente está "pronto".

GATE · Clarity ≥ 12/15
PHASE_02 · ATIVA
/design
Definir arquitetura

A spec técnica: o como construir, antes de escrever a primeira linha.

SAÍDA · DESIGN.md
PHASE_03
/build
Implementar com verificação

Código real + lint/testes + relatório de build. A prova de qualidade sai junto com o código.

GATE · lint · testes · AT
PHASE_04
/ship
Encerrar e aprender

Arquivar a feature e registrar as lições, o acervo que alimenta a KB.

SAÍDA · archive + lições
ID_REF // PHASE_02 — DISSECAÇÃO
ENTRADA
Requisitos + AT
de /define
PROCESSO
Decisão registrada
trade-off explícito
SAÍDA
Spec técnica
para /build
ARTEFATO_PERSISTIDO: .claude/sdd/ STATUS: COMPILANDO
BYPASS // DEV LOOP
/dev

Tarefa pequena e direta? Pula o ciclo completo e usa o atalho. O rigor de verificação é o mesmo; o que some são os cinco artefatos.

CONDIÇÃO: escopo < 1 arquivo-alvo

AST-03 // PHASE TRANSFORMATION RIBBON · o pacote de sinal percorre as cinco cassetes no scroll.

SEC_04 // TOPOLOGIA
SUBAGENTS · BARRAMENTO COMPARTILHADO

11 experts de papel, agnósticos de stack.

O escopo de cada um é um papel de engenharia, aplicável a qualquer stack. Cada agente entra quando a tarefa se beneficia de contexto próprio, e todos rodam em model: inherit.

GRAFO // .claude/agents/graph.json ORCHESTRATES
Grafo do orquestrador max conectado aos 11 agentes especializados max ORQUESTRADOR explorer code-reviewer test-writer git-workflow security-rev. debugger validator documenter ext-observer designer tracker

Toque ou clique num nó para abrir a ficha. Cada agente declara role, tools e connects_to (ex.: debugger → test-writer).

MEMÓRIA VIVA // AST-05
O coração é o .claude/ que cada projeto recebe.
/rules
contrato always-on da sessão
LIVE
/kb
base treinada por projeto
LIVE
/sdd
features, specs e arquivo
LIVE
/agents
os 11 papéis + o grafo
LIVE
RETENÇÃO: persistente entre sessões
SINCRONIA: /setup · /init · /train-kb
AGENTEROLEESCOPO
explorersearchLocalizar código e entender a arquitetura antes de implementar.
code-reviewerreviewRevisão ampla de diff/PR: bugs, segurança, aderência, simplicidade.
test-writertestingEscrever/completar testes cobrindo os Acceptance Tests.
git-workflowvcsHigiene de repo: conventional commits, branches, PRs, .gitignore.
security-reviewersecurityProfundidade em segurança: segredos, injeção, authn/authz, deps.
debuggerdebugA partir da falha/stacktrace: isolar a causa-raiz e propor o fix mínimo.
validatorvalidationVerificar conformidade do resultado à spec/AT: roda e observa.
documenterdocsDocumentar em docs/ (humano × LLM, fora da KB), nunca-destrutivo.
external-observerobservationObservar alvo externo/opaco (site/API/app) e confrontá-lo com a referência.
designerdesignCriar/revisar interface: shape → craft → audit, a11y e anti-slop.
trackertrackingInstrumentar tráfego consent-first: medição, dedup, PII hasheada.
SEC_05 // INSTRUMENTAÇÃO
CLI · STATUSLINE · TERMINAL

É assim que o seu terminal fica.

Do zero ao ciclo SDD em cinco passos. Sem dashboard, sem painel: a instrumentação vive onde você já trabalha.

pwsh — native-sdd
branch: main v0.10.58
# 0. clonar o repositório $ git clone github.com/Phenrique-DataDev/Native-sdd   # 1. preparar a máquina + ~/.claude $ onboarding/install.ps1 ✓ CLIs · Claude Code · perfil pessoal — idempotente   # 2. criar o projeto (alias: nsp) $ New-SddProject meu-projeto -Git -Open ✓ .claude/ · rules · agents · sdd — scaffold limpo   # 3. curadoria: especializa o scaffold neste projeto $ /setup ✓ 11 agentes ajustados · KB treinada · contexto sincronizado   # 4. executar o ciclo $ /init
AST-07 // SPEC-TO-CODE COMPILER CLI EXIT 0
STATUSLINE // AST-06
PHASE: 03_BUILD
CONTEXT_BUFFER: OPTIMAL
PROGRESSO DE FASE03 / 05
brainstormdefinedesignbuildship
DESPACHO DE AGENTES
test-writer ✓ CONCLUÍDO
code-reviewer ● EM CURSO
validator ○ NA FILA
GUARDS SEMPRE ATIVOS
✓ secret-guard
✓ destructive-guard
✓ managed policy
permissão-só · fail-closed · não persiste entre sessões
/peers · SESSÕES ATIVAS
→ chat-A · feat/landing
→ chat-B · fix/install-mcp
SEC_06 // EXECUÇÃO
MATRIZ UNIFICADA · AST-08

Três blocos e você está rodando.

Esquema mestre do compilador: entrada, pipeline de cinco fases, barramento de agentes, memória e artefato ENTRADA intenção P_00 brainstorm P_01 define P_02 design P_03 build P_04 ship SAÍDA artefato verificado BARRAMENTO · 11 AGENTES MEMÓRIA · .claude/ Esquema mestre do compilador: entrada, pipeline de cinco fases, barramento de agentes, memória e artefato ENTRADA intenção P_00 brainstorm P_01 define P_02 design P_03 build P_04 ship SAÍDA artefato verificado BARRAMENTO 11 AGENTES MEMÓRIA .claude/
ESQUEMA MESTRE
fluxo unidirecional
agentes sob demanda
toda fase lê e grava
REV // 0.10.58 STATUS: COMPILADO
COMO COMEÇAR

  1. Instale

    Prepara a máquina: as ferramentas de linha de comando, o Claude Code e a sua configuração pessoal. Leva alguns minutos.

    $ pwsh -NoProfile -Command "irm https://raw.githubusercontent.com/Phenrique-DataDev/Native-sdd/main/onboarding/bootstrap.ps1 | iex"

    Rode num PowerShell 7 (pwsh).

    $ curl -fsSL https://raw.githubusercontent.com/Phenrique-DataDev/Native-sdd/main/onboarding/bootstrap.sh | bash

    Precisa de bash, curl e tar. No macOS, pede a senha de administrador uma vez.

    No fim, feche e abra um terminal novo.

  2. Crie o projeto

    Troque meu-projeto pelo nome que quiser. A pasta nasce com o método pronto e abre no VS Code.

    $ nsp meu-projeto -Open

  3. Comece no Claude Code

    Dentro do projeto, /setup registra a stack, o domínio e as convenções, e /init especializa os agentes para eles.

    › /setup
    › /init
Guia completo no README
Sem cadastro. O Native-SDD não coleta telemetria de uso.
// AUTOR
Pedro Henrique Lopes
Analytics Engineer · ClickHouse, dbt, Python
Sorocaba, SP · Brasil
LinkedIn GitHub
EXPERIÊNCIA
  1. Engenheiro de dados jan 2026 – hoje
    Suprema Gaming

    Pipelines ETL/ELT e modelos dbt em ClickHouse e Snowflake, incluindo a migração para o novo data warehouse em ClickHouse.

  2. Analista de dados fev 2024 – jan 2026
    Máxima

    Dashboards em Power BI e Looker e automação de relatórios para Logística, RH, Financeiro e Comercial.

FORMAÇÃO E CERTIFICAÇÕES
  • ClickHouse Database AssociateClickHouse · 2026
  • Claude Code in ActionAnthropic · 2026
  • Pós-graduação em Ciência de DadosUniCesumar · em curso
  • Tecnólogo em Análise e Desenvolvimento de SistemasUNIASSELVI · 2025
STACK
  • ClickHouse
  • dbt
  • Snowflake
  • SQL
  • Python
  • BigQuery
  • Power BI
  • Looker
  • Git

O Native-SDD é o estudo de caso do jeito que eu trabalho: 34 comandos, 11 agentes e 12 regras, escritos e testados por mim.

Gratuito, aberto e independente.

Mantido de forma independente. Se te poupou tempo ou te ajudou a trabalhar melhor, considere apoiar. Qualquer valor ajuda a manter o desenvolvimento.

b784c378-b3e4-4617-8dbb-ca6c5b722a8f

Pix via QR code

QR code para pagamento via Pix