Tecnologia além do código.
Régys Borges da Silveira
Início / Acervo

Tag: especificação

7 resultado(s)

Mesa ilustrativa com pedido de revisão, procedimento e relatório, representando uma skill

Sua primeira skill: transforme uma tarefa repetitiva em um procedimento

Você pede à IA para revisar uma alteração. Na primeira vez, lembra de explicar o objetivo, indicar os arquivos e exigir evidências.

Ver resumo completo

Você pede à IA para revisar uma alteração. Na primeira vez, lembra de explicar o objetivo, indicar os arquivos e exigir evidências. Na segunda, esquece de avisar que a revisão não pode modificar o código. Na terceira, recebe uma resposta organizada, mas sem saber se os testes mencionados realmente foram executados. Falta um procedimento que possa ser reutilizado sem depender da memória de cada conversa.

Uma skill pode organizar esse trabalho. Vamos construir uma pequena skill de revisão de uma rotina de importação em Delphi, partindo do pedido concreto e chegando às instruções de execução. O cenário é fictício. O objetivo é aprender a estruturar o procedimento, não anunciar que um arquivo de texto garante uma revisão correta. Também veremos como conferir seus limites antes de utilizá-lo.

Se a dificuldade começa porque ninguém definiu o comportamento esperado, vale conhecer SDD em Delphi. A apresentação do livro relaciona especificações, contratos e critérios de aceitação ao desenvolvimento. A página oferece uma degustação para avaliar se esse aprofundamento corresponde à necessidade do seu projeto, antes de comprar a obra.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração realista de uma pasta de projeto com uma pasta menor de módulo e documentos de orientação.

AGENTS.md na prática: como orientar a IA dentro de um projeto

A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora.

Ver resumo completo

A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora. Na próxima tarefa, precisa repetir o mesmo contexto. O problema não é somente a qualidade do pedido: os acordos do projeto ainda dependem de alguém lembrar de transmiti-los.

Um arquivo de orientações pode organizar esses acordos, desde que a ferramenta saiba onde encontrá-lo e a equipe saiba mantê-lo. Ele não deve reunir toda a documentação, todas as decisões antigas e todos os pedidos do histórico. Deve ajudar a trabalhar naquele ambiente, localizando referências relevantes e estabelecendo limites verificáveis.

Neste capítulo da série sobre instruções para IA, vamos construir um exemplo de AGENTS.md para um projeto Delphi fictício. Explicaremos raiz do projeto, módulo, precedência e conferência antes de usá-los. O comportamento de descoberta descrito aqui é o documentado para o Codex em 4 de outubro de 2026; não será apresentado como uma regra de todos os assistentes.

Se o desafio é explicitar comportamentos e conferir alterações, SDD em Delphi aprofunda especificações, contratos e critérios de aceite. Consulte o sumário e a degustação gratuita para avaliar como ligar essas orientações à implementação e aos testes. Um arquivo de instruções é mais útil quando participa desse entendimento, não quando funciona apenas como uma lista de preferências.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração de duas folhas: texto corrido e conteúdo organizado em títulos e listas.

Como escrever um arquivo Markdown que humanos e IA consigam usar

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente.

Ver resumo completo

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente. Quando o documento cresce, surgem referências vagas, instruções repetidas e dúvidas sobre o que realmente deve ser feito. Trocar a extensão do arquivo não resolve essa dificuldade.

Markdown ajuda a organizar texto sem exigir um editor sofisticado. Ele permite indicar títulos, listas, links e trechos de código usando caracteres comuns. Mas a qualidade do arquivo depende também de decisões de escrita: explicar o contexto, separar responsabilidades e oferecer critérios que permitam conferir o trabalho. Formatação e entendimento precisam caminhar juntos.

Neste segundo capítulo da série sobre instruções para IA, vamos aprender a sintaxe essencial e aplicá-la ao exemplo fictício de revisão de uma importação Delphi. O objetivo não é decorar todos os recursos do formato, mas construir um documento que uma pessoa consiga revisar e uma ferramenta consiga apresentar de forma previsível. Também veremos os limites desse cuidado.

Para aprofundar a passagem de uma solicitação vaga para requisitos, contratos e critérios de aceite, conheça SDD em Delphi. O sumário e a degustação gratuita ajudam a avaliar esse método antes de escolher a edição. A conexão com este capítulo é direta: um arquivo bem apresentado só ganha valor técnico quando registra um entendimento verificável.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração realista de uma mesa com pedido avulso, regras de projeto, manual de referência e procedimento de revisão.

Prompt, instrução, referência ou skill: onde colocar cada informação para a IA

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco.

Ver resumo completo

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco. Na revisão seguinte, monta quase a mesma mensagem. Depois de algumas semanas, existem versões diferentes dessas orientações, e ninguém sabe qual delas continua válida.

O problema não começa na falta de um arquivo especial. Começa quando informações com funções diferentes são tratadas como se fossem uma única mensagem. Um pedido descreve o trabalho de agora; uma regra orienta o projeto; um documento fornece evidência; um procedimento organiza uma tarefa repetível. Separar essas funções ajuda tanto o leitor humano quanto o assistente que recebe o contexto.

Este artigo abre a série sobre instruções para IA, do Markdown às skills. Vamos construir essas distinções usando uma manutenção Delphi fictícia, mostrar onde cada informação pode ficar e propor um exercício de organização. Não é preciso conhecer agentes ou formatos de arquivos para acompanhar. Os exemplos são propostas didáticas, não resultados medidos de uma integração.

Quando a dificuldade é transformar uma intenção em regras e critérios verificáveis, SDD em Delphi oferece um aprofundamento em especificações, contratos e rastreabilidade. Consulte o sumário e a degustação gratuita para avaliar esse percurso. Para estudar as camadas de contexto, ferramentas e operação ao redor do modelo, a leitura complementar é IA Além da Conversa.

Publicado em · Régys Borges da Silveira
Ler artigo →

Atualização Validador Paf-ECF ER 02.01

Liberada uma nova versão do validador de arquivos do Paf-ECF já contemplando a versão 02.01 da especificação de requisitos, uma ressalva é que os registros G2, S2, S3 ainda não foram implementados, assim que terminar a homologação e tiver um tempinho eu disponibilizo uma atualização com eles. Para todo o restante está funcionando perfeitamente, mas caso alguém encontre…

Ver resumo completo

Liberada uma nova versão do validador de arquivos do Paf-ECF já contemplando a versão 02.01 da especificação de requisitos, uma ressalva é que os registros G2, S2, S3 ainda não foram implementados, assim que terminar a homologação e tiver um tempinho eu disponibilizo uma atualização com eles. Para todo o restante está funcionando perfeitamente, mas caso alguém encontre algum bug não existe em informar. Para baixar vá até: ACBrValidadorPafECF

Publicado em · Régys Borges da Silveira
Ler artigo →

Especificação de Requisitos Paf-ECF 02.01 – Comentada

Estou postando a Especificação de Requisitos do Paf-ECF 02.01 comentada para ajudar a quem vai homologar nesta nova especificação, leitura obrigatória para quem vai homologar Paf-ECF. O roteiro de análise ainda continua sendo o 1.8 que pode ser obtido no site do CONFAZ, menu ECF, clicando em Roteiro de Análise Paf-ECF.

Ver resumo completo

Estou postando a Especificação de Requisitos do Paf-ECF 02.01 comentada para ajudar a quem vai homologar nesta nova especificação, leitura obrigatória para quem vai homologar Paf-ECF. O roteiro de análise ainda continua sendo o 1.8 que pode ser obtido no site do CONFAZ, menu ECF, clicando em Roteiro de Análise Paf-ECF. Especificação de Requisitos do Paf-ECF 02.01 comentada

Publicado em · Régys Borges da Silveira
Ler artigo →

Especificação de requisitos do Paf-ECF 02.01

Foi liberado o "ATO COTEPE/ICMS 9", que revoga o "ATO COTEPE/ICMS 06/08" e faz valer a nova especificação de requisitos versão 02.01 a partir do dia 1 de junho de 2013 conforme artigo: Art. 8º Este Ato entra em vigor na data de sua publicação no Diário Oficial da União, produzindo efeitos a partir do primeiro dia do terceiro…

Ver resumo completo

Foi liberado o "ATO COTEPE/ICMS 9", que revoga o "ATO COTEPE/ICMS 06/08" e faz valer a nova especificação de requisitos versão 02.01 a partir do dia 1 de junho de 2013 conforme artigo: Art. 8º Este Ato entra em vigor na data de sua publicação no Diário Oficial da União, produzindo efeitos a partir do primeiro dia do terceiro mês subseqüente ao de sua publicação. Seguem-se os links para o ato cotepe, especificação de requisitos grifada com mudanças e perfis de requisitos por estados. ATO COTEPE/ICMS 9, DE 13 DE MARÇO DE 2013. Especificação de Requisitos Paf-ECF 02.01 Tabela de requisitos…

Publicado em · Régys Borges da Silveira
Ler artigo →