# FOXY Planner

> Plataforma de gestão de operação, clientes, projetos e conteúdo das empresas MELLOW e
> FOXY. Foi construída para ser operada por agentes de IA: em vez de navegar pela
> interface, um agente envia comandos estruturados que o sistema valida, pré-visualiza
> e executa, com histórico e desfazer.

## Antes de operar

- [Manual operacional](/ai-manual.md): arquitetura, hierarquia, todos os comandos, campos, exemplos e fluxos.
- [Manifesto de integração](/ai/manifest.json): pontos de entrada, regras e garantias, em JSON.
- [Esquema de comandos](/ai/command-schema.json): JSON Schema de cada comando, com campos obrigatórios e regras de validação.
- [Diretório de workspaces](/ai/workspaces.json): nomes oficiais, apelidos e projetos. Exige sessão.

## Onde executar

- [Central de comandos](/admin/ai-command-center): cola o lote, valida, mostra a prévia e executa. Exige sessão autenticada.

## Hierarquia

Unidade -> Workspace/Pasta -> Projeto/Card -> Entrega/Subcard -> Tarefas e detalhes.

## Regras

- Ler o manual antes de operar.
- Pesquisar antes de criar.
- Não duplicar objetos.
- Não excluir sem confirmação explícita.
- Preferir arquivamento a exclusão.
- Nunca exibir senhas nos logs.
- Validar o resultado após executar.

## Garantias do sistema

- Nenhum comando do protocolo apaga linha do banco: arquivar é visibilidade e encerrar projeto é status.
- 5 comandos exigem `confirmDestructive: true`, e quem libera é uma pessoa: archive_workspace, create_contract, update_contract, add_access, update_access.
- Toda execução grava a operação inversa e pode ser desfeita.
- Não é possível executar JavaScript arbitrário; só os comandos previstos.
- Nenhuma rota destinada a IA devolve senha, token ou chave.