O problema
Mantenho um ecossistema pessoal extenso — briefings de IA agendados, contentores de automação, um cofre de conhecimento, um sistema de execução, vários sites publicados. Estava bem documentado e era arquitetonicamente sólido. Era também, como descobri, estruturalmente incapaz de reparar nas suas próprias falhas.
Uma auditoria a quatro domínios revelou o que era silenciosamente verdade há meses:
- Três dos cinco briefings agendados estavam silenciosamente mortos — o diário há cerca de três meses
- Dois contentores de automação estavam em baixo há três dias, sem política de reinício e sem notificação
- O disco consumia cerca de 5 GB por dia rumo ao nível crítico, sem diagnóstico
- Os documentos constitucionais contradiziam a realidade em produção há semanas
- A única rotina de verificação de saúde era estruturalmente incapaz de ver qualquer um dos pontos acima
Vale a pena nomear o modo de falha com precisão, porque se generaliza: cada componente estava individualmente saudável e não reportava a lado nenhum. Não havia nenhuma superfície onde o sistema, como um todo, falasse com o seu operador. Acrescentar mais um painel teria acrescentado uma décima sexta coisa a verificar. A lacuna não era de monitorização. Era de orientação.
A verdadeira restrição
A restrição dura não era técnica. Era a atenção.
Tenho um diagnóstico de TDAH e sou sobrevivente de um traumatismo cranioencefálico. Uma ferramenta que exige vigilância para ser útil é uma ferramenta que abandono em duas semanas — e tenho o cemitério de apps de produtividade abandonadas para o provar. Por isso, o brief de design não era “mostrar todo o estado do sistema”. Era mais difícil:
“Desenhar para a pior manhã, não para a melhor.”
Essa única restrição gerou quase todas as decisões seguintes. Excluiu a completude, excluiu a configuração, excluiu tudo o que recompensa a verificação frequente e excluiu toda a linguagem visual de urgência a que as ferramentas de monitorização recorrem por defeito.
Cinco decisões que fizeram o trabalho
1. Observa, não possui
O Compass guarda zero dados primários. Cada facto que apresenta vive noutro lugar e é lido, nunca criado. O teste a que o submeti: apagar o Compass esta noite e não perder nada. É isto que o torna seguro para depender dele — nunca poderá tornar-se mais um sistema a exigir cópias de segurança, migração ou cuidados.
2. A confiança é a funcionalidade
Cada dado traz a sua idade. Cada inferência traz a sua confiança. E, sobretudo, “o próprio monitor está em baixo” é um estado de primeira classe — não um erro, não um ecrã em branco. Uma ferramenta de monitorização que não consegue reportar a própria falha é exatamente a ferramenta que acabou de me falhar durante três meses. O Compass foi construído para admitir quando não sabe.
3. Um limite rígido de três itens, e um próximo movimento
A interface recusa-se a mostrar mais de três coisas a precisar de atenção e apresenta exatamente uma próxima ação recomendada por dia. Não uma lista priorizada — um único movimento. As listas devolvem a decisão ao leitor; numa manhã má, é nesse adiamento que a ferramenta perde.
4. O silêncio é um entregável
“Nada precisa de si” é um estado de sucesso assumido com orgulho, desenhado com o mesmo cuidado que qualquer alerta — não um estado vazio, não um marcador de posição. A maioria das ferramentas trata o silêncio como ausência de conteúdo. Aqui é o produto a funcionar. O orçamento de notificações é de cerca de zero a duas por semana, por decisão de design.
5. Predefinições anti-vergonha
Sem sequências. Sem percentagens de conclusão. Sem paredes vermelhas. Os cartões de falha trazem causa, reparação e uma correção com um toque, sujeita a consentimento — nunca uma reprimenda. Um sistema que o faz sentir-se mal pelo estado que está a reportar é um sistema que deixará de abrir, e uma ferramenta de monitorização que não se abre é pior do que nenhuma.
A marca transporta a tese
O brief de identidade era “um instrumento silencioso, não uma app exigente”. A marca é uma rosa dos ventos reduzida à sua forma mínima e honesta:
- O anel é um arco de 300° com uma abertura deliberada — o sistema nunca está “concluído”, apenas orientado. Lê-se também como um anel de progresso em repouso: calmo, sem contar.
- A agulha é toda a tese do produto numa só forma. A lâmina norte é sólida — o que importa agora. A lâmina sul é apenas contorno — contexto que pode ignorar com segurança. Sinal versus ignorável em segurança, desenhado.
- O ponto de pivô é você. Tudo gira em torno de um centro fixo.
É monocromática e herda currentColor, pelo que a barra de navegação, o favicon, o modo escuro e as incorporações são todos o mesmo recurso. Zero variantes para manter — o que é, em si mesmo, uma decisão pensada para o TDAH.
Silêncio cromático
A interface base é quase monocromática e a cor saturada está reservada exclusivamente à semântica de estado, pelo que a cor significa sempre alguma coisa. Quando tudo pode ter cor, a cor deixa de transportar informação — é assim que os painéis de monitorização se transformam em papel de parede.
O estado surge como pequenos pontos e barras finas, nunca como fundos de cartão inundados. Uma parede de vermelho é pânico, não informação.
O acento — um âmbar chamado north-500 — foi escolhido em vez do óbvio azul ou verde-azulado por três razões convergentes: lê-se como luz do dia quente, mantém-se distinguível do par semântico verde/vermelho para segurança em caso de daltonismo, e o quente sobre tinta sobrevive ao Night Shift do iOS sem se transformar em lama. Um elemento âmbar por ecrã, no máximo.
A tipografia é a pilha do sistema, deliberadamente: custo de descarga zero para uma app offline-first e uma sensação nativa — o Compass deve ler-se como parte do telemóvel, não como um site. Apenas quatro tamanhos. O peso faz a hierarquia; o tamanho faz a estrutura.
Uma correção que vale a pena registar
A primeira especificação assumia que a pilha de tipos de letra do sistema herdaria o Dynamic Type do iOS, oferecendo escalonamento de texto acessível sem custo. Não herda — o Dynamic Type não se propaga ao conteúdo web de uma PWA. Uma revisão de design apanhou-o antes da construção.
O Compass inclui, por isso, o seu próprio controlo de tamanho de texto como multiplicador rem na raiz, com toda a tipografia definida em rem sobre a escala de quatro papéis, para que a hierarquia sobreviva ao escalonamento. É uma pequena correção que teria sido uma falha de acessibilidade lançada em silêncio — e, para uma audiência de uma pessoa que precisa dela, uma falha fatal.
Arquitetura
Dois componentes novos, tudo o resto reutilizado:
- Um coletor — um script horário que lê sinais que já existem (JSON de saúde, instantâneos de ferramentas, heartbeats de ficheiros, estado de contentores, agendador, git e disco), verifica cada um contra um contrato de cadência declarado, executa um diagnóstico de falhas determinístico e envia um único objeto de estado autenticado. O estado pessoal nunca toca num URL público.
- Uma superfície — uma PWA estática, instalável e totalmente funcional offline. Quatro ecrãs, dois níveis de profundidade.
A camada de inteligência é deliberadamente de dois níveis: determinística primeiro, IA depois. Os heartbeats são aritmética sobre carimbos temporais de ficheiros, não chamadas a modelos. A IA anota factos; nunca é os factos. E o agendador corre localmente, e não na nuvem — precisamente porque o agendador na nuvem foi o que falhou em silêncio durante três meses. A falha ensinou a arquitetura.
Custo recorrente: aproximadamente zero.
Estado — com honestidade
A Fase 1 está lançada e ativa. O coletor corre, a PWA está instalada no meu telemóvel e o ciclo matinal de dois minutos é real. Está em uso diário pelo seu utilizador previsto.
A Fase 0 — reparar as falhas que a auditoria encontrou — está parcialmente concluída; a tendência do disco continua em aberto. A Fase 2 (o motor de oportunidades e as narrativas de pontos cegos) está especificada e por construir. A Fase 3 existe apenas como condição: construí-la só se as Fases 1 e 2 se tornarem hábito.
Os critérios de sucesso pelos quais o vou avaliar aos seis meses são deliberadamente falsificáveis: zero falhas silenciosas com mais de 48 horas, pelo menos uma conclusão posta em prática por semana, menos de quinze minutos de manutenção por mês e o que chamei o teste Prove-It — sete dias fora, um ecrã, totalmente reorientado.
O que este projeto me ensinou
Desenhar para a própria restrição é o brief mais afiado que existe. Não havia persona atrás da qual me esconder nem investigação para interpretar — se uma decisão estivesse errada, sentia-o na manhã seguinte. As predefinições anti-vergonha, o limite de três itens e o silêncio-como-sucesso não foram escolhidos de uma biblioteca de padrões; foram escolhidos porque as alternativas já me tinham falhado pessoalmente.
A coisa mais valiosa que uma ferramenta de observabilidade pode fazer é admitir ignorância. Todo o projeto existe porque um verificador de saúde não conseguia ver o seu próprio ponto cego. Construir “não sei” como um estado de primeira classe — e não como uma lacuna — é a decisão de design que levaria para qualquer produto que lide com incerteza, o que hoje significa a maioria dos produtos com IA.
E a contenção é mais difícil de desenhar do que a capacidade. Cada ecrã foi um argumento contra acrescentar alguma coisa.
Como foi feito
O Compass foi desenhado e construído com assistência de IA do princípio ao fim, trabalhando com o Claude na auditoria, na especificação e na implementação — e revisto por passagens de agentes adversariais que apanharam erros reais, incluindo a falha do Dynamic Type descrita acima.
A direção de produto, as restrições, os princípios de design e cada decisão de julgamento são meus. Refiro o método explicitamente porque é assim que trabalho agora, e porque um estudo de caso sobre confiança que fosse vago quanto à sua própria proveniência seria uma má publicidade ao princípio.