Neste artigo
- Por que pedir "faz um site" trava o projeto inteiro
- A anatomia do prompt estruturado
- Estrutura de pastas e dados falsos explícitos
- O critério acadêmico: o que gerar e o que saber explicar
- Cronograma de quatro semanas até o prazo de dezembro
- Usar IA no TCC é aceito pelas instituições?
- Por onde começo o prompt do front-end do zero?
- Vale mais a pena usar framework ou HTML, CSS e JavaScript puros?
- E quando a IA gera código que não funciona?
A pergunta que expõe o drama silencioso de boa parte dos cursos técnicos apareceu entre as discussões mais comentadas da semana no r/programacao. O relato é de um aluno no terceiro módulo de um curso técnico em Informática que precisa entregar o front-end de um website até o início de dezembro, como parte do TCC da turma. O grupo tem o tema desde o segundo módulo, escreveu a monografia a partir dele, e agora chegou a hora de desenvolver de fato: banco de dados, backend, frontend e a questão da hospedagem. O problema está no histórico do curso, descrito com franqueza pelo próprio autor: de programação de verdade, a turma viu somente lógica e algumas linhas de código básicas. O resto ficou por conta dos alunos, correndo atrás em um período muito curto, e a parte que coube a ele é a que mais assusta quem está começando: o front-end inteiro do site.
A thread sobre o front-end do TCC até dezembro condensa uma situação que a comunidade reconhece na hora, e as respostas que ela recebeu resumem os dois registros que o r/programacao produz nesses casos: humor de quem já atravessou aperto parecido e método de quem sobreviveu e contou como. Esta tutoria transforma esse material em um roteiro utilizável por qualquer estudante com prazo apertado, dentro ou fora da academia. O caminho tem três movimentos: decompor a página em componentes antes de pedir qualquer coisa à inteligência artificial, estruturar cada prompt com contexto, restrições e dados falsos explícitos, e aplicar o critério acadêmico que separa o que pode ser gerado por ferramenta do que você precisa saber explicar de viva voz na apresentação.
Por que pedir "faz um site" trava o projeto inteiro
O primeiro erro do estudante com prazo curto é o mais natural de todos: abrir a ferramenta de IA e pedir um site. O pedido genérico devolve um monolito, um bloco de código grande demais para revisar, com decisões embutidas que ninguém discutiu, dependências que ninguém escolheu e uma estrutura de arquivos que raramente sobrevive à segunda tela. Quando algo quebra, e algo vai quebrar, o estudante não tem mapa nenhum para localizar o problema, porque não participou de nenhuma das decisões que produziram aquele código. É a versão acadêmica do problema que a discussão sobre como o Jules e o vibe coding estão transformando a programação descreve no mercado: aceitar tudo o que a ferramenta entrega é rápido até o momento em que é preciso dar manutenção, e no TCC esse momento chega na semana da apresentação.
A alternativa que a comunidade indica é decompor antes de pedir. Uma página, por mais complexa que pareça, é um conjunto pequeno de peças que se repetem: um cabeçalho com navegação, um bloco de destaque, uma lista de itens, um formulário, um rodapé. Cada peça tem entradas e saídas previsíveis. Decompor é transformar "fazer o site" em uma fila de tarefas minúsculas e independentes, e cada tarefa minúscula cabe em um prompt que a IA resolve bem, com código curto o suficiente para você ler, entender e ajustar.
| Tela típica de TCC | Componentes depois da decomposição |
|---|---|
| Home | Cabeçalho com menu, bloco de destaque, cartões de resumo, rodapé |
| Listagem | Barra de busca, filtros, tabela ou grade de cartões, paginação |
| Formulário | Campos com rótulo, validação visual, botões de ação, mensagem de confirmação |
| Detalhe | Cabeçalho do item, bloco de informação, botões de ação, retorno à lista |
💡 Dica: adote a regra de um componente por prompt. O pedido pequeno gera resposta pequena, resposta pequena é possível de entender em minutos, e código que você entendeu é código que você consegue defender na apresentação.
A anatomia do prompt estruturado
Decomposta a página, cada componente merece um prompt com a mesma anatomia, e é aqui que o prompt estruturado se diferencia do pedido solto. Quatro campos se repetem nas versões que funcionam:
- Contexto técnico. A stack, a versão e o que já existe no projeto. "Projeto com HTML, CSS e JavaScript puros, sem framework, arquivos já criados nestas pastas" elimina a maior fonte de resposta inútil, que é a ferramenta presumir um ambiente diferente do seu.
- Objetivo único. Um componente por vez, descrito pelo comportamento e não por adjetivos. "Formulário de cadastro de livro com nome, autor e ano, que valida campos vazios antes de enviar" é um objetivo; "um formulário bonito" é um desejo.
- Restrições explícitas. O que a resposta deve usar e o que deve evitar: CSS em arquivo separado, sem bibliotecas externas, nomes de classe em português, comentários onde houver decisão não óbvia.
- Formato de saída. Quais arquivos criar, em quais pastas, com o conteúdo completo de cada um. Esse campo é o que impede a resposta fragmentada, daquele tipo que traz um trecho sem dizer onde ele entra.
O esqueleto abaixo serve de molde e pode ser adaptado para qualquer componente do inventário:
Contexto: projeto de TCC em HTML, CSS e JavaScript puros.
Pastas existentes: css/, js/, img/. Nenhum framework instalado.
Objetivo: componente de listagem de itens em tabela.
Comportamento: recebe uma lista de objetos e renderiza uma linha
por item, com as colunas nome, categoria e status.
Restrições: CSS em arquivo separado, sem bibliotecas externas,
nomes de variáveis em português, sem estilos inline.
Dados: use exatamente esta lista de exemplo, com estes campos:
[{ "nome": "Item 1", "categoria": "geral", "status": "ativo" },
{ "nome": "Item 2", "categoria": "geral", "status": "inativo" }]
Saída: o conteúdo completo de js/listagem.js e css/listagem.css.
Repare que o molde já embute as duas decisões que separam o prompt estruturado do improviso: a restrição de ambiente, que mantém o projeto coerente, e os dados falsos explícitos, que merecem a seção seguinte inteira.
Estrutura de pastas e dados falsos explícitos
Dois campos do molde merecem seção própria porque são os que mais evitam retrabalho. O primeiro é a estrutura de pastas. Quando o prompt não declara onde cada arquivo entra, a ferramenta decide sozinha, e cada resposta decide de um jeito, o que produz um projeto com arquivos espalhados e referências inconsistentes. Declarar as pastas existentes e pedir a saída organizada dentro delas mantém o projeto navegável, e navegável é o que a banca vai abrir. Para o estudante que sente que essa organização deveria ter sido aprendida antes, o material de base existe: o guia de lógica, fluxos e primeiros algoritmos cobre o alicerce que o curso do relato deixou em aberto, e a decomposição em componentes é a continuação natural dele.
O segundo campo é o dos dados falsos explícitos. Todo front-end de TCC vai consumir, no fim, os dados do banco de dados do grupo, e a integração despenca quando o front-end foi construído sobre campos inventados pela IA. A solução é definir no prompt a forma exata dos dados: os nomes dos campos, os tipos e alguns registros de exemplo, listados dentro do próprio prompt. Com isso, o componente nasce já consumindo a estrutura real, e a troca dos dados falsos pelos dados do backend vira uma substituição de fonte, não uma reescrita. Os dados falsos também protegem o prazo: enquanto o backend do grupo não está pronto, o front anda com exemplo, e ninguém fica parado esperando o colega.
Quem quiser entender até onde vai o modelo de componentes que sustenta essa decomposição encontra no guia sobre React Server Components a evolução desse conceito nos frameworks modernos: componente é a unidade que o mercado inteiro passou a usar, e aprender a pensar em componentes no TCC é aprender o vocabulário do dia seguinte ao diploma.
O critério acadêmico: o que gerar e o que saber explicar
Usar IA no TCC tem uma fronteira que não é técnica, é acadêmica, e vale desenhar antes da primeira linha gerada. O critério que sustenta o uso honesto é simples: a ferramenta pode gerar o que você consegue explicar, e não deve gerar o que você não sabe defender. A banca não costuma perguntar se você digitou cada caractere; ela pergunta por que essa estrutura, por que essa validação, o que acontece quando o usuário envia o formulário vazio. Responder essas perguntas exige domínio, não memorização, e domínio se constrói exatamente no processo de revisar, ajustar e testar o que a ferramenta produziu.
| Pode ser gerado com IA | Precisa ser seu na apresentação |
|---|---|
| Layout estático e estilos repetitivos | A decisão de estrutura: por que essas pastas e esses arquivos |
| Componente descrito por você e revisado linha a linha | O fluxo de dados: de onde vem cada informação e para onde vai |
| Formulário com validação que você especificou | O comportamento: o que acontece em cada caminho do usuário |
| Arquivos de configuração e apoio do projeto | As escolhas de ferramenta e o que cada uma custa e entrega |
⚠️ Atenção: antes de fechar o projeto, faça o teste da explicação em voz alta: percorra o site e explique cada componente como se a banca estivesse na sala. Toda parte que você travar de explicar precisa ser refeita por você, com a IA no papel de tutor e não de autora.
Vale registrar também a política da instituição, que varia entre cursos e orientadores. O caminho seguro é a transparência: registrar com o orientador que a ferramenta de IA está no fluxo de trabalho, em qual papel, e guardar o histórico das decisões próprias. O que caracteriza problema não é a ferramenta, é a entrega de algo que o aluno não consegue explicar, e esse é o mesmo critério da tabela acima.
Cronograma de quatro semanas até o prazo de dezembro
Com o método fechado, o prazo de semanas deixa de ser ameaça e vira calendário. O desenho abaixo assume quatro semanas de trabalho e se ajusta ao tempo real disponível do grupo:
- Semana 1: inventário de telas, decomposição em componentes, esqueleto do projeto com pastas definidas e o primeiro componente no ar com dados falsos.
- Semana 2: produção dos componentes restantes, um prompt por componente, revisão de cada resposta antes de aceitar e consistência de visual entre as telas.
- Semana 3: troca dos dados falsos pelos dados reais do backend do grupo, ajuste de integração, hospedagem configurada e teste em celular e computador.
- Semana 4: revisão de detalhes, conteúdo real nas telas, ensaio da apresentação com o teste da explicação em voz alta e folga para o imprevisto que sempre existe.
O relato do r/programacao que abriu este guia descreve um aperto real, mas o aperto tem saída com método: decompor, pedir com estrutura, revisar cada resposta e saber explicar tudo o que foi entregue. O site do TCC sai, o prazo é cumprido, e o que fica depois da apresentação é melhor que o site: o estudante que entrou no projeto dependendo da ferramenta sai dele sabendo dirigir a ferramenta. Para levar esse uso com método para além do TCC, o guia de como usar IA no dia a dia da programação mostra como a ferramenta entra na rotina de trabalho sem ocupar o lugar do raciocínio.
Perguntas frequentes
Usar IA no TCC é aceito pelas instituições?
A política varia entre instituições, cursos e orientadores, e a confirmação com o orientador faz parte do processo. O critério prático que atravessa as respostas da comunidade é o domínio: ferramenta que ajuda a produzir o que você explica é recurso de trabalho, ferramenta que substitui o que você não sabe explicar é o problema real em qualquer política.
Por onde começo o prompt do front-end do zero?
Pelo prompt de inventário: liste as telas, peça a decomposição em componentes e a estrutura de pastas inicial antes de qualquer código. Com a estrutura acordada, cada componente seguinte entra em um prompt próprio com o molde de contexto, objetivo, restrições e formato de saída.
Vale mais a pena usar framework ou HTML, CSS e JavaScript puros?
Depende do que o curso exige e do que o grupo domina, e essa decisão deve vir antes dos prompts porque ela entra no campo de contexto de todos eles. O critério da apresentação decide: framework que você não sabe justificar é mais um risco do que um recurso no dia da banca.
E quando a IA gera código que não funciona?
Reduza o escopo: teste o componente isolado, confira se os dados de exemplo estão no formato declarado e verifique se a resposta respeitou as restrições do prompt. A depuração guiada, com o erro colado no prompt junto do contexto, costuma resolver em uma ou duas voltas, e cada volta ensina mais que aceitar a primeira resposta mágica.