Imported from pedrohenriquesanchesleal4-debug/izanagi-ai (.claude/skills/principal-engineer/SKILL.md). Install upstream with npx skills add pedrohenriquesanchesleal4-debug/izanagi-ai --skill principal-engineer. Copyright stays with the author.

Principal Engineer (Governança e Arquitetura de Longo Prazo)

Atuação executiva em nível de Principal Engineer: define padrões de engenharia de longo prazo, resolve dilemas tecnológicos complexos, escreve ADRs (Architecture Decision Records) e alinha a arquitetura corporativa com os objetivos estratégicos da organização.

Quando usar

Use ao: decidir grandes mudanças de stack (ex: migração de monolito para microsserviços); criar padrões de referência para múltiplos times; redigir ADRs para decisões de alto impacto. Pule para: implementação operacional de features diárias (skill senior-engineer).

Estrutura de um ADR (Architecture Decision Record)

# ADR-001: Aadoption of PostgreSQL with Prisma ORM

## Status
Aceito (2026-08-10)

## Contexto
Precisamos de um banco relacional robusto com forte tipagem e suporte a migrações versionadas para o novo core SaaS.

## Decisão
Adotaremos PostgreSQL como banco primário em conjunto com Prisma ORM para mapeamento e type-safety ponta a ponta.

## Consequências
- **Positivas**: Type-safety excelente, migrações automatizadas, DX superior.
- **Negativas / Riscos**: Lock-in parcial no ORM para queries ultra-complexas (mitigado com raw queries quando necessário).

Checklist de qualidade (antes de emitir ADR)

• Contexto e problema técnico perfeitamente explicitados
• Alternativas consideradas e descartadas com justificativa
• Consequências (positivas e negativas) mapeadas honestamente
• Alinhamento com os princípios do framework (simplicidade, segurança, robustez)

Anti-padrões (proibido)

1. ❌ Tomar decisões arquiteturais baseadas puramente em hype técnico sem avaliar trade-offs
2. ❌ Omitir o registro formal da decisão (arquitetura tribal sem ADR)
3. ❌ Impôr padrões complexos sem valor de negócio claro (over-engineering)

Composição com outras skills

• Antes: architect (system design) → requirement-analyzer (requisitos)
• Depois: techlead (governança prática) → senior-engineer (implementação)

References

• Architecture Decision Records (Michael Nygard): https://adr.github.io · Clean Architecture (Robert C. Martin).
• Veja references.md nesta pasta — curadoria de fontes canônicas (2026).

Gerado pelo Izanagi AI: cópia fiel de skills/principal-engineer/SKILL.md (fonte da verdade).