> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gere notas de versão

> Toda semana, transforme mudanças do GitHub e do Linear em notas de versão que as pessoas realmente conseguem ler.

export const Connectors = ({items}) => <div style={{
  margin: "8px 0 20px"
}}>
    <style>{`
      .connectors-list, .connectors-list * { margin-top: 0 !important; margin-bottom: 0 !important; }
      .connectors-row {
        display: flex !important;
        align-items: flex-start !important;
        gap: 10px !important;
        padding: 4px 0 !important;
        min-height: 0 !important;
        height: auto !important;
      }
      .connectors-row img {
        width: 20px !important;
        height: 20px !important;
        max-width: 20px !important;
        max-height: 20px !important;
        margin: 2px 0 0 !important;
        display: block !important;
      }
    `}</style>
    <div className="connectors-list">
      {items.map((item, i) => <div key={item.id} className="connectors-row" style={{
  borderTop: i === 0 ? "none" : "1px solid rgba(130,130,130,0.22)"
}}>
          <img src={`/images/connectors/${item.id}.svg`} alt="" width={20} height={20} />
          <div style={{
  minWidth: 0
}}>
            <div>
              <strong>{item.name}</strong>
              {item.why ? <span style={{
  opacity: 0.72
}}> · {item.why}</span> : null}
            </div>
            {item.auth === "api-key" ? <div style={{
  fontSize: "11.5px",
  lineHeight: 1.35,
  color: "#F26207",
  marginTop: "2px"
}}>
                Not a native connector. Agent will ask for your API key.
              </div> : null}
          </div>
        </div>)}
    </div>
  </div>;

export const AiPrompt = ({children}) => {
  return <CodeBlock className="relative block max-w-full overflow-x-hidden font-sans !whitespace-pre-wrap !break-words" style={{
    overflowWrap: "anywhere",
    wordBreak: "break-word"
  }}>
      <div className="pr-7" style={{
    whiteSpace: "pre-wrap",
    overflowWrap: "anywhere",
    wordBreak: "break-word"
  }}>
        {children}
      </div>
    </CodeBlock>;
};

Toda semana, extraia as mudanças do GitHub e do Linear, gere notas de versão voltadas ao
cliente, agrupadas em Novidades, Melhorias e Correções, e publique-as no Notion. Ignore
tarefas apenas internas e sinalize qualquer coisa que pareça uma mudança que quebra
compatibilidade (breaking change), para que produto, suporte e clientes compartilhem a mesma
história em uma cadência regular.

## Ideal para

* Gerentes de produto que precisam de um changelog semanal sem esperar por uma tag de versão.
* Marketing de produto e suporte que precisam da mesma história que os clientes recebem.

## Conectores

<Connectors
  items={[
{ id: "github", name: "GitHub", why: "Pull requests mesclados e tags" },
{ id: "linear", name: "Linear", why: "Issues e títulos voltados ao cliente" },
{ id: "notion", name: "Notion", why: "Notas publicadas" },
]}
/>

## Antes de começar

Aponte o Agent para o repositório e o time no Linear. Conecte o Notion para a página
publicada. Diga em qual dia a execução semanal deve acontecer.

## Prompt para o agente

<AiPrompt>
  Crie uma rotina que rode toda segunda-feira às 9h. Extraia as mudanças da
  semana passada do GitHub e do Linear, gere notas de versão voltadas ao
  cliente, agrupadas em Novidades, Melhorias e Correções, e publique-as no
  Notion. Ignore tarefas apenas internas. Sinalize qualquer coisa que
  pareça uma mudança que quebra compatibilidade.
</AiPrompt>

## O que esperar

O Agent redige as notas da semana passada a partir dos pull requests e issues, e então
escreve uma página no Notion. Ajuste o tom antes de enviar aos clientes. Ignore qualquer
coisa que pareça uma tarefa interna, e coloque as mudanças que quebram compatibilidade no
topo. Compare a página com os pull requests mesclados na semana passada antes de publicar.

## Adapte ao seu caso

<AiPrompt>
  Escreva duas versões: uma para clientes, outra para o changelog interno.
  Mantenha-as na mesma página do Notion.
</AiPrompt>

<AiPrompt>
  Adicione uma postagem no Slack em #ship que linke a página do Notion e
  liste os 3 destaques.
</AiPrompt>

## Solução de problemas

* **Tarefas internas aparecem nas notas:** aponte o Agent para o repositório e o time correto no Linear, e peça novamente para ignorar tarefas que nunca chegam aos clientes.
* **Uma mudança que quebra compatibilidade ficou escondida:** diga ao Agent o que "quebra compatibilidade" significa para você (login, cobrança ou uma migração obrigatória) e peça para colocar esses itens no topo, sinalizados.
* **A página do Notion está errada:** forneça o link exato da página ou do banco de dados, e diga se deve sobrescrever as notas da semana passada ou criar uma nova página a cada execução.

## Relacionados

<CardGroup cols={2}>
  <Card title="Buscar candidatos" href="/pt/use-cases/source-candidates">
    O mesmo conector do GitHub para contratação, não para lançamentos.
  </Card>

  <Card title="Analise feedback de clientes" href="/pt/use-cases/analyze-customer-feedback">
    Para gerentes de produto que também revisam tickets no Notion.
  </Card>
</CardGroup>