# Criar ou reconciliar o ambiente IAs no Notion

Este procedimento materializa a instalação completa, seguindo o [template exato](reproduzir-template-exato.md). O [esquema](../assets/notion/esquema.json) define os cinco objetos, campos, opções, relações e vistas sem IDs de origem. Os textos em assets/notion são modelos de conteúdo, não uma importação que cria bases automaticamente.

## 1. Reconhecer destino e capacidade

Leia a página de destino, seus filhos e a condição existente antes de editar. Confira conta/espaço, autoridade do pedido e operações expostas: ler página, criar/atualizar página, criar base, alterar esquema, criar relações e configurar vistas. Use as ferramentas reais do ambiente e sua documentação, inclusive a sintaxe de Markdown quando houver. Não pressuponha nomes de ferramentas ou formatos de argumentos de outro assistente.

Um link não prova acesso. Teste leitura e a operação necessária no destino autorizado. Não amplie permissões nem altere compartilhamento para fabricar sucesso. Se uma etapa não estiver disponível, prepare seu conteúdo, deixe a condição parcial e continue as independentes.

## 2. Reutilizar antes de criar

Procure IAs e cadastros equivalentes dentro do destino. Leia esquemas, vistas e registros, inclusive homônimos e sinônimos no campo aliases do esquema. “Catálogo de agentes”, por exemplo, pode ser o cadastro Agentes. Não renomeie um cadastro de negócio só por preferência estética.

Mantenha um mapa de correspondência entre função, ID da página/base, ID da fonte de dados e URL. As relações usam a fonte da **instância da pessoa**; página de base e fonte de dados podem ter identificadores diferentes. Preserve todos os registros e propriedades existentes. Antes de alterar opções de situação, conserve as opções já usadas e explicite a equivalência com as necessárias. Se um campo homônimo tem significado ou tipo incompatível, proponha o ajuste concreto e não o apague.

Após uma tentativa com resultado incerto, liste e leia o destino antes de criar novamente. Retome pelo mapa, não pelo número de passos executados.

## 3. Construir as cinco bases

Crie/reconcilie nesta ordem para resolver as relações: **Agentes → Tarefas dos agentes → Melhores práticas e melhorias → Sistemas → Produtos**. O esquema contém todos os campos; use tipos nativos de título, texto, seleção, status, pessoa, URL, data e relação.

| Base | Uso e relações |
|---|---|
| Agentes | Função, entregas, limites, ambiente, fontes, arquivos, Skills, acionamento, edição e conferência. Responsável humano só quando conhecido. |
| Tarefas dos agentes | Agentes participantes, Agente de origem e Próximo agente relacionados ao cadastro Agentes; resultado esperado, conclusão, próxima ação, entrega, responsável e prazo. |
| Melhores práticas e melhorias | Agentes afetados e Demanda de origem relacionados aos cadastros desta instalação; ocorrência, evidência, proposta, decisão e aplicação conferida. |
| Sistemas | Agentes que usam ↔ Sistemas no cadastro dos agentes. Finalidade, tipo, situação, acesso e operações permitidas. **Zero registros iniciais.** |
| Produtos | Agentes de apoio ↔ Produtos apoiados no cadastro dos agentes. Público, resultado, situação e referências. **Zero registros iniciais.** |

Crie cada relação uma vez, com retorno na outra base quando suportado. Confira o destino efetivo e o campo inverso antes de adicionar outro; duas relações soltas com nomes parecidos não substituem o vínculo recíproco. Campos de pessoa não recebem nomes inventados ou o autor da distribuição.

No Kanban, as situações são: A fazer; Em andamento; Aguardando insumo; Aguardando retorno; Em revisão; Concluída; Cancelada. As duas últimas pertencem ao grupo concluído. Nas melhorias: A analisar; Decidida; Em aplicação; Aplicada e conferida; Não aplicar. As duas últimas pertencem ao grupo concluído. Preserve o vocabulário equivalente de bases em uso.

Não preencha Sistemas e Produtos, nem mesmo com “Claude”, “Notion” ou um produto de exemplo. Elas são sugestões para a pessoa desenvolver depois; seus campos e relações já devem estar utilizáveis.

## 4. Montar a página IAs

Use o corpo exato em [pagina-ias.md](../assets/notion/pagina-ias.md) e o conjunto em template.json. Substitua cada marcador pelo objeto confirmado desta instalação; os exemplos, relações e vistas são parte da entrega. No Notion, prefira menções e vistas nativas; não deixe marcadores ou código de exemplo visíveis na entrega.

Componha:
- uma introdução curta;
- três acessos: Trabalho, Agentes e Melhorias;
- **Tarefas dos agentes**, vista vinculada à base única de tarefas;
- **Agentes do meu sistema**, galeria do cadastro único de agentes;
- Sistemas e Produtos em uma seção de cadastros sugeridos, com explicação de que começam vazios;
- orientações de começo e de localização dos materiais em seções recolhíveis.

Configure poucas propriedades visíveis. O quadro inicial segue exclusivamente as configurações portal_tasks:0 e tasks:1 de template.json: Demanda, Situação, Origem da tarefa, Pessoa que delegou, Agente de origem, Próximo agente e Próxima ação, nessa ordem. Agrupe por status: três grupos (a fazer, em andamento e concluído), mantendo os estados detalhados nos cartões. Se o mecanismo só oferecer agrupamento por opção, use as sete opções e registre a diferença; a ausência do Kanban nativo não recebe condição concluída.

A galeria mostra Agente, Situação e Função; dispense capas sem utilidade. Tabelas de Sistemas e Produtos mostram título, situação, finalidade/resultado e agentes relacionados. Priorize leitura e navegação; não crie imagens ou callouts decorativos no lugar dos acessos.

## 5. Cadastrar o próprio Couto-IAS e preparar fichas

Procure a ficha antes de criar. Na instalação inicial, use **somente o corpo e as propriedades da página couto_ias em template.json**, e as demais páginas iniciais pelos respectivos keys. A ficha começa em Em preparação; complete ambiente, acesso, pasta, edição, fontes e conferência apenas com fatos da instância. Criar o cadastro não demonstra instalação.

Os quadros individuais iniciais seguem as configurações c0_tasks:0, prep_tasks:0 e review_tasks:0 de template.json, vinculados à mesma base de tarefas e filtrados pelas próprias fichas. Não crie uma base por agente. [ficha-agente.md](../assets/notion/ficha-agente.md) serve apenas para agentes novos, criados depois da reprodução inicial. [cadastro-couto-ias.md](../assets/notion/cadastro-couto-ias.md) explica como completar campos de uso; não fornece outro corpo concorrente.

Guarde na ficha a orientação de consulta da fila: ao ser acionado para continuar trabalho, recuperar os itens destinados a este agente e suas fontes. Se a pasta/Projeto puder ser editada no escopo recebido, inclua essa rota nas instruções próprias. Criar uma vista não faz o Projeto receber essa instrução por si só.

## Auditoria e delegação fazem parte da estrutura

Crie a vista Auditoria dos componentes dentro de Agentes, com as nove dimensões e os quatro campos de evidência definidos no esquema e em [auditoria](auditoria-dos-componentes.md). Inicialize os três cadastros do template como Não avaliado; deixe data e referência vazias. Não atribua aprovação pela construção da estrutura.

Em Tarefas dos agentes, inclua Origem da tarefa, Pessoa que delegou e Solicitante identificado, preservando Agente de origem e Próximo agente. Reproduza os cartões e o exemplo de delegação humana definidos no template. Confira pedido de pessoa e de agente como origens distintas.

## 6. Conferir e deixar a instância recuperável

Leia novamente:
1. a página IAs, sua posição e seus acessos;
2. os cinco esquemas e os alvos de cada relação;
3. o cadastro do Couto-IAS e a vista filtrada por sua identidade;
4. as vistas compartilhadas, seu agrupamento e as propriedades mostradas;
5. Sistemas e Produtos com zero registros, sem tratar consulta sem acesso como vazio.

Conserve os IDs, as edições, o que foi reaproveitado/criado e a condição no registro da instalação. Não grave URLs da conta de teste nos arquivos distribuídos. As Rotas da instância recebem seus próprios destinos; o pacote de origem continua neutro.

Para verificar uma passagem, prefira uma tarefa real pequena autorizada. Se usar exemplo, rotule-o como demonstração e mantenha-o separado do trabalho real. Confira pedido, retorno e uso segundo [passagens no Kanban](passagens-no-kanban.md); uma simulação pelo mesmo executor não prova dois Projetos independentes.

Declare separadamente: ambiente criado/reconciliado; componentes disponibilizados; plugin instalado/selecionado; primeira entrega; retomada. A instalação completa só recebe essa condição quando as partes do pedido estiverem aplicadas e conferidas. Recursos limitados pedem um recibo parcial, com destino e próxima ação concretos.