CeobeFA333/codex-scientific-diagram-visio

Diagrama de Modelo Científico Visio

Crie ou revise uma figura de arquitetura científica no Microsoft Visio usando objetos editáveis nativos. Trate a correção científica, a geometria legível e a editabilidade como portas separadas; passe por todas as três antes da entrega.

Escolha o modo

• Reconstrução completa: construa a página solicitada a partir de um contrato de modelo verificado e de uma referência visual.
• Revisão local: faça backup do VSDX e altere somente os estágios, símbolos, dimensões, conectores, tipografia ou espaçamento nomeados.
• Auditoria/exportação: inspecione um VSDX existente, corrija apenas defeitos autorizados, reabra-o e exporte PDF mais PNG de 300 DPI.

Se a lógica fonte não tiver sido reconciliada entre código, configuração, manuscrito e figuras antigas, use primeiro scientific-model-diagram-prompting ou realize a passagem de evidências em handoff-contract.md. Nunca infira uma operação de fusão ou dimensão de tensor apenas pela aparência visual.

Fluxo de trabalho obrigatório

1. Congele o modelo alvo

Crie um contrato de modelo contendo ordem dos estágios, formato do tensor em cada fronteira, semântica das operações, parâmetros treináveis, regra de fusão, larguras do classificador, número de classes e rótulos exatos. Cite arquivos fonte e números de linha quando código ou manuscrito estiver disponível.

Aplique esta prioridade de evidência, a menos que o usuário escolha explicitamente outro alvo:

1. modelo construído ou executado com sucesso;
2. implementação de treinamento e configuração do experimento;
3. equações do manuscrito e texto do método;
4. VSDX antigo ou figura raster;
5. referência visual gerada.

Pare e relate contradições não resolvidas antes de desenhar quando elas alterarem materialmente a arquitetura. Leia handoff-contract.md para o esquema de handoff necessário.

2. Proteja a fonte e isole os arquivos de trabalho

• Resolva o VSDX fonte e os caminhos exatos de saída antes de editar.
• Use o diretório de trabalho nomeado pelo usuário. Se nenhum for fornecido, crie um diretório irmão _visio_work.
• Mantenha capturas de tela, rasters de referência, backups com timestamp, exportações temporárias, renders de QA e saídas auxiliares dentro desse diretório de trabalho.
• Faça backup do VSDX fonte antes da primeira mutação. Não sobrescreva a única cópia.
• Remova páginas não relacionadas apenas quando o usuário autorizar e após registrar os nomes das páginas no log de trabalho.

3. Controle o Microsoft Visio deliberadamente

Use a skill de automação Windows computer-use quando disponível. Antes da primeira ação de UI em uma sessão nova, inicialize seu runtime e leia sky.documentation("guidance"); leia sky.documentation("confirmations") antes de ações que possam exigir confirmação. Direcione a janela do Visio pela identidade da aplicação/janela e inspecione capturas de tela em vez de usar sequências de coordenadas cegas.

Abra o VSDX no Microsoft Visio. Não substitua a execução do Visio por um raster, captura de tela SVG, PowerPoint ou editor de diagramas genérico quando o usuário solicitou o Visio.

Leia visio-execution.md antes de controlar o Visio.

4. Construa geometria antes dos detalhes

Defina tamanho da página, orientação, margens, camadas, contêineres de estágio, linhas de base das linhas e corredores de conectores antes de colocar módulos. Use um plano de coordenadas e geometria repetida para ramificações paralelas.

Crie mestres nativos reutilizáveis ou formas agrupadas para componentes repetidos. Mantenha operandos, operadores, dimensões e conectores independentes. Um cuboide 3D deve permanecer um grupo de faces frontal/superior/lateral editáveis; nunca achate a página.

Use layout-and-style.md para tokens de layout, tamanhos de fonte, construção de cuboides, conectores, agrupamento e padrões de publicação do usuário.

5. Desenhe em passes

Execute estes passes em ordem:

1. página, camadas e contêineres;
2. guias de linhas repetidas e corredores de conectores;
3. módulos e cuboides reutilizáveis;
4. operandos matemáticos e operadores independentes;
5. conectores colados aos pontos de conexão;
6. rótulos, dimensões, legenda e legenda;
7. alinhamento, distribuição e agrupamento local;
8. limpeza visual na escala de visualização e no detalhe original.

Após cada passe importante, capture uma captura de tela no diretório de trabalho. Se for solicitada uma revisão local, altere apenas a região afetada e verifique novamente suas conexões de entrada e saída.

6. Garanta roteamento e legibilidade

• Prefira linhas de ramificação perfeitamente horizontais e curvas ortogonais.
• Reserve corredores de conectores vazios antes de colocar texto.
• Cole cada conector funcional a pontos de conexão explícitos.
• Nunca passe uma linha por texto, operador, cuboide, cartão de plotagem ou outra ponta de seta.
• Mantenha linhas paralelas com altura e espaçamento iguais; use Alinhar e Distribuir em vez de estimar visualmente.
• Encurte rótulos ou alargue contêineres antes de reduzir o texto abaixo do tamanho mínimo.
• Inspecione tanto uma visualização de página inteira quanto uma captura de tela ampliada. Texto que só é legível quando ampliado falha.

7. Salve, reabra e verifique a editabilidade

Salve o VSDX final no caminho solicitado, feche-o e reabra-o no Visio. Selecione e edite individualmente pelo menos:

• uma face dentro de um cuboide agrupado;
• um operador ou símbolo matemático;
• um conector e ambas as suas extremidades coladas;
• um rótulo de estágio.

Confirme que a imagem de referência foi removida ou ocultada em uma camada de Referência bloqueada, que páginas não relacionadas estão ausentes quando solicitado, e que nenhum objeto se tornou um bitmap de página inteira único.

Execute scripts/inspect_vsdx.py após salvar. Esta verificação estática complementa, mas nunca substitui, a inspeção visual.

8. Exporte e realize a QA final

Exporte PDF e PNG do Visio. Para uma página de 16 × 9 polegadas, um raster de 300 DPI tem pelo menos 4800 × 2700 pixels. Inspecione ambas as exportações em busca de clipping, substituição de fonte, linhas finas/quebradas, artefatos de sombra e erros de limite de página.

Execute a qa-checklist.md completa. Não entregue enquanto qualquer item de fidelidade científica, sobreposição, conector, integridade de texto, exportação ou editabilidade falhar.

Regras de revisão local

• Preserve formas, estilos, camadas e configurações de página não afetados.
• Faça backup antes de editar e salve a revisão sob uma nova versão até que seja aceita.
• Diagnostique o menor subgrafo afetado: conector de entrada, objetos editados, conector de saída.
• Re-roteie conectores adjacentes após mover qualquer objeto.
• Re-execte a QA de visualização de página inteira; uma correção local pode criar uma colisão global.

Handoff obrigatório

Relate:

1. arquitetura alvo e base de evidências;
2. caminhos da fonte, backup, diretório de trabalho e saída;
3. páginas removidas ou retidas;
4. caminhos do VSDX, PDF e PNG, além do tamanho de pixel/DPI do PNG;
5. resumo da inspeção estática do VSDX;
6. testes de reabertura/editabilidade realizados;
7. qualquer incerteza restante.

Não considere sucesso apenas porque o arquivo foi salvo ou exportado.