Entradas do diário de bordo sobre Deep Cut Atlas.https://imperfectsystems.com/https://imperfectsystems.com/pt/blog/driving-locked-iphone-coding-session/https://imperfectsystems.com/pt/blog/driving-locked-iphone-coding-session/WebDriverAgent precisava de um telefone sempre desbloqueado na mesa. iPhone Mirroring e mirroir-mcp deixam um agente tocar e testar o MusicKit no escuro.Wed, 30 Sep 2026 00:00:00 GMTDevelopmentiosmusickitautomationdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/homebrew-untrusted-tap-audit/https://imperfectsystems.com/pt/blog/homebrew-untrusted-tap-audit/A barreira de confiança existe porque um tap real foi comprometido. Vinte minutos lendo a fórmula, as permissões e o mantenedor venceram dez segundos rodando o comando sugerido.Mon, 21 Sep 2026 00:00:00 GMTDevelopmentsecuritymacostoolingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/abandoned-tooling-npm-git/https://imperfectsystems.com/pt/blog/abandoned-tooling-npm-git/Um npm uninstall que deixa um binário de 44MB para trás, e um stash cujo rótulo registra onde o HEAD estava apontando, não do que o diff trata.Wed, 16 Sep 2026 00:00:00 GMTDevelopmentgitnpmtoolingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/stashed-fix-live-repro-different-bug/https://imperfectsystems.com/pt/blog/stashed-fix-live-repro-different-bug/Um apply de stash limpo, uma regra do SwiftLint que compara sintaxe em vez de rastrear o consumo, e uma travada em três abas que não era o bug já corrigido.Tue, 15 Sep 2026 00:00:00 GMTDevelopmentiosswiftdebuggingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/app-store-rejection-musickit-gotcha/https://imperfectsystems.com/pt/blog/app-store-rejection-musickit-gotcha/Autorização não é assinatura, um tipo de erro que não existe, e uma correção pronta ficando invisível no git stash enquanto eu a reconstruía a partir de anotações.Sat, 12 Sep 2026 00:00:00 GMTDevelopmentiosswiftmusickitapp-storedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/filter-bug-three-issues/https://imperfectsystems.com/pt/blog/filter-bug-three-issues/O filtro relatado funcionava bem - o problema real era outro filtro, deliberadamente independente, e o fix certo foi uma terceira opção nunca cogitada.Thu, 03 Sep 2026 00:00:00 GMTDevelopmentiosswiftswiftuidev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/rating-prompt-simulator/https://imperfectsystems.com/pt/blog/rating-prompt-simulator/Um gate de três vitórias, uma chamada a requestReview(), e uma crença recebida sobre o comportamento do simulador que se provou errada quando eu realmente testei.Wed, 02 Sep 2026 00:00:00 GMTDevelopmentiosswiftapp-storedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/bug-i-filed-was-wrong/https://imperfectsystems.com/pt/blog/bug-i-filed-was-wrong/O bug que registrei era uma proteção para algo impossível. A solução real foi uma exclusão em tempo de leitura, que quebrou outros quatro testes.Sat, 29 Aug 2026 00:00:00 GMTDevelopmentiosswifttestingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/playlist-already-had-right-name/https://imperfectsystems.com/pt/blog/playlist-already-had-right-name/Um artefato de renomeação, uma API sem campo de autor, e um teste em dispositivo real provando que o bug já tinha se corrigido sozinho, fechado como está.Fri, 28 Aug 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/featured-albums-test-that-lied/https://imperfectsystems.com/pt/blog/featured-albums-test-that-lied/Não existe flag isEssential - Essentials é só uma playlist. featuredAlbums é o sinal real, e um fixture mudado expôs um teste que ninguém rodou de novo.Wed, 26 Aug 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/tracklist-section-thirty-minutes/https://imperfectsystems.com/pt/blog/tracklist-section-thirty-minutes/Um método de protocolo, um enum de estado reaproveitado, uma convenção de roteamento que se manteve, e um orçamento de lint que forçou uma divisão que valia a pena fazer de qualquer forma.Tue, 18 Aug 2026 00:00:00 GMTDevelopmentiosswiftdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/eight-second-scan-every-refresh/https://imperfectsystems.com/pt/blog/eight-second-scan-every-refresh/Medir no dispositivo encontrou um scan da biblioteca inteira rodando em cada lote do Discover - e uma armadilha de medição de 16x onde o cache HTTP favoreceu o caminho errado.Fri, 14 Aug 2026 00:00:00 GMTDevelopmentiosswiftperformancemusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/try-turned-outage-into-all-caught-up/https://imperfectsystems.com/pt/blog/try-turned-outage-into-all-caught-up/Um try? ?? [] fazia uma falha de rede parecer indistinguível de "sem lançamentos", o que deixou uma interrupção guardar em cache um feed vazio por cima de dados bons durante 24 horas.Thu, 13 Aug 2026 00:00:00 GMTDevelopmentiosswifterror-handlingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/setting-worked-perfectly-felt-broken/https://imperfectsystems.com/pt/blog/setting-worked-perfectly-felt-broken/Um filtro só era aplicado ao reabrir o app, porque uma TabView mantém os view models vivos e seu estado semeado fica congelado. A correção apagou um conceito.Wed, 12 Aug 2026 00:00:00 GMTDevelopmentiosswiftswiftuiuxdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/one-knowledge-base-all-agents/https://imperfectsystems.com/pt/blog/one-knowledge-base-all-agents/CLAUDE.md serve para convenções estáveis, não para pegadinhas e lições aprendidas. Isso precisa de um cofre compartilhado único, não uma cópia por repo.Tue, 11 Aug 2026 00:00:00 GMTDevelopmentaiclaude-codeknowledge-managementdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/shipping-deep-cut-atlas-first-submission/https://imperfectsystems.com/pt/blog/shipping-deep-cut-atlas-first-submission/Um consumível que deveria ter sido não consumível, um product ID que você nunca pode reutilizar, um archive que silenciosamente não foi rebuildado, e um rename com um pavio de duas semanas.Mon, 10 Aug 2026 00:00:00 GMTDevelopmentiosswiftapp-storestorekitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/pro-gated-icloud-sync/https://imperfectsystems.com/pt/blog/pro-gated-icloud-sync/Um blob no KVS com tombstones em vez de CloudKit-em-tudo, um decorator que mantém usuários free longe do iCloud por completo, e provar que a sincronização funciona com só um dispositivo.Thu, 30 Jul 2026 00:00:00 GMTDevelopmentiosswifticlouddev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/ux-decision-wrong-first-try/https://imperfectsystems.com/pt/blog/ux-decision-wrong-first-try/A ação de adicionar à playlist combinava com o gesto irmão no mesmo card, e brigava com o resto do app. Escolher o ponto de referência errado para «consistente».Tue, 21 Jul 2026 00:00:00 GMTDevelopmentiosswiftuxdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/discover-tab-stuck-digging/https://imperfectsystems.com/pt/blog/discover-tab-stuck-digging/Uma busca de artista que falhava nunca contava como checada, então um artista ruim se reselecionava para sempre - até um teste de várias rodadas achar a segunda proteção.Wed, 15 Jul 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/docs-sweep-two-more-stale-claims/https://imperfectsystems.com/pt/blog/docs-sweep-two-more-stale-claims/Seis itens de desvio já conhecidos, dois a mais encontrados ao rodar os comandos documentados, e uma correção de nome que a memória do projeto deixou mais restrita que um find-replace.Sun, 12 Jul 2026 00:00:00 GMTDevelopmentiosdocumentationdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/pinning-swiftlint-ci-homebrew/https://imperfectsystems.com/pt/blog/pinning-swiftlint-ci-homebrew/brew install swiftlint instala o que estiver estável hoje, e a CI de release é a mais exposta a essa deriva. A fixação é o binário portátil, não uma formula.Sat, 11 Jul 2026 00:00:00 GMTDevelopmentiosswiftcidev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/closing-test-gaps-swift-6-flip/https://imperfectsystems.com/pt/blog/closing-test-gaps-swift-6-flip/Extraindo algoritmos para fora do alcance do MusicKit, um parâmetro de mock que era silenciosamente ignorado, e dois testes que vinham passando pelo motivo errado o tempo todo.Wed, 08 Jul 2026 00:00:00 GMTDevelopmentiosswifttestingswift-concurrencydev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/segfault-wasnt-a-bug/https://imperfectsystems.com/pt/blog/segfault-wasnt-a-bug/Uma limpeza da camada de serviço do MusicKit em que apagar métodos mortos travou todos os testes de uma vez, e a solução foi um build limpo, não um debugger.Tue, 07 Jul 2026 00:00:00 GMTDevelopmentiosswifttestingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/history-load-path-over-commenting/https://imperfectsystems.com/pt/blog/history-load-path-over-commenting/Três fetches sequenciais em que um nem era necessário de cara, dois recálculos quadráticos, e um linter que expôs por que eu estava realmente escrevendo todos aqueles comentários.Sun, 05 Jul 2026 00:00:00 GMTDevelopmentiosswiftperformancedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/actor-isolation-trap-off-main-thread/https://imperfectsystems.com/pt/blog/actor-isolation-trap-off-main-thread/Conformidades a Codable sintetizadas pelo compilador também herdam o isolamento padrão em MainActor, e async let tem exigências mais rígidas que a task que você já tinha.Thu, 02 Jul 2026 00:00:00 GMTDevelopmentiosswiftswift-concurrencydev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/whole-library-scan-thought-fixed/https://imperfectsystems.com/pt/blog/whole-library-scan-thought-fixed/Um padrão não se corrige de uma vez só. Mais um scan de biblioteca no main actor, escondido num caminho de escrita, e uma API em lote numa única direção.Sun, 28 Jun 2026 00:00:00 GMTDevelopmentiosswiftmusickitperformancedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/discover-tab-empty-wrong-question/https://imperfectsystems.com/pt/blog/discover-tab-empty-wrong-question/IDs de biblioteca usados em requisições de catálogo: dois sintomas, um bug só, uma correção verificada no dispositivo, e o número de 1.610 artistas que forçou um redesenho.Tue, 23 Jun 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/filter-set-becomes-a-feature/https://imperfectsystems.com/pt/blog/filter-set-becomes-a-feature/O armazenamento de 'Não Tenho Interesse' só guardava chaves. Depois ele precisou virar uma tela, e o modelo precisou carregar sua própria descrição.Mon, 22 Jun 2026 00:00:00 GMTDevelopmentiosswiftswiftdatacloudkitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/buttons-werent-broken-main-thread-busy/https://imperfectsystems.com/pt/blog/buttons-werent-broken-main-thread-busy/118 testes verdes, uma passada limpa no simulador, e botões mortos num telefone de verdade. O bug era um serviço @MainActor fazendo trabalho síncrono entre awaits.Sat, 20 Jun 2026 00:00:00 GMTDevelopmentiosswiftswiftuiperformancedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/racing-the-main-actor-await/https://imperfectsystems.com/pt/blog/racing-the-main-actor-await/@MainActor elimina data races, não races de interleaving. Um token de geração, uma guarda contra falha desatualizada, e um teste de race determinístico.Fri, 12 Jun 2026 00:00:00 GMTDevelopmentiosswiftswift-concurrencyswift-testingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/mocks-couldnt-fail-error-injection/https://imperfectsystems.com/pt/blog/mocks-couldnt-fail-error-injection/Todo branch de catch era código morto nos testes. Uma costura de falha de 15 linhas resolveu isso, e depois uma suíte de testes sem anotação derrubou o runner inteiro.Tue, 09 Jun 2026 00:00:00 GMTDevelopmentiosswiftswift-testingtestingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/five-parallel-agents-ios-review/https://imperfectsystems.com/pt/blog/five-parallel-agents-ios-review/Cinco fatias de ~700 linhas, briefings que também perguntam o que está bem feito, e a etapa de verificação que separou bugs reais dos só plausíveis.Sun, 07 Jun 2026 00:00:00 GMTDevelopmentiosswiftclaude-codecode-reviewdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/swiftlint-github-actions-ci-ios/https://imperfectsystems.com/pt/blog/swiftlint-github-actions-ci-ios/Adotando um linter em um código que nunca teve um, um hook de pre-commit sem framework, e três coisas que o runner macOS fez que a documentação não mencionava.Fri, 05 Jun 2026 00:00:00 GMTDevelopmentiosswiftswiftlintgithub-actionscidev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/storekit-2-lifetime-unlock-three-things/https://imperfectsystems.com/pt/blog/storekit-2-lifetime-unlock-three-things/A API de compra é a parte fácil. As junções entre StoreKit 2, isolamento do Swift 6 e observação do SwiftUI foram onde o tempo foi.Thu, 04 Jun 2026 00:00:00 GMTDevelopmentiosswiftstorekitswiftuidev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/building-music-player-i-cant-hear/https://imperfectsystems.com/pt/blog/building-music-player-i-cant-hear/Mini-player para quando o MusicKit fica mudo no simulador: um protocolo de dois métodos, um indicador com uma mentira honesta, e um bug deixado de propósito.Mon, 01 Jun 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/swiftdata-test-crashed-no-error-message/https://imperfectsystems.com/pt/blog/swiftdata-test-crashed-no-error-message/Cinco testes reportando um «Crash» genérico: um helper bem-intencionado deixou o ModelContainer ser desalocado enquanto o store manteve seu context. Um context é algo emprestado.Sun, 31 May 2026 00:00:00 GMTDevelopmentiosswiftswiftdataswift-testingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/mainactor-taskgroup-swift-6/https://imperfectsystems.com/pt/blog/mainactor-taskgroup-swift-6/O checker de isolamento baseado em regiões manda eu abrir um bug, e a Task não estruturada, hoje fora de moda, acaba sendo a ferramenta certa.Sat, 30 May 2026 00:00:00 GMTDevelopmentiosswiftswift-concurrencydev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/apple-music-same-album-two-ids/https://imperfectsystems.com/pt/blog/apple-music-same-album-two-ids/Construindo o fluxo de adicionar à biblioteca, descobri que o MusicKit dá IDs diferentes para as cópias de biblioteca e catálogo do mesmo álbum.Thu, 28 May 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/building-ui-for-data-i-cant-see-yet/https://imperfectsystems.com/pt/blog/building-ui-for-data-i-cant-see-yet/Construir uma tela de playlist agrupada por álbum antes de ter dados reais: detecção de EP e um teste que pegou um fixture desatualizado.Tue, 26 May 2026 00:00:00 GMTDevelopmentiosswiftmusickitdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/musickit-app-simulator-mock-service/https://imperfectsystems.com/pt/blog/musickit-app-simulator-mock-service/Um protocolo, um serviço real e um mock que registra suas escritas: tornando o simulador útil de novo, além do imprevisto com worktree e a armadilha do target recém-criado.Mon, 25 May 2026 00:00:00 GMTDevelopmentiosswiftmusickitswift-testingdev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/claude-code-xcode-synchronized-groups/https://imperfectsystems.com/pt/blog/claude-code-xcode-synchronized-groups/Um agente não consegue clicar no assistente de New Project. Os file-system synchronized groups do Xcode 16 são a costura que permite a ele dominar cada arquivo de código-fonte mesmo assim.Sat, 23 May 2026 00:00:00 GMTDevelopmentiosswiftxcodeclaude-codedev-logdeep-cut-atlashttps://imperfectsystems.com/pt/blog/setting-up-claude-code-for-an-ios-project/https://imperfectsystems.com/pt/blog/setting-up-claude-code-for-an-ios-project/Escrevendo o CLAUDE.md de um app iOS antes de existir Swift: a armadilha do MusicKit no simulador e as regras do CloudKit para SwiftData.Fri, 22 May 2026 00:00:00 GMTDevelopmentiosswiftmusickitclaude-codedev-logdeep-cut-atlas