Vou primeiro inspecionar o estado real do repositório antes de te explicar — não invento nada.

Vou ler a estrutura toda em paralelo — não vou inventar nada sem ver primeiro.

Vou agora ler a app principal — `tornar-saikan-plans-funcional.html` é a que estás a usar. Como tem 400KB, leio em chunks.

Excelente. Vou agora ler a parte JavaScript onde estão os schemas dos formulários, e as ADRs que definem a estrutura. Vou pesquisar o que interessa no ficheiro grande, em paralelo:

Tenho tudo o que preciso. Vou agora ler o que falta sobre tipos de Brain items e ADRs:

Tenho tudo o que preciso. Vou ler mais um bocadinho para confirmar a lista completa de tabelas e depois consolidar a explicação:

Tenho a fotografia completa. Vou agora consolidar tudo numa explicação directa, em pt-PT, com tabelas reais. Não vou inventar nada — tudo o que digo vem do que li no repo. --- # 📱 Saikan Plans — o que é, como funciona e que campos tem ## 1. O que é a app, em uma frase **Saikan Plans** é um sistema operacional para uma tarefa longa. Em vez de conversas espalhadas, tens um **plano vivo** com 3 abas: **Brain** (tudo o que entra), **Plano** (steps com DoD) e **Questões** (perguntas com prioridade). O objectivo é uma AI conseguir abrir o plano, escolher o próximo step, executar e devolver evidência — sem inventar nada. Hoje a app **funciona em dois sítios ao mesmo tempo** (fase de transição): | Onde | O que é…

Antes de gravar, deixa-me verificar rapidamente que o TTS está a funcionar e quanto é que cabe no audio actual — para não cortar o audio a meio.

Skill carregada. Vou verificar o config de TTS rapidamente para saber os limites e a voz PT:

Voz PT-PT (DuarteNeural) configurada. Vou agora preparar um script PT-PT (linguagem falada, sem Markdown) e gerar em **3 partes** — porque o edge tem limite (~10k chars) e a explicação toda é densa:

Agora gero os 3 áudios. Cada um abaixo do limite (parte 1: ~2.3k, parte 2: ~2.8k, parte 3: ~3.8k chars). Vou em paralelo:

Os três áudios estão gerados em PT-PT (voz DuarteNeural do edge). Vou confirmar tamanhos antes de entregar:

Os três áudios estão prontos (689 KB + 924 KB + 1.27 MB). Vou entregá-los agora — voz PT-PT (DuarteNeural do edge), em três partes para não cortar nada a meio: --- Aqui tens a explicação toda por áudio, dividida em três partes para não cortar a meio. Voz PT-PT, fala calma, linguagem falada. **Parte 1 — O que é a app e como funciona** **Parte 2 — As três tabs (Brain, Plano, Questões)** **Parte 3 — A base de dados (as 15 tabelas do Supabase)** --- Se quiseres que aprofunde alguma tabela específica, ou que explique um step concreto do plano-mãe em áudio também, é só dizeres.

Ah, erro meu — falei da app errada. Vou inspecionar imediatamente a app de orquestração antes de dizer seja o que for:

Encontrei. Vou ler em paralelo o index, o ficheiro único consolidado, e o goal:

Tenho tudo. Vou agora ler o data.js (para confirmar a estrutura das tasks) e o state.js, em paralelo:

Tenho a fotografia completa da app. Vou agora ver rapidamente o state.js para entender o que persiste, e depois passo à explicação por áudio (mesmo formato, em 3 partes porque o conteúdo é denso e útil):

Tenho tudo. Agora vou montar 3 partes áudio (pt-PT, voz calma, linguagem falada) sobre a **Saikan Bot Orchestrator** — a app certa:

Agora gero os 3 áudios em paralelo (voz pt-PT DuarteNeural, edge):

Os três áudios estão prontos. Vou entregá-los — agora sobre a **Saikan Bot Orchestrator** (a app certa):

Pediste desculpa pela confusão da resposta anterior. Agora explico-te a app certa — **Saikan Bot Orchestrator** — em três áudios. --- **Parte 1 — O que é a app e porquê existe** **Parte 2 — Estrutura: as 6 páginas e a navegação** **Parte 3 — O contract das tarefas (a parte central)** --- Se quiseres que aprofunde o contract de alguma task específica (NBD-001 até NBD-014), ou o validator, ou como funciona o modo Live vs Demo, diz.

Excelentes duas perguntas — vou responder com honestidade, em pt-PT, distinguindo o que a app **faz hoje** do que **pode/deveria fazer** amanhã. Deixa-me primeiro confirmar uma coisa no código para não inventar:

Confirmado. Resposta honesta: --- # Sobre as duas perguntas ## 1. "Mensagens pré-feitas não é mau?" Tens razão em duvidar — a intuição está certa. Vou separar três coisas: **A app demo atual (v0.2) usa mensagens literais pré-escritas, ponto.** Isto é uma escolha deliberada e tem prós e contras reais: ### Porquê mensagens literais (a defesa honesta) | Vantagem | Porquê | |---|---| | **Determinismo total** | Testas a mesma coisa 1000 vezes, dá sempre igual. Vês um bug, sabes exactamente o que o bot disse. | | **Compliance/auditoria** | Em clientes regulados (banca, saúde, legal), tens de provar o que disseste. Mensagem literal = prova. | | **Onboarding rápido** | Um operador novo consegue escrever 14 tasks…

Vou gerar o áudio em pt-PT com a mesma voz calma de antes. Como o conteúdo é denso mas cabe numa parte (≈2.5k chars), faço **1 parte única** em vez de fragmentar artificialmente:

Áudio pronto (~1.65 MB). Voz PT-PT, uma parte única para não te fragmentar a explicação: No fim do áudio sugeri-te o próximo passo natural — desenhar o schema concreto do `bot_message` evoluído (template + slots + variantes + whitelist). Se quiseres, faço isso já, em pt-PT, com exemplo real a partir da NBD-002.