O que o Panolayer faz
O que é a Arquitetura?
A Arquitetura é um mapa analisado a partir do seu código-fonte. Navegue por funções, dependências e chamadores para entender qual código uma alteração pode afetar.
Os documentos vivos são atualizados automaticamente?
Não. Gere documentos vivos a partir da Arquitetura e gere-os novamente quando quiser refletir alterações no código. Eles não são atualizados automaticamente.
Verificação
O que devo fazer com uma regra com falha?
Leia a expectativa, o comportamento observado, o local e os chamadores afetados. Corrija o código se ele estiver errado, ou corrija a regra se a expectativa estiver errada, e verifique novamente. Você também pode escolher Fix It para entregar a falha ao Panolayer Agent.
Por que a verificação não retornou nada?
Um resultado vazio não prova que o código está correto. Verifique o status da análise e da avaliação e relate uma avaliação indisponível se o problema persistir.
Agentes
Quem paga pelo uso de modelos de um agente de terceiros?
Você usa a assinatura ou a chave de API compatível do fornecedor. O Panolayer executa o agente, mas não cobre a conta de modelo dele.
Por que um agente não iniciou?
Leia o erro de instalação ou de inicialização e verifique a plataforma e as permissões solicitadas. Se a CLI abrir mas pedir login, conclua o login do fornecedor antes de atribuir trabalho a ele.
Alterações e commits
O que a pontuação de risco não me diz?
Ela não prova que o código funciona nem que os chamadores continuam corretos. Um modelo lê o diff, atribui uma pontuação a cada arquivo e ajuda você a escolher o que revisar; a verificação é separada.
Posso fazer commit com falhas?
Sim. Seu próprio commit não é bloqueado pela verificação. As falhas continuam visíveis para que você decida como tratá-las.
Configuração e conta
Posso usar um Mac com Intel?
Não. O Panolayer precisa de um Mac com Apple silicon executando o macOS 15 Sequoia ou posterior.
Limites e solução de problemas
Por que a etapa de aprovação é local?
A etapa de aprovação fica no seu Mac, antes da sua branch e antes da revisão no host Git. Ela não é uma verificação de CI compartilhada nem uma regra de proteção de branch, então não impõe uma política para toda a equipe.
Como relato um bug?
Use as ferramentas de relatório de bugs do app ou a página de contato. Inclua as etapas e o erro que você vê, sem credenciais nem código-fonte privado.