How we work

Building software with AI agents, told from a real repository

Como trabalhamos

Construindo software com agentes de IA, a partir de um repositório real

Opening

Nothing new under the sun

Source: Ecclesiastes 1:9

Abertura

Nada de novo debaixo do sol

Fonte: Ecclesiastes 1:9

Opening

The same problems for fifty years

  • 1968: the field is named software engineering, as a provocation
  • 1975: adding people to a late project makes it later
  • Today: with more AI, teams deliver faster and less stably

Source: The storytelling deck

Abertura

Os mesmos problemas há cinquenta anos

  • 1968: o campo recebe o nome de engenharia de software, como provocação
  • 1975: adicionar pessoas a um projeto atrasado o atrasa ainda mais
  • Hoje: com mais IA, os times entregam mais rápido e com menos estabilidade

Fonte: The storytelling deck

Opening

Except the AI agents

You already use them, so what changes?

Abertura

A não ser os agentes de IA

Vocês já os usam, então o que muda?

Method

Small steps, and now an agent takes them

  • Agile Manifesto, 2001: working software is the primary measure of progress
  • Extreme Programming, 1999: small steps that each end in working software
  • New: an agent on one side of the pair

Source: Agile Manifesto principles; Extreme Programming Explained

Método

Passos pequenos, e agora um agente os dá

  • Manifesto Ágil, 2001: software funcionando é a principal medida de progresso
  • Extreme Programming, 1999: passos pequenos que terminam em software funcionando
  • Novo: um agente de um dos lados do par

Fonte: Agile Manifesto principles; Extreme Programming Explained

Method

The issue now carries all the context

An agent takes it from the board and delivers it alone

  • Context: and the decisions taken, by whom and when
  • Dependencies: and what each one delivers
  • Facts: checked in the code
  • Done when: a check the agent can run itself
Método

A issue agora carrega todo o contexto

Um agente a pega do board e entrega sozinho

  • Contexto: e as decisões tomadas, por quem e quando
  • Dependências: e o que cada uma entrega
  • Fatos: conferidos no código
  • Pronto quando: uma verificação que o próprio agente roda
Flow

An old limit, tuned for agents

Work in progress (WIP), per person, on every board

  • 1: the queue refuses a second item
  • 3: until the work began to run through subagents
  • 10: a session now holds several issues at once

Source: The Kanban Guide

Fluxo

Um limite antigo, ajustado para agentes

Trabalho em andamento (WIP), por pessoa, em todo board

  • 1: a fila recusa um segundo item
  • 3: até o trabalho começar a passar por subagentes
  • 10: uma sessão agora segura várias issues ao mesmo tempo

Fonte: The Kanban Guide

Flow

The rule became a script

Nobody has to remember it

Fluxo

A regra virou script

Ninguém precisa lembrar

~/nereus
# Take an eleventh issue$ scripts/board/queue claim 111refused: #101, #102, #103, #104, #105, #106, #107, #108, #109, #110 already In Progress for maria (WIP limit 10); finish one or release it first
~/nereus
# Pegar uma décima primeira issue$ scripts/board/queue claim 111refused: #101, #102, #103, #104, #105, #106, #107, #108, #109, #110 already In Progress for maria (WIP limit 10); finish one or release it first
Flow

The real board, live

The same flow metrics, read by people and agents

Source: The Kanban Guide

Fluxo

O board real, ao vivo

As mesmas métricas de fluxo, lidas por pessoas e agentes

Fonte: The Kanban Guide

~/nereus
# Who holds what, right now$ scripts/board/queue team # What arrived and what was completed, per week$ scripts/board/queue metrics \    --weeks 4
~/nereus
# Quem está com o quê, agora$ scripts/board/queue team # O que chegou e o que foi concluído, por semana$ scripts/board/queue metrics \    --weeks 4
The division of work

A session coordinates, subagents deliver

And the owner decides

  • Creating an agent: one issue, its own worktree, a brief that stands alone
  • The session: holds several issues, reviews, relays what matters
  • The owner: sets the priorities and the merge order, and says when to push
A divisão do trabalho

Uma sessão coordena, subagentes entregam

E o dono decide

  • Criar um agente: uma issue, sua própria worktree, um briefing que se sustenta sozinho
  • A sessão: segura várias issues, revisa, repassa o que importa
  • O dono: define as prioridades e a ordem dos merges, e diz quando fazer push
Agents talking

Sessions talk before they collide

  • A name: each session gets one from the NATO alphabet, from a hook
  • [claim]: the issue, the worktree and the paths it will touch
  • [ask]: before a shared resource, such as a cluster
  • [release]: what it no longer holds
Agentes conversando

As sessões conversam antes de colidir

  • Um nome: cada sessão recebe um do alfabeto da OTAN, por um hook
  • [claim]: a issue, a worktree e os caminhos que vai tocar
  • [ask]: antes de um recurso compartilhado, como um cluster
  • [release]: o que não segura mais
Agents talking

An order can come from a phone

  • Remote sessions: the same session, followed and driven from a phone
  • Triton: the switchboard that hands an order to an idle agent
  • The beach: work orders that leave a voice session and reach a local agent
Agentes conversando

Uma ordem pode vir do celular

  • Sessões remotas: a mesma sessão, acompanhada e conduzida pelo celular
  • Triton: a central que entrega uma ordem a um agente livre
  • A beach: ordens de trabalho que saem de uma sessão de voz e chegam a um agente local
Costs

Every order has a price

Estimated from its tokens and recorded; the figures stay private

  • One order per session: every call reads the whole context again
  • Filtered output: what enters the context is read on every later call
  • Subagents: for mechanical work, on a lighter model
  • Every week: tokens and cost per order, against the week before
Custos

Toda ordem tem um preço

Estimado pelos tokens e registrado; os valores ficam privados

  • Uma ordem por sessão: cada chamada lê todo o contexto de novo
  • Saída filtrada: o que entra no contexto é lido em toda chamada seguinte
  • Subagentes: para trabalho mecânico, em um modelo mais leve
  • Toda semana: tokens e custo por ordem, contra a semana anterior
Memory

ADRs have a new reader: the agent

Every session is a new person on the project

  • 2011: short, numbered decision records, kept in the repository
  • Now: a session starts empty and reads them before designing
  • Guides: one page per topic, read when the topic comes up

Source: Michael Nygard, Documenting Architecture Decisions

Memória

Os ADRs têm um novo leitor: o agente

Toda sessão é uma pessoa nova no projeto

  • 2011: registros de decisão curtos e numerados, guardados no repositório
  • Agora: uma sessão começa vazia e os lê antes de projetar
  • Guias: uma página por assunto, lida quando o assunto aparece

Fonte: Michael Nygard, Documenting Architecture Decisions

Improvement

The team still reflects, the agents read it

  • Every order: its tokens, estimated cost and pull request, by a script
  • Every wave: a panel of stakeholders proposes improvements as issues
  • The pillars: written for the agents too, so they come to value them

Source: Agile Manifesto principles

Melhoria

O time ainda reflete, os agentes leem

  • Toda ordem: tokens, custo estimado e pull request, por um script
  • Toda onda: um painel de stakeholders propõe melhorias como issues
  • Os pilares: escritos também para os agentes, para que passem a valorizá-los

Fonte: Agile Manifesto principles

Closing

Nothing new under the sun, except the AI agents

Fechamento

Nada de novo debaixo do sol, a não ser os agentes de IA

Closing

Next week, try one old practice with your agents

  • The WIP limit: pick a number, and make a script refuse the next item
  • An issue an agent can carry out alone: with a check it runs itself
  • An ADR: one decision your agent should read before changing it
Fechamento

Na semana que vem, teste uma prática antiga com seus agentes

  • O limite de WIP: escolha um número, e faça um script recusar o próximo item
  • Uma issue que um agente executa sozinho: com uma verificação que ele mesmo roda
  • Um ADR: uma decisão que seu agente deve ler antes de mudá-la
Closing

Thank you

Fechamento

Obrigado

References

Sources

Referências

Fontes

References · 1/6

Ecclesiastes 1

  • About: The chapter of the Hebrew Bible where the phrase comes from.
  • For this talk: "There is nothing new under the sun" (verse 9) is the first half of this talk.
Referências · 1/6

Ecclesiastes 1

  • Sobre: O capítulo da Bíblia hebraica de onde vem a frase.
  • Para esta palestra: "Nada de novo debaixo do sol" (versículo 9) é a primeira metade desta palestra.

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

References · 2/6

Principles behind the Agile Manifesto

Agile Manifesto signatories · 2001

  • About: The twelve principles behind the Manifesto for Agile Software Development.
  • For this talk: "Working software is the primary measure of progress", and "at regular intervals, the team reflects on how to become more effective".
Referências · 2/6

Principles behind the Agile Manifesto

Agile Manifesto signatories · 2001

  • Sobre: Os doze princípios por trás do Manifesto para o Desenvolvimento Ágil de Software.
  • Para esta palestra: "Working software is the primary measure of progress", e "at regular intervals, the team reflects on how to become more effective".

https://agilemanifesto.org/principles.html

References · 3/6

Extreme Programming

Kent Beck · 1999

  • About: The method Kent Beck developed and described in Extreme Programming Explained, published in October 1999.
  • For this talk: Small steps that each end in working software; here, with an agent on one side of the pair.
Referências · 3/6

Extreme Programming

Kent Beck · 1999

  • Sobre: O método que Kent Beck desenvolveu e descreveu em Extreme Programming Explained, publicado em outubro de 1999.
  • Para esta palestra: Passos pequenos que terminam em software funcionando; aqui, com um agente de um dos lados do par.

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

References · 4/6

The Kanban Guide

John Coleman, Daniel Vacanti and others · 2025

  • About: A short definition of Kanban: the flow, its practices and its four mandatory metrics.
  • For this talk: "Kanban system members must explicitly control the number of work items in a workflow from started to finished."
Referências · 4/6

The Kanban Guide

John Coleman, Daniel Vacanti and others · 2025

  • Sobre: Uma definição curta de Kanban: o fluxo, suas práticas e suas quatro métricas obrigatórias.
  • Para esta palestra: "Kanban system members must explicitly control the number of work items in a workflow from started to finished."

https://kanbanguides.org/english/

References · 5/6

Documenting Architecture Decisions

Michael Nygard · 2011

  • About: The post that proposes short, numbered decision records kept in the repository: title, context, decision, status and consequences.
  • For this talk: "A new person coming on to a project may be perplexed, baffled, delighted, or infuriated by some past decision."
Referências · 5/6

Documenting Architecture Decisions

Michael Nygard · 2011

  • Sobre: O texto que propõe registros de decisão curtos e numerados, guardados no repositório: título, contexto, decisão, status e consequências.
  • Para esta palestra: "A new person coming on to a project may be perplexed, baffled, delighted, or infuriated by some past decision."

https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions

References · 6/6

Times importam mais do que nunca

Paulo Caroli

  • About: A book on human direction and AI acceleration in product work.
  • For this talk: The AI accelerates, people set the direction and decide.
Referências · 6/6

Times importam mais do que nunca

Paulo Caroli

  • Sobre: Um livro sobre direção humana e aceleração com IA no trabalho de produto.
  • Para esta palestra: A IA acelera, as pessoas dão a direção e decidem.

https://caroli.org/livro/times-importam-mais-do-que-nunca/