Published

23/07/2026

Modified

23/07/2026

Diretrizes de Auditoria para I.A (Validação de Aulas)

Este documento serve como guia de referência (Project-Scoped Rule) para agentes de Inteligência Artificial ao auditar e criar o material didático das aulas (Slides, Capítulos e Laboratórios). Ao analisar qualquer aula, a I.A deve garantir rigorosamente que os seguintes critérios sejam atendidos, tendo como base o arquivo planodeensino/Planejamento_Aulas2.md:

1. Regras para os Slides (/slides/*.tex)

  • [ ] Alinhamento Teórico: O conteúdo dos slides deve abordar todos os pontos citados na seção “Tópicos Abordados” e “Mini-Teoria” do planejamento da aula.
  • [ ] Dinâmica de Tempo (40 minutos): A aula teórica nos slides deve ser projetada para durar no máximo 40 minutos. O tempo restante da sessão deve ser dedicado à prática e à explicação do roteiro de laboratório.
  • [ ] Objetivos da Sessão (Resumo): O primeiro slide após a folha de rosto (\titleslide ou \frame{\titlepage}) deve se chamar obrigatoriamente “Objetivos da Sessão” e conter uma lista de tópicos resumindo o que será visto.
  • [ ] Roteiro Prático (Laboratório): O último slide antes do fechamento (\end{document}) deve se chamar obrigatoriamente “Roteiro do Laboratório XX”. Ele deve conter uma lista numerada (\begin{enumerate}) descrevendo os passos práticos que os alunos farão no laboratório (ex: configurar ambiente, codificar, rodar testes unitários, enviar via Git).

2. Regras para os Laboratórios (/laboratorio/*.tex)

  • [ ] Classe Autônoma: Deve usar \documentclass[12pt,a4paper]{article} (nunca subfiles).

  • [ ] Pacotes Padrão: Deve conter:

    \usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[portuguese]{babel}
\usepackage{../../../capitulo-style}

  • [ ] Identificação Completa: Deve possuir \title{...}, \author{Engenharia de IA...}, \date{} e usar a macro \maketitle logo após o \begin{document}.

  • [ ] Estilização de Código: Todo trecho de código fonte deve utilizar obrigatoriamente o pacote listings (ex: \begin{lstlisting}[style=python]) em vez de blocos de verbatim cru.

  • [ ] Clareza e Passo-a-Passo: As instruções devem guiar o aluno de forma procedural e finalizar com as instruções de entrega (ex: CI/CD do GitLab).

3. Regras para os Capítulos (/capitulo/*.tex)

  • [ ] Densidade de Conteúdo: O capítulo não deve ser apenas um esqueleto ou resumo (como era o erro das aulas 5 a 8). Deve ser aprofundado o suficiente para render aproximadamente 4 páginas por PDF.
  • [ ] Riqueza Visual (Imagens e Desenhos): É extremamente importante incluir figuras, gráficos, diagramas estruturais ou desenhos (como ilustrações TikZ ou arquivos PNG/JPG) para elucidar e ilustrar a teoria abordada no texto.
  • [ ] Estilo Autônomo: Assim como os laboratórios, também deve usar a classe article e possuir o pacote de estilos \usepackage{../../../capitulo-style}.

Instrução à I.A: Sempre que o usuário solicitar a “validação” ou “auditoria” de uma aula, cruze as informações da aula com as regras acima e corrija os arquivos .tex necessários para atingir 100% de conformidade, recompilando os PDFs em seguida.

Back to top