Pular para o conteúdo

Método pedagógico

Como funciona — fluxo socrático em 5 passos

Apoio à escrita acadêmica é radicalmente diferente de ghostwriting. Este documento explica como cada Skill estrutura seu raciocínio sem fazer pelo aluno — vantagem reputacional, não fragilidade.

Fluxo socrático — 5 passos por Skill

  1. Você abre a Skill e responde 3 a 5 perguntas

    Cada Skill (Tema, Problema, Objetivos, etc.) tem um prompt versionado em `agent_prompts` aprovado pela coordenação pedagógica e pelo Subagente Compliance. A IA não improvisa — segue um roteiro socrático estável.

    Detalhe técnico: Exemplo na Skill Tema: (a) qual a área CAPES; (b) qual recorte temporal/geográfico; (c) qual o objeto de estudo específico; (d) o tema cabe em 25 palavras?

  2. Validadores determinísticos rodam antes da resposta

    Detectores em `lib/llm/cep-detector` (sujeitos de pesquisa CEP/CONEP), `lib/llm/lgpd-crianca-detector` (PII de menor — ADR-0010) e `lib/skills/alerts/*` (regras pedagógicas) interceptam o input antes da chamada LLM.

    Detalhe técnico: Zero alucinação em itens críticos: comprimento de resumo NBR 6028 (150-500 palavras), eixos obrigatórios de Justificativa, faixas de Introdução (500-2000 palavras), citações [VERIFICAR FONTE].

  3. LLM roteado conforme sensibilidade (ADR-0010)

    Conteúdo com PII de menor: Maritaca AI (Sabiazinho-4, hospedado em São Paulo). Conteúdo geral de TCC/Mestrado/Doutorado: Anthropic Claude Haiku 4.5 / Sonnet 4.6. Fallback Gemini 2.5 Flash. Embedding RAG via OpenAI text-embedding-3-small.

    Detalhe técnico: Soberania de dados sensíveis BR cumpre LGPD art. 33 sem depender de cláusulas-padrão internacionais ainda em consulta pública pela ANPD.

  4. Rascunho ancorado nas suas respostas

    A Skill gera o texto em PT-BR culto a partir do que VOCÊ respondeu. Validações ABNT (NBR 14724, 6023, 6024, 6028, 10520) rodam em tempo real via `lib/abnt/check`. Citações de autores consolidados marcadas com [VERIFICAR FONTE] até grounding em Crossref/OpenAlex confirmar.

    Detalhe técnico: Para Skill Referências, mínimo recomendado: 10 referências TCC, 30 dissertação, 60 tese. Detector de uncertainty rule garante que entradas manuais fiquem marcadas até validação.

  5. Cada decisão fica em `decisions_log` auditável

    Quando você marca uma Skill como aprovada, a transição é registrada com timestamp, ator (você/sistema), versão do prompt vigente e snapshot do conteúdo. Você defende cada parágrafo na banca com evidência documental.

    Detalhe técnico: Tabela append-only com RLS — só você acessa suas próprias decisões. Auditoria total via SQL para coordenadores Enterprise (consentimento explícito).

Workspace 3 colunas — sua mesa de trabalho

Inspirado em IDEs profissionais. Toda a informação relevante para a Skill ativa fica em uma tela única, sem cliques desnecessários.

Coluna 1 · Jornada

Lista compacta das 11 Skills FA (ou 5 FP). Cada Skill tem um dot colorido indicando estado: não iniciada, em perguntas, rascunho gerado, aguardando revisão, aprovada, exportada.

Sticky no desktop. Permite saltar entre Skills sem perder contexto.

Coluna 2 · Conversa

Chat com a Skill ativa. Mensagens do aluno (bolha clara) e da IA (bolha branca, com pergunta socrática ou rascunho). Stream ao vivo via Vercel AI SDK. Persistência por projeto.

Ações contextuais: Pronto para gerar, Marcar para revisão, Aprovar Skill.

Coluna 3 · Evidências

Camada de confiança: Referências confirmadas via Crossref, ABNT check rodando em tempo real, decisões registradas (decisions_log), versão do prompt ativo, e validação humana pendente.

Anti-alucinação: estados vazios explícitos em vez de mock.

Validação determinística — sem alucinação

Cada Skill tem validadores baseados em regex e contagem — sem LLM no julgamento. Estes 25+ alertas pedagógicos rodam toda vez que você envia uma mensagem. Resultado: feedback acionável, não feedback inventado.

SkillRegra validadaSeveridade
Resumo (NBR 6028)150-500 palavrashigh
ResumoSeção 'Palavras-chave' obrigatóriahigh
Introdução500-2000 palavras (acima → redundância)medium
IntroduçãoPrimeiro parágrafo com contexto/panoramamedium
Justificativa≥ 2 de 3 eixos (científica + social + lacuna)medium
MetodologiaTipo declarado (qualitativa/quantitativa/mista)high
MetodologiaInstrumentos nomeados (entrevista, questionário...)medium
FundamentaçãoMínimo 3 autores distintos em diálogomedium
FundamentaçãoCitações marcadas [VERIFICAR FONTE]medium
ReferênciasABNT NBR 6023 (ano, ponto trailing)high
ReferênciasMínimo: 10 TCC / 30 dissertação / 60 tesemedium
ProblemaPergunta fechada (E/Existe...) sinalizalow

Código aberto para auditoria em lib/skills/alerts/ e lib/abnt/check.ts.

Exemplo concreto — Skill Tema (prompt v1.0.3)

Veja como o método socrático estruturado se materializa numa sessão real.

🤖 Agente Turbo · Skill Tema · pergunta 1/4

“Antes de qualquer texto, preciso entender o recorte. Em qual área CAPESseu projeto se encaixa? Use a classificação oficial: Engenharias, Saúde, Humanas, Sociais Aplicadas, ou Linguística/Letras/Artes.”

👤 Você

Humanas. Mestrado em Educação, foco em formação de professores de matemática.

🤖 Agente Turbo · pergunta 2/4

“Ótimo recorte de área. Agora o recorte temporal e geográfico. Você pretende investigar professores em formação inicial, continuada ou ambos? E em qual unidade federativa, município ou rede?”

👤 Você

Formação continuada, rede municipal de Belo Horizonte, últimos 5 anos (2021-2026).

✅ Após perguntas 3 e 4 · Tema delimitado (25 palavras)

“Uso de inteligência artificial generativa na formação continuada de professores de matemática da rede municipal de Belo Horizonte (2021-2026).”

✓ 24 palavras (NBR 14724 pede até 25 para tema delimitado) · Área CAPES ✓ Recorte temporal ✓ Recorte geográfico ✓ Objeto específico ✓

Pronto para começar pela Skill Tema?

Escolha um plano e, em 30 segundos, você está respondendo à primeira pergunta socrática.

Página atualizada em 17/05/2026 · v1.0