Prompt: gerar o cabeçalho e a documentação padrão de um programa .p

Quando usar

Toda empresa tem um padrão de cabeçalho, e ninguém gosta de preencher. Pior: programa antigo que você alterou continua com o cabeçalho de 2007 dizendo outra coisa. Este prompt lê o código e escreve o cabeçalho a partir do que está lá de fato.

O prompt

Código:

Você é um desenvolvedor Progress ABL sênior.

Leia o programa abaixo e gere a documentação dele. Regra principal:
descreva o que o código FAZ, não o que o nome do programa sugere que ele
faça. Se os dois divergirem, aponte a divergência.

Gere:

A) Um cabeçalho de comentário no formato exato do modelo que eu colei
   abaixo, preenchendo todos os campos. Onde não houver informação no
   código, escreva "A CONFIRMAR" — nunca invente autor, data ou número de
   chamado.

B) Um bloco de comentário por procedure/function interna, com uma linha de
   propósito e a descrição de cada parâmetro.

C) Um resumo de 5 a 10 linhas para colar no chamado ou na wiki, em
   português, para quem não é técnico entender o que o programa faz.

D) Uma lista das dependências: programas chamados com RUN, includes,
   tabelas e temp-tables. Essa lista é o que salva na hora do deploy.

Modelo de cabeçalho:
---
[COLE AQUI O PADRÃO DE CABEÇALHO DA SUA EMPRESA]
---

Programa:
---
[COLE O CÓDIGO AQUI]
---

O que preencher

O modelo de cabeçalho. Cole o padrão da sua empresa mesmo — o da Totvs, o do cliente, o seu. A IA respeita o formato que você der, inclusive alinhamento e largura dos asteriscos.

Se você não tiver um padrão à mão, dá para usar este como ponto de partida:

Código:

/*****************************************************************************
** Programa....:
** Objetivo....:
** Autor.......:
** Data........:
** Versão......:
**-----------------------------------------------------------------------------
** Alterações:
** Data        Autor            Chamado    Descrição
** ----------  ---------------  ---------  ------------------------------------
**
*****************************************************************************/

O que esperar de volta

O item D é o que mais economiza tempo depois. Quando chega a hora de subir para produção e alguém pergunta "o que mais precisa ir junto?", a lista já está pronta no cabeçalho.

E preste atenção quando ela apontar a divergência entre nome e comportamento: programa chamado esrel001.p que na verdade grava em tabela é exatamente o tipo de armadilha que só aparece depois que quebrou.