Skip to content
@fernando-moretes

Fernando Azevedo - Moretes.com

16+ anos conectando estratégia de negócio e engenharia com AWS, sistemas event-driven, plataformas de dados, IA e arquitetura para o mercado financeiro.

Fernando Moretes

Arquitetura de soluções · AWS · IA · Engenharia de plataforma

Uma convenção, uma pipeline, um lugar.


Por que uma organização

O portfólio cresceu além do que uma conta pessoal governa bem. Repositórios acumulados ao longo de anos, cada um com o seu jeito de nomear, de testar e de versionar — quando isso passa de algumas dezenas, o custo deixa de ser escrever código e passa a ser encontrar as coisas e confiar no que está lá.

Houve também um limite técnico. Conta pessoal do GitHub não tem runner de nível de conta: a API expõe runners por repositório e por organização, e o endpoint de usuário não existe. Automação de CI própria numa conta pessoal significaria repetir a mesma configuração repositório a repositório.

Mover para uma organização resolveu os dois de uma vez, e forçou a padronização que estava atrasada.


Como está montado

flowchart LR
    subgraph ORG["Organização"]
        REPOS["Repositórios<br/><i>uma convenção de nomes</i>"]
        WF["Workflows reutilizáveis<br/><i>a régua, num lugar só</i>"]
    end

    subgraph PIPE["Pipeline"]
        LINT["Convenção<br/><i>PR e branch</i>"]
        CI["Build e testes"]
        SEC["Segurança<br/><i>segredos e dependências</i>"]
        REL["Release<br/><i>SemVer automático</i>"]
    end

    REPOS -->|"chamam"| WF
    WF --> LINT --> CI --> SEC --> REL
Loading

Cada repositório carrega um chamador de poucas linhas apontando para os workflows reutilizáveis. Corrigir a régua é mudar um arquivo — a correção alcança todos no push seguinte, sem migração e sem varredura.


A convenção de nomes

Um nome deveria responder três perguntas antes de alguém abrir o código: o que é, para que serve e se ainda vale mexer. Oito prefixos dão conta:

Prefixo O que é
app- Aplicação com deploy e usuário final
svc- Serviço ou API, sem interface própria
ref- Arquitetura de referência e material técnico
tool- Utilitário de linha de comando
infra- Infraestrutura como código e plataforma
lib- Biblioteca consumida por outros projetos
dot- Configuração de ambiente
lab- Experimento e prova de conceito

Um repositório é lab- até provar que é outra coisa. Promover é barato; descobrir tarde que um app- nunca passou de experimento é caro.


O que a pipeline verifica

Etapa O que olha
Convenção Título do PR em Conventional Commits, nome do branch, tamanho da mudança
Build Stack detectada pelos manifestos do próprio repositório
Segurança Segredos no histórico e vulnerabilidade em dependência
Release Versão calculada dos commits, com changelog

Só segredo vazado barra o merge. Uma pipeline que barra tudo é uma pipeline que se aprende a contornar. Vulnerabilidade em dependência entra numa fila e é priorizada; segredo no histórico não espera fila, porque a credencial já vazou no instante do push — e removê-la do histórico não a torna válida de novo.

A versão sai do commit: fix: sobe o patch, feat: o minor, feat!: o major. Ninguém escreve número de versão à mão, então a régua é a mesma sempre.


Público e privado

O que está aberto aqui é o que tem valor fora daqui: arquitetura de referência, ferramenta reutilizável, material técnico. Trabalho de cliente e projeto em andamento seguem fechados — não por qualidade, mas porque servem a um contexto que não é o de quem passa por aqui.


Em destaque

Repositório O que é Stack
app-mcp-aws-solution-architect Bilingual MCP server and AWS solution architecture assistant for service discovery, Well-Archit Python
app-aws-event-driven-finops-platform Bilingual event-driven AWS banking platform with FinOps-aware service selection, security, obse HTML · ⭐ 1
app-bedrock-agent-starter Bilingual Amazon Bedrock agent starter with Lambda tools, Terraform, evaluations, docs and DevS Python
app-aws-ai-reference-architectures Bilingual AWS AI reference architecture portfolio with Bedrock, RAG, MLOps, Terraform, Well-Arc HCL
ref-finops-architect-toolkit AWS FinOps toolkit: RI vs On-Demand, S3 storage class optimizer, Lambda cost estimator, tagging TypeScript
app-aws-agentic-ai-reference-architecture Bilingual AWS agentic AI reference architecture with Bedrock, MCP tools, guardrails, observabil HTML · ⭐ 1
ref-aws-architecture-studio AWS Architecture Studio: ADR wizard with live preview, Mermaid diagram builder, reference patte TypeScript
ref-aws-pattern-library A curated catalog of 22+ AWS reference architectures with diagrams, ADRs, Well-Architected poin TypeScript
ref-adr-decision-platform Web platform to author, list and version ADRs and RFCs with MADR, Nygard and Y-statement templa TypeScript
ref-architecture-diagrams-library Diagrams as code for AWS, C4, BPMN, event-driven, sequence and state — reproducible and reviewa TypeScript
tool-google-terminal-search CLI utility for Google search from the terminal, maintained as part of Fernando Moretes public Shell
dot-homebrew-google-terminal-search Homebrew distribution repository for google-terminal-search, part of Fernando Moretes public to Ruby · ⭐ 1
Ver os demais repositórios públicos
Repositório O que é Stack
ref-sa-daily-toolkit Daily skills, scripts and templates for Solution Architects: ADRs, Well-Architected, threat mod TypeScript
app-queue-advisor-pricing Queue Advisor pricing app published under moretes.com with public GitHub documentation. TypeScript · ⭐ 1
platform-workflows Workflows reutilizaveis das pipelines
app-dailyfocus DailyFocus productivity app published under moretes.com with public GitHub documentation. TypeScript

TypeScript · HTML · Python · Shell · Ruby · HCL

fernando.moretes.com · LinkedIn

Índice gerado automaticamente · 09/2026

Popular repositories Loading

  1. dot-homebrew-google-terminal-search dot-homebrew-google-terminal-search Public

    Homebrew distribution repository for google-terminal-search, part of Fernando Moretes public tooling portfolio.

    Ruby 1

  2. app-queue-advisor-pricing app-queue-advisor-pricing Public

    Queue Advisor pricing app published under moretes.com with public GitHub documentation.

    TypeScript 1

  3. tool-diagram-as-code tool-diagram-as-code Public

    Forked from awslabs/diagram-as-code

    Diagram-as-code project/fork connected to Fernando Moretes architecture portfolio.

    Go 1

  4. tool-deskbuddy tool-deskbuddy Public

    Forked from LextZip/Deskbuddy

    Public fork tracked in Fernando Moretes GitHub portfolio.

    C++ 1

  5. app-aws-agentic-ai-reference-architecture app-aws-agentic-ai-reference-architecture Public

    Bilingual AWS agentic AI reference architecture with Bedrock, MCP tools, guardrails, observability and DevSecOps pipelines.

    HTML 1

  6. app-aws-event-driven-finops-platform app-aws-event-driven-finops-platform Public

    Bilingual event-driven AWS banking platform with FinOps-aware service selection, security, observability and Vercel frontend.

    HTML 1

Repositories

Showing 10 of 19 repositories

Top languages

Loading…

Most used topics

Loading…