# Uso no Cowork

Esta instrução prepara a utilização dos arquivos da Skill. Não certifica instalação, importação, permissões, execução agendada ou capacidades atuais de uma conta Cowork.

## Pedido que a pessoa pode fazer

Faça este pedido na conversa com a IA que produzirá o desenho. Nessa conversa, disponibilize a Skill e seus apoios, junto dos arquivos e informações do agente que já possui. Informe o que sabe sobre o que está em uso, proposto ou pendente; a IA identifica as lacunas que mudam o desenho. Se esses materiais já estiverem acessíveis, basta conferir sua presença. O pedido abaixo não exige que você programe ou escolha campos técnicos.

> Produza o Design do Agente, começando pela visão geral e permitindo expandir Skills, pastas e rotinas. Mostre também como participa do sistema. Use os arquivos e a condição atual que forneci. Quero abrir o HTML, selecionar cada parte e acompanhar o caminho de uma entrega. Mostre o que já existe, o que é proposta e o que depende de mim. Entregue também o modelo e a leitura textual.

A IA recupera o pedido e os insumos antes de perguntar. Se faltar uma informação que muda a arquitetura, faz uma pergunta prioritária e continua o que independe dela. Não pede que a pessoa escolha campos JSON ou desenhe setas.

## Realizar com os meios recebidos

1. Confira se o conteúdo desta Skill e os arquivos de apoio estão acessíveis na sessão. Ver o nome da Skill não demonstra que seu corpo foi recebido. Se a sessão não os recebe, abra `SKILL.md` e os apoios pertinentes pela pasta disponível.
2. Leia a orientação do agente, fontes e Estado do caso. Guarde decisões e dados particulares na instância do usuário. Use exemplos apenas como forma.
3. Produza o modelo JSON numa pasta de trabalho autorizada. Se houver Python 3.9+ disponível, execute `scripts/gerar_design_do_agente.py` para essa entrega (ou `scripts/gerar_mapa.py` para o perfil geométrico), indicando o modelo e o HTML de destino. Os caminhos são resolvidos em relação à pasta da Skill ou fornecidos integralmente à ferramenta.
4. Abra o HTML gerado no recurso disponível. Se a prévia bloquear scripts, use o HTML salvo num navegador autorizado e a leitura equivalente. O conteúdo já estará no HTML mesmo sem JavaScript.
5. Entregue HTML, JSON, Markdown e condição da conferência. A pessoa pode abrir o HTML local sem serviço externo. Links do chat não substituem o arquivo salvo.

Se Python ou terminal não estiver disponível, produza o modelo e a versão textual e adapte o template correspondente: `assets/design-do-agente.html` para o Design do Agente; `assets/documento-mapa.html` para o perfil geométrico. Preserve a navegação e preencha também o conteúdo semântico da leitura completa, além dos dados JSON escapados. Os contratos e geradores mostram a projeção de cada campo; não entregue apenas JSON embutido que dependa de JavaScript para existir. Confira o resultado e diga que a geração foi manual, sem transferir programação à pessoa.

Não instale bibliotecas, ative agendas ou altere conectores para produzir um mapa. Se o ambiente impedir salvar HTML, entregue a leitura textual e indique a limitação concreta; não declare um HTML produzido que não foi salvo.

## Conferência pela pessoa

Sem explicação adicional do autor, a pessoa deve conseguir dizer:

- O que o agente recebe e entrega?
- Qual conhecimento muda seu julgamento?
- Como uma entrega passa para outro participante?
- Quem inicia a execução e decide o efeito reservado?
- O que existe, o que está proposto e o que ainda não foi observado?

Resposta divergente orienta correção de conteúdo ou representação. Clique funcionando demonstra interação, não compreensão.

## Atualizar

Atualize o JSON conservando IDs e conferindo novamente as fontes e a condição atual. Regenere os derivados em outra edição ou com substituição autorizada. Um mapa salvo é uma fotografia; não acompanha mudanças do agente automaticamente. Guarde os três arquivos no destino competente e vincule a demanda quando houver continuidade.


O Design do Agente permite expandir e recolher grupos, consultar componentes e seguir vínculos internos. O gerador recebe a descrição do caso; não descobre ou sincroniza a pasta real automaticamente. A presença dos arquivos da Skill na sessão precisa ser conferida conforme a implantação.
