Nereus
A composable platform API, more than an IDP
Nereus
Uma API de plataforma componível, mais que um IDP
Fifteen minutes to show why I think this is bigger than an IDP. The idea, what sets it apart, two examples, and how the work happens.
The ask comes at the end: one small, concrete step.
Quinze minutos para mostrar por que acho que isto é maior que um IDP. A ideia, o que a diferencia, dois exemplos e como o trabalho acontece.
O pedido vem no fim: um passo pequeno e concreto.
An IDP is one profile, not the product
One API in front, every client speaks of capabilities
Um IDP é um profile, não o produto
Uma API na frente, todo cliente fala de capacidades
The product is the Platform API, the one door. The CLI, a portal, an IDE reading an app.yaml and an agent all go through it; none needs a kubeconfig, and all speak of capabilities, never of the tools behind them.
An Internal Developer Platform is one profile: a list of capabilities installed together. Thinking in Platforms gives the same thesis words: a platform serves any recurring knowledge work, with an "internal marketing platform" and a "patient tracking platform" as examples (p. 20).
The five planes come from the platform tooling landscape; each box is a candidate capability.
Sources:
O produto é a Platform API, a porta única. A CLI, um portal, uma IDE lendo um app.yaml e um agente passam todos por ela; nenhum precisa de kubeconfig, e todos falam de capacidades, nunca das ferramentas por trás.
Um Internal Developer Platform é um profile: uma lista de capacidades instaladas juntas. O Thinking in Platforms dá palavras à mesma tese: uma plataforma serve qualquer trabalho do conhecimento recorrente, com uma "internal marketing platform" e uma "patient tracking platform" como exemplos (p. 20).
Os cinco planos vêm do platform tooling landscape; cada caixa é uma capacidade candidata.
Fontes:
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 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
Three words carry the whole model (ADR 0002). A Reef is the contract, say authentication. A Nereid is the implementation, say Keycloak. A Mandate says which Nereid is the default and with what settings.
Everything is installed at runtime: a new Reef brings its API, a new Nereid brings its own commands to the CLI. Nothing is compiled into the platform.
The full deck: docs/presentations/nereus.html.
Três palavras carregam o modelo inteiro (ADR 0002). Um Reef é o contrato, por exemplo authentication. Um Nereid é a implementação, por exemplo Keycloak. Um Mandate diz qual Nereid é o padrão e com que configuração.
Tudo é instalado em runtime: um Reef novo traz sua API, um Nereid novo traz seus próprios comandos para a CLI. Nada é compilado dentro da plataforma.
O deck completo: docs/presentations/nereus.html.
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
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
This is the difference from the IDPs I know. A platform team picks tools from the CNCF Landscape, and soon scripts, templates and apps depend on each choice; changing it is a project.
Here the choice stays a moving part from day one (ADR 0011). A team tries a tool as a Nereid; if it does not fit, it adds another to the same Reef and switches the default Mandate. No command, client or app declaration changes.
Esta é a diferença para os IDPs que conheço. Um time de plataforma escolhe ferramentas do CNCF Landscape, e logo scripts, templates e apps dependem de cada escolha; trocar vira um projeto.
Aqui a escolha continua uma peça móvel desde o primeiro dia (ADR 0011). Um time testa uma ferramenta como Nereid; se não servir, acrescenta outro ao mesmo Reef e troca o Mandate padrão. Nenhum comando, cliente ou declaração de app muda.
A Nereid brings its own commands
Um Nereid traz os próprios comandos
# 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
It is not a drawing: the first slice runs on a local k3d. nereus init prepares a cluster, a Reef arrives with its API, and the CLI learns the commands its Nereid publishes.
Every output says what changed and what comes next, in kubectl's words. The exact output here is abbreviated; the profile today already runs tenancy, release, environment, database, metrics, secrets, authentication, catalog, scm, delivery, registry and build.
Não é um desenho: a primeira fatia roda num k3d local. nereus init prepara um cluster, um Reef chega com sua API, e a CLI aprende os comandos que seu Nereid publica.
Toda saída diz o que mudou e o que vem depois, com as palavras do kubectl. A saída aqui está resumida; o profile hoje já roda tenancy, release, environment, database, metrics, secrets, authentication, catalog, scm, delivery, registry e build.
One contract, two Nereids behind it
Um contrato, dois Nereids por trás
# The authentication Reef: the interface every client uses$ nereus reef get authenticationauthentication.getnereus.dev/v1alpha1 sessions create get list delete # nereus login
An interface is a Reef. Clients only know sessions create, which is nereus login; they never know which tool answers.
Both live at once: the {nereid:keycloak} Nereid and an {nereid:auth0} Nereid, behind the same contract, each with a share of the traffic. Every request goes through Nereus, so both are measured with the same yardstick.
The full deck: docs/presentations/implementation-comparator.html.
Uma interface é um Reef. Os clientes só conhecem sessions create, que é o nereus login; nunca sabem qual ferramenta responde.
Os dois no ar ao mesmo tempo: o Nereid {nereid:keycloak} e um Nereid {nereid:auth0}, atrás do mesmo contrato, cada um com uma parte do tráfego. Todo pedido passa pelo Nereus, então os dois são medidos com a mesma régua.
O deck completo: docs/presentations/implementation-comparator.html.
A Nereid compares the implementations
Um Nereid compara as implementações
# 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
Three measures, weights the team sets: performance from one trace, from request to Ready; satisfaction from a one-key score; total cost, license plus who keeps it running.
Faster login doesn't decide on its own. Keycloak has no license, but someone keeps it running: the cost a benchmark doesn't show. Hypotheses are proven with experiment metrics, and we measure flow, never individuals.
Três medidas, com pesos que o time define: performance de um trace só, do pedido ao Ready; satisfação de uma nota com uma tecla; custo total, licença mais quem mantém de pé.
Login mais rápido não decide sozinho. O Keycloak não tem licença, mas alguém mantém de pé: o custo que o benchmark não mostra. Hipóteses são provadas com métricas de experimentos, e medimos fluxo, nunca indivíduos.
A decision switches the default Mandate
Uma decisão troca o Mandate padrão
# 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
A person decides, the platform records and applies. The decision names who, when and on what data; its event switches the default Mandate, and no client changes.
The platform becomes a laboratory for technical decisions: every tool choice tested in production, measured and reversible, instead of argued in a meeting. These commands are the contract of the proposal, not built yet.
Uma pessoa decide, a plataforma registra e aplica. A decisão diz quem, quando e com base em quais dados; o seu evento troca o Mandate padrão, e nenhum cliente muda.
A plataforma vira um laboratório de decisões técnicas: toda escolha de ferramenta testada em produção, medida e reversível, em vez de discutida numa reunião. Estes comandos são o contrato da proposta, ainda não construídos.
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
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
The same door serves people and agents. An agent asked for a Postgres calls the {reef:database} Reef; the {nereid:cloudnative-pg} Nereid does the work.
The API is the one door, and it cannot lie (a pillar): permissions, policy and cost apply to the agent as to anyone, and what it reports is the real state.
A mesma porta serve pessoas e agentes. Um agente que recebe o pedido de um Postgres chama o Reef {reef:database}; o Nereid {nereid:cloudnative-pg} faz o trabalho.
A API é a porta única, e não pode mentir (uma pillar): permissões, policy e custo valem para o agente como para qualquer um, e o que ele relata é o estado real.
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
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
Several agent sessions work on this repository at once, each on its own issue and worktree. They coordinate with four messages only: claim, ask, release and note.
Triton takes this to the platform: a room across users and machines, where an order can come from a phone and one agent can ask another, logged in to Nereus and on record.
The decks: docs/presentations/triton.html and docs/presentations/how-we-work.html.
Várias sessões de agentes trabalham neste repositório ao mesmo tempo, cada uma na sua issue e worktree. Elas se coordenam com quatro mensagens apenas: claim, ask, release e note.
O Triton leva isto para a plataforma: uma sala entre usuários e máquinas, onde uma ordem pode vir do celular e um agente pode pedir a outro, autenticado no Nereus e com registro.
Os decks: docs/presentations/triton.html e docs/presentations/how-we-work.html.
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
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
The practices are fifty years old; what is new is who carries them out. Each issue holds all its context so an agent can deliver it alone, and the board limits work in progress.
Deterministic first, AI only where it is good: a rule that depends on an agent remembering it becomes a hook, a test or a script.
The full deck: docs/presentations/how-we-work.html.
Sources:
As práticas têm cinquenta anos; o novo é quem as executa. Cada issue carrega todo o contexto para um agente entregá-la sozinho, e o board limita o trabalho em andamento.
Determinístico primeiro, IA só onde é boa: uma regra que depende de o agente lembrar vira um hook, um teste ou um script.
O deck completo: docs/presentations/how-we-work.html.
Fontes:
1165 references back the decisions
- Platform engineering: 175
- Security: 158
- AI and agents: 142
- DevOps and SRE: 120
- Agile and lean: 97
1165 referências sustentam as decisões
- Platform engineering: 175
- Security: 158
- AI and agents: 142
- DevOps and SRE: 120
- Agile and lean: 97
Every decision names where it came from. The list in docs/references.md has 1165 sources in sixteen themes, each marked with who brought it and whether it was checked on the web.
Twenty-three pillars guide the work, from the Agile Manifesto to "the same quality for fewer tokens"; the agents read them, so they value what the project values.
Source: docs/references.md and docs/vision.md.
Toda decisão diz de onde veio. A lista em docs/references.md tem 1165 fontes em dezesseis temas, cada uma marcada com quem a trouxe e se foi verificada na web.
Vinte e três pillars guiam o trabalho, do Manifesto Ágil a "a mesma qualidade com menos tokens"; os agentes as leem, então valorizam o que o projeto valoriza.
Fonte: docs/references.md e docs/vision.md.
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
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
Thinking in Platforms places production systems on two axes (p. 36-37): whether the design is explicit or implicit, and whether ownership is concentrated or fragmented.
Nereus starts close to hero-based: one owner holds most of the context. Each written rule, hook and self-contained issue moves it toward the platform quadrant; the risk on the way is bureaucracy, so each rule names its reason.
Sources:
O Thinking in Platforms coloca os sistemas de produção em dois eixos (p. 36-37): se o desenho é explícito ou implícito, e se o ownership é concentrado ou fragmentado.
O Nereus começa perto do modelo herói: um dono guarda a maior parte do contexto. Cada regra escrita, hook e issue autossuficiente o move para o quadrante de plataforma; o risco no caminho é a burocracia, então cada regra diz o seu motivo.
Fontes:
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
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
One small, concrete step: pick one capability where there is a real tool debate, run both behind the same contract, and let the comparator decide.
If it works, it shows the bigger idea in practice: a platform as the operating model of the work, with the IDP as its first profile.
Um passo pequeno e concreto: escolher uma capacidade onde existe um debate real de ferramenta, rodar as duas atrás do mesmo contrato e deixar o comparator decidir.
Se funcionar, mostra a ideia maior na prática: uma plataforma como modelo operacional do trabalho, com o IDP como o primeiro profile.
Sources
Fontes
- Thinking in Platforms · Kaspar von Grünberg and Luca Galante · 2026
- Platform tooling landscape · platformengineering.org
- Extreme Programming · Kent Beck · 1999
- How to avoid death by PowerPoint · David JP Phillips · 2014
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.
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.
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.
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.
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.
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.
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.
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.