A-101

A base de conhecimento dos seus agentes de código

Contexto do seu projeto em todo agente de código.

O acervo guarda o contexto do seu projeto numa base única, versionada como código, que se atualiza sozinha a cada merge e a cada sessão de dev.

ACERVOO CONHECIMENTO DO SEU PROJETOPedidos ficam no banco orders-dbStaging-1 é o ambiente de testesTestes de API: make test-apiPOST /pedidos/reembolsoDO CÓDIGOTestar com o pedido 4521DA SESSÃOENSINAAGENTE DO BRUNOAGENTE DA ANAAGENTE DE QUEM CHEGAR AMANHÛ cria o POST /pedidos/reembolsoFeito: endpoint, testes e docs.› como testo o /pedidos/reembolso?Use o pedido 4521 no staging-1.› o que mudou essa semana?Bruno criou o reembolso. Já sei testar.SEMPRE EM DIA
  1. o conhecimento do seu projeto guardado no acervo
  2. agente do Bruno cria o endpoint e ensina o acervo
  3. agente da Ana já sabe testar o endpoint
  4. agente de quem chegar amanhã começa sabendo tudo
Como funcionaBruno trabalhando

(01) Premissa

O conhecimento existe. Só está espalhado.

Folha A-201

(01) Premissa

Folha A-201

(01) Premissa

O conhecimento existe. Só está espalhado.

Folha A-201

acervo, s.m.
conjunto catalogado de bens

acervo, s.m.
conjunto catalogado de bens

No que o acervo acredita

O conhecimento do seu projeto está espalhado. Como testar o reembolso mora na cabeça do Bruno. Qual pedido usar no staging está numa thread do Slack. Alguém explicou o banco de pedidos a um agente semana passada, e fechou a aba. Todo agente começa do zero, e cada pessoa do time ensina tudo de novo. O acervo guarda tudo em um só lugar, atualizado pelo próprio trabalho e lido por todo agente do time.

O conhecimento do seu projeto está espalhado. Como testar o reembolso mora na cabeça do Bruno. Qual pedido usar no staging está numa thread do Slack. Alguém explicou o banco de pedidos a um agente semana passada, e fechou a aba. Todo agente começa do zero, e cada pessoa do time ensina tudo de novo. O acervo guarda tudo em um só lugar, atualizado pelo próprio trabalho e lido por todo agente do time.

O conhecimento do seu projeto está espalhado. Como testar o reembolso mora na cabeça do Bruno. Qual pedido usar no staging está numa thread do Slack. Alguém explicou o banco de pedidos a um agente semana passada, e fechou a aba. Todo agente começa do zero, e cada pessoa do time ensina tudo de novo. O acervo guarda tudo em um só lugar, atualizado pelo próprio trabalho e lido por todo agente do time.

-17%
-17%

Tokens de contexto
por sessão

-4h30m
-4h30m

De tempo
por tarefa

-66%
-66%

Perguntas
ao time

-7 dias
-7 dias

De onboarding

(02) O catálogo

Seis itens do acervo de um projeto

Folha A-301

(02) O catálogo

Folha A-301

(02) O catálogo

Seis itens do acervo de um projeto

Folha A-301

Como funciona.

Seu agente usa o que o time já descobriu.

Seu agente usa o que o time já descobriu.

Seu agente usa o que o time já descobriu.

A-301

A-301

A-301serviço depedidosA-303massa dedadosA-306API depedidosA-302contrato doreembolsoA-305testar oreembolsoA-304POST/reembolso

01

Lê todos os repositórios.

No dia 0, o acervo indexa todos os repositórios da empresa, sejam dez, centenas ou milhares, e levanta endpoints, bancos, comandos e convenções. Cada um vem com o trecho de onde saiu, e o que não bate com esse trecho é descartado.

02

Aprende com as sessões.

Numa sessão, o agente descobre coisas que não estão escritas em nenhum arquivo: como criar massa de dados, qual pedido usar no staging, que comando sobe o ambiente. O que ele aprendeu vira um documento novo para o acervo.

03

Entrega só o que tem a ver.

Quando alguém pede algo a um agente, o acervo manda junto o contexto daquela tarefa, com a origem de cada coisa. Se nada serve, não manda nada.

04

Passa pelo lint.

Antes de entrar no acervo, todo documento novo passa pelo lint. O que está certo entra. O que parece suspeito fica retido.

(03) Como funciona

Como a base se mantém em dia sozinha

Folha A-401

(03) Como funciona

Folha A-401

(03) Como funciona

Como a base se mantém em dia sozinha

Folha A-401

Quatro passos. Nenhum deles é seu.

Quatro passos. Nenhum deles é seu.

Você só trabalha. O acervo aprende com o código e com as sessões, entrega a todo agente e mantém tudo em dia.

Você só trabalha. O acervo aprende com o código e com as sessões, entrega a todo agente e mantém tudo em dia.

SEUS AGENTESO CONHECIMENTO DO PROJETOCOMPARTILHADO COM· o agente da Ana· o agente do Bruno· quem chegar amanhãO QUE TODOS SABEM1ESCREVA O SEUguiasregrasagentes+Banco orders-db+Teste: pedido 4521sessão+POST /reembolsocódigo+Testes: make test-api+Staging-1 de testes+Valores em centavos+6 · APRENDIDO SOZINHO2AGENTE DA ANAAGENTE DO BRUNOCOMPARTILHADO POR TODOSREGRAS COMUNSbancoteste 4521reembolsomake teststaging-1centavosO REGISTROQUAL AGENTE TEM O QUÊBanco orders-dbsalvoseg 10:02Staging-1 de testessalvoseg 10:02POST /pedidos/reembolsosalvoqua 09:15Testar com o pedido 4521salvoqua 09:21…3TODO AGENTE EM DIAA MESMA VERSÃO EM TODOSATUALIZADO AUTOMATICAMENTE4LINTED · 6 ASSETS1 FINDING · FIX ATTACHED

01

Conectar · uma vez

Conectar

Conectar

Rode um comando e aponte para a base de conhecimento, de onde você estiver. É todo o setup.

Você ganha

Uma base para o projeto inteiro

Setup

Um comando

02

Aprender · o tempo todo

Aprender

Aprender

Quando o Bruno faz merge do POST /pedidos/reembolso, o acervo atualiza o que mudou. Quando ele explica ao agente como testar, o acervo guarda. Tudo automático.

Você ganha

Atualização automática

Fontes

Código mergeado, sessões de dev

03

Compartilhar · automático

Compartilhar

Compartilhar

Antes de começar, o agente da Ana recebe o conhecimento mais recente, no formato que ele entende. Ela pergunta como testar o reembolso e ele já sabe.

Você ganha

Todo agente em dia

Mexe em

Só no que o acervo escreveu

04

Manter em dia · sempre

Manter em dia

Manter em dia

A cada merge e a cada sessão, o acervo atualiza sozinho e confere que todo agente tem a mesma versão. Quem chega amanhã já começa sabendo tudo.

Você ganha

Todo agente sempre igual

Esforço

Zero

(04) Tipos de conhecimento

O que um acervo guarda

Folha A-501

(04) Tipos de conhecimento

Folha A-501

(04) Tipos de conhecimento

O que um acervo guarda

Folha A-501

Cinco tipos de conhecimento, um só formato.

Cinco tipos de conhecimento, um só formato.

Tudo o que seus agentes precisam saber cabe em cinco tipos, do passo a passo para testar o reembolso à regra de que valores vão sempre em centavos. O acervo escreve nos formatos abertos que a maioria dos agentes já lê, e traduz para os que não leem.

Tudo o que seus agentes precisam saber cabe em cinco tipos, do passo a passo para testar o reembolso à regra de que valores vão sempre em centavos. O acervo escreve nos formatos abertos que a maioria dos agentes já lê, e traduz para os que não leem.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

TESTAR REEMBOLSOquando: testar1. suba o staging-12. use o pedido 4521GUIAS“como testo o reembolso?”

M-01

Guia

Um passo a passo, usado quando a tarefa pede

Know-how passo a passo, como testar o reembolso no staging-1 com o pedido 4521. O agente só usa quando a tarefa pede.

Passe o mouse, foque ou toque num tipo para ver como ele funciona

(05) No dia a dia

Situações comuns, resolvidas sozinhas

Folha A-601

(05) No dia a dia

Folha A-601

(05) No dia a dia

Situações comuns, resolvidas sozinhas

Folha A-601

O que muda no dia a dia do time.

O que muda no dia a dia do time.

#

Situação · o que o acervo faz

Exemplo

Tipo

01

Bruno criou um endpoint

Todo agente passa a saber usar e testar

Reembolso

Código

02

Um dev explicou algo ao agente

Vira conhecimento do projeto, automaticamente

Pedido 4521

Sessão

03

Alguém novo entrou no time

O agente dele já sabe o projeto no primeiro dia

Onboarding

Novo

04

A Ana pergunta como testar o reembolso

O agente dela responde: pedido 4521 no staging-1

Reembolso

Pergunta

05

Uma regra do projeto mudou

Todo agente recebe a versão nova, automaticamente

Centavos

Regra

06

O Bruno mudou o contrato do endpoint

Todo agente passa a usar o contrato novo

Pedidos

Mudança

07

Alguém voltou de férias

O agente dele já sabe o que mudou

Férias

Retorno

08

Todo agente sabe a mesma coisa

Nada a fazer

-

Tudo certo

01

Bruno criou um endpoint

Todo agente passa a saber usar e testar

Reembolso

Código

02

Um dev explicou algo ao agente

Vira conhecimento do projeto, automaticamente

Pedido 4521

Sessão

03

Alguém novo entrou no time

O agente dele já sabe o projeto no primeiro dia

Onboarding

Novo

04

A Ana pergunta como testar o reembolso

O agente dela responde: pedido 4521 no staging-1

Reembolso

Pergunta

05

Uma regra do projeto mudou

Todo agente recebe a versão nova, automaticamente

Centavos

Regra

06

O Bruno mudou o contrato do endpoint

Todo agente passa a usar o contrato novo

Pedidos

Mudança

07

Alguém voltou de férias

O agente dele já sabe o que mudou

Férias

Retorno

08

Todo agente sabe a mesma coisa

Nada a fazer

-

Tudo certo

(07) Acesso antecipado

Pilotos, rollouts, revisões de segurança

Folha A-801

(07) Acesso antecipado

Folha A-801

(07) Acesso antecipado

Pilotos, rollouts, revisões de segurança

Folha A-801

( Vamos conversar )

Vamos implementar o Acervo no seu projeto?

A base de conhecimento dos seus agentes de código