📝 Documentação e Knowledge-Sharing — Requisito da vaga

Vaga: "Create and maintain thorough documentation, lead technical discussions, and drive knowledge-sharing initiatives."

---

O que documentar em sistemas de AI

• Arquitetura — Diagramas, fluxos, decisões (ADR)
• Prompts — Versões, propósito, exemplos
• Métricas — O que se mede, thresholds, como interpretar
• Runbooks — Como fazer deploy, rollback, troubleshooting
• Decisões — Porque RAG vs fine-tuning, porque este chunk size

---

ADR (Architecture Decision Records)

Formato: Contexto → Decisão → Consequências. Ex: "Escolhemos pgvector porque já temos Postgres e os dados ficam em UE."

---

Knowledge-sharing

• Tech talks — Explicar sistema novo à equipa
• Documentação interna — Confluence, Notion, READMEs
• Code review — Explicar decisões no PR
• Onboarding — Guias para novos membros
• Post-mortems — O que correu mal e aprendizagens

---

Exemplo para dar na entrevista

"No projeto X, documentei a arquitetura do RAG num ADR — porque escolhemos hybrid search, chunk size, etc. Mantive um runbook para deploy e troubleshooting. Partilhei com a equipa numa sessão técnica onde expliquei o fluxo e os trade-offs."