Customizando seus Próprios Templates e Criando sua Biblioteca Pessoal

Customizando seus Próprios Templates e Criando sua Biblioteca Pessoal — aula do módulo Templates de Prompt & OpenCRO, na trilha Governança Ágil com Método…

Leitura de aproximadamente 4 minutos.

Módulo: Templates de Prompt & OpenCRO · Curso: Governança Ágil com Método OKAM · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Customizando seus Próprios Templates e Criando sua Biblioteca Pessoal

O que você vai aprender

1. Do Prompt Artesanal ao Arsenal de Automação

No início da jornada com Inteligência Artificial, todo mundo digita prompts artesanais: você abre a caixa de mensagem, pensa na hora em como explicar a tarefa, redige três frases e torce para a IA acertar.

Com o tempo, você percebe que cerca de 80% das suas tarefas com IA se repetem:

Em vez de reinventar a roda a cada interação, o desenvolvedor que domina o método OKAM constrói uma Biblioteca Pessoal de Templates.

2. A Arquitetura da Sua Biblioteca Pessoal

A melhor maneira de armazenar seus templates é dentro do próprio repositório, no diretório padrão .agents/templates/:


+-------------------------------------------------------------------------------+
|                       ESTRUTURA DA BIBLIOTECA DE TEMPLATES                    |
+-------------------------------------------------------------------------------+
|                                                                               |
|  meu-projeto/                                                                 |
|  ├── .agents/                                                                 |
|  │   ├── AGENTS.md                    <-- Constituição do projeto             |
|  │   └── templates/                                                           |
|  │       ├── nova-feature.md          <-- Template de especificação           |
|  │       ├── correcao-cirurgica.md    <-- Template de correção de bugs        |
|  │       ├── suite-de-testes.md       <-- Template de testes automatizados    |
|  │       └── auditoria-seguranca.md   <-- Checklist de segurança pré-commit   |
|  └── src/                                                                     |
|                                                                               |
+-------------------------------------------------------------------------------+

Ao manter os templates em arquivos Markdown dentro do projeto, eles são automaticamente sincronizados pelo Git, permitindo que qualquer membro da sua equipe (ou você mesmo em outro computador) tenha acesso instantâneo às melhores práticas consolidadas.

3. Como Criar um Template Reutilizável Eficiente

Para que um template seja verdadeiramente útil e fácil de preencher, ele deve conter:

1. Variáveis Entre Colchetes [ASSIM]: Marcadores visuais fáceis de identificar e preencher (ex.: [NOME_DO_ARQUIVO], [OBJETIVO]). 2. Seção de Contexto Fixo: As regras do seu projeto que nunca mudam (ex.: "use CSS puro", "respeite a estrutura de pastas do OKAM"). 3. Critérios de Aceite Claros: O que define que a tarefa foi concluída com sucesso.

Exemplo: Template de Auditoria de Segurança Pré-Deploy

Veja um exemplo de template pronto para salvar na sua pasta .agents/templates/auditoria-seguranca.md:


# Solicitação de Auditoria de Segurança Pré-Deploy

## 1. Escopo da Análise
Por favor, analise todos os arquivos modificados na pasta `src/`.

## 2. Itens Obrigatórios de Verificação
- [ ] Há chaves de API, senhas ou tokens gravados no código?
- [ ] Há bibliotecas externas não autorizadas sendo importadas?
- [ ] Todas as entradas de dados do usuário possuem validação?
- [ ] Há código comentado ou trechos temporários esquecidos?

## 3. Formato da Resposta
Para cada item com problema, aponte o arquivo e a linha exata, sugerindo a correção cirúrgica sem reescrever o restante do código.

4. Comparativo de Eficiência Operacional

| Dimensão | Digitação Artesanal de Prompts | Operação com Biblioteca de Templates | |---|---|---| | Tempo de Preparação | 5 a 10 minutos pensando no texto | 30 segundos (preenche os colchetes do arquivo) | | Taxa de Erro da IA | Alta (omissão frequente de detalhes) | Quase nula (todos os requisitos já mapeados) | | Padronização do Time | Cada pessoa pede de um jeito diferente | Todo o time segue o mesmo padrão de qualidade | | Evolução do Processo | Conhecimento fica na cabeça do usuário | Conhecimento gravado e versionado no Git |

5. Armadilhas Comuns e Como Evitar

[!TIP]
Tratar Templates como Peças de Museu Estáticas: Um template nunca está 100% finalizado. Sempre que um template produzir uma resposta com pequenas falhas, adicione uma cláusula preventiva no arquivo .md correspondente. Trate seus templates como código vivo e de alto valor estratégico.

Exercício Prático

Vamos criar sua pasta de templates e seu primeiro modelo customizado:

1. Crie a pasta de templates no seu projeto:


   mkdir -p .agents/templates

2. Crie o arquivo de template de nova página: Crie o arquivo .agents/templates/nova-pagina-web.md com o seguinte conteúdo:


   # Template: Criação de Nova Página Web
   - Nome do arquivo: src/[nome-da-pagina].html
   - Título da página: [Título Amigável]
   - Componentes necessários:
     1. Cabeçalho com logo e link para voltar à home.
     2. Seção principal com [Descreva o conteúdo principal].
     3. Rodapé com direitos autorais.
   - Padrão: Utilize a folha de estilos `src/style.css` existente. Proibido estilos inline.

3. Teste a invocação do template: Abra uma conversa com o assistente e diga:

"Por favor, utilize o modelo em .agents/templates/nova-pagina-web.md para criar a página de Termos de Uso (src/termos.html)."

Observe a agilidade e o alinhamento impecável com os padrões do seu projeto.

Outras aulas do módulo