Nereus

A composable platform API, more than an IDP

Nereus

Uma API de plataforma componível, mais que um IDP

The thesis · One door

An IDP is one profile, not the product

One API in front, every client speaks of capabilities

A tese · Uma porta

Um IDP é um profile, não o produto

Uma API na frente, todo cliente fala de capacidades

Developer Control PlaneIntegration & Delivery PlaneResource PlaneObservabilitySecurityPLATFORM APIMonitoring & LoggingObservabilityFinOpsIncident MgmtCode AnalysisSecretsIdentityPolicyNetwork SecuritySoftware CatalogApp DeclarationGolden PathsVersion ControlCIRegistryOrchestratorIaCDeliveryComputeDataNetworkingServicesCLIENTS{ }IDEapp.yamlAGENTS.md>_CLI$ nereus init$ platform deploy◧PortalBrowse the catalogCreate from template✦Agents“Create a Postgresfor greeting-api”
The difference · The model

The platform starts empty and grows at runtime

  • Reef: a capability's contract, one API group
  • Nereid: a controller that implements it with a tool
  • Mandate: the default and the rules for its use
A diferença · O modelo

A plataforma começa vazia e cresce em runtime

  • Reef: o contrato de uma capacidade, um API group
  • Nereid: um controller que a implementa com uma ferramenta
  • Mandate: o padrão e as regras de uso
The difference · Moving parts

Swapping the tool changes no command

  • Elsewhere: code soon depends on each tool chosen
  • Here: a second Nereid joins the same Reef
  • The switch: the default Mandate changes, clients don't
A diferença · Peças móveis

Trocar a ferramenta não muda nenhum comando

  • Nos outros: o código logo depende de cada ferramenta escolhida
  • Aqui: um segundo Nereid entra no mesmo Reef
  • A troca: muda o Mandate padrão, os clientes não
The difference · It runs

A Nereid brings its own commands

A diferença · Roda

Um Nereid traz os próprios comandos

~/example
# Prepare a cluster$ nereus init✓ core/api installed # Apply the environment Reef$ nereus reef apply environment✓ core/reefs/environment created Next steps:   nereus environment --help  nereus nereid apply <nereid> --reef environment
Examples · The comparator · 1/3

One contract, two Nereids behind it

Exemplos · O comparator · 1/3

Um contrato, dois Nereids por trás

~/example
# The authentication Reef: the interface every client uses$ nereus reef get authenticationauthentication.getnereus.dev/v1alpha1  sessions  create get list delete   # nereus login
Examples · The comparator · 2/3

A Nereid compares the implementations

Exemplos · O comparator · 2/3

Um Nereid compara as implementações

~/example
# Compare both on login, over 30 days$ nereus comparison create auth-10 \    --reef authentication \    --verb login \    --window 30dscope: sessions create (login)weights: perf 30 · sat 30 · cost 40 sli          slo     keycloak  auth0login <1s    ≥99%    99.2% ✓   99.6% ✓satisfaction ≥4.5    4.1   ~   4.3   ~total cost   ≤R$10k  R$26k ✗   R$11k ~error budget         20%       60%sla                  own team  vendorverdict      auth0
Examples · The comparator · 3/3

A decision switches the default Mandate

Exemplos · O comparator · 3/3

Uma decisão troca o Mandate padrão

~/example
# Record the decision; the default Mandate follows$ nereus comparison decision create keycloak-to-auth0 \    --comparison auth-10 \    --choose auth0✓ decision/keycloak-to-auth0 createdby:       mariaat:       2026-10-21 14:32based on: comparison/auth-10verdict:  auth0 (marginal)event:    authentication.defaultmandate.changed
Examples · Agents

An agent is just one more client of the API

  • The ask: "create a Postgres for greeting-api"
  • No kubeconfig: it speaks of database, not of the tool
  • One door that cannot lie: what it sees is what runs
Exemplos · Agentes

Um agente é só mais um cliente da API

  • O pedido: "crie um Postgres para greeting-api"
  • Sem kubeconfig: fala de database, não da ferramenta
  • Uma porta que não mente: o que ele vê é o que roda
Examples · Collaboration

Agents talk before they collide

  • Claim: a session takes an issue and says which files
  • Ask: before a shared cluster or file, it waits for peers
  • Triton: one agent asks another, every word on record
Exemplos · Colaboração

Agentes conversam antes de colidir

  • Claim: uma sessão pega uma issue e diz quais arquivos
  • Ask: antes de um cluster ou arquivo compartilhado, espera os pares
  • Triton: um agente pede a outro, cada palavra registrada
How we work · Method

Nothing new under the sun, except the agents

  • Old practices: Agile, XP, WIP limits, walking skeleton
  • New executor: an agent carries out each issue alone
  • Rule becomes script: a hook enforces what an agent forgets
Como trabalhamos · Método

Nada de novo sob o sol, exceto os agentes

  • Práticas antigas: Agile, XP, limites de WIP, walking skeleton
  • Novo executor: um agente entrega cada issue sozinho
  • A regra vira script: um hook garante o que o agente esquece
How we work · The groundwork

1165 references back the decisions

  • Platform engineering: 175
  • Security: 158
  • AI and agents: 142
  • DevOps and SRE: 120
  • Agile and lean: 97
Como trabalhamos · O referencial

1165 referências sustentam as decisões

  • Platform engineering: 175
  • Security: 158
  • AI and agents: 142
  • DevOps and SRE: 120
  • Agile and lean: 97
How we work · Where we stand

From hero to platform

Each explicit rule moves the design out of one head

  • Artisanal: implicit design, fragmented ownership
  • Hero-based: implicit design, ownership in few heads
  • Bureaucratic: explicit design, diffuse ownership
  • Platform: explicit design, end-to-end ownership
Como trabalhamos · Onde estamos

Do herói à plataforma

Cada regra explícita tira o desenho de uma cabeça só

  • Artesanal: desenho implícito, ownership fragmentado
  • Herói: desenho implícito, ownership em poucas cabeças
  • Burocrático: desenho explícito, ownership difuso
  • Plataforma: desenho explícito, ownership de ponta a ponta
Closing · The ask

A pilot of the comparator?

  • Scope: one capability, two tools, one real team
  • Measure: performance, satisfaction and cost
  • Outcome: a tool decision backed by data, not opinion
Fechamento · O pedido

Um piloto do comparator?

  • Escopo: uma capacidade, duas ferramentas, um time real
  • Medida: performance, satisfação e custo
  • Resultado: uma decisão de ferramenta baseada em dados, não opinião
References

Sources

Referências

Fontes

References · 1/4

Thinking in Platforms

Kaspar von Grünberg and Luca Galante · 2026

  • About: Platform engineering as the operating model for work in the AI era.
  • For this talk: A platform is the operating model of knowledge work; an Internal Developer Platform is one profile of it.
Referências · 1/4

Thinking in Platforms

Kaspar von Grünberg and Luca Galante · 2026

  • Sobre: Platform engineering como o modelo operacional do trabalho na era da IA.
  • Para esta palestra: Uma plataforma é o modelo operacional do trabalho do conhecimento; um Internal Developer Platform é um profile dela.

https://read.amazon.com/kp/kshare?asin=B0HF615873

References · 2/4

Platform tooling landscape

platformengineering.org

  • About: The five planes of a platform and the tools in each.
  • For this talk: Each box in a plane is a candidate Reef, with one API in front.
Referências · 2/4

Platform tooling landscape

platformengineering.org

  • Sobre: Os cinco planos de uma plataforma e as ferramentas de cada um.
  • Para esta palestra: Cada caixa de um plano é um Reef candidato, com uma API na frente.

https://platformengineering.org/platform-tooling

References · 3/4

Extreme Programming

Kent Beck · 1999

  • About: Small steps that each end in working software.
  • For this talk: The practices are old; what is new is that an agent takes the steps.
Referências · 3/4

Extreme Programming

Kent Beck · 1999

  • Sobre: Passos pequenos que terminam em software funcionando.
  • Para esta palestra: As práticas são antigas; o novo é que um agente dá os passos.

https://en.wikipedia.org/wiki/Extreme_programming

References · 4/4

How to avoid death by PowerPoint

David JP Phillips · 2014

  • About: One message per slide, few words, the presenter carries the rest.
  • For this talk: The style of this deck.
Referências · 4/4

How to avoid death by PowerPoint

David JP Phillips · 2014

  • Sobre: Uma mensagem por slide, poucas palavras, quem apresenta carrega o resto.
  • Para esta palestra: O estilo deste deck.

https://www.youtube.com/watch?v=Iwpi1Lm6dFo