Roadmap de produto no vibe coding: tabela de 4 colunas, um ID só

O arquivo de melhorias estava tão cheio de texto que Martin não via o próximo passo. Ele falou isso na live de 66 min: o humano se perde e a IA, no mesmo arquivo, ainda tem o que ler. Um roadmap de produto no vibe coding é o arquivo que você abre e entende de relance, uma tabela de 4 colunas, um ID por feature. A instrução longa e o detalhe de implementação ficam noutro arquivo, o de detalhe, que só o modelo abre na hora de construir.

A feature 112 no melhorias virava o item 47 no roadmap. 2 números para a mesma linha de trabalho. Ele pediu o modelo do CV Gestão, os 10 primeiros itens, 4 colunas (número, o que é, por que importa, concluído ou pendente), e mandou o resto das instruções para um arquivo que ele não precisa abrir.

O melhorias virou texto demais para quem constrói

Martin reclamou de contexto demais no lugar errado: o melhorias misturava mapa e manual, e ele não apontava o que vinha agora.

esse arquivo melhorias é tanto texto que eu, Martin, que sou um ser humano e não sou uma Iá, tô perdido quanto a os próximos passos, o que que tem que ser feito.

A mesma feature tinha 2 números. Ele trabalhava a 112 no melhorias. Quando a linha ia para o roadmap, virava 47.

Hoje a gente faz um arquivo, trabalha uma feature no melhorias, que é o número 112. Aí quando vai pro roadmap é o item 47, é tipo uns números diferente. Isso aí tá ruim, entendeu?

Você abre um arquivo, procura 112, abre o outro, procura 47, e gasta a sessão reconciliando índice enquanto o próximo passo do produto continua sem dono.

As 4 colunas que o CV Gestão já tinha

Ele pediu o modelo que já tinham usado no CV Gestão, incompleto de propósito: só os 10 primeiros itens, para mostrar que a tabela é simples. Ele já tinha usado essa lógica ao dar um arquivo de referência pra IA. Desta vez o exemplo na tela é a tabela que ele consegue varrer. Isso aparece também em nicho de produto.

eu só queria que você trouxesse o modelo de road map que a gente fez pro projeto do CV Gestão. Não precisa colocar ele completo, pode colocar só os primeiros 10 itens, mas tipo assim, só para eu mostrar que é uma tabela simples

Ele ditou as 4 colunas de memória e deu o exemplo que separa rótulo de explicação.

eram quatro colunas, né? o número da feature. Uma breve explicação ali, né? Uma explicação, não é o título da feature, tipo agendar followup direto do drawer. Aí explica a feature que é, ó, ah, aqui é pro usuário conseguir fazer um followup direto do orçamento sem precisar fazer X, Y, Z. E o porqu era importante, né? Então, eram essas as colunas. E daí mais uma coluna explicando se já foi concluído ou não.

"agendar followup direto do drawer" é o rótulo. A célula ao lado diz o que o usuário consegue fazer sem sair do orçamento. Essa é a coluna que o humano lê. Com só o título do ticket, você ainda chama a IA para decodificar. Com a frase curta, 10 linhas bastam para ver o estado do produto.

Instrução de build no vibe coding vai para o arquivo de detalhe

Martin partiu o trabalho em voz alta: o que ele precisa ver fica na tabela, o que não é visão simples vai para o outro arquivo.

tudo, todas essas instruções para você, que é o o porqu importa, sei lá, eh, tudo que que não é uma uma visão simples para eu entender, coloque em um em um outro arquivo de detalhe que só você abre na hora de construir.

O "por que importa" da tabela é a versão curta, para ele. A instrução de construção e o texto que só o modelo usa na hora de implementar vão para o arquivo de detalhe. Ele cogitou juntar melhorias com hold e não fundiu: melhorias continua sendo material da IA, o humano quer a lista.

Na sequência, pediu um holdmap na raiz, com o nome exemplo-holdmap.md, para ter um mapa que ele consiga abrir. O arquivo map que ele já tinha falhava no mesmo ponto: começava com um bloco que não era para ele.

Tu consegue transformar isso num arquivo aqui na raiz mesmo, só exemplo, traço holdmap. MD.

hoje eu abro o arquivo map e tem um monte de explicação ali na parte de do início que não é para mim, entendeu? que são instruções para você

A tabela fica para o humano e o detalhe para o modelo, com o mesmo ID nos 2 arquivos.

112 tem que ser 112 nos 2 arquivos

Amanhã, no repo, uma tabela de 4 colunas com os 10 primeiros itens já mostra se você ainda lê o produto. O ID 112 permanece 112. O exemplo-holdmap.md fica na raiz para o modelo copiar o formato, e o arquivo de detalhe só abre na hora de construir.

Quem quiser o momento em que ele dita as colunas e pede o exemplo-holdmap.md na raiz pode assistir à live de 66 min. A partição entre mapa humano e instrução de modelo é o jeito do vibe coding quando o mesmo arquivo ainda mistura os 2.