Skip to content
iam.alan.abreu

ADRs & Roadmap

Decisões de Arquitetura & Roadmap.

Contexto, trade-offs, decisões e marcos de evolução implementados e planejados para a plataforma.

Launch stateThese entries are placeholders while the real case studies and experiment write-ups are prepared for publication.

Decisões Registradas

6

ADR-001 até ADR-006
Aceitas & Implementadas

5

Em produção no site
Em Progresso / Propostas

1

ADR-006 (Busca Híbrida)
Conclusão dos Marcos

94%

Evolução do Sistema

Trajetória de decisões de infraestrutura, IA nativa, visualização 3D e retrieval semântico.

V1.0Marco 1 — Core Platform Foundations
ACCEPTED2024-03-10

ADR-001: GitOps over imperative pipelines

Use declarative reconciliation from Git instead of imperative deployment pipelines to drive cluster state.

100% Concluído (4 fases)
Ver ADR
V2.5Marco 6 — Semantic Brain & Hybrid Retrieval
PROPOSED2026-09-06

ADR-006: Vector embeddings and hybrid search for knowledge retrieval

Adopt hybrid retrieval combining lexical BM25 matching with vector embeddings (text-embedding-004) for Ask Alan.

65% Concluído (4 fases)
Ver ADR
  • Standardization on text-embedding-004Concluído

    Selected Google text-embedding-004 (768 dimensions) for superior semantic understanding across cloud native and DevSecOps domains.

  • Reciprocal Rank Fusion (RRF)Em desenvolvimento

    Implemented fusion ranking combining lexical keyword BM25 candidates with semantic cosine similarity scores before LLM generation.

  • PostgreSQL pgvector Schema MigrationPlanejado

    Provisioning pgvector table with automated re-indexing triggers executing whenever content is committed via /write.

  • Semantic Recall & Grounding EvaluationPlanejado

    Evaluation suite testing conceptual paraphrase queries (e.g. 'zero trust ingress' vs 'Istio mutual TLS') to ensure 100% citation grounding.