BPX Governance Framework

Guia central para qualquer pessoa — dev, PM, gestor ou analista — do zero até a entrega de um projeto, seguindo os padrões da BPX.

Fluxo completo de um projeto BPX

IDEIA
  │
  ▼
┌─────────────────────────────────────────────────────┐
│  WIZARD — Novo Projeto                              │
│  "Tenho uma ideia, como começo?"                    │
│  → skills/novo-projeto/SKILL.md                     │
│  Gera: briefing de aprovação + solicitação de repo  │
└─────────────────────────┬───────────────────────────┘
                          │ ✅ Briefing aprovado
                          ▼
┌─────────────────────────────────────────────────────┐
│  FASE 1 — Kickoff & Escopo                          │
│  "O que exatamente vamos construir?"                │
│  → fase-1-kickoff/                                  │
└─────────────────────────┬───────────────────────────┘
                          │ ✅ Escopo aprovado
                          ▼
┌─────────────────────────────────────────────────────┐
│  FASE 2 — Governança de IA                          │
│  "Isso respeita nossas políticas internas de IA?"   │
│  → fase-2-governanca-ia/                            │
└─────────────────────────┬───────────────────────────┘
                          │ ✅ Política validada
                          ▼
┌─────────────────────────────────────────────────────┐
│  FASE 3 — Infraestrutura & Git                      │
│  "Temos repositório, banco e acessos prontos?"      │
│  → fase-3-infra-git/                                │
└─────────────────────────┬───────────────────────────┘
                          │ ✅ Infra provisionada
                          ▼
┌─────────────────────────────────────────────────────┐
│  FASE 4 — Homologação & Deploy                      │
│  "Está seguro e pronto para produção?"              │
│  → fase-4-homologacao/                              │
└─────────────────────────┬───────────────────────────┘
                          │ ✅ Aprovado
                          ▼
                    🚀 PRODUÇÃO

O que existe em cada etapa

| Etapa | Conteúdo | |-------|----------| | Wizard Novo Projeto | Guia interativo para pessoas não-técnicas: coleta a ideia, detecta dados sensíveis e gera o briefing e a solicitação de repositório automaticamente | | Fase 1 — Kickoff | Checklist de escopo, template de briefing, Skill do Claude para conduzir o kickoff | | Fase 2 — Governança de IA | Políticas internas, checklist de IA, Skill de validação | | Fase 3 — Infra & Git | Passo a passo Git, template de solicitação de repositório, checklist Postgres | | Fase 4 — Homologação | Checklist de segurança, critérios de aceite, Skill de homologação |

Biblioteca de Agentes BPX

Componentes de IA aprovados e validados pelo time de tecnologia. Qualquer pessoa pode navegar, escolher e copiar no Claude.

→ Abrir biblioteca

Agentes disponíveis: Wizard Novo Projeto, Analista de Planilha, Gerador de Dashboard, Automação de Relatório, Verificador de Dados Sensíveis, Formulário de Cadastro.

Componentes externos integrados (aitmpl.com)

| Componente | Tipo | O que faz | Instalar | |---|---|---|---| | security-audit | Skill | Auditoria técnica: OWASP, APIs, pen test, hardening | npx claude-code-templates@latest --skill security/security-audit | | security-auditor | Agent | Auditor sênior: compliance, controles, vulnerabilidades, relatório | npx claude-code-templates@latest --agent security/security-auditor |

Arquivos locais: skills/security-audit/SKILL.md e agents/security-auditor.md

Usando o Claude como seu guia

No Claude (Cowork ou Claude Code), o Agente de Governança BPX responde a qualquer etapa. Basta dizer:

"Tenho uma ideia de projeto" — abre o Wizard "Quero iniciar o kickoff" — abre a Fase 1 "Preciso validar meu escopo de IA" — abre a Fase 2 "Quero solicitar repositório" — abre a Fase 3 "Vamos fazer a homologação" — abre a Fase 4

Políticas obrigatórias

→ Política de Repositórios e Acesso a Projetos

Resumo das regras não negociáveis:

• Todo repositório é privado e fica no GitHub BPX
• Acesso somente via convite com conta corporativa
• Projetos com dados financeiros, de RH ou de clientes → infra BPX obrigatória
• Dúvidas ou solicitações: contato com o setor de tecnologia

Stack padrão BPX

| Camada | Tecnologia | |--------|-----------| | Banco de dados | PostgreSQL | | Backend | Node.js (TypeScript) / Python | | LLM | Claude (Anthropic) | | Controle de versão | GitHub BPX (privado) | | Infra | AWS / Docker / Kubernetes | | CI/CD | GitHub Actions |

Qualquer desvio exige aprovação formal do Arquiteto de Referência antes do início do desenvolvimento.

Estrutura da pasta

governance/
├── README.md                        ← este arquivo
├── politica-repositorios.md         ← regras de acesso e hospedagem
├── library/
│   └── index.html                   ← biblioteca de agentes BPX
├── skills/
│   ├── governance-orchestrator/     ← agente orquestrador principal
│   ├── novo-projeto/                ← wizard de criação de projetos
│   └── security-audit/              ← auditoria técnica de segurança (aitmpl.com)
├── agents/
│   └── security-auditor.md          ← auditor de segurança sênior (aitmpl.com)
├── fase-1-kickoff/
├── fase-2-governanca-ia/
├── fase-3-infra-git/
└── fase-4-homologacao/

Pendências abertas

| Item | Responsável | Status | |------|-------------|--------| | Spec de estrutura de pastas e linguagem padrão | Tech Lead | ⏳ Aguardando | | Configuração padrão de CI/CD | Time de Infraestrutura | ⏳ Aguardando | | E-mail oficial do time Lifters | David | ⏳ Confirmar | | Processo de levantamento de projetos existentes | David | 🔜 Próximo passo | | Expansão da biblioteca de agentes | Time de Tecnologia | 🔜 Em andamento |

Mantido por: Arquitetura & Infraestrutura BPX (Lifters Tecnologia) Versão: 1.1 — Revise trimestralmente