Example Conversation

You: Preciso preparar o Plano de Ensino de Cirurgia II para o próximo semestre. Você consegue me ajudar?

Agent: Consigo. Para começar, preciso confirmar a identificação da disciplina. Pode me passar:

• Instituição e curso
• Área das DCNs (Medicina, no caso?)
• Nome e código da disciplina
• Período/semestre e período letivo
• Carga horária total e a divisão (teórica / prática / EaD / extensão)
• Professor(a) responsável e departamento

You: Faculdade de Medicina São Lucas (código MEC 5481), curso de Medicina, área Medicina mesmo. Disciplina Cirurgia II, código MED-742, 7º período, período letivo 2026/1. Carga horária total 60h: 40h teóricas + 14h práticas + 6h de extensão. Professor responsável: Dr. Henrique Marques Vieira (Doutor em Cirurgia Geral), Departamento de Clínica Cirúrgica.

Agent: Anotado. Antes de redigir, vou ancorar o documento nas três normas que se aplicam ao seu caso:

• Resolução CNE/CES nº 3/2025 — DCNs do curso de Medicina (perfil do egresso e competências).
• Resolução CNE/CES nº 7/2018 — curricularização da extensão (mínimo de 10% da carga horária do curso). Suas 6h de extensão em 60h totais (10%) cumprem o piso por disciplina e contribuem para o cômputo do curso.
• ABNT NBR 6023:2025 — formato das referências bibliográficas (sobrenome em CAIXA ALTA, ano, local: editora).

Pode me enviar a ementa oficial registrada no PPC? Ela deve ser um parágrafo único e descritivo — não vou reescrevê-la sem deliberação do NDE.

You: A ementa do PPC é: “Estudo das afecções cirúrgicas do aparelho digestório, da parede abdominal e do sistema endócrino. Indicações cirúrgicas, técnicas operatórias fundamentais, manejo perioperatório e complicações pós-operatórias. Treinamento prático em centro cirúrgico-escola e ações de extensão em saúde digestiva na comunidade.”

Agent: Perfeito — registrei a ementa em parágrafo único. Vou agora redigir as 13 seções canônicas usando o template. Para os Objetivos, vou usar verbos da Taxonomia de Bloom revisada (avaliáveis e observáveis):

• Geral: “Capacitar o estudante a diagnosticar e conduzir afecções cirúrgicas prevalentes do aparelho digestório, parede abdominal e sistema endócrino…”
• Específicos: “identificar indicações cirúrgicas…”, “executar técnicas operatórias básicas sob supervisão…”, “avaliar desfechos perioperatórios e complicações…”.

Para Justificativa, vou articular a disciplina ao perfil do egresso da Resolução CNE/CES 3/2025 (Área de Competência II — Atenção à Saúde, item de habilidades cirúrgicas básicas). Posso seguir?

You: Pode seguir. Use as referências básicas Sabiston, Townsend e Goffi.

Agent: Documento gerado em plano-de-ensino-cirurgia-ii.md. Rodando o validador agora.

[chamada da ferramenta validar_plano_de_ensino]

Agent: Resultado da validação:

• OK — 13 seções canônicas presentes.
• OK — Bibliografia básica: 3 entradas (mínimo 3).
• OK — Bibliografia complementar: 6 entradas (mínimo 5).
• OK — Metodologia menciona extensão e cita a Resolução CNE/CES 7/2018.
• OK — Todas as entradas em ABNT NBR 6023:2025 (autoria em CAIXA ALTA, ano, local: editora).

Documento pronto para apreciação do NDE. Quer que eu exporte como .docx via a skill docx-tools?

Sample Output Excerpt

Trecho do plano-de-ensino-cirurgia-ii.md — Identificação completa, Ementa em parágrafo único, Objetivos com verbos de Bloom, e as duas primeiras unidades do Conteúdo Programático. Numeração de seções segue ABNT NBR 6024 (sem ponto após o indicativo numérico).

Plano de Ensino — Cirurgia II

1 IDENTIFICAÇÃO

2 EMENTA

Estudo das afecções cirúrgicas do aparelho digestório, da parede abdominal e do sistema endócrino. Indicações cirúrgicas, técnicas operatórias fundamentais, manejo perioperatório e complicações pós-operatórias. Treinamento prático em centro cirúrgico-escola e ações de extensão em saúde digestiva na comunidade.

3 OBJETIVOS

Objetivo geral

Capacitar o estudante a diagnosticar e conduzir afecções cirúrgicas prevalentes do aparelho digestório, da parede abdominal e do sistema endócrino, integrando indicação, técnica operatória básica e cuidado perioperatório, em conformidade com o perfil do egresso definido na Resolução CNE/CES nº 3/2025.

Objetivos específicos

1. Identificar as indicações cirúrgicas das principais afecções do trato gastrointestinal alto e baixo, diferenciando abordagens eletivas e de urgência.
2. Executar, sob supervisão direta, técnicas operatórias básicas de parede abdominal (herniorrafia inguinal e umbilical) e drenagem de coleções, em centro cirúrgico-escola.
3. Avaliar desfechos perioperatórios e classificar complicações pós-operatórias segundo a escala de Clavien-Dindo, propondo conduta clínica apropriada.

5 CONTEÚDO PROGRAMÁTICO

Unidade I — Afecções cirúrgicas do aparelho digestório alto

• Doença do refluxo gastroesofágico e hérnias hiatais: indicação cirúrgica e técnicas (fundoplicaturas).
• Úlcera péptica complicada: perfuração, hemorragia, estenose pilórica.
• Cirurgia bariátrica: indicações, técnicas (bypass em Y-de-Roux, sleeve) e seguimento.
• Tumores gástricos: estadiamento e gastrectomias.

Unidade II — Parede abdominal e hérnias

• Anatomia cirúrgica da parede abdominal e canal inguinal.
• Hérnias inguinais, umbilicais, incisionais: classificação e indicação operatória.
• Técnicas: Lichtenstein, Shouldice, reparo laparoscópico (TAPP/TEP).
• Complicações: recidiva, dor crônica pós-herniorrafia, infecção de sítio cirúrgico.

Extension Tools

validar_plano_de_ensino — Validação heurística da estrutura do Plano de Ensino. Recebe o caminho do arquivo Markdown e produz um relatório indicando o que está OK e o que precisa de ajuste antes de submeter ao NDE/coordenação.

Verificações realizadas:

• 13 seções canônicas presentes — Identificação, Ementa, Objetivos, Justificativa, Conteúdo Programático, Metodologia de Ensino, Recursos Didáticos, Avaliação da Aprendizagem, Bibliografia Básica, Bibliografia Complementar, Cronograma, Aprovação, Fundamentação Legal.
• Ementa em parágrafo único — confirma que a seção 2 contém um único bloco descritivo, sem listas ou múltiplos parágrafos (ementa é registrada no PPC e não deve ser fragmentada).
• Bibliografia básica ≥ 3 entradas — mínimo exigido pelo MEC/INEP em avaliação in loco.
• Bibliografia complementar ≥ 5 entradas — mínimo exigido pelo MEC/INEP.
• Curricularização da extensão (CNE/CES 7/2018) — verifica que a seção de Metodologia menciona explicitamente atividades de extensão e cita a Resolução CNE/CES nº 7/2018, em conformidade com o piso de 10% da carga horária do curso em ações de extensão.
• Verbos de Bloom em Objetivos — heurística que sinaliza objetivos com verbos não-observáveis (“saber”, “compreender”) em vez de verbos avaliáveis da Taxonomia de Bloom revisada (identificar, aplicar, analisar, avaliar, criar).
• Conformidade ABNT NBR 6023:2025 — cada entrada bibliográfica deve ter autor pessoal em CAIXA ALTA seguido de vírgula (ou autor institucional/jurisdição em CAIXA ALTA seguido de ponto), ano de publicação com 4 dígitos e dados de publicação no formato Local: Editora (exceto para legislação e documentos eletrônicos com Disponível em:).

O relatório lista cada item como [OK], [FALTA] ou [ATENÇÃO] e termina com um veredito agregado: RESULTADO: OK ou RESULTADO: INCOMPLETO com a lista de ajustes pendentes.

Getting Started

1. Instale a skill br-plano-de-ensino na sua workspace. A dependência docx-tools será instalada automaticamente para permitir exportar o plano em .docx ao final.
2. Faça upload do manual da sua IES ou do modelo institucional de Plano de Ensino, se houver. A skill respeitará a estrutura institucional e só completará campos canônicos faltantes.
3. Anexe a DCN da área (ex.: Resolução CNE/CES nº 3/2025 para Medicina; Resolução CNE/CES nº 5/2018 para Direito; Resolução CNE/CES nº 1/2023 para Psicologia) para que o agente cite a resolução correta na seção de Fundamentação Legal e articule a Justificativa ao perfil do egresso.
4. Preencha os metadados da disciplina: instituição (com código MEC), curso, código da disciplina, período letivo, carga horária total e divisão (teórica / prática / EaD / extensão), professor(a) responsável e departamento.
5. Forneça a ementa oficial registrada no PPC. A skill não reescreve a ementa — se não houver versão homologada, ela marcará [ementa a ser homologada pelo NDE].
6. Gere o Plano de Ensino. O agente conduz a coleta seção a seção (13 no total), usando verbos de Bloom revisada para Objetivos e ABNT NBR 6023:2025 para a bibliografia.
7. Rode validar_plano_de_ensino no arquivo gerado antes de assinar e submeter ao NDE/coordenação. Corrija os itens marcados [FALTA] e revalide até obter RESULTADO: OK.
8. Exporte para .docx via a skill docx-tools quando precisar de uma versão para assinatura física ou submissão ao MEC/INEP.