Skip to content

gvillalta99/swebok-ai

Repository files navigation

SWEBOK-AI v5.0

Versão Status Licença Site

"O código tornou-se commodity; o contexto tornou-se capital."

O SWEBOK-AI v5.0 (Software Engineering Body of Knowledge - AI Edition) é uma reimaginação completa do Guia do Conhecimento em Engenharia de Software tradicional para a era dos Large Language Models (LLMs) e agentes de IA.

🌐 Acesse o site: https://gvillalta99.github.io/swebok-ai/


📖 Sobre o Projeto

Este repositório publica o SWEBOK-AI v5.0, uma reimaginação do SWEBOK tradicional para a era de agentes e LLMs.

O Paradigma AI-First

Antes (SWEBOK v4) Depois (SWEBOK-AI v5)
Engenharia = Transformar requisitos em código eficiente Engenharia = Estabelecer restrições para sistemas autônomos gerarem soluções provavelmente corretas
Foco na produção de código Foco na verificação e governança
Gargalo: escrever código Gargalo: validar código gerado por IA
Requisitos = "o que construir" Restrições = "o que NÃO deixar construir"

🚀 Comece Agora


📚 Estrutura do Guia

O SWEBOK-AI v5.0 organiza o conhecimento em 16 Knowledge Areas (KAs), reconfigurados para o paradigma AI-First:

Fundamentos

  • Capítulo 0: Introdução ao SWEBOK-AI
  • Capítulo 1: Engenharia de Restrições e Contexto

Knowledge Areas Principais

  • Capítulo 2: Arquitetura de Sistemas Híbridos
  • Capítulo 3: Design de Sistemas Híbridos (Humanos-IA)
  • Capítulo 4: Orquestração e Curadoria de Código
  • Capítulo 5: Verificação e Validação em Escala
  • Capítulo 6: Engenharia de Operações de Software
  • Capítulo 7: Manutenção de Sistemas Opaços
  • Capítulos 8-18: Knowledge Areas em expansão

🎯 Para Quem É Este Guia?

  • Engenheiros de Software que trabalham com ferramentas de IA
  • Líderes Técnicos definindo estratégias de adoção de IA
  • Arquitetos projetando sistemas humanos-IA
  • Profissionais de QA validando código gerado por LLMs
  • Estudantes compreendendo a nova realidade da engenharia de software

🏗️ Arquitetura do Projeto

Reestruturação dos KAs Tradicionais

Software Requirements → Engenharia de Restrições e Contexto

  • Mudança radical: Deixa de ser sobre "capturar o que o usuário quer" para "estabelecer fronteiras de domínio que a IA não deve transgredir"
  • Novos tópicos: Especificação Negativa, Modelagem de Degradação Graciosa, Especificação por Invariantes, Economia da Verificação

Software Design → Design de Sistemas Híbridos (Humanos-IA)

  • Fusão disciplinar: Absorve arquitetura de software e engenharia de sistemas complexos
  • Novos tópicos: Arquitetura de Supervisão, Design para Auditabilidade, Padrões de Separação de Concerns, Antropização de Interfaces

Software Construction → Orquestração e Curadoria de Código

  • Transformação: Deixa de ser "como escrever código" para "como avaliar, integrar e refinar código gerado"
  • Novos tópicos: Verificação Sintética, Gestão de Variabilidade Gerada, Engenharia de Prompts, Debugging de Modelos

Novos KAs Obrigatórios

  1. Engenharia de Garantia e Verificação em Escala - O gargalo deixou de ser produção e passou a ser validação
  2. Governança de IA para Engenharia de Software - Responsabilidade legal e alocação de culpa em falhas
  3. Engenharia de Manutenção de Sistemas Opaços - Manutenção de código legado gerado por IA
  4. Economia e Métricas da Engenharia com IA - Paradoxo de Jevons aplicado ao software

🛠️ Tecnologia

Este projeto usa:

  • MkDocs - Gerador de sites estáticos
  • Material for MkDocs - Tema moderno e responsivo
  • Python - Backend e automação

Executar Localmente

# Instalar dependências
pip install mkdocs mkdocs-material mkdocs-exporter

# Servir localmente (hot reload)
mkdocs serve

# Build do site
mkdocs build

# Deploy para GitHub Pages
mkdocs gh-deploy

🤝 Contribuição

Este é um projeto open source em desenvolvimento ativo. Sua contribuição é bem-vinda!


📝 Licença

O conteúdo original deste repositório está sob a licença CC BY 4.0. Materiais de terceiros não são distribuídos aqui; veja NOTICE.


📊 Status do Projeto

Status

Este guia está em desenvolvimento ativo. Novos capítulos são adicionados regularmente.

Última atualização: 2026-02-05


📧 Contato

Para dúvidas, sugestões ou discussões sobre o projeto:


SWEBOK-AI v5.0
Engenharia de Software para a Era da IA

About

Guia open source de Engenharia de Software na era dos LLMs, reimaginando o SWEBOK com foco em restrições, verificação e governança de sistemas autonômos.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors