| name | vibe-coding-fundamentals |
| description | Skill abrangente sobre Vibe Coding, GitHub Copilot Agent Mode e metodologia de colaboração com IA. Use para entender os princípios fundamentais, arquitetura de skills/agents/prompts e como construir um ecossistema de customizações para Copilot. |
Skill: Vibe Coding Fundamentals
Bem-vindo ao mundo do Vibe Coding — uma metodologia completamente nova de programação onde você colabora com GitHub Copilot Agent Mode para criar código de forma natural e iterativa.
O que é Vibe Coding? 🎸
Vibe Coding é um paradigma de programação onde:
- Você descreve o que quer em linguagem natural
- Copilot escreve o código completo com inteligência
- Você testa e itera para refinar o resultado
- O código funciona — mesmo que você não domine cada linha
Não é sobre ignorância técnica. É sobre leverage — usar a IA como um colaborador especializado na sua stack.
Princípios Fundamentais
| Princípio | Descrição |
|---|
| 🤝 Colaboração | Humano + IA trabalhando juntos |
| 🎯 Intenção Clara | Comunicar o que você quer, não como fazer |
| 🔄 Iteração Rápida | Testar, feedback, refinar, repetir |
| 📚 Context Matters | Bom contexto = melhor código |
| 🛡️ Confiança Verificada | Sempre revisar e testar |
GitHub Copilot Agent Mode 🤖
O que é?
Agent Mode é o modo avançado do Copilot onde ele atua como um agente autônomo capaz de:
- 🧠 Entender o contexto do seu projeto
- 📖 Ler e analisar múltiplos arquivos
- 🔍 Buscar informações e padrões
- 🛠️ Executar ações complexas
- 📝 Criar ou modificar código em larga escala
Como Ativar
- Abra VS Code
- Pressione
Cmd + Shift + P (macOS) ou Ctrl + Shift + P (Windows/Linux)
- Digite
@mentions ou use o símbolo @
- Procure por Agent Mode ou use
@ para invocar agentes
- Descreva o que você quer que o agente faça
Diferença: Chat vs Agent Mode
## Chat Mode (Padrão)
- Você faz pergunta
- Copilot responde
- Contexto limitado ao que você escreve
## Agent Mode ⭐
- Você descreve uma tarefa complexa
- Copilot lê múltiplos arquivos
- Copilot cria/modifica/testa automaticamente
- Contexto completo do projeto
- Executa ações iterativas
Arquitetura de Customização 🏗️
Para implementar Vibe Coding efetivamente, você precisa de 4 camadas:
1️⃣ Custom Instructions (Raiz do Projeto)
Arquivo: .github/copilot-instructions.md
Define como o Copilot deve se comportar no seu projeto:
- Linguagem e tom
- Convenções de código
- Estruturas de arquivo
- Boas práticas específicas
Exemplo do Projeto:
- Responda sempre em português brasileiro
- Use MAIÚSCULAS para palavras reservadas em COBOL
- Mantenha estrutura de 4 divisões
👉 Referência: copilot-instructions.md
2️⃣ Global Agents Instructions
Arquivo: AGENTS.md (raiz do projeto)
Instruções que definem:
- Estrutura de agentes disponíveis
- Padrões de código esperados
- Regras de ouro (Always Do, Never Do)
- Convenções de nomenclatura
Exemplo do Projeto:
- Use a estrutura padrão de 4 divisões
- Declare todas as variáveis na DATA DIVISION
- Termine sentenças com ponto final
👉 Referência: AGENTS.md
3️⃣ Skills (Domínios Especializados)
Pasta: .github/skills/
Skills encapsulam conhecimento sobre um domínio específico:
O que é um Skill?
Um conjunto de instruções e boas práticas para um contexto específico:
- Linguagem/tecnologia
- Padrão de projeto
- Tipo de tarefa recorrente
Estrutura de um Skill
.github/skills/
├── cobol-calculadora/
│ └── SKILL.md ← Instruções + exemplos
├── README-manutencao/
│ └── SKILL.md ← Workflow específico
└── vibe-coding-fundamentals/
└── SKILL.md ← Este arquivo
Formato do SKILL.md
---
name: nome-do-skill
description: Descrição clara do que o skill faz
---
[Conteúdo estruturado com seções claras]
Skills Disponíveis no Projeto
| Skill | Propósito | Referência |
|---|
| cobol-calculadora | Criar calculadoras em COBOL | SKILL.md |
| readme-manutencao | Manter 3 READMEs sincronizados | SKILL.md |
| vibe-coding-fundamentals | Entender VibeCoding e Agent Mode | Este arquivo |
| agent-customization | Criar/editar agents e customizações | copilot-skill:/agent-customization/SKILL.md |
4️⃣ Agents (Executores Autônomos)
Pasta: .github/agents/
Agentes são specialistas que executam tarefas complexas:
Tipos de Agentes
## Análise (Read-Only)
- COBOL Planner: Planeja sem fazer mudanças
- COBOL Reviewer: Revisa código, sugere melhorias
- README Writer: Analisa e organiza docs
## Execução (Code Changes)
- COBOL Coder: Escreve e compila código
- Explore: Pesquisa rápida do codebase
## Orquestração
- COBOL Vibecoder: Conecta todo o workflow
Workflow Típico
graph LR
A["🤔 Você Descreve"]
B["📋 COBOL Planner<br/>(Planejamento)"]
C["🛠️ COBOL Coder<br/>(Implementação)"]
D["👀 COBOL Reviewer<br/>(Análise)"]
E["📝 README Writer<br/>(Documentação)"]
A --> B
B --> C
C --> D
D --> E
Como Invocar um Agente
# Chat Mode
@COBOL Planner: Como estruturar uma calculadora em COBOL?
# Agent Mode (mais poderoso)
Use o seletor de agentes para invocar:
- Clique em `@` no chat
- Selecione o agente desejado
- Descreva a tarefa completa
👉 Agentes Disponíveis:
5️⃣ Prompts (Fluxos Reutilizáveis)
Pasta: .github/prompts/
Prompts são receitas para tarefas recorrentes:
Exemplos
| Prompt | Para Quê | Referência |
|---|
| criar-programa.prompt.md | Criar programa COBOL do zero | Arquivo |
| implementar-soma.prompt.md | Adicionar soma à calculadora | Arquivo |
| testar-programa.prompt.md | Compilar e testar código | Arquivo |
| atualizar-readme.prompt.md | Sincronizar docs em 3 idiomas | Arquivo |
Stack de Customização do cowboy 🏛️
Este projeto demonstra a stack completa:
copilot-instructions.md
↓ Define comportamento global
AGENTS.md
↓ Regras gerais
├── Skills/
│ ├── cobol-calculadora/
│ ├── readme-manutencao/
│ └── vibe-coding-fundamentals/
│ ↓ Conhecimento de domínio
├── Agents/
│ ├── cobol-planner.agent.md
│ ├── cobol-coder.agent.md
│ ├── cobol-reviewer.agent.md
│ └── readme-writer.agent.md
│ ↓ Executores especializados
└── Prompts/
├── criar-programa.prompt.md
├── implementar-soma.prompt.md
└── ...
↓ Receitas recorrentes
Workflow Prático: Vibe Coding em Ação 🎬
Cenário: Implementar Logaritmo na Calculadora
Passo 1: Planejamento
Você: @COBOL Planner
Como implementar logaritmo (base 10) em COBOL?
Planner: [Analisa AGENTS.md e copilot-instructions.md]
[Responde com plano estruturado]
Passo 2: Acessar Skill Apropriado
Copilot reconhece:
- Domínio: COBOL
- Padrão: Operação matemática
- Skill sugerido: cobol-calculadora
Passo 3: Execução (Agent Mode)
Você: @COBOL Coder
Implemente logaritmo na calculadora seguindo:
1. Skill: cobol-calculadora
2. Padrão de prompt: implementar-log.prompt.md
3. Review em: cobol-reviewer.agent.md
Coder: [Escreve código completo]
[Compila e testa]
[Retorna resultado]
Passo 4: Revisão
Você: @COBOL Reviewer
Revise o código de logaritmo
Reviewer: [Analisa boas práticas]
[Sugere melhorias]
[Aprova ou solicita mudanças]
Passo 5: Documentação
Você: @README Writer
Atualize README em PT-BR, EN e ZH
com a nova operação de logaritmo
Writer: [Sincroniza 3 arquivos]
[Mantém formatação e estrutura]
Boas Práticas para Vibe Coding ✅
DO's (Faça)
✅ Descrição Clara
BOM: "Crie uma calculadora que soma, subtrai, multiplica e divide dois números inteiros de 5 dígitos"
RUIM: "Faz uma calc"
✅ Context Completo
BOM: Use o skill cobol-calculadora e siga AGENTS.md
RUIM: Só escreve o código
✅ Revisar o Resultado
Sempre verifique:
- Compila sem erros?
- Executa corretamente?
- Segue as conventions?
✅ Usar Skill Apropriado
Tarefa com COBOL → cobol-calculadora
Tarefa com README → readme-manutencao
Tarefa nova → vibe-coding-fundamentals
DON'Ts (Não Faça)
❌ Confiar Cegamente
ERRADO: Copiar e colar sem revisar
CORRETO: Revisar, testar e validar tudo
❌ Ignorar Convenções
ERRADO: "Ignora AGENTS.md, faz do teu jeito"
CORRETO: "Segue rigorosamente AGENTS.md"
❌ Context Vago
ERRADO: "Cria um programa"
CORRETO: "Cria um programa COBOL que calcula logaritmo base 10"
Mapa Mental do Projeto 🧠
cowboy/
│
├── 📖 README.md / README-en.md / README-zh.md
│ └── Documentação principal (3 idiomas)
│
├── 🏗️ AGENTS.md
│ └── Regras globais, estrutura COBOL
│
├── 📚 .github/copilot-instructions.md
│ └── Instruções Copilot específicas
│
├── 🧠 .github/skills/
│ ├── cobol-calculadora/
│ │ └── Como criar calculadoras
│ ├── readme-manutencao/
│ │ └── Como manter docs sincronizadas
│ └── vibe-coding-fundamentals/
│ └── Este skill → Conceitos e arquitetura
│
├── 🤖 .github/agents/
│ ├── cobol-planner.agent.md
│ │ └── Planeja sem fazer mudanças
│ ├── cobol-coder.agent.md
│ │ └── Escreve e compila
│ ├── cobol-reviewer.agent.md
│ │ └── Revisa código
│ ├── readme-writer.agent.md
│ │ └── Mantém docs
│ └── cobol-vibecoder.agent.md
│ └── Orquestra tudo
│
├── 📝 .github/prompts/
│ ├── criar-programa.prompt.md
│ ├── implementar-soma.prompt.md
│ ├── implementar-subtracao.prompt.md
│ ├── implementar-divisao.prompt.md
│ ├── implementar-log.prompt.md
│ ├── testar-programa.prompt.md
│ ├── atualizar-readme.prompt.md
│ └── manutencao-repositorio.prompt.md
│
└── 💻 src/
└── CALCULADORA.cbl
└── Programa compilável
Casos de Uso para Este Skill 🎯
Use Este Skill Quando:
-
Entender Vibe Coding
- "O que é Vibe Coding?"
- "Como funciona Agent Mode?"
- "Por que usar Skills?"
-
Configurar Novo Projeto
- "Como estruturar customizações de Copilot?"
- "Qual é a hierarquia de Skills, Agents, Prompts?"
- "Como criar um SKILL.md novo?"
-
Troubleshooting de Customizações
- "Por que meu Agent não está sendo reconhecido?"
- "Como adicionar um novo Skill?"
- "Qual é a ordem correta de execução?"
-
Aprender Best Practices
- "Como escrever bons prompts?"
- "Quando usar cada agente?"
- "Como estruturar um Skill efetivo?"
NÃO Use Este Skill Para:
❌ Implementação COBOL específica → Use cobol-calculadora
❌ Manutenção de READMEs → Use readme-manutencao
❌ Revisar código produzido → Use COBOL Reviewer Agent
❌ Troubleshooting de compilação → Use COBOL Coder Agent
Referências Cruzadas 📚
Documentação Principal
Copilot Instructions
Skills Relacionados
Agents Especializados
Prompts Reutilizáveis
Próximos Passos 🚀
Depois de entender este Skill:
- Leia AGENTS.md para ver as regras globais
- Explore .github/copilot-instructions.md para entender comportamento
- Estude cobol-calculadora/SKILL.md como exemplo prático
- Invoque um agente com uma tarefa real (use
@COBOL Planner primeiro!)
- Crie seu próprio Skill seguindo este template
Lembre-se 💭
"Vibe Coding não é preguiça — é leverage. Você está colaborando com um especialista de IA para escribir código melhor, mais rápido e com menos erros."
🤠 cowboy
"Vibe Coding é programar sem entender o código"
↓
Espera, não...
↓
"Vibe Coding é programar COM IA como seu par,
focando na intenção e qualidade ao invés
de cada linha de sintaxe."
Versão
- Vibe Coding Fundamentals Skill: v1.0
- Data: 28 de março de 2026
- Compatível com: GitHub Copilot Agent Mode
- Linguagem: Português Brasileiro (PT-BR)
