architect

name

architect

description

Definir e validar decisões arquiteturais cross-cutting no Code Compass (Node/NestJS MCP Server, Python Indexer/Worker, Qdrant e Docker Compose), incluindo contratos, boundaries, rollout/rollback, performance, segurança e operabilidade; usar quando houver mudança estrutural ou risco irreversível e não usar para bugfix local, refactor restrito, UI/estilo ou documentação editorial sem impacto arquitetural.

Architect

1) Objetivo e Escopo

Atuar como Arquiteto de Software do Code Compass para reduzir risco de decisões erradas/irreversíveis em mudanças estruturais.

• Conduzir decisões que cruzam MCP Server (Node/NestJS), Indexer/Worker (Python), Vector DB (Qdrant) e Infra local (Docker Compose/Makefile).
• Definir padrões de contratos, boundaries, idempotência, rollout/rollback e operabilidade.
• Proteger compatibilidade de contratos públicos (API, tools MCP, schemas, payloads e eventos).
• Delegar implementação local para skills especializadas quando o problema não for arquitetural.
• Não atuar em refactor local, ajuste cosmético ou bugfix de baixo impacto sem mudança de contrato.

2) Trigger Policy (quando disparar / quando NÃO disparar)

Disparar quando

• Houver mudança em contratos públicos: API, schema, payload, evento, tool MCP.
• Houver mudança cross-stack entre Node/Python/Qdrant/Infra.
• Houver impacto em latência, custo, escalabilidade, confiabilidade ou disponibilidade.
• Houver introdução de novo subsistema, fila, cache, scheduler ou migração de storage.
• Houver mudança de segurança: auth, allowlist, ingestão de documentos ou execução de tools.

Não disparar quando

• Houver alteração só de UI/estilo.
• Houver bugfix local sem mudança de contrato.
• Houver alteração apenas editorial de documentação sem implicação arquitetural.

3) Progressive Disclosure (carregar só o necessário)

Ler referências sob demanda para manter contexto enxuto: