Skip to content

00-introducao

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

00-introducao

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
readme.md
readme.md
 
 

readme.md

🟦 Módulo 00: Introdução ao VibeCoding

Tempo: 30 minutos
Objetivo: Entender vibecoding, sua importância, e o roadmap do workshop

O que é VibeCoding? 🎨

VibeCoding é uma metodologia moderna onde humanos e IA colaboram estruturadamente para desenvolver software melhor e mais rápido.

Diferente de:

  • ❌ Usar IA como simples autocomplete
  • ❌ Pedir código pronto sem pensar
  • ✅ Planejamento + Comunicação Clara + Agentes Autônomos

Fluxo Tradicional vs VibeCoding

Tradicional:
Ideia → Escrever Código → Testar → Debug → Iterar

VibeCoding:
Ideia → Planejamento Estruturado 
      → Agentes IA Autônomos
      → Código + Validação Automática
      → Feedback Humano
      → Iteração Consciente

Por que VibeCoding? 💡

Problema Atual

Desenvolvimento tradicional é:

  • ⏱️ Lento: Muita discussão, pouco código
  • 🐛 Cheio de bugs: Humanos cometemos erros
  • 😴 Repetitivo: Copy-paste, refactoring manual
  • 📉 Pouca documentação: Ninguém gosta de escrever docs

Solução: VibeCoding

  • ✅ Rápido: IA gera múltiplas opções em segundos
  • ✅ Mais seguro: Agentes verificam antes de executar
  • ✅ Menos repetição: IA cuida de tarefas chatas
  • ✅ Documentação automática: IA documenta enquanto trabalha

Comparação Real

Problema: Criar API REST com 10 endpoints

Tradicional:  8 horas de coding manual
VibeCoding:  2 horas (planejamento + refinamento)

Pilares de VibeCoding 🏛️

1. Planejamento é Desenvolvimento

Um bom plano previne 80% dos problemas.

❌ Planejar 5 min, codificar 7 horas, debug 2 horas
✅ Planejar 1 hora, codificar 2 horas, debug 15 min

2. Agentes Autônomos

Programas IA que:

  • Pensam sobre o problema
  • Planejam uma solução
  • Executam passo-a-passo
  • Validam o resultado

3. Model Context Protocol (MCP)

Comunicação padronizada entre humano e IA:

  • Humano: "Aqui estão minhas ferramentas"
  • IA: "Entendi, vou usar isso para resolver"
  • Humano: "Valido seu trabalho"

4. Iteração Consciente

Feedback estruturado leva a melhoria contínua

5. Prompt Engineering

Conversas claras com IA = código claro

Exemplos Reais 🌍

Exemplo 1: Desenvolvimento de Projeto

Tradicional:

  1. Spec em Word (15 min)
  2. Reunião de esclarecimento (1h)
  3. Desenvolvimento (1 semana)
  4. Code review (2 dias)
  5. Ajustes (2 dias) Total: ~2 semanas

VibeCoding:

  1. IA decompose problema automaticamente (5 min)
  2. Agentes geram protótipos (2h)
  3. Refinamento humano (3h)
  4. Validação (30 min) Total: ~6 horas

Exemplo 2: Debug de Bug

Tradicional:

  1. Ler logs (20 min)
  2. Debugar manual (1-2h)
  3. Testar fix (30 min)

VibeCoding:

  1. IA analisa logs e código
  2. Propõe 3 soluções possíveis (2 min)
  3. Escolhe e testa a melhor (5 min) Total: ~15 minutos

Skills que Aprenderá 🎯

Ao final deste workshop, você conseguirá:

✅ Explicar como LLMs funcionam internamente
✅ Desenhar um agente autônomo
✅ Usar MCP para comunicação estruturada
✅ Planejar um projeto do zero com IA
✅ Otimizar prompts para melhor qualidade
✅ Construir sistemas multi-agente
✅ Integrar IA em pipelines reais de desenvolvimento

Roadmap do Workshop 🗺️

TOTAL: 4-6 horas

┌─────────────────────────────────────────┐
│ 00 - INTRODUÇÃO (30 min) ← Você está aqui
│ Entender vibecoding, importância
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 01 - CONCEITOS FUNDAMENTAIS (45 min)
│ Como LLMs funcionam, tokens, prompting básico
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 02 - AGENTES IA (60 min)
│ O que são agentes, tool use, loops de ação
│ Exercício: Estender agente
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 03 - MCP PROTOCOLO (45 min)
│ Model Context Protocol, cliente/servidor
│ Exercício: MCP básico
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 04 - PLANEJAMENTO ⭐ (45 min)
│ POR QUE é crucial, COMO estruturar
│ Exercício: Planejar um projeto
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 05 - TÉCNICAS PRÁTICAS (60 min)
│ Prompt engineering, chain-of-thought, RAG
│ Exercício: Otimizar prompts
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 06 - PROJETO CAPSTONE (90 min) 🎉
│ Assistente de Planejamento de Projetos
│ Integra: Agentes + MCP + Planejamento
│ Resultado: Sistema funcional
└─────────────────────────────────────────┘

Total: ~315 minutos = 5,25 horas (ajustável)

Como Aproveitar Este Lab 📚

Para Autoestudo

  1. ✅ Leia cada módulo na sequência
  2. ✅ Execute os exemplos de código
  3. ✅ Faça os exercícios
  4. ✅ Consulte as soluções depois
  5. ✅ Implemente o projeto capstone

Tempo estimado: 8-12 horas (você pode acelerar ou aprofundar)

Para Workshop (com instrutor)

  1. Instrutor apresenta conceitos
  2. Você executa exemplos em paralelo
  3. Grupo faz exercícios juntos
  4. Dúvidas durante a aula

Tempo: 4-6 horas conforme planejado

Para Aula na PUC

Há roteiros de aula estruturados em cada módulo!

Requisitos Prévios ✓

Você precisa saber:

  • ✅ Python básico (variáveis, funções, loops)
  • ✅ Conceitos de API REST (GET, POST)
  • ✅ Git básico (clone, commit, push)

Não precisa saber:

  • ❌ Machine Learning avançado
  • ❌ Redes neurais profundas
  • ❌ Calculus ou álgebra linear

Setup Rápido ⚡

Antes de começar os módulos:

# 1. Clone este repositório
git clone <repo>
cd lab-vibecoding

# 2. Crie ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/macOS
# ou venv\Scripts\activate  # Windows

# 3. Instale dependências
pip install -r requirements.txt

# 4. Configure seu LLM (escolha um)
# Opção A: Ollama (local)
ollama pull llama2
ollama serve

# Opção B: OpenAI
export OPENAI_API_KEY="sk-..."

# Opção C: Groq
export GROQ_API_KEY="grsk-..."

# 5. Teste a instalação
python tests/check_setup.py

Detalhes em INSTALL.md

Próximos Passos 🚀

Opção 1: Continue Aqui

→ Leia por-que-vibecoding.md para aprofundar a motivação

Opção 2: Vá para Módulo 01

→ Módulo 01 cobre conceitos fundamentais de LLMs

Opção 3: Veja os Slides

→ slides.md tem apresentação visual

Dúvidas? 🤔

Pronto? Vá para o próximo arquivo: Módulo 01 - Conceitos Fundamentais

Ou continue lendo: