{"updatedAt":"2026-09-13","blog":[{"slug":"thesis-2-1-adaptive-reasoning","category":"models","asset":"modelGraph","date":"2026-09-10","read":8,"readingMinutes":{"pt":8,"en":8,"es":8,"fr":8},"title":{"pt":"Thesis 2.1: compute adaptativo virou parte da resposta","en":"Thesis 2.1: adaptive compute became part of the answer","es":"Thesis 2.1: el cómputo adaptativo pasó a formar parte de la respuesta","fr":"Thesis 2.1 : le calcul adaptatif fait désormais partie de la réponse"},"lead":{"pt":"A versão 2.1 separa tarefas simples de problemas que realmente exigem prova, auditoria e verificação, sem transformar cada prompt em um ritual de múltiplos agentes.","en":"Version 2.1 separates simple tasks from problems that genuinely require proof, auditing, and verification, without turning every prompt into a multi-agent ritual.","es":"La versión 2.1 separa las tareas simples de los problemas que realmente requieren demostración, auditoría y verificación, sin convertir cada prompt en un ritual multiagente.","fr":"La version 2.1 distingue les tâches simples des problèmes qui exigent réellement preuve, audit et vérification, sans transformer chaque requête en rituel multi-agent."},"blocks":[{"title":{"pt":"O problema não era falta de tokens","en":"The problem was not a lack of tokens","es":"El problema no era la falta de tokens","fr":"Le problème n’était pas le manque de tokens"},"body":[{"pt":"Em testes difíceis, o gargalo aparecia antes da matemática: o roteador podia classificar uma prova extensa como tarefa de instrução ou aplicar esforço baixo justamente quando o prompt pedia auditoria recursiva. Thesis 2.1 muda a unidade de decisão. O sistema estima família, dificuldade, risco de erro e contrato de saída antes de escolher o nível de compute. A meta não é usar mais raciocínio sempre; é impedir que uma tarefa de alto risco receba o mesmo orçamento de uma resposta cotidiana.","en":"In hard tests, the bottleneck appeared before the mathematics: the router could treat a long proof as an instruction task or use low effort precisely when the prompt requested recursive auditing. Thesis 2.1 changes the unit of decision. The system estimates family, difficulty, error risk, and output contract before choosing compute. The goal is not to reason more all the time; it is to prevent high-risk work from receiving the same budget as routine chat.","es":"En pruebas difíciles, el cuello de botella aparecía antes de la matemática: el router podía tratar una demostración larga como una tarea de instrucciones o usar esfuerzo bajo justo cuando el prompt exigía auditoría recursiva. Thesis 2.1 estima familia, dificultad, riesgo y contrato de salida antes de elegir cómputo.","fr":"Dans les tests difficiles, le goulot d’étranglement apparaissait avant les mathématiques : le routeur pouvait traiter une longue preuve comme une tâche d’instructions ou appliquer un faible effort au moment même où le prompt demandait un audit récursif. Thesis 2.1 estime famille, difficulté, risque et contrat de sortie avant d’allouer le calcul."}]},{"title":{"pt":"Uma política de dificuldade, não um botão decorativo","en":"A difficulty policy, not a decorative button","es":"Una política de dificultad, no un botón decorativo","fr":"Une politique de difficulté, pas un bouton décoratif"},"body":[{"pt":"Low continua existindo para respostas determinadas por contexto curto. Medium entra quando há várias restrições ou encadeamento lógico. High passa a ser obrigatório em provas, operator theory, matemática avançada, problemas abertos e solicitações explícitas de xhigh ou ultra. O usuário ainda pode pedir um esforço, mas o runtime não reduz uma tarefa classificada como difícil só porque uma heurística textual escolheu a rota errada.","en":"Low remains appropriate for short-context tasks. Medium enters when several constraints or logical steps interact. High becomes mandatory for proofs, operator theory, advanced mathematics, open problems, and explicit xhigh or ultra requests. User choice still matters, but the runtime no longer downgrades a difficult task because a textual heuristic picked the wrong route.","es":"Low sigue siendo adecuado para tareas simples. Medium entra cuando interactúan varias restricciones. High pasa a ser obligatorio para demostraciones, teoría de operadores, matemática avanzada, problemas abiertos y solicitudes xhigh o ultra.","fr":"Low reste adapté aux tâches simples. Medium intervient lorsque plusieurs contraintes interagissent. High devient obligatoire pour les preuves, la théorie des opérateurs, les mathématiques avancées, les problèmes ouverts et les demandes xhigh ou ultra."}]},{"title":{"pt":"Preflight barato antes do solver caro","en":"A cheap preflight before the expensive solver","es":"Un preflight barato antes del solver caro","fr":"Un preflight peu coûteux avant le solveur coûteux"},"body":[{"pt":"Em instâncias difíceis, o Melos 2 pode atuar primeiro como crítico rápido. Ele não resolve a questão; extrai obrigações de formato, invariantes, pontos de circularidade e falhas que merecem inspeção. Esse mapa é entregue ao GPT-OSS 120B, que continua sendo o solver principal. A separação reduz um tipo comum de desperdício: usar o modelo maior para descobrir, tarde demais, que deixou passar uma condição explícita do prompt.","en":"On hard instances, Melos 2 can act first as a fast critic. It does not solve the problem; it extracts format obligations, invariants, circularity risks, and failure modes worth inspecting. That map is handed to GPT-OSS 120B, which remains the primary solver. This avoids spending the larger model merely to discover too late that it missed an explicit condition.","es":"En instancias difíciles, Melos 2 puede actuar primero como crítico rápido. No resuelve el problema: extrae obligaciones, invariantes, riesgos de circularidad y modos de fallo para el GPT-OSS 120B.","fr":"Sur les instances difficiles, Melos 2 peut d’abord agir comme critique rapide. Il ne résout pas le problème : il extrait obligations, invariants, risques de circularité et modes d’échec pour GPT-OSS 120B."}]},{"title":{"pt":"Verificação só quando compra informação","en":"Verification only when it buys information","es":"Verificación solo cuando compra información","fr":"Vérification seulement lorsqu’elle apporte de l’information"},"body":[{"pt":"O 2.1 não transforma toda resposta em dois passes de 120B. Checks determinísticos vêm primeiro. Quando a tarefa é arriscada e ainda existe incerteza material, um segundo modelo pode auditar a conclusão. O ganho desejado é reduzir erros independentes e violações de contrato, não produzir uma resposta diferente por vaidade. Se o verificador não encontra defeito concreto, a resposta primária permanece.","en":"2.1 does not turn every answer into two 120B passes. Deterministic checks come first. When risk remains material, a second model can audit the conclusion. The objective is to reduce independent errors and contract violations, not to produce a different answer for novelty. If the verifier finds no concrete defect, the primary answer stays.","es":"2.1 no convierte cada respuesta en dos pasadas de 120B. Primero vienen los checks deterministas. Un segundo modelo audita solo cuando el riesgo sigue siendo material.","fr":"2.1 ne transforme pas chaque réponse en deux passages 120B. Les contrôles déterministes viennent d’abord. Un second modèle n’audite que lorsque le risque reste matériel."}]},{"title":{"pt":"O que 2.1 não promete","en":"What 2.1 does not promise","es":"Lo que 2.1 no promete","fr":"Ce que 2.1 ne promet pas"},"body":[{"pt":"Mais compute não transforma um foundation model em oráculo. Thesis 2.1 não promete prova de problemas abertos, zero erro ou superioridade universal. A mudança é operacional: problemas difíceis recebem mais capacidade, saídas passam por contratos verificáveis e afirmações extraordinárias enfrentam guards explícitos. A versão deve ser julgada por regressões e benchmarks, não pelo número 2.1.","en":"More compute does not turn a foundation model into an oracle. Thesis 2.1 does not promise solutions to open problems, zero error, or universal superiority. The change is operational: difficult problems receive more capacity, outputs face verifiable contracts, and extraordinary claims face explicit guards. The version should be judged by regressions and benchmarks, not by the 2.1 label.","es":"Más cómputo no convierte un modelo base en un oráculo. Thesis 2.1 no promete resolver problemas abiertos ni error cero. Debe juzgarse por regresiones y benchmarks, no por la etiqueta 2.1.","fr":"Davantage de calcul ne transforme pas un modèle de base en oracle. Thesis 2.1 ne promet ni résolution des problèmes ouverts ni erreur zéro. Il doit être jugé par les régressions et les benchmarks, pas par l’étiquette 2.1."}]}]},{"slug":"thesis-2-1-math-first-routing","category":"engineering","asset":"modelPaper","date":"2026-09-10","read":7,"readingMinutes":{"pt":7,"en":7,"es":7,"fr":7},"title":{"pt":"Math-first: por que Thesis 2.1 mudou a ordem do roteamento","en":"Math-first: why Thesis 2.1 changed routing order","es":"Math-first: por qué Thesis 2.1 cambió el orden del enrutamiento","fr":"Math-first : pourquoi Thesis 2.1 a changé l’ordre de routage"},"lead":{"pt":"Quando uma prova tem muitas regras de formato, o formato não pode roubar a tarefa da matemática. O 2.1 dá prioridade ao conteúdo e valida a apresentação depois.","en":"When a proof contains many format rules, formatting must not steal the task from mathematics. 2.1 prioritizes the substance and validates presentation afterward.","es":"Cuando una demostración contiene muchas reglas de formato, el formato no puede robarle la tarea a la matemática. 2.1 prioriza el contenido y valida la presentación después.","fr":"Lorsqu’une preuve contient de nombreuses contraintes de forme, la forme ne doit pas voler la tâche aux mathématiques. 2.1 priorise le fond puis valide la présentation."},"blocks":[{"title":{"pt":"A falha de precedência","en":"The precedence failure","es":"El fallo de precedencia","fr":"L’échec de priorité"},"body":[{"pt":"Um prompt matemático sério costuma conter dezenas de comandos: prove, audite, use três fases, preserve uma notação, pare sob uma condição, não consulte a web. Um classificador ingênuo vê muitos verbos imperativos e conclui “instruction following”. Isso é tecnicamente coerente e operacionalmente errado. A tarefa central continua sendo matemática. Thesis 2.1 identifica primeiro o domínio decisivo; o contrato de forma vira uma camada posterior.","en":"A serious math prompt often contains many commands: prove, audit, use three phases, preserve notation, stop under a condition, do not browse. A naive classifier sees many imperatives and labels it instruction following. That is technically coherent and operationally wrong. The central task is still mathematics. Thesis 2.1 identifies the decisive domain first; format becomes a later contract layer.","es":"Un prompt matemático serio contiene muchos imperativos. Un clasificador ingenuo puede etiquetarlo como instruction following aunque la tarea central siga siendo matemática. Thesis 2.1 identifica primero el dominio decisivo.","fr":"Une requête mathématique sérieuse contient de nombreux impératifs. Un classifieur naïf peut la ranger dans le suivi d’instructions alors que la tâche centrale reste mathématique. Thesis 2.1 identifie d’abord le domaine décisif."}]},{"title":{"pt":"Conteúdo primeiro, contrato depois","en":"Substance first, contract second","es":"Contenido primero, contrato después","fr":"Le fond d’abord, le contrat ensuite"},"body":[{"pt":"O router agora trata prova, álgebra linear, combinatória, teoria dos números, probabilidade, cálculo, corpos finitos e operator theory como famílias de reasoning com prioridade própria. Depois da geração, um guard verifica marcadores obrigatórios, JSON-only, contagem de palavras, fases e regras de loop. Assim, cumprir o formato não exige trocar o solver matemático por um caminho de texto genérico.","en":"The router now treats proof, linear algebra, combinatorics, number theory, probability, calculus, finite fields, and operator theory as reasoning families with their own precedence. After generation, a guard checks required markers, JSON-only output, word counts, phases, and loop rules. Formatting therefore does not require replacing the mathematical solver with a generic text path.","es":"El router trata demostración, álgebra lineal, combinatoria, teoría de números, probabilidad, cálculo, cuerpos finitos y teoría de operadores como familias de razonamiento. Después, un guard valida el contrato.","fr":"Le routeur traite preuve, algèbre linéaire, combinatoire, théorie des nombres, probabilité, calcul, corps finis et théorie des opérateurs comme familles de raisonnement. Un guard valide ensuite le contrat."}]},{"title":{"pt":"Famílias diferentes, verificações diferentes","en":"Different families, different checks","es":"Familias diferentes, verificaciones diferentes","fr":"Familles différentes, contrôles différents"},"body":[{"pt":"Combinatória pede controle contra dupla contagem. Teoria dos números pede resíduos reversos e hipóteses de coprimalidade. Operator theory pede domínio, closability, diferença entre simétrico e autoadjunto, classes de Schatten, espectro essencial e topologia de convergência. O 2.1 mantém lenses específicos para impedir que uma auditoria matemática vire apenas “releia a resposta e veja se parece correta”.","en":"Combinatorics needs protection against double counting. Number theory needs reverse residues and coprimality checks. Operator theory needs domains, closability, symmetry versus self-adjointness, Schatten classes, essential spectrum, and convergence topology. 2.1 uses family-specific lenses so mathematical auditing does not collapse into “read it again and see if it looks right.”","es":"Combinatoria exige control de doble conteo; teoría de números, residuos y coprimalidad; teoría de operadores, dominios, autoadjunción, clases de Schatten y espectro esencial.","fr":"La combinatoire exige un contrôle du double comptage ; la théorie des nombres, des résidus et de la coprimalité ; la théorie des opérateurs, domaines, auto-adjonction, classes de Schatten et spectre essentiel."}]},{"title":{"pt":"Corpos finitos continuam com pipeline especializado","en":"Finite fields keep a specialized pipeline","es":"Los cuerpos finitos conservan un pipeline especializado","fr":"Les corps finis conservent un pipeline spécialisé"},"body":[{"pt":"Problemas de F₂, decomposição por fatores irredutíveis, semissimplicidade, centralizadores e classes de conjugação já possuíam um caminho especializado. Thesis 2.1 não joga esse trabalho fora. O novo kernel reconhece esses casos e delega ao pipeline matemático existente com esforço alto, preservando solvers determinísticos e verificações que já provaram valor.","en":"Problems over F₂, irreducible-factor decompositions, semisimplicity, centralizers, and conjugacy classes already had a specialized path. Thesis 2.1 keeps it. The new kernel recognizes those cases and delegates to the existing mathematical pipeline at high effort, preserving deterministic solvers and proven checks.","es":"Los problemas sobre F₂ y clases de conjugación conservan el pipeline especializado existente, ahora llamado con esfuerzo alto.","fr":"Les problèmes sur F₂ et les classes de conjugaison conservent le pipeline spécialisé existant, désormais appelé avec un effort élevé."}]},{"title":{"pt":"O ganho real é menos desvio silencioso","en":"The real gain is less silent drift","es":"La ganancia real es menos desvío silencioso","fr":"Le gain réel est moins de dérive silencieuse"},"body":[{"pt":"Esse desenho não aumenta a inteligência do foundation model por decreto. Ele reduz uma classe concreta de erro sistêmico: mandar o modelo certo para o problema errado. Em benchmarks de reasoning, um roteamento imperfeito pode apagar qualquer benefício de um modelo maior. Math-first transforma esse risco em uma decisão explícita e observável.","en":"This design does not increase foundation-model intelligence by decree. It reduces a concrete systems error: sending the right model down the wrong path. In reasoning benchmarks, bad routing can erase the benefit of a larger model. Math-first turns that risk into an explicit, observable decision.","es":"El diseño no vuelve más inteligente al foundation model por decreto. Reduce un error sistémico concreto: enviar el modelo correcto por la ruta equivocada.","fr":"Cette architecture ne rend pas le foundation model plus intelligent par décret. Elle réduit une erreur système concrète : envoyer le bon modèle dans le mauvais chemin."}]}]},{"slug":"thesis-2-1-cross-model-verification","category":"engineering","asset":"barChart","date":"2026-09-10","read":7,"readingMinutes":{"pt":7,"en":7,"es":7,"fr":7},"title":{"pt":"Thesis 2.1: 120B resolve, 20B audita","en":"Thesis 2.1: 120B solves, 20B audits","es":"Thesis 2.1: 120B resuelve, 20B audita","fr":"Thesis 2.1 : 120B résout, 20B audite"},"lead":{"pt":"A verificação cruzada usa modelos com perfis diferentes e orçamentos separados para procurar defeitos, sem duplicar o custo do solver principal em toda mensagem.","en":"Cross-model verification uses different model profiles and separate budgets to search for defects without duplicating the primary solver cost on every message.","es":"La verificación cruzada usa modelos con perfiles distintos y presupuestos separados para buscar defectos sin duplicar el coste del solver principal.","fr":"La vérification croisée utilise des profils de modèles différents et des budgets séparés pour chercher des défauts sans doubler le coût du solveur principal."},"blocks":[{"title":{"pt":"Independência útil, não consenso teatral","en":"Useful independence, not theatrical consensus","es":"Independencia útil, no consenso teatral","fr":"Une indépendance utile, pas un consensus théâtral"},"body":[{"pt":"Pedir ao mesmo modelo para “revisar a própria resposta” pode detectar erros, mas também reproduz os mesmos atalhos. No 2.1, GPT-OSS 120B continua responsável pela solução e GPT-OSS 20B pode atuar como auditor independente. O verificador recebe a tarefa e a resposta como material não confiável, tenta resolver o passo decisivo por conta própria e procura contraexemplos, hipóteses escondidas e violações de contrato.","en":"Asking the same model to review itself can catch mistakes but can also repeat the same shortcuts. In 2.1, GPT-OSS 120B owns the solution while GPT-OSS 20B can act as an independent auditor. The verifier treats both task and answer as untrusted material, recomputes the decisive step, and looks for counterexamples, hidden assumptions, and contract violations.","es":"Pedir al mismo modelo que se revise puede repetir los mismos atajos. En 2.1, el 120B resuelve y el 20B puede auditar de forma independiente.","fr":"Demander au même modèle de se relire peut reproduire les mêmes raccourcis. Dans 2.1, le 120B résout et le 20B peut auditer de manière indépendante."}]},{"title":{"pt":"Quotas por modelo viram recurso de arquitetura","en":"Per-model quotas become an architectural resource","es":"Las cuotas por modelo se convierten en recurso arquitectónico","fr":"Les quotas par modèle deviennent une ressource d’architecture"},"body":[{"pt":"O governor acompanha orçamento por modelo. Isso permite gastar compute do 20B para verificação sem fingir que cada token do auditor pertence ao teto do 120B. A consequência prática é simples: o sistema pode obter uma segunda perspectiva quando ela vale a pena sem reduzir desnecessariamente a resposta principal.","en":"The governor tracks budget per model. That means 20B verification compute can be spent without pretending every auditor token belongs to the 120B ceiling. Practically, the system can obtain a second perspective when useful without unnecessarily shrinking the primary answer.","es":"El governor controla el presupuesto por modelo, permitiendo usar cómputo del 20B para verificación sin reducir innecesariamente la respuesta del 120B.","fr":"Le governor suit le budget par modèle, ce qui permet d’utiliser le 20B pour la vérification sans réduire inutilement la réponse du 120B."}]},{"title":{"pt":"O auditor não ganha direito de reescrever tudo","en":"The auditor does not get permission to rewrite everything","es":"El auditor no obtiene permiso para reescribirlo todo","fr":"L’auditeur n’obtient pas le droit de tout réécrire"},"body":[{"pt":"Um verificador probabilístico também erra. Por isso a arquitetura não aceita qualquer discordância como correção. O council distingue defeito menor de defeito material e exige confiança alta antes de substituir a conclusão. Se não houver falha concreta, mantém-se o resultado do solver. Essa assimetria evita que a verificação introduza regressões por preferência estilística.","en":"A probabilistic verifier can also be wrong. The architecture therefore does not treat every disagreement as a correction. The council separates minor issues from material defects and requires high confidence before replacing the conclusion. Without a concrete failure, the solver result remains.","es":"Un verificador probabilístico también puede equivocarse. El council separa defectos menores de fallos materiales y exige alta confianza antes de sustituir la respuesta.","fr":"Un vérificateur probabiliste peut lui aussi se tromper. Le council sépare les défauts mineurs des erreurs matérielles et exige une forte confiance avant de remplacer la réponse."}]},{"title":{"pt":"Determinístico antes do LLM","en":"Deterministic checks before an LLM","es":"Determinista antes del LLM","fr":"Le déterministe avant le LLM"},"body":[{"pt":"Contagem exata de palavras, JSON válido, presença de fases, marcadores de loop e testes de código não precisam de julgamento semântico. Esses checks vêm antes. O auditor é reservado para propriedades que exigem interpretação: uma implicação circular, uma hipótese esquecida, um argumento espectral mal definido ou uma conclusão mais forte que as premissas.","en":"Exact word counts, valid JSON, required phases, loop markers, and code tests do not need semantic judgment. Those checks come first. The auditor is reserved for properties that require interpretation: circular implications, missing assumptions, ill-defined spectral arguments, or conclusions stronger than their premises.","es":"Conteo de palabras, JSON válido, fases y marcadores de loop se validan de forma determinista. El auditor queda para errores que requieren interpretación.","fr":"Le comptage de mots, le JSON valide, les phases et les marqueurs de boucle sont contrôlés de façon déterministe. L’auditeur reste réservé aux erreurs exigeant une interprétation."}]},{"title":{"pt":"Verificação é evidência, não certificado de verdade","en":"Verification is evidence, not a truth certificate","es":"La verificación es evidencia, no un certificado de verdad","fr":"La vérification est une preuve supplémentaire, pas un certificat de vérité"},"body":[{"pt":"Quando dois modelos concordam, a confiança operacional pode aumentar, mas a resposta não se torna matematicamente provada por votação. Thesis 2.1 registra verificação como uma classe de evidência e continua distinguindo resultado derivado, teste executado, fonte recuperada e julgamento de modelo. Essa separação é parte do produto porque evita que telemetria pareça mais forte do que realmente é.","en":"When two models agree, operational confidence may increase, but the answer does not become mathematically proven by vote. Thesis 2.1 records verification as one evidence class and keeps derived results, executed tests, retrieved sources, and model judgments distinct.","es":"El acuerdo entre dos modelos puede aumentar la confianza operativa, pero no convierte una respuesta en una demostración por votación.","fr":"L’accord de deux modèles peut augmenter la confiance opérationnelle, mais ne transforme pas une réponse en preuve par vote."}]}]},{"slug":"thesis-2-1-open-problem-guard","category":"research","asset":"theory","date":"2026-09-10","read":8,"readingMinutes":{"pt":8,"en":8,"es":8,"fr":8},"title":{"pt":"Riemann como teste de produto: o Open Problem Guard do Thesis 2.1","en":"Riemann as a product test: Thesis 2.1 Open Problem Guard","es":"Riemann como prueba de producto: el Open Problem Guard de Thesis 2.1","fr":"Riemann comme test produit : l’Open Problem Guard de Thesis 2.1"},"lead":{"pt":"Problemas abertos são excelentes testes de honestidade: o sistema precisa explorar ideias sem converter uma ponte conjectural em “prova” só porque a escrita ficou convincente.","en":"Open problems are excellent honesty tests: the system must explore ideas without turning a conjectural bridge into a “proof” merely because the prose became convincing.","es":"Los problemas abiertos son excelentes pruebas de honestidad: el sistema debe explorar ideas sin convertir un puente conjetural en “prueba” solo porque el texto resulte convincente.","fr":"Les problèmes ouverts sont d’excellents tests d’honnêteté : le système doit explorer des idées sans transformer une passerelle conjecturale en « preuve » parce que le texte paraît convaincant."},"blocks":[{"title":{"pt":"Por que RH expõe falhas de reasoning","en":"Why RH exposes reasoning failures","es":"Por qué RH expone fallos de razonamiento","fr":"Pourquoi RH révèle les failles de raisonnement"},"body":[{"pt":"A Hipótese de Riemann concentra quase todos os riscos que um agente avançado precisa administrar: objetos analíticos delicados, construções espectrais formais, limites de operadores, equivalências não provadas e enorme incentivo para confundir uma ideia elegante com um teorema. Um sistema que responde bem a perguntas triviais ainda pode falhar de forma espetacular aqui. Por isso RH entrou no 2.1 como caso de regressão e não como promessa de descoberta.","en":"The Riemann Hypothesis concentrates many risks an advanced agent must manage: delicate analytic objects, formal spectral constructions, operator limits, unproved equivalences, and strong incentives to confuse an elegant idea with a theorem. A system that performs well on routine tasks can still fail spectacularly here. RH is therefore a regression case in 2.1, not a promise of discovery.","es":"La Hipótesis de Riemann concentra objetos analíticos delicados, construcciones espectrales formales, límites de operadores y equivalencias no demostradas. Por eso entra como caso de regresión, no como promesa de descubrimiento.","fr":"L’hypothèse de Riemann concentre objets analytiques délicats, constructions spectrales formelles, limites d’opérateurs et équivalences non prouvées. Elle sert donc de cas de régression, pas de promesse de découverte."}]},{"title":{"pt":"A regra: não assuma a ponte que precisa provar","en":"The rule: do not assume the bridge you need to prove","es":"La regla: no asumas el puente que debes demostrar","fr":"La règle : ne supposez pas le pont qu’il faut démontrer"},"body":[{"pt":"Se um operador é definido a partir dos zeros e depois sua autoadjunção é usada para concluir que os zeros estão na reta crítica, o argumento pode conter a própria conjectura na construção. Se Kε é compacto para ε>0, isso não dá automaticamente convergência espectral bijetiva quando ε→0. Se uma perturbação é compacta, o teorema de Weyl não permite apagar livremente um espectro essencial preexistente. O Open Problem Guard força o solver a identificar esse tipo de ponte antes de declarar êxito.","en":"If an operator is defined from the zeros and self-adjointness is then used to conclude the zeros lie on the critical line, the construction may hide the conjecture itself. If Kε is compact for ε>0, that does not automatically yield bijective spectral convergence as ε→0. If a perturbation is compact, Weyl’s theorem does not let it freely erase pre-existing essential spectrum. The Open Problem Guard forces the solver to identify these bridges before declaring success.","es":"Si un operador se define a partir de los ceros y luego se usa su autoadjunción para probar dónde están esos ceros, la construcción puede ocultar la propia conjetura. El guard obliga a identificar ese tipo de circularidad.","fr":"Si un opérateur est défini à partir des zéros puis son auto-adjonction sert à conclure où se trouvent ces zéros, la construction peut cacher la conjecture elle-même. Le guard force l’identification de ce type de circularité."}]},{"title":{"pt":"Falhar corretamente também é capacidade","en":"Failing correctly is also capability","es":"Fallar correctamente también es capacidad","fr":"Échouer correctement est aussi une capacité"},"body":[{"pt":"Em problemas abertos, a melhor resposta muitas vezes é um mapa rigoroso do ponto em que o argumento quebra. Thesis 2.1 trata isso como resultado legítimo. Se o domínio autoadjunto não foi construído, a topologia de convergência não foi especificada ou o determinante usado exige trace class que não foi provada, o sistema deve expor a obstrução. Preencher a lacuna com linguagem plausível é uma regressão.","en":"For open problems, the best answer is often a rigorous map of where the argument breaks. Thesis 2.1 treats that as a legitimate result. If a self-adjoint domain is missing, a convergence topology is unspecified, or a determinant requires trace class that has not been established, the system should expose the obstruction. Filling the gap with plausible prose is a regression.","es":"En problemas abiertos, una buena respuesta puede ser un mapa riguroso del punto donde falla el argumento. Rellenar la laguna con prosa plausible es una regresión.","fr":"Pour les problèmes ouverts, une bonne réponse peut être une cartographie rigoureuse du point de rupture. Combler le vide par une prose plausible est une régression."}]},{"title":{"pt":"Loops do prompt agora viram contrato verificável","en":"Prompt loops become a verifiable contract","es":"Los loops del prompt se convierten en contrato verificable","fr":"Les boucles du prompt deviennent un contrat vérifiable"},"body":[{"pt":"Um teste recente exigia iniciar outra iteração sempre que a confiança ficasse abaixo de 9/10. A resposta avaliou a própria construção em 3/10 e mesmo assim encerrou. O 2.1 transforma esse padrão em check: se existe nota abaixo do limiar, o output precisa conter o marcador de falha e uma iteração subsequente quando o prompt assim exige. É um detalhe de instruction following, mas em reasoning longo esse detalhe decide se o processo continua ou abandona a busca cedo demais.","en":"A recent test required another iteration whenever confidence fell below 9/10. The answer scored its own construction 3/10 and still stopped. 2.1 turns that pattern into a check: if a score falls below the threshold, the output must contain the failure marker and a subsequent iteration when the prompt requires it. It looks like instruction following, but in long reasoning it determines whether the search continues or stops too early.","es":"Una prueba exigía otra iteración por debajo de 9/10. La respuesta se dio 3/10 y terminó. 2.1 convierte esa regla en un check verificable.","fr":"Un test exigeait une nouvelle itération sous 9/10. La réponse s’est notée 3/10 puis s’est arrêtée. 2.1 transforme cette règle en contrôle vérifiable."}]},{"title":{"pt":"Exploração continua permitida","en":"Exploration remains allowed","es":"La exploración sigue permitida","fr":"L’exploration reste permise"},"body":[{"pt":"O guard não foi criado para transformar o modelo em um compilador que só repete resultados conhecidos. Ele pode propor operadores, conexões com física matemática, novos critérios condicionais e caminhos especulativos. A exigência é rotular corretamente o status lógico de cada ponte e separar conjectura, heurística e consequência demonstrada. Isso preserva criatividade sem vender imaginação como resolução.","en":"The guard is not meant to turn the model into a compiler that only repeats known results. It can propose operators, links to mathematical physics, conditional criteria, and speculative paths. The requirement is to label the logical status of each bridge and separate conjecture, heuristic, and demonstrated consequence. This preserves creativity without selling imagination as resolution.","es":"El guard no impide explorar. Exige separar con claridad conjetura, heurística y consecuencia demostrada.","fr":"Le guard n’interdit pas l’exploration. Il exige de séparer clairement conjecture, heuristique et conséquence démontrée."}]}]},{"slug":"melos-2-fast-math-reasoning","category":"models","asset":"modelGraph","date":"2026-09-10","read":6,"readingMinutes":{"pt":6,"en":6,"es":6,"fr":6},"title":{"pt":"Melos 2: reasoning rápido sem fingir que tudo é fácil","en":"Melos 2: fast reasoning without pretending everything is easy","es":"Melos 2: razonamiento rápido sin fingir que todo es fácil","fr":"Melos 2 : raisonnement rapide sans prétendre que tout est facile"},"lead":{"pt":"O modelo rápido mantém single-pass na maior parte do uso, mas agora sobe o esforço de forma agressiva em matemática e lógica difícil, em vez de economizar justamente onde o erro custa mais.","en":"The fast model remains single-pass for most work, but now raises reasoning effort aggressively on hard math and logic instead of saving compute where errors cost the most.","es":"El modelo rápido sigue siendo single-pass en la mayoría de los casos, pero ahora aumenta el esfuerzo en matemática y lógica difíciles.","fr":"Le modèle rapide reste single-pass dans la majorité des cas, mais augmente désormais fortement l’effort sur les mathématiques et la logique difficiles."},"blocks":[{"title":{"pt":"Velocidade continua sendo o contrato","en":"Speed remains the contract","es":"La velocidad sigue siendo el contrato","fr":"La vitesse reste le contrat"},"body":[{"pt":"Melos 2 continua baseado no GPT-OSS 20B e não herda a arquitetura completa de múltiplos estágios do Thesis 2.1. O caminho padrão permanece curto: classificar, escolher esforço, gerar e validar o contrato. Isso preserva a característica que torna o Melos útil em chat cotidiano, coding rápido e tarefas que não justificam uma auditoria externa.","en":"Melos 2 remains based on GPT-OSS 20B and does not inherit the full multi-stage architecture of Thesis 2.1. The default path stays short: classify, choose effort, generate, validate the contract. That preserves its value for everyday chat, fast coding, and tasks that do not justify an external audit.","es":"Melos 2 sigue basado en GPT-OSS 20B y mantiene un camino corto: clasificar, elegir esfuerzo, generar y validar contrato.","fr":"Melos 2 reste fondé sur GPT-OSS 20B et conserve un chemin court : classifier, choisir l’effort, générer et valider le contrat."}]},{"title":{"pt":"High agora significa high","en":"High now means high","es":"High ahora significa high","fr":"High signifie désormais high"},"body":[{"pt":"Antes, heurísticas de velocidade podiam manter problemas matemáticos difíceis em low ou medium. A política nova leva em conta tamanho, densidade de restrições, linguagem de prova e sinais de problema aberto. Quando o risco sobe, Melos pode usar high reasoning e um orçamento de saída maior, ainda dentro de um único passe.","en":"Previously, speed heuristics could keep hard math problems in low or medium. The new policy considers length, constraint density, proof language, and open-problem signals. As risk rises, Melos can use high reasoning and a larger output budget while remaining single-pass.","es":"Antes, heurísticas de velocidad podían dejar matemática difícil en low o medium. La nueva política puede subir a high sin abandonar el single-pass.","fr":"Auparavant, des heuristiques de vitesse pouvaient laisser des problèmes difficiles en low ou medium. La nouvelle politique peut monter en high sans quitter le single-pass."}]},{"title":{"pt":"Math e logic recebem disciplinas próprias","en":"Math and logic get their own disciplines","es":"Math y lógica reciben disciplinas propias","fr":"Maths et logique reçoivent leurs propres disciplines"},"body":[{"pt":"Para matemática, o contrato exige codificar restrições, checar o passo decisivo e substituir o resultado de volta quando possível. Para lógica espacial e theory of mind, o modelo mantém estados separados para evitar vazamento de conhecimento. Para code trace, registra mutações e ordem de avaliação. São instruções pequenas, específicas e baratas, não uma persona universal gigantesca.","en":"For mathematics, the contract requires encoding constraints, checking the decisive step, and substituting results back when possible. For spatial logic and theory of mind, the model keeps separate states to avoid knowledge leakage. For code tracing, it tracks mutation and evaluation order. These are small, specific disciplines rather than one giant universal persona.","es":"Para matemática se codifican restricciones y se verifica el paso decisivo; para lógica espacial y teoría de la mente se mantienen estados separados; para code trace se sigue mutación y orden de evaluación.","fr":"Pour les maths, les contraintes sont encodées et l’étape décisive vérifiée ; pour la logique spatiale et la théorie de l’esprit, les états restent séparés ; pour le code trace, mutation et ordre d’évaluation sont suivis."}]},{"title":{"pt":"Guard de contrato sem segunda geração automática","en":"A contract guard without automatic second generation","es":"Guard de contrato sin segunda generación automática","fr":"Un guard de contrat sans seconde génération automatique"},"body":[{"pt":"Melos verifica JSON-only, inteiro-only e outras estruturas objetivas. Uma segunda chamada só é aberta quando existe uma violação observável que realmente precisa de reparo. Essa política reduz latência de cauda e evita o paradoxo de um “modelo rápido” que passa metade do tempo avaliando a si mesmo.","en":"Melos checks JSON-only, integer-only, and other objective structures. A second call is opened only when there is an observable violation that genuinely needs repair. This keeps tail latency down and avoids the paradox of a “fast model” spending half its time evaluating itself.","es":"Melos valida estructuras objetivas y solo abre una segunda llamada cuando existe una violación observable que requiere reparación.","fr":"Melos valide les structures objectives et n’ouvre un second appel que lorsqu’une violation observable nécessite réellement une réparation."}]},{"title":{"pt":"Quando usar Melos e quando usar Thesis 2.1","en":"When to use Melos and when to use Thesis 2.1","es":"Cuándo usar Melos y cuándo Thesis 2.1","fr":"Quand utiliser Melos ou Thesis 2.1"},"body":[{"pt":"Melos é a escolha natural quando tempo de resposta importa e a tarefa cabe em uma trajetória forte. Thesis 2.1 entra quando o custo de uma falha justifica preflight, reasoning mais profundo, verificação cruzada ou guards de problemas abertos. Os dois modelos compartilham princípios de honestidade e contrato, mas não fingem ter a mesma curva de latência.","en":"Melos is the natural choice when response time matters and the task fits a single strong trajectory. Thesis 2.1 enters when the cost of failure justifies preflight, deeper reasoning, cross-model verification, or open-problem guards. They share integrity principles but do not pretend to have the same latency curve.","es":"Melos es la opción natural cuando importa la latencia; Thesis 2.1 cuando el coste del error justifica preflight, reasoning profundo y verificación.","fr":"Melos est le choix naturel lorsque la latence compte ; Thesis 2.1 lorsque le coût d’une erreur justifie preflight, raisonnement approfondi et vérification."}]}]},{"slug":"evidence-led-ai-decisions","category":"research","asset":"modelPaper","date":"2026-09-07","title":{"pt":"Da resposta à decisão: um protocolo de evidências","en":"From answer to decision: an evidence protocol","es":"De la respuesta a la decisión: un protocolo de evidencia","fr":"De la réponse à la décision : un protocole de preuves"},"lead":{"pt":"Aprenda a transformar uma resposta plausível em uma conclusão auditável, com hipóteses, fontes, limites e um critério explícito de aceitação.","en":"Turn a plausible answer into an auditable conclusion with assumptions, sources, limits and explicit acceptance criteria.","es":"Convierte una respuesta plausible en una conclusión auditable con supuestos, fuentes, límites y criterios de aceptación.","fr":"Transformez une réponse plausible en conclusion vérifiable grâce aux hypothèses, sources, limites et critères d’acceptation."},"blocks":[{"title":{"pt":"Defina o que mudaria sua decisão","en":"Define what would change your decision","es":"Define qué cambiaría tu decisión","fr":"Définissez ce qui changerait votre décision"},"body":[{"pt":"Antes de pedir uma comparação, escreva a decisão concreta e os critérios que podem alterá-la. Para escolher uma ferramenta de trabalho, por exemplo, disponibilidade na sua região, exportação dos dados e compatibilidade com seu fluxo podem valer mais que a quantidade de recursos. Defina quais requisitos são obrigatórios, quais são preferências e qual informação ainda falta. Uma resposta útil deve mostrar o que sabe, o que pressupõe e o que precisa confirmar. Sem esse registro, uma tabela extensa pode apenas esconder uma escolha arbitrária.","en":"Write down the actual decision and the criteria that could change it. For a work tool, regional availability, data export and workflow compatibility may matter more than feature count. Separate mandatory requirements from preferences and unknowns. An answer should expose what is known, assumed and still unverified; a large table cannot substitute for that distinction.","es":"Escribe la decisión concreta y los criterios que podrían cambiarla. Para una herramienta de trabajo, disponibilidad regional, exportación de datos y compatibilidad pueden importar más que el número de funciones. Separa requisitos obligatorios, preferencias e incógnitas. La respuesta debe distinguir conocimiento, supuestos y hechos pendientes de verificar. Una tabla extensa no sustituye esa distinción.","fr":"Écrivez la décision concrète et les critères susceptibles de la modifier. Pour un outil professionnel, disponibilité régionale, export des données et compatibilité peuvent compter davantage que le nombre de fonctions. Séparez exigences, préférences et inconnues. La réponse doit distinguer faits établis, hypothèses et vérifications manquantes. Un grand tableau ne remplace pas cette distinction."}]},{"title":{"pt":"Vincule cada afirmação decisiva à fonte","en":"Link decisive claims to their sources","es":"Vincula afirmaciones decisivas con sus fuentes","fr":"Reliez chaque affirmation décisive à sa source"},"body":[{"pt":"Registre a afirmação, o endereço da fonte, a data de consulta, a versão do produto e o trecho que sustenta a conclusão. Uma fonte primária descreve diretamente o objeto: documentação do fabricante, publicação da pesquisa, registro oficial ou dados originais. Uma fonte secundária pode contextualizar ou apontar problemas, mas não deve receber autoridade que não possui. Abrir um link não prova que ele sustenta a afirmação. Confira também o escopo: uma funcionalidade disponível em um plano não implica que exista em todos. Quando duas fontes discordarem, mantenha o conflito visível até localizar a diferença de data, versão ou condições.","en":"Record the claim, source address, access date, product version and supporting passage. Primary sources include vendor documentation, original research and official records. Secondary sources can provide context without inheriting authority they do not have. Opening a link does not prove that it supports the claim. Check scope: a feature in one plan may be absent from another. Keep conflicting evidence visible until differences in date, version or conditions explain it.","es":"Registra afirmación, enlace, fecha de consulta, versión y pasaje de apoyo. Las fuentes primarias incluyen documentación del fabricante, investigación original y registros oficiales. Las secundarias aportan contexto sin heredar una autoridad inexistente. Abrir un enlace no demuestra que respalde la afirmación. Comprueba el alcance: una función de un plan puede faltar en otro. Mantén visibles las discrepancias hasta explicar diferencias de fecha, versión o condiciones.","fr":"Consignez affirmation, lien, date de consultation, version et passage justificatif. Les sources primaires comprennent documentation du producteur, recherche originale et registres officiels. Les sources secondaires apportent du contexte sans acquérir une autorité inexistante. Ouvrir un lien ne prouve pas qu’il soutient l’affirmation. Vérifiez le périmètre : une fonction peut dépendre de l’offre. Gardez les contradictions visibles jusqu’à expliquer les différences de date, version ou conditions."}]},{"title":{"pt":"Faça uma verificação independente","en":"Perform an independent check","es":"Realiza una comprobación independiente","fr":"Effectuez une vérification indépendante"},"body":[{"pt":"Escolha a afirmação com maior efeito sobre a decisão e tente refutá-la. Em uma conta, recalcule com outro método e confira as unidades. Se três pessoas trabalham quatro horas por dia durante cinco dias, o resultado é 3 × 4 × 5 = 60 horas-pessoa; não são 60 dias nem 60 horas de duração do calendário. Em uma recomendação técnica, execute um exemplo pequeno com resultado conhecido. Pedir a um segundo modelo que concorde não equivale a um teste: os dois podem reproduzir o mesmo erro. Registre o procedimento e o resultado observado, inclusive quando a verificação falha.","en":"Try to disprove the claim with the largest effect on the decision. Recalculate quantities independently and inspect units: three people working four hours for five days contribute 60 person-hours, not 60 calendar hours. For technical recommendations, run a small example with a known result. Agreement from a second model is not an executed test; both can repeat the same error. Record the procedure and observed result, including failures.","es":"Intenta refutar la afirmación que más influye en la decisión. Recalcula y revisa unidades: tres personas trabajando cuatro horas durante cinco días aportan 60 horas-persona, no 60 horas de calendario. En recomendaciones técnicas, ejecuta un caso pequeño con resultado conocido. El acuerdo de otro modelo no equivale a una prueba ejecutada: ambos pueden repetir el error. Registra procedimiento y resultado, incluidos los fallos.","fr":"Essayez de réfuter l’affirmation la plus influente. Recalculez et contrôlez les unités : trois personnes travaillant quatre heures pendant cinq jours représentent 60 heures-personnes, pas 60 heures calendaires. Pour une recommandation technique, exécutez un petit cas au résultat connu. L’accord d’un second modèle ne constitue pas un test exécuté : les deux peuvent reproduire l’erreur. Consignez procédure et résultat, échecs compris."}]},{"title":{"pt":"Encerre com condições, não com certeza artificial","en":"Close with conditions, not artificial certainty","es":"Concluye con condiciones y límites","fr":"Concluez avec des conditions explicites"},"body":[{"pt":"Uma conclusão responsável pode ser condicional: “Esta opção atende aos requisitos confirmados; falta verificar a exportação antes da adoção”. Liste as pendências que realmente podem mudar a escolha, a pessoa responsável pela checagem e o momento de rever a decisão. Evite porcentagens de confiança sem método definido. O resultado final deve permitir que outra pessoa repita a verificação sem reconstruir toda a conversa. Critério de aceitação: requisitos obrigatórios atendidos, afirmações decisivas sustentadas, contas reproduzidas e nenhuma pendência crítica escondida. Essa disciplina reduz o retrabalho porque separa uma decisão pronta de uma investigação ainda em andamento.","en":"A responsible conclusion can be conditional: this option meets confirmed requirements, but export remains untested. Name the unresolved issues that could change the choice, the verification owner and a review date. Avoid confidence percentages without a defined method. Acceptance requires mandatory criteria, supported decisive claims, reproducible calculations and visible critical gaps. Another person should be able to repeat the checks without reconstructing the conversation.","es":"Una conclusión responsable puede ser condicional: la opción cumple los requisitos confirmados, pero falta probar la exportación. Indica pendientes que podrían cambiar la elección, responsable y fecha de revisión. Evita porcentajes de confianza sin método. La aceptación exige requisitos cumplidos, afirmaciones sustentadas, cálculos reproducibles y lagunas críticas visibles. Otra persona debe poder repetir las comprobaciones sin reconstruir la conversación.","fr":"Une conclusion responsable peut être conditionnelle : l’option satisfait les exigences confirmées, mais l’export reste à tester. Indiquez les inconnues décisives, leur responsable et une date de révision. Évitez les pourcentages de confiance sans méthode. L’acceptation exige critères respectés, affirmations étayées, calculs reproductibles et lacunes critiques visibles. Un tiers doit pouvoir répéter les contrôles sans reconstruire la conversation."}]}],"readingMinutes":{"pt":3,"en":2,"es":2,"fr":2},"read":3},{"slug":"agentic-code-review-and-recovery","category":"engineering","asset":"code","date":"2026-09-07","title":{"pt":"Código por agentes: revisão, execução e recuperação","en":"Agentic code: review, execution and recovery","es":"Código con agentes: revisión, ejecución y recuperación","fr":"Code agentique : révision, exécution et récupération"},"lead":{"pt":"Um fluxo prático para transformar pedidos em mudanças pequenas, verificáveis e reversíveis, sem confundir uma interface convincente com execução comprovada.","en":"A practical workflow for small, verifiable and reversible changes, with clear evidence of execution.","es":"Un flujo práctico para cambios pequeños, verificables y reversibles, con pruebas claras de ejecución.","fr":"Un parcours pratique pour des changements limités, vérifiables et réversibles, avec des preuves d’exécution."},"blocks":[{"title":{"pt":"Reproduza antes de corrigir","en":"Reproduce before fixing","es":"Reproduce antes de corregir","fr":"Reproduisez avant de corriger"},"body":[{"pt":"Descreva o comportamento esperado e o observado com uma entrada concreta. “Login falha” é menos útil que “depois de confirmar o e-mail, o retorno abre a página inicial, mas a sessão não é restaurada”. Registre navegador, versão, rota e mensagem de erro sem copiar senhas ou tokens. Siga a ação do formulário ao servidor e de volta ao estado visual. Quando a falha estiver localizada, preserve um caso pequeno que a reproduza. Isso impede uma correção cosmética que apenas muda a mensagem enquanto o problema permanece.","en":"Describe expected and observed behavior with a concrete input. “After email confirmation, the callback opens home but does not restore the session” is more useful than “login fails”. Record browser, version, route and error without passwords or tokens. Trace the form action through the server and back to the UI, then preserve a small reproduction. This prevents cosmetic fixes that only change an error message.","es":"Describe comportamiento esperado y observado con una entrada concreta. “Tras confirmar el correo, el retorno abre el inicio pero no restaura la sesión” ayuda más que “falla el acceso”. Registra navegador, versión, ruta y error sin contraseñas ni tokens. Sigue la acción hasta el servidor y de vuelta a la interfaz. Conserva un caso mínimo para evitar arreglos cosméticos.","fr":"Décrivez le comportement attendu et observé avec une entrée concrète. « Après confirmation du courriel, le retour ouvre l’accueil sans restaurer la session » est plus utile que « la connexion échoue ». Notez navigateur, version, route et erreur sans secrets. Suivez l’action jusqu’au serveur puis à l’interface. Conservez un cas minimal pour éviter les corrections purement cosmétiques."}]},{"title":{"pt":"Revise o conjunto completo de mudanças","en":"Review the complete changeset","es":"Revisa el conjunto completo de cambios","fr":"Examinez l’ensemble des modifications"},"body":[{"pt":"Leia os arquivos alterados e seus consumidores. Uma assinatura de função nova pode exigir mudanças no cliente, no servidor, nos tipos e no teste. Confira caminhos, importações, tratamento de falhas e compatibilidade com dados existentes. O agente deve preparar as alterações antes de gravá-las e mostrar o que será criado, atualizado ou removido. Uma alteração em permissões ou migração merece uma revisão específica; a existência de um botão “Aplicar” não prova que essa revisão aconteceu. Se o projeto mudou durante a geração, compare a revisão de origem e recalcule o diff antes de aplicar.","en":"Read changed files and their consumers. A new function signature can affect client, server, types and tests. Check paths, imports, failure handling and existing data. Stage changes before writing and list creates, updates and deletions. Permissions and migrations need specific review. If the workspace changed during generation, compare the original revision and recompute the diff before applying.","es":"Lee archivos modificados y consumidores. Una nueva firma puede afectar cliente, servidor, tipos y pruebas. Revisa rutas, importaciones, fallos y datos existentes. Prepara los cambios antes de escribir y enumera creaciones, actualizaciones y eliminaciones. Permisos y migraciones requieren revisión específica. Si cambió el proyecto durante la generación, compara la revisión inicial y recalcula el diff antes de aplicar.","fr":"Lisez fichiers modifiés et consommateurs. Une nouvelle signature peut toucher client, serveur, types et tests. Contrôlez chemins, imports, erreurs et données existantes. Préparez les modifications avant écriture et détaillez créations, mises à jour et suppressions. Permissions et migrations exigent une révision ciblée. Si le projet a changé pendant la génération, comparez la révision initiale et recalculez le diff."}]},{"title":{"pt":"Separe os níveis de verificação","en":"Separate verification levels","es":"Separa niveles de verificación","fr":"Distinguez les niveaux de vérification"},"body":[{"pt":"Um parser confirma que a sintaxe é aceita. Um build verifica parte da integração entre módulos. Um teste unitário cobre uma regra isolada. Um teste de ponta a ponta percorre uma tarefa real. Nenhum deles, sozinho, garante todo o produto. Para um login, verifique campos inválidos, credenciais recusadas, conexão indisponível, retorno de sessão e recuperação de acesso. Para arquivos, confira se o documento abre e contém o que foi solicitado. Relate comando, resultado e limite do teste. Quando a execução não estiver disponível, marque “não executado”; não substitua evidência por uma frase confiante.","en":"A parser checks syntax; a build checks part of module integration; a unit test covers an isolated rule; an end-to-end test follows a real task. None guarantees the whole product. Login checks should include invalid fields, rejected credentials, network failures, session restoration and recovery. Generated files should open and contain the requested content. Report command, result and limits. If execution is unavailable, label it unexecuted.","es":"Un parser comprueba sintaxis; un build, parte de la integración; una prueba unitaria, una regla; una prueba integral, una tarea real. Ninguna garantiza todo el producto. Comprueba campos inválidos, credenciales rechazadas, red caída, restauración de sesión y recuperación. Los archivos deben abrir y contener lo pedido. Informa comando, resultado y límites. Si no hubo ejecución, indícalo.","fr":"Un parseur contrôle la syntaxe ; une compilation, une partie de l’intégration ; un test unitaire, une règle ; un test complet, une tâche réelle. Aucun ne garantit tout le produit. Testez champs invalides, refus d’identifiants, panne réseau, restauration et récupération. Les fichiers doivent s’ouvrir avec le contenu demandé. Rapportez commande, résultat et limites. Sans exécution, indiquez-le explicitement."}]},{"title":{"pt":"Planeje a recuperação","en":"Plan recovery","es":"Planifica la recuperación","fr":"Prévoyez la récupération"},"body":[{"pt":"Antes de aplicar, mantenha uma cópia recuperável dos arquivos afetados. Valide todos os destinos antes da primeira gravação e rejeite caminhos fora da pasta autorizada, links simbólicos e colisões entre arquivos. Se uma gravação falhar, restaure o conjunto anterior em vez de deixar metade da alteração aplicada. Depois de publicar, repita o fluxo principal na versão servida: o artefato local e o publicado podem divergir. Critério de aceitação: o defeito reproduzido desaparece, os fluxos adjacentes continuam funcionando, o usuário consegue revisar o diff e existe um caminho claro de retorno.","en":"Keep recoverable copies before applying. Validate every destination first; reject paths outside the authorized directory, symbolic links and conflicting file paths. Restore the previous set if a write fails. After publishing, repeat the main workflow on the served version: local and deployed artifacts can differ. Acceptance means the reproduced defect is fixed, adjacent flows work, the diff is reviewable and rollback is clear.","es":"Conserva copias recuperables. Valida todos los destinos antes de escribir; rechaza rutas fuera de la carpeta autorizada, enlaces simbólicos y conflictos. Restaura el conjunto anterior si falla una escritura. Tras publicar, repite el flujo principal: los artefactos locales y publicados pueden diferir. La aceptación requiere defecto corregido, flujos adyacentes funcionales, diff revisable y recuperación clara.","fr":"Conservez des copies récupérables. Validez tous les chemins avant écriture ; refusez sorties du dossier autorisé, liens symboliques et collisions. Restaurez l’ensemble précédent si une écriture échoue. Après publication, répétez le parcours principal : artefacts locaux et publiés peuvent différer. L’acceptation exige défaut corrigé, parcours voisins fonctionnels, diff lisible et retour arrière clair."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"read":2},{"slug":"voice-dictation-from-thought-to-draft","category":"product","asset":"chat","date":"2026-09-06","title":{"pt":"Da fala ao rascunho: ditado que você consegue revisar","en":"From speech to draft: dictation you can review","es":"De la voz al borrador: dictado que puedes revisar","fr":"De la parole au brouillon : une dictée à relire"},"lead":{"pt":"Organize ideias falando, acompanhe o texto durante a captura e revise o que importa antes de enviar.","en":"Organize ideas aloud, follow the text during capture, and review what matters before sending.","es":"Organiza ideas hablando, sigue el texto durante la captura y revisa lo importante antes de enviar.","fr":"Organisez vos idées à voix haute, suivez le texte pendant la capture et relisez avant l’envoi."},"blocks":[{"title":{"pt":"Comece pela intenção","en":"Start with intent","es":"Empieza por la intención","fr":"Commencez par l’intention"},"body":[{"pt":"Antes de ligar o microfone, escolha a entrega: uma mensagem, uma lista de tarefas ou o esboço de um documento. Diga primeiro o objetivo e depois os detalhes. Em uma reunião, por exemplo, separe decisão, responsável e prazo em frases distintas. Essa ordem reduz a necessidade de reorganizar um parágrafo longo depois. Você não precisa falar como um texto pronto; o rascunho existe justamente para preservar ideias antes da edição.","en":"Before turning on the microphone, choose the output: a message, a task list, or a document outline. State the goal first, followed by details. For meeting notes, separate the decision, owner, and deadline into distinct sentences. This reduces the need to reorganize a long paragraph later. You do not need to speak like a finished document; a draft preserves ideas before editing.","es":"Antes de activar el micrófono, elige el resultado: un mensaje, una lista de tareas o el esquema de un documento. Explica primero el objetivo y después los detalles. En notas de reunión, separa decisión, responsable y fecha en frases distintas. Así reduces la reorganización posterior. No necesitas hablar como un texto terminado; un borrador conserva ideas antes de editarlas.","fr":"Avant d’activer le microphone, choisissez le résultat : message, liste de tâches ou plan de document. Énoncez l’objectif, puis les détails. Dans un compte rendu, séparez décision, responsable et échéance en phrases distinctes. Vous aurez moins à réorganiser ensuite. Inutile de parler comme un document terminé : le brouillon conserve les idées avant leur révision."}]},{"title":{"pt":"Texto parcial não é texto definitivo","en":"Partial text is provisional","es":"El texto parcial es provisional","fr":"Le texte partiel reste provisoire"},"body":[{"pt":"Nos navegadores compatíveis, o ditado mostra resultados parciais enquanto você fala. Algumas palavras podem mudar quando o reconhecimento recebe mais contexto. Isso é esperado, especialmente com nomes próprios, números e frases interrompidas. Em outros dispositivos, a captura pode usar a transcrição ao vivo do serviço ou transcrever ao parar. A velocidade depende do aparelho, do navegador e da conexão; não existe promessa de latência zero.","en":"Compatible browsers show partial results while you speak. Words may change as recognition receives more context, especially names, numbers, and interrupted sentences. Other devices may use service-based live transcription or transcribe when recording stops. Speed depends on the device, browser, and connection; zero latency is not promised.","es":"Los navegadores compatibles muestran resultados parciales mientras hablas. Algunas palabras cambian al recibir más contexto, sobre todo nombres, números y frases interrumpidas. Otros dispositivos pueden usar la transcripción en vivo del servicio o transcribir al detener la grabación. La velocidad depende del dispositivo, navegador y conexión; no se promete latencia cero.","fr":"Les navigateurs compatibles affichent des résultats partiels pendant la dictée. Certains mots changent avec le contexte, notamment les noms, nombres et phrases interrompues. D’autres appareils utilisent la transcription en direct du service ou transcrivent à l’arrêt. La vitesse dépend de l’appareil, du navigateur et de la connexion ; une latence nulle n’est pas promise."}]},{"title":{"pt":"Revise os pontos de maior impacto","en":"Review high-impact details","es":"Revisa los detalles importantes","fr":"Relisez les détails importants"},"body":[{"pt":"Ao terminar, confira valores, datas, nomes e negações. “Não aprovar” e “aprovar” mudam completamente uma instrução. Use fones ou um ambiente silencioso quando possível e evite que várias pessoas falem ao mesmo tempo. O microfone preenche o rascunho; ele não envia a mensagem automaticamente. Para editar durante a captura, pare o ditado primeiro. Você mantém controle sobre o texto final e decide o momento do envio.","en":"When finished, check amounts, dates, names, and negations. “Do not approve” and “approve” completely change an instruction. Use headphones or a quiet environment when possible, and avoid overlapping speakers. The microphone fills the draft; it does not send the message automatically. Stop dictation before editing. You control the final text and decide when to send it.","es":"Al terminar, comprueba cantidades, fechas, nombres y negaciones. «No aprobar» y «aprobar» cambian por completo una instrucción. Usa auriculares o un entorno silencioso y evita voces simultáneas. El micrófono completa el borrador; no envía el mensaje automáticamente. Detén el dictado antes de editar. Tú controlas el texto final y decides cuándo enviarlo.","fr":"À la fin, vérifiez montants, dates, noms et négations. « Ne pas approuver » et « approuver » changent totalement une instruction. Préférez un environnement calme et évitez les voix simultanées. Le microphone remplit le brouillon sans envoyer le message. Arrêtez la dictée avant de modifier le texte. Vous contrôlez le résultat final et le moment de l’envoi."}]}],"readingMinutes":{"pt":2,"en":1,"es":1,"fr":1},"read":2},{"slug":"read-ai-benchmarks-without-false-certainty","category":"models","asset":"modelPaper","date":"2026-09-06","title":{"pt":"Como ler um benchmark de IA sem confundir meta com resultado","en":"Reading AI benchmarks without confusing goals and results","es":"Cómo leer benchmarks de IA sin confundir metas y resultados","fr":"Lire un benchmark d’IA sans confondre objectif et résultat"},"lead":{"pt":"Uma pontuação só fica útil quando você conhece a prova, a versão, as condições e as falhas incluídas na conta.","en":"A score becomes useful when you know the test, version, conditions, and failures included.","es":"Una puntuación resulta útil cuando conoces la prueba, versión, condiciones y fallos contabilizados.","fr":"Un score devient utile lorsque vous connaissez le test, sa version, ses conditions et les échecs comptés."},"blocks":[{"title":{"pt":"Compare a mesma prova","en":"Compare the same test","es":"Compara la misma prueba","fr":"Comparez le même test"},"body":[{"pt":"Imagine dois sistemas avaliados em datas diferentes. Um resolveu problemas antigos; o outro recebeu uma edição mais difícil. Ordenar apenas os números mistura populações diferentes. Antes de comparar, procure a edição do conjunto de avaliação, as categorias e a forma de calcular a média. Um bom resultado em raciocínio não determina sozinho a qualidade em código, linguagem ou instruções. Também importa saber se ferramentas e pesquisa externa estavam permitidas.","en":"Imagine two systems evaluated on different dates: one solved older problems while the other received a harder edition. Ranking only their numbers mixes different populations. Check the dataset edition, categories, and averaging method first. Strong reasoning does not determine coding, language, or instruction-following quality. Whether tools and external search were allowed also matters.","es":"Imagina dos sistemas evaluados en fechas distintas: uno resolvió problemas antiguos y otro una edición más difícil. Ordenar solo los números mezcla poblaciones diferentes. Comprueba la edición, categorías y cálculo de la media. Un buen razonamiento no determina por sí solo la calidad en código, lenguaje o instrucciones. También importa si se permitieron herramientas y búsqueda externa.","fr":"Imaginez deux systèmes évalués à des dates différentes : l’un traite d’anciens problèmes, l’autre une édition plus difficile. Classer leurs seuls scores mélange des populations différentes. Vérifiez l’édition, les catégories et la moyenne. Le raisonnement ne détermine pas seul la qualité du code, du langage ou du suivi des instructions. L’autorisation d’outils et de recherche externe compte également."}]},{"title":{"pt":"Conte também as falhas","en":"Count failures too","es":"Cuenta también los fallos","fr":"Comptez aussi les échecs"},"body":[{"pt":"Uma avaliação de produto precisa registrar respostas incorretas, interrupções e indisponibilidade. Excluir tentativas que falharam na rede pode inflar a impressão de confiabilidade. Relate separadamente acerto entre respostas concluídas e sucesso considerando todas as tentativas. Uma amostra pequena serve para encontrar regressões e orientar investigação; ela não sustenta uma posição global. Repetições e casos variados ajudam a enxergar a incerteza que um número isolado esconde.","en":"A product evaluation should record incorrect answers, interruptions, and unavailability. Excluding network failures can inflate apparent reliability. Report accuracy among completed responses separately from success across all attempts. A small sample helps identify regressions and guide investigation; it cannot establish global rank. Repeats and varied cases expose uncertainty hidden by a single number.","es":"Una evaluación debe registrar respuestas incorrectas, interrupciones e indisponibilidad. Excluir fallos de red puede inflar la fiabilidad aparente. Separa la precisión de respuestas completadas del éxito en todos los intentos. Una muestra pequeña identifica regresiones y orienta investigaciones; no establece una posición global. Repeticiones y casos variados muestran la incertidumbre oculta en un número.","fr":"Une évaluation doit compter réponses incorrectes, interruptions et indisponibilité. Exclure les échecs réseau peut gonfler la fiabilité apparente. Distinguez la précision des réponses terminées du succès sur toutes les tentatives. Un petit échantillon révèle des régressions, sans établir un rang mondial. Répétitions et cas variés rendent visible l’incertitude cachée par un chiffre."}]},{"title":{"pt":"Traga a avaliação para o seu trabalho","en":"Evaluate your own workload","es":"Evalúa tu propio trabajo","fr":"Évaluez votre propre travail"},"body":[{"pt":"Monte uma coleção de tarefas representativas, removendo dados pessoais desnecessários. Defina o resultado esperado antes de experimentar: um cálculo conferível, um arquivo que abre ou uma alteração que passa no teste relevante. Reserve casos que não serão usados no ajuste. Compare qualidade, tempo até uma entrega utilizável e frequência de falhas. Uma meta ambiciosa orienta desenvolvimento; o resultado publicado precisa continuar ligado às evidências que realmente existem.","en":"Build a collection of representative tasks with unnecessary personal data removed. Define expected outcomes before experimenting: a checkable calculation, a file that opens, or a change that passes a relevant test. Reserve cases that will not be used for tuning. Compare quality, time to usable delivery, and failure frequency. Ambitious goals guide development; published results must remain tied to evidence.","es":"Reúne tareas representativas sin datos personales innecesarios. Define el resultado antes de experimentar: un cálculo verificable, un archivo que abre o un cambio que supera la prueba pertinente. Reserva casos que no se usarán para ajustes. Compara calidad, tiempo hasta una entrega útil y frecuencia de fallos. Las metas orientan el desarrollo; los resultados publicados deben seguir vinculados a evidencias.","fr":"Rassemblez des tâches représentatives sans données personnelles inutiles. Définissez le résultat attendu : calcul vérifiable, fichier qui s’ouvre ou modification passant le test pertinent. Réservez des cas exclus des ajustements. Comparez qualité, délai de livraison utile et fréquence des échecs. Les objectifs guident le développement ; les résultats publiés doivent rester liés aux preuves."}]}],"readingMinutes":{"pt":2,"en":1,"es":1,"fr":1},"read":2},{"slug":"multilingual-workspace-light-mode-reading","category":"settings","asset":"site","date":"2026-09-06","title":{"pt":"Um espaço de trabalho legível em mais de um idioma","en":"A readable workspace across languages","es":"Un espacio de trabajo legible en varios idiomas","fr":"Un espace de travail lisible en plusieurs langues"},"lead":{"pt":"Idioma, contraste e preferência de leitura precisam funcionar juntos nas tarefas que você repete todos os dias.","en":"Language, contrast, and reading preferences should work together in everyday tasks.","es":"Idioma, contraste y preferencias de lectura deben funcionar juntos en las tareas diarias.","fr":"Langue, contraste et préférences de lecture doivent fonctionner ensemble au quotidien."},"blocks":[{"title":{"pt":"Escolha uma preferência explícita","en":"Choose an explicit preference","es":"Elige una preferencia explícita","fr":"Choisissez une préférence explicite"},"body":[{"pt":"A detecção automática acompanha o idioma do navegador. Se você compartilha um aparelho ou trabalha em outra língua, selecione uma preferência manual. A interface oferece português, inglês, espanhol e francês. Navegar do blog para a documentação e voltar à conversa deve preservar a escolha. Os controles traduzidos ajudam a encontrar ações; seus próprios textos, nomes de arquivos e trechos de código devem manter o conteúdo original.","en":"Automatic detection follows the browser language. Choose a manual preference when sharing a device or working in another language. The interface offers Portuguese, English, Spanish, and French. Moving between the blog, documentation, and conversation should preserve the choice. Translated controls help locate actions; your text, filenames, and code should retain their original content.","es":"La detección automática sigue el idioma del navegador. Elige una preferencia manual al compartir un dispositivo o trabajar en otra lengua. La interfaz ofrece portugués, inglés, español y francés. Pasar del blog a la documentación y a la conversación debe conservar la elección. Los controles traducidos ayudan a encontrar acciones; tus textos, nombres de archivos y código deben conservar el original.","fr":"La détection automatique suit la langue du navigateur. Choisissez une préférence manuelle sur un appareil partagé ou pour travailler dans une autre langue. L’interface propose portugais, anglais, espagnol et français. Le passage du blog à la documentation puis à la conversation doit conserver ce choix. Les commandes traduites facilitent les actions ; vos textes, noms de fichiers et code gardent leur contenu original."}]},{"title":{"pt":"Modo claro exige mais que um fundo branco","en":"Light mode needs more than a white background","es":"El modo claro exige más que un fondo blanco","fr":"Le mode clair exige plus qu’un fond blanc"},"body":[{"pt":"Uma tela legível precisa distinguir superfície, texto, borda e seleção. Caixas de entrada, menus, mensagens de erro e painéis secundários merecem o mesmo cuidado que a página inicial. Prefira uma luminosidade confortável no aparelho e aumente o texto se necessário. Cor sozinha não deve comunicar um estado: rótulos e ícones também ajudam. Fotografias, ilustrações e arquivos anexados não precisam ter suas cores invertidas para acompanhar o tema.","en":"A readable screen distinguishes surfaces, text, borders, and selection. Inputs, menus, errors, and secondary panels need the same care as the home page. Use comfortable device brightness and enlarge text when needed. Color alone should not communicate state: labels and icons help too. Photos, illustrations, and attachments should not have their colors inverted to match the theme.","es":"Una pantalla legible distingue superficies, texto, bordes y selección. Entradas, menús, errores y paneles secundarios requieren el mismo cuidado que la portada. Ajusta el brillo y amplía el texto si hace falta. El color no debe comunicar un estado por sí solo: etiquetas e iconos también ayudan. Fotografías, ilustraciones y archivos adjuntos no necesitan invertir sus colores para seguir el tema.","fr":"Un écran lisible distingue surfaces, texte, bordures et sélection. Champs, menus, erreurs et panneaux secondaires méritent autant de soin que l’accueil. Réglez une luminosité confortable et agrandissez le texte si nécessaire. La couleur seule ne doit pas indiquer un état : libellés et icônes aident aussi. Photos, illustrations et pièces jointes ne doivent pas être inversées pour suivre le thème."}]},{"title":{"pt":"Verifique o fluxo que você usa","en":"Check the workflow you use","es":"Comprueba tu flujo de trabajo","fr":"Vérifiez votre parcours habituel"},"body":[{"pt":"Depois de mudar idioma ou tema, abra uma conversa, um menu e um artigo. Confira se o foco do teclado continua visível e se os botões longos cabem na tela. No celular, faça essa conferência com o teclado aberto. Se encontrar um trecho sem tradução, registre a página, o idioma e a frase exata, sem incluir informações privadas da conversa. Isso torna o problema reproduzível e permite corrigir a origem em vez de apenas uma captura de tela.","en":"After changing language or theme, open a conversation, a menu, and an article. Check visible keyboard focus and long button labels. On mobile, check with the keyboard open. If a phrase remains untranslated, record the page, language, and exact phrase without private conversation details. This makes the issue reproducible and supports fixing its source rather than a single screenshot.","es":"Tras cambiar idioma o tema, abre una conversación, un menú y un artículo. Comprueba el foco del teclado y las etiquetas largas. En móvil, revisa con el teclado abierto. Si queda una frase sin traducir, anota página, idioma y frase exacta sin datos privados de la conversación. Así el problema es reproducible y se puede corregir su origen.","fr":"Après avoir changé langue ou thème, ouvrez une conversation, un menu et un article. Vérifiez le focus clavier et les longs libellés. Sur mobile, gardez le clavier ouvert. Si une phrase reste non traduite, notez page, langue et phrase exacte sans détails privés. Le problème devient reproductible, ce qui permet d’en corriger la source."}]}],"readingMinutes":{"pt":2,"en":1,"es":2,"fr":1},"read":2},{"slug":"melos-2-fast-work-with-verifiable-output","date":"2026-09-04","read":2,"category":"product","asset":"modelPaper","title":{"pt":"Melos 2: velocidade só conta quando a resposta continua verificável","en":"Melos 2: speed only matters when the answer stays verifiable","es":"Melos 2: la velocidad solo importa si la respuesta sigue siendo verificable","fr":"Melos 2 : la vitesse ne compte que si la réponse reste vérifiable"},"dek":{"pt":"Uma rota mais rápida para trabalho cotidiano, com foco em respostas diretas, pesquisa quando necessária e formato final consistente.","en":"A faster route for everyday work, focused on direct answers, retrieval when needed, and consistent final output.","es":"Una ruta más rápida para el trabajo diario, centrada en respuestas directas, búsqueda cuando hace falta y formato final consistente.","fr":"Une voie plus rapide pour le travail quotidien, axée sur des réponses directes, la recherche lorsque nécessaire et une sortie cohérente."},"body":[{"pt":"Rapidez útil não é simplesmente reduzir o tempo até o primeiro token. É reduzir o tempo até uma resposta que já respeita o pedido, deixa claro quando depende de informação atual e evita obrigar o usuário a corrigir detalhes básicos depois.","en":"Useful speed is not just reducing time to first token. It is reducing time to an answer that already respects the request, recognizes when fresh information matters, and avoids pushing basic cleanup back to the user.","es":"La velocidad útil no es solo reducir el tiempo hasta el primer token, sino llegar antes a una respuesta que ya respete el pedido, reconozca cuándo importa información actual y evite correcciones básicas posteriores.","fr":"La vitesse utile ne consiste pas seulement à réduire le temps jusqu’au premier token, mais à atteindre plus vite une réponse qui respecte déjà la demande, reconnaît le besoin d’informations récentes et évite les corrections de base."}],"blocks":[{"title":{"pt":"Menos cerimônia, mais entrega","en":"Less ceremony, more delivery","es":"Menos ceremonia, más entrega","fr":"Moins de cérémonie, plus de livraison"},"body":[{"pt":"Perguntas simples devem continuar simples. O ganho de velocidade desaparece quando a interface acrescenta um relatório inteiro a uma decisão de duas linhas.","en":"Simple questions should stay simple. Speed disappears when the interface adds a full report to a two-line decision.","es":"Las preguntas simples deben seguir siendo simples. La velocidad desaparece cuando la interfaz añade un informe entero a una decisión de dos líneas.","fr":"Les questions simples doivent rester simples. La vitesse disparaît lorsque l’interface ajoute un rapport complet à une décision de deux lignes."}]},{"title":{"pt":"Pesquisar quando a resposta depende do agora","en":"Search when the answer depends on now","es":"Buscar cuando la respuesta depende del presente","fr":"Rechercher lorsque la réponse dépend du présent"},"body":[{"pt":"Preço, disponibilidade, versão, notícia e documentação que muda precisam de fonte atual. Conhecimento estável não precisa abrir a web por hábito.","en":"Price, availability, versions, news, and changing documentation need fresh sources. Stable knowledge should not open the web by habit.","es":"Precio, disponibilidad, versiones, noticias y documentación cambiante necesitan fuentes actuales. El conocimiento estable no debe abrir la web por costumbre.","fr":"Prix, disponibilité, versions, actualités et documentation changeante exigent des sources récentes. Les connaissances stables ne doivent pas ouvrir le web par habitude."}]},{"title":{"pt":"O formato final também é qualidade","en":"Final format is part of quality","es":"El formato final también es calidad","fr":"Le format final fait partie de la qualité"},"body":[{"pt":"JSON, listas curtas, tabelas e respostas “somente o valor” devem sair no formato pedido. Uma resposta correta que quebra o contrato ainda gera trabalho extra.","en":"JSON, short lists, tables, and value-only answers should arrive in the requested form. A correct answer that breaks the contract still creates extra work.","es":"JSON, listas cortas, tablas y respuestas de solo valor deben llegar en el formato pedido. Una respuesta correcta que rompe el contrato sigue creando trabajo extra.","fr":"JSON, listes courtes, tableaux et réponses limitées à une valeur doivent respecter le format demandé. Une réponse correcte qui rompt le contrat crée encore du travail."}]},{"title":{"pt":"Quando usar Thesis 2","en":"When to use Thesis 2","es":"Cuándo usar Thesis 2","fr":"Quand utiliser Thesis 2"},"body":[{"pt":"Arquitetura complexa, investigação longa, código de alto risco e tarefas que exigem muitas verificações ainda justificam uma rota mais pesada. A escolha deve seguir a carga de trabalho, não o prestígio do nome.","en":"Complex architecture, long investigations, high-risk code, and tasks requiring many checks still justify a heavier route. The choice should follow workload, not model-name prestige.","es":"Arquitectura compleja, investigaciones largas, código de alto riesgo y tareas con muchas verificaciones siguen justificando una ruta más pesada. La elección debe seguir la carga de trabajo, no el prestigio del nombre.","fr":"Architecture complexe, investigations longues, code à haut risque et tâches nécessitant de nombreuses vérifications justifient toujours une voie plus lourde. Le choix doit suivre la charge de travail, pas le prestige du nom."}]},{"title":{"pt":"Exemplo prático e critério de aceitação","en":"Worked example and acceptance criterion","es":"Ejemplo práctico y criterio de aceptación","fr":"Exemple pratique et critère d’acceptation"},"body":[{"pt":"Para resumir uma reunião, peça primeiro cinco decisões com responsável e prazo. Compare o resultado com as notas originais: nomes preservados, prazos ausentes sinalizados e nenhuma decisão inventada. Se uma ambiguidade mudar a entrega, forneça a informação faltante antes de trocar de modelo. Meça o tempo até o resumo aprovado, incluindo as correções que você precisou fazer.","en":"For meeting summaries, request five decisions with owners and deadlines. Compare them with the notes: names preserved, missing deadlines flagged, no invented decisions. Resolve material ambiguity before switching models. Measure time to an accepted summary, including your corrections.","es":"Para resumir reuniones, pide cinco decisiones con responsables y plazos. Compáralas con las notas: nombres correctos, plazos ausentes señalados y ninguna decisión inventada. Resuelve ambigüedades antes de cambiar de modelo. Mide el tiempo hasta aceptar el resumen, incluidas tus correcciones.","fr":"Pour résumer une réunion, demandez cinq décisions avec responsables et échéances. Comparez-les aux notes : noms conservés, échéances manquantes signalées, aucune décision inventée. Résolvez les ambiguïtés avant de changer de modèle. Mesurez le délai jusqu’au résumé accepté, corrections comprises."}]}],"updated":"2026-09-06","lead":{"pt":"Uma rota mais rápida para trabalho cotidiano, com foco em respostas diretas, pesquisa quando necessária e formato final consistente.","en":"A faster route for everyday work, focused on direct answers, retrieval when needed, and consistent final output.","es":"Una ruta más rápida para el trabajo diario, centrada en respuestas directas, búsqueda cuando hace falta y formato final consistente.","fr":"Une voie plus rapide pour le travail quotidien, axée sur des réponses directes, la recherche lorsque nécessaire et une sortie cohérente."},"readingMinutes":{"pt":2,"en":1,"es":2,"fr":2}},{"slug":"verify-ai-answer-without-redoing-everything","date":"2026-09-04","read":2,"category":"engineering","asset":"barChart","title":{"pt":"Como verificar uma resposta de IA sem refazer tudo do zero","en":"How to verify an AI answer without redoing everything","es":"Cómo verificar una respuesta de IA sin rehacerlo todo","fr":"Comment vérifier une réponse d’IA sans tout refaire"},"dek":{"pt":"Uma revisão eficiente procura o ponto decisivo, não repete todo o raciocínio por esporte.","en":"Efficient review checks the decisive point instead of repeating the whole solution for sport.","es":"Una revisión eficiente busca el punto decisivo en lugar de repetir toda la solución.","fr":"Une vérification efficace cible le point décisif au lieu de répéter toute la solution."},"body":[{"pt":"A melhor checagem é proporcional ao risco. Se a resposta depende de um total, recalcule o total. Se depende de uma regra jurídica, confirme a fonte e a vigência. Se depende de código, execute o caminho crítico. Revisar tudo igualmente custa caro e ainda pode deixar passar o único ponto que realmente decide a resposta.","en":"The best check is proportional to risk. If the answer depends on a total, recompute the total. If it depends on a legal rule, confirm the source and effective date. If it depends on code, execute the critical path. Reviewing everything equally is expensive and can still miss the one decisive point.","es":"La mejor verificación es proporcional al riesgo. Si la respuesta depende de un total, recalcúlalo; si depende de una norma, confirma fuente y vigencia; si depende de código, ejecuta el camino crítico.","fr":"La meilleure vérification est proportionnelle au risque. Si la réponse dépend d’un total, recalculez-le ; d’une règle, vérifiez source et date ; du code, exécutez le chemin critique."}],"blocks":[{"title":{"pt":"Ache a afirmação que governa o resto","en":"Find the claim that governs the rest","es":"Encuentra la afirmación que gobierna el resto","fr":"Trouver l’affirmation qui gouverne le reste"},"body":[{"pt":"Quase toda resposta complexa tem uma ou duas premissas sem as quais a conclusão muda. Marque essas premissas primeiro.","en":"Most complex answers have one or two premises that would change the conclusion if wrong. Mark them first.","es":"Casi toda respuesta compleja tiene una o dos premisas que cambian la conclusión si son falsas. Márcalas primero.","fr":"Presque toute réponse complexe comporte une ou deux prémisses dont l’erreur changerait la conclusion. Identifiez-les d’abord."}]},{"title":{"pt":"Use um método diferente para conferir","en":"Use a different method to check","es":"Usa un método diferente para comprobar","fr":"Utiliser une méthode différente pour vérifier"},"body":[{"pt":"Somar a mesma coluna duas vezes do mesmo jeito repete o mesmo erro. Prefira uma checagem independente: outra fórmula, outro agrupamento, um teste de limite ou uma fonte primária.","en":"Adding the same column twice in the same way repeats the same mistake. Prefer an independent check: another formula, grouping, boundary test, or primary source.","es":"Sumar la misma columna dos veces de la misma manera repite el mismo error. Prefiere otra fórmula, agrupación, prueba de límites o fuente primaria.","fr":"Additionner la même colonne deux fois de la même manière répète la même erreur. Préférez une autre formule, un autre regroupement, un test limite ou une source primaire."}]},{"title":{"pt":"Separe erro de informação de erro de formato","en":"Separate information errors from format errors","es":"Separa errores de información y de formato","fr":"Séparer erreur d’information et erreur de format"},"body":[{"pt":"Um número certo dentro de um JSON inválido é um problema de entrega; um JSON perfeito com número errado é um problema de conteúdo. Corrigir os dois exige diagnósticos diferentes.","en":"A correct number inside invalid JSON is a delivery problem; perfect JSON with the wrong number is a content problem. They require different fixes.","es":"Un número correcto dentro de JSON inválido es un problema de entrega; JSON perfecto con número incorrecto es un problema de contenido.","fr":"Un nombre correct dans un JSON invalide est un problème de livraison ; un JSON parfait avec un nombre faux est un problème de contenu."}]},{"title":{"pt":"Pare quando a evidência fecha","en":"Stop when evidence closes the question","es":"Detente cuando la evidencia cierre la cuestión","fr":"S’arrêter lorsque les preuves ferment la question"},"body":[{"pt":"Verificação infinita também é desperdício. Quando o ponto decisivo foi confirmado por evidência apropriada e não há contradição material aberta, seguir revisando tende a adicionar custo sem reduzir risco.","en":"Infinite verification is waste too. Once the decisive point is supported by appropriate evidence and no material contradiction remains, further review often adds cost without reducing risk.","es":"La verificación infinita también desperdicia recursos. Cuando el punto decisivo está confirmado y no queda contradicción material, seguir revisando suele añadir coste sin reducir riesgo.","fr":"La vérification infinie est aussi du gaspillage. Une fois le point décisif confirmé et aucune contradiction matérielle restante, poursuivre ajoute souvent du coût sans réduire le risque."}]},{"title":{"pt":"Exemplo prático e critério de aceitação","en":"Worked example and acceptance criterion","es":"Ejemplo práctico y criterio de aceptación","fr":"Exemple pratique et critère d’acceptation"},"body":[{"pt":"Escolha a afirmação que mais influencia a conclusão e procure uma evidência independente. Em um orçamento, recalcule um subtotal e confira a unidade; em uma comparação, abra a fonte do critério decisivo. Se o primeiro teste falhar, amplie a revisão para os itens da mesma classe. Registre o que foi conferido e mantenha o restante como não verificado.","en":"Test the claim that most affects the conclusion using independent evidence. Recalculate a budget subtotal and check units, or open the source for a decisive comparison criterion. If the first test fails, review similar items. Record what was checked and leave the rest unverified.","es":"Comprueba la afirmación decisiva con evidencia independiente. Recalcula un subtotal y verifica unidades, o abre la fuente del criterio principal de una comparación. Si falla la primera prueba, revisa elementos similares. Registra lo comprobado y deja el resto como no verificado.","fr":"Vérifiez l’affirmation décisive avec une preuve indépendante. Recalculez un sous-total et ses unités, ou consultez la source du critère principal d’une comparaison. En cas d’échec, examinez les éléments similaires. Consignez les vérifications et laissez le reste non vérifié."}]}],"updated":"2026-09-06","lead":{"pt":"Uma revisão eficiente procura o ponto decisivo, não repete todo o raciocínio por esporte.","en":"Efficient review checks the decisive point instead of repeating the whole solution for sport.","es":"Una revisión eficiente busca el punto decisivo en lugar de repetir toda la solución.","fr":"Une vérification efficace cible le point décisif au lieu de répéter toute la solution."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"web-research-source-date-can-change-answer","date":"2026-09-04","read":2,"category":"search","asset":"globeHand","title":{"pt":"Pesquisa na web: quando a data da fonte muda a resposta","en":"Web research: when a source date changes the answer","es":"Investigación web: cuando la fecha de la fuente cambia la respuesta","fr":"Recherche web : quand la date d’une source change la réponse"},"dek":{"pt":"Recência não é enfeite de citação. Em muitos temas, ela faz parte do conteúdo.","en":"Freshness is not citation decoration. In many topics, it is part of the answer.","es":"La actualidad no es decoración de la cita: en muchos temas forma parte de la respuesta.","fr":"La fraîcheur n’est pas un décor de citation : dans de nombreux sujets, elle fait partie de la réponse."},"body":[{"pt":"Uma página excelente de dois anos atrás pode ser a fonte errada para preço, versão, disponibilidade, regra vigente ou liderança atual. A primeira pergunta de uma pesquisa boa é: este fato pode ter mudado desde a publicação?","en":"An excellent page from two years ago can still be the wrong source for price, version, availability, current rules, or leadership. The first question in good research is whether the fact could have changed since publication.","es":"Una página excelente de hace dos años puede ser la fuente equivocada para precio, versión, disponibilidad, norma vigente o liderazgo actual.","fr":"Une excellente page vieille de deux ans peut être la mauvaise source pour un prix, une version, une disponibilité, une règle actuelle ou une direction."}],"blocks":[{"title":{"pt":"Classifique a volatilidade","en":"Classify volatility","es":"Clasifica la volatilidad","fr":"Classer la volatilité"},"body":[{"pt":"História, definições e princípios físicos tendem a envelhecer devagar. Preços, placares, APIs, políticas, horários e cargos podem mudar em horas ou dias.","en":"History, definitions, and physical principles tend to age slowly. Prices, scores, APIs, policies, hours, and roles can change within hours or days.","es":"Historia, definiciones y principios físicos envejecen despacio. Precios, resultados, APIs, políticas, horarios y cargos pueden cambiar en horas o días.","fr":"Histoire, définitions et principes physiques vieillissent lentement. Prix, scores, API, politiques, horaires et fonctions peuvent changer en quelques heures ou jours."}]},{"title":{"pt":"Prefira a fonte que pode responder","en":"Prefer the source that can answer","es":"Prefiere la fuente capaz de responder","fr":"Préférer la source capable de répondre"},"body":[{"pt":"Uma página de marketing não é a melhor fonte para um limite técnico; uma postagem social não substitui documentação oficial para comportamento de API. Autoridade depende da pergunta.","en":"A marketing page is not the best source for a technical limit; a social post does not replace official documentation for API behavior. Authority depends on the question.","es":"Una página de marketing no es la mejor fuente para un límite técnico; una publicación social no sustituye documentación oficial para una API.","fr":"Une page marketing n’est pas la meilleure source pour une limite technique ; un post social ne remplace pas la documentation officielle d’une API."}]},{"title":{"pt":"Use datas absolutas","en":"Use absolute dates","es":"Usa fechas absolutas","fr":"Utiliser des dates absolues"},"body":[{"pt":"“Ontem” e “recentemente” envelhecem mal. Em relatórios ou decisões, registre a data da fonte e a data em que o fato foi verificado.","en":"“Yesterday” and “recently” age badly. In reports or decisions, record the source date and the date the fact was checked.","es":"“Ayer” y “recientemente” envejecen mal. En informes o decisiones, registra la fecha de la fuente y la fecha de verificación.","fr":"« Hier » et « récemment » vieillissent mal. Dans un rapport ou une décision, indiquez la date de la source et celle de la vérification."}]},{"title":{"pt":"Quando não pesquisar","en":"When not to search","es":"Cuándo no buscar","fr":"Quand ne pas rechercher"},"body":[{"pt":"Abrir a web para toda pergunta aumenta latência e ruído. Se o fato é estável e o usuário não pediu fontes atuais, pesquisa automática pode piorar uma resposta que já era simples.","en":"Opening the web for every question adds latency and noise. If the fact is stable and fresh sources were not requested, automatic search can make a simple answer worse.","es":"Abrir la web para cada pregunta añade latencia y ruido. Si el dato es estable y no se pidieron fuentes actuales, la búsqueda automática puede empeorar una respuesta simple.","fr":"Ouvrir le web pour chaque question ajoute latence et bruit. Si le fait est stable et qu’aucune source récente n’est demandée, la recherche automatique peut dégrader une réponse simple."}]},{"title":{"pt":"Exemplo prático e critério de aceitação","en":"Worked example and acceptance criterion","es":"Ejemplo práctico y criterio de aceptación","fr":"Exemple pratique et critère d’acceptation"},"body":[{"pt":"Ao comparar recursos de um produto, registre versão, data consultada e região. Uma página recente pode repetir informações antigas; procure a data do fato, não apenas a publicação. Havendo conflito, prefira a documentação do responsável pelo produto e explicite o ponto ainda incerto. Guarde o link junto da afirmação para que outra pessoa consiga refazer a checagem.","en":"When comparing product features, record version, access date, and region. A recent page may repeat old facts; check the event date too. Prefer the responsible producer’s documentation when sources conflict and state unresolved uncertainty. Keep each link beside the claim so another person can repeat the check.","es":"Al comparar funciones, registra versión, fecha de consulta y región. Una página reciente puede repetir hechos antiguos; comprueba también la fecha del hecho. Ante conflictos, prioriza documentación del fabricante y señala la incertidumbre. Conserva cada enlace junto a su afirmación para repetir la comprobación.","fr":"Pour comparer des fonctionnalités, notez version, date de consultation et région. Une page récente peut reprendre des faits anciens ; vérifiez leur date. En cas de conflit, privilégiez la documentation du producteur et précisez l’incertitude. Gardez chaque lien auprès de l’affirmation pour permettre une nouvelle vérification."}]}],"updated":"2026-09-06","lead":{"pt":"Recência não é enfeite de citação. Em muitos temas, ela faz parte do conteúdo.","en":"Freshness is not citation decoration. In many topics, it is part of the answer.","es":"La actualidad no es decoración de la cita: en muchos temas forma parte de la respuesta.","fr":"La fraîcheur n’est pas un décor de citation : dans de nombreux sujets, elle fait partie de la réponse."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":2}},{"slug":"spreadsheet-ai-seven-checks-before-trusting-total","date":"2026-09-04","read":2,"category":"engineering","asset":"barChart","title":{"pt":"Planilhas com IA: sete checagens antes de confiar no total","en":"AI spreadsheets: seven checks before trusting the total","es":"Hojas de cálculo con IA: siete comprobaciones antes de confiar en el total","fr":"Tableurs et IA : sept vérifications avant de faire confiance au total"},"dek":{"pt":"O erro mais perigoso em uma planilha costuma parecer plausível.","en":"The most dangerous spreadsheet error usually looks plausible.","es":"El error más peligroso de una hoja de cálculo suele parecer plausible.","fr":"L’erreur la plus dangereuse dans un tableur paraît souvent plausible."},"body":[{"pt":"Planilhas misturam dados, regra de negócio e cálculo. Uma IA pode acertar a fórmula e usar a coluna errada, ou filtrar corretamente e somar linhas duplicadas. Por isso, a revisão precisa olhar para o caminho do dado, não apenas para o resultado final.","en":"Spreadsheets mix data, business rules, and calculation. An AI can write the right formula against the wrong column, or filter correctly and sum duplicated rows. Review the data path, not just the final number.","es":"Las hojas de cálculo mezclan datos, reglas de negocio y cálculo. Una IA puede usar la fórmula correcta sobre la columna equivocada o sumar filas duplicadas.","fr":"Les tableurs mélangent données, règles métier et calcul. Une IA peut écrire la bonne formule sur la mauvaise colonne ou additionner des lignes dupliquées."}],"blocks":[{"title":{"pt":"1–2 · Unidade e universo","en":"1–2 · Unit and population","es":"1–2 · Unidad y universo","fr":"1–2 · Unité et population"},"body":[{"pt":"Confirme a unidade de cada coluna e quais linhas pertencem ao universo da pergunta. Misturar reais com milhares de reais ou pedidos com clientes muda tudo sem produzir erro de sintaxe.","en":"Confirm each column’s unit and which rows belong to the question’s population. Mixing currency with thousands of currency units or orders with customers changes everything without a syntax error.","es":"Confirma la unidad de cada columna y qué filas pertenecen al universo de la pregunta.","fr":"Confirmez l’unité de chaque colonne et les lignes appartenant à la population étudiée."}]},{"title":{"pt":"3–4 · Duplicatas e nulos","en":"3–4 · Duplicates and nulls","es":"3–4 · Duplicados y nulos","fr":"3–4 · Doublons et valeurs nulles"},"body":[{"pt":"Antes de somar, conte chaves únicas e nulos. Um join um-para-muitos pode multiplicar receita; um nulo tratado como zero pode esconder ausência de dado.","en":"Before summing, count unique keys and nulls. A one-to-many join can multiply revenue; treating null as zero can hide missing data.","es":"Antes de sumar, cuenta claves únicas y nulos. Un join uno-a-muchos puede multiplicar ingresos.","fr":"Avant de sommer, comptez les clés uniques et les valeurs nulles. Une jointure un-à-plusieurs peut multiplier le chiffre d’affaires."}]},{"title":{"pt":"5 · Recalcule uma amostra","en":"5 · Recompute a sample","es":"5 · Recalcula una muestra","fr":"5 · Recalculer un échantillon"},"body":[{"pt":"Escolha poucas linhas e calcule manualmente. Se a regra não fecha em uma amostra pequena, não confie na automação sobre cem mil linhas.","en":"Pick a few rows and compute them manually. If the rule does not close on a small sample, do not trust the automation over a hundred thousand rows.","es":"Elige pocas filas y calcula manualmente. Si la regla no cierra en una muestra pequeña, no confíes en la automatización masiva.","fr":"Choisissez quelques lignes et calculez-les manuellement. Si la règle ne tient pas sur un petit échantillon, ne faites pas confiance à l’automatisation massive."}]},{"title":{"pt":"6–7 · Total alternativo e reconciliação","en":"6–7 · Alternate total and reconciliation","es":"6–7 · Total alternativo y conciliación","fr":"6–7 · Total alternatif et rapprochement"},"body":[{"pt":"Crie um segundo caminho de cálculo e reconcilie com uma fonte externa quando existir. Diferença pequena e explicada pode ser arredondamento; diferença sem explicação é sinal para parar.","en":"Create a second calculation path and reconcile against an external source when available. A small explained difference may be rounding; an unexplained difference is a stop signal.","es":"Crea un segundo camino de cálculo y concilia con una fuente externa cuando exista.","fr":"Créez un second chemin de calcul et rapprochez-le d’une source externe lorsqu’elle existe."}]},{"title":{"pt":"Exemplo prático e critério de aceitação","en":"Worked example and acceptance criterion","es":"Ejemplo práctico y criterio de aceptación","fr":"Exemple pratique et critère d’acceptation"},"body":[{"pt":"Crie uma cópia da planilha e teste um cenário pequeno cujo resultado você conhece. Inclua uma célula vazia, um valor negativo e um número armazenado como texto. Confira se filtros escondem linhas usadas na soma e se percentuais são frações ou valores inteiros. Só depois compare o total completo. Um valor plausível pode continuar errado por causa de unidade, duplicação ou intervalo incompleto.","en":"Use a copy and test a small scenario with a known result. Include an empty cell, a negative value, and a number stored as text. Check hidden filtered rows and whether percentages are fractions or integers before comparing the full total. Plausible values can still contain unit, duplication, or range errors.","es":"Usa una copia y prueba un escenario pequeño con resultado conocido. Incluye una celda vacía, un negativo y un número guardado como texto. Revisa filas filtradas y si los porcentajes son fracciones o enteros antes del total completo. Un valor plausible puede ocultar errores de unidades, duplicación o rango.","fr":"Travaillez sur une copie avec un petit cas au résultat connu. Ajoutez cellule vide, valeur négative et nombre enregistré comme texte. Vérifiez les lignes filtrées et le format des pourcentages avant le total complet. Une valeur plausible peut cacher des erreurs d’unité, de doublon ou de plage."}]}],"updated":"2026-09-06","lead":{"pt":"O erro mais perigoso em uma planilha costuma parecer plausível.","en":"The most dangerous spreadsheet error usually looks plausible.","es":"El error más peligroso de una hoja de cálculo suele parecer plausible.","fr":"L’erreur la plus dangereuse dans un tableur paraît souvent plausible."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"generated-code-review-checklist-expensive-bugs","date":"2026-09-04","read":2,"category":"code","asset":"coding","title":{"pt":"Código gerado: um checklist curto que pega bugs caros","en":"Generated code: a short checklist that catches expensive bugs","es":"Código generado: una lista corta que detecta errores caros","fr":"Code généré : une courte checklist qui détecte des bugs coûteux"},"dek":{"pt":"Compilar é o começo da revisão, não o fim.","en":"Compilation is the start of review, not the end.","es":"Compilar es el inicio de la revisión, no el final.","fr":"Compiler est le début de la revue, pas la fin."},"body":[{"pt":"Código de IA costuma falhar nas bordas: autenticação, estado concorrente, persistência, erros de rede, compatibilidade e caminhos que o exemplo feliz nunca executa. Uma revisão curta e bem escolhida vale mais que dezenas de comentários estilísticos.","en":"AI-generated code often fails at boundaries: authentication, concurrent state, persistence, network errors, compatibility, and paths the happy example never executes. A short targeted review beats dozens of style comments.","es":"El código generado por IA suele fallar en los bordes: autenticación, estado concurrente, persistencia, errores de red y compatibilidad.","fr":"Le code généré par IA échoue souvent aux frontières : authentification, état concurrent, persistance, erreurs réseau et compatibilité."}],"blocks":[{"title":{"pt":"Contrato público primeiro","en":"Public contract first","es":"Contrato público primero","fr":"Contrat public d’abord"},"body":[{"pt":"Confira nomes de rota, parâmetros, formato de retorno e estados esperados antes de olhar implementação interna. Uma função elegante que rompe o contrato ainda é regressão.","en":"Check route names, parameters, return formats, and expected states before inspecting internals. An elegant function that breaks the contract is still a regression.","es":"Comprueba rutas, parámetros, formatos de retorno y estados esperados antes de mirar la implementación interna.","fr":"Vérifiez routes, paramètres, formats de retour et états attendus avant d’examiner l’implémentation interne."}]},{"title":{"pt":"Falhas que precisam ser simuladas","en":"Failures worth simulating","es":"Fallos que conviene simular","fr":"Pannes à simuler"},"body":[{"pt":"Teste sessão expirada, timeout, resposta vazia, duplicidade de clique, arquivo ausente e retry. Esses casos revelam mais que o screenshot do caminho feliz.","en":"Test expired sessions, timeouts, empty responses, double clicks, missing files, and retries. These reveal more than a happy-path screenshot.","es":"Prueba sesión expirada, timeout, respuesta vacía, doble clic, archivo ausente y retry.","fr":"Testez session expirée, timeout, réponse vide, double clic, fichier manquant et retry."}]},{"title":{"pt":"Persistência e concorrência","en":"Persistence and concurrency","es":"Persistencia y concurrencia","fr":"Persistance et concurrence"},"body":[{"pt":"Pergunte quem é dono do estado e o que acontece quando duas ações chegam juntas. Muitos bugs de produção são duas operações corretas executadas na ordem errada.","en":"Ask who owns state and what happens when two actions arrive together. Many production bugs are two correct operations executed in the wrong order.","es":"Pregunta quién es dueño del estado y qué ocurre cuando dos acciones llegan a la vez.","fr":"Demandez qui possède l’état et ce qui se passe lorsque deux actions arrivent simultanément."}]},{"title":{"pt":"Teste o que você pretende afirmar","en":"Test what you intend to claim","es":"Prueba lo que pretendes afirmar","fr":"Tester ce que vous comptez affirmer"},"body":[{"pt":"“Funcionando” deve significar algo observável: build passou, rota abriu, estado persistiu ou teste específico passou. Sem evidência, use “candidato” em vez de “corrigido”.","en":"“Working” should mean something observable: build passed, route opened, state persisted, or a specific test passed. Without evidence, say “candidate” instead of “fixed.”","es":"“Funciona” debe significar algo observable: build correcto, ruta abierta, estado persistido o test específico aprobado.","fr":"« Fonctionne » doit signifier quelque chose d’observable : build réussi, route ouverte, état persisté ou test précis réussi."}]},{"title":{"pt":"Exemplo prático e critério de aceitação","en":"Worked example and acceptance criterion","es":"Ejemplo práctico y criterio de aceptación","fr":"Exemple pratique et critère d’acceptation"},"body":[{"pt":"Para uma mudança de login, não basta testar que o formulário aparece. Verifique inicialização, credenciais inválidas, rede indisponível e retorno de uma sessão existente. Reproduza o defeito antes de editar e mantenha um teste que falhe na versão anterior. A revisão deve acompanhar o caminho completo da ação, porque uma tela correta pode depender de um script que nem chegou a iniciar.","en":"For login changes, rendering a form is insufficient. Check initialization, invalid credentials, unavailable network, and returning sessions. Reproduce the defect first and retain a test that fails on the previous version. Review the full action path: a correct-looking screen may depend on a script that never started.","es":"En cambios de acceso no basta con mostrar el formulario. Revisa inicialización, credenciales incorrectas, red caída y sesiones existentes. Reproduce el defecto primero y conserva una prueba que falle en la versión anterior. Examina el recorrido completo: una pantalla correcta puede depender de un script que nunca arrancó.","fr":"Pour modifier la connexion, afficher le formulaire ne suffit pas. Vérifiez initialisation, identifiants incorrects, panne réseau et sessions existantes. Reproduisez le défaut puis conservez un test échouant sur l’ancienne version. Examinez tout le parcours : un écran correct peut dépendre d’un script jamais lancé."}]}],"updated":"2026-09-06","lead":{"pt":"Compilar é o começo da revisão, não o fim.","en":"Compilation is the start of review, not the end.","es":"Compilar es el inicio de la revisión, no el final.","fr":"Compiler est le début de la revue, pas la fin."},"readingMinutes":{"pt":2,"en":1,"es":1,"fr":1}},{"slug":"long-work-prompts-contracts-not-novels","date":"2026-09-04","read":1,"category":"projects","asset":"docs","title":{"pt":"Trabalho longo com IA: escreva contratos, não romances","en":"Long AI work: write contracts, not novels","es":"Trabajo largo con IA: escribe contratos, no novelas","fr":"Travail long avec l’IA : écrivez des contrats, pas des romans"},"dek":{"pt":"O contexto que sobrevive é o que pode ser checado depois.","en":"The context that survives is the context that can be checked later.","es":"El contexto que sobrevive es el que puede comprobarse después.","fr":"Le contexte qui survit est celui qui peut être vérifié ensuite."},"body":[{"pt":"Em projetos longos, um prompt enorme vira arqueologia. Melhor separar objetivo, invariantes, decisões, evidência, estado atual e próximo marco. Cada bloco responde a uma pergunta operacional e pode ser atualizado sem reescrever toda a história.","en":"In long projects, a giant prompt becomes archaeology. Separate objective, invariants, decisions, evidence, current state, and next milestone. Each block answers an operational question and can be updated independently.","es":"En proyectos largos, un prompt enorme se convierte en arqueología. Separa objetivo, invariantes, decisiones, evidencia, estado actual y próximo hito.","fr":"Dans les projets longs, un prompt géant devient de l’archéologie. Séparez objectif, invariants, décisions, preuves, état actuel et prochain jalon."}],"blocks":[{"title":{"pt":"Objetivo em uma frase testável","en":"A testable one-sentence objective","es":"Objetivo en una frase comprobable","fr":"Un objectif testable en une phrase"},"body":[{"pt":"“Melhorar o app” é ambíguo. “Reduzir o login a um fluxo estável sem mudar a regra de sessão” diz o que melhorar e o que preservar.","en":"“Improve the app” is ambiguous. “Reduce login to a stable flow without changing session rules” states what to improve and what to preserve.","es":"“Mejorar la app” es ambiguo. “Hacer estable el login sin cambiar la regla de sesión” define mejora y preservación.","fr":"« Améliorer l’app » est ambigu. « Stabiliser le login sans changer la règle de session » définit ce qu’il faut améliorer et préserver."}]},{"title":{"pt":"Invariantes ficam separados","en":"Keep invariants separate","es":"Separa los invariantes","fr":"Séparer les invariants"},"body":[{"pt":"Liste o que não pode quebrar: auth, formato de arquivo, rota pública, compatibilidade, identidade visual ou requisito jurídico. Isso impede que uma melhoria local compre uma regressão global.","en":"List what must not break: auth, file format, public route, compatibility, visual identity, or legal requirement. This prevents a local improvement from buying a global regression.","es":"Lista lo que no puede romperse: auth, formato, ruta pública, compatibilidad, identidad visual o requisito legal.","fr":"Listez ce qui ne doit pas casser : auth, format de fichier, route publique, compatibilité, identité visuelle ou exigence juridique."}]},{"title":{"pt":"Decisão e evidência não são a mesma coisa","en":"Decision and evidence are different","es":"Decisión y evidencia no son lo mismo","fr":"Décision et preuve sont différentes"},"body":[{"pt":"“Vamos usar X” é decisão. “Teste Y passou em Z” é evidência. Manter os dois separados ajuda uma sessão futura a saber o que pode ser reavaliado e o que foi observado.","en":"“We will use X” is a decision. “Test Y passed in Z” is evidence. Keeping them separate helps a future session know what can be reconsidered and what was observed.","es":"“Usaremos X” es decisión. “La prueba Y pasó en Z” es evidencia.","fr":"« Nous utiliserons X » est une décision. « Le test Y a réussi dans Z » est une preuve."}]},{"title":{"pt":"Handoff termina com próximo marco","en":"End handoff with the next milestone","es":"Termina el handoff con el próximo hito","fr":"Terminer le handoff par le prochain jalon"},"body":[{"pt":"Um bom handoff não termina em “continue daí”. Ele aponta o próximo resultado verificável, os arquivos relevantes e qualquer bloqueio ainda aberto.","en":"A good handoff does not end with “continue from there.” It names the next verifiable result, relevant files, and any open blocker.","es":"Un buen handoff no termina en “continúa desde ahí”; indica el próximo resultado verificable, archivos relevantes y bloqueos.","fr":"Un bon handoff ne se termine pas par « continuez ». Il indique le prochain résultat vérifiable, les fichiers pertinents et les blocages ouverts."}]},{"title":{"pt":"Especifique invariantes, entregas e critérios de parada","en":"Specify invariants, deliverables, and stop criteria","es":"Especifica invariantes, entregables y criterios de parada","fr":"Spécifier invariants, livrables et critères d’arrêt"},"body":[{"pt":"Prompts longos falham quando misturam objetivo, contexto, preferência e detalhe incidental sem indicar o que é obrigatório. Para trabalho de várias etapas, escreva um contrato curto: resultado esperado, arquivos ou sistemas que podem ser tocados, invariantes que não podem mudar, evidências que precisam ser produzidas e condição de conclusão. O modelo pode então planejar livremente dentro dessas bordas. Se surgir conflito entre duas instruções, a regra de prioridade deve estar explícita, não escondida na posição de uma frase em um bloco de milhares de tokens.","en":"Long prompts fail when they mix goals, context, preferences, and incidental details without marking what is mandatory. For multi-step work, write a compact contract: expected result, files or systems that may be touched, invariants that must not change, evidence to produce, and a completion condition. The model can plan freely inside those boundaries. If instructions conflict, priority should be explicit rather than implied by sentence position in thousands of tokens.","es":"Los prompts largos fallan cuando mezclan objetivo, contexto, preferencias y detalles incidentales sin indicar qué es obligatorio. Para trabajo de varias etapas, escribe un contrato breve: resultado esperado, archivos o sistemas permitidos, invariantes, evidencia y condición de finalización. El modelo puede planificar libremente dentro de esas fronteras.","fr":"Les prompts longs échouent lorsqu’ils mélangent objectif, contexte, préférences et détails accessoires sans préciser ce qui est obligatoire. Pour un travail en plusieurs étapes, écrivez un contrat court : résultat attendu, fichiers ou systèmes autorisés, invariants, preuves à produire et condition de fin. Le modèle peut planifier librement dans ces limites."},{"pt":"Durante a execução, mantenha o contrato separado do diário de trabalho. Novas descobertas entram como estado atualizado; não reescreva silenciosamente a intenção inicial. Ao final, verifique cada critério de aceitação e liste o que ficou incompleto. Isso funciona melhor do que pedir “seja extremamente cuidadoso” vinte vezes, uma tradição venerável dos prompts que só aumenta o tamanho sem aumentar a precisão.","en":"During execution, keep the contract separate from the work log. New discoveries become updated state; they should not silently rewrite the original intent. At the end, verify every acceptance criterion and list anything incomplete. This works better than repeating “be extremely careful” twenty times, a distinguished prompt tradition that mostly increases length rather than precision.","es":"Durante la ejecución, mantén el contrato separado del diario de trabajo. Los nuevos hallazgos actualizan el estado sin reescribir silenciosamente la intención inicial. Al final, verifica cada criterio de aceptación y enumera lo incompleto. Funciona mejor que repetir “sé extremadamente cuidadoso” veinte veces.","fr":"Pendant l’exécution, gardez le contrat séparé du journal de travail. Les nouvelles découvertes mettent à jour l’état sans réécrire silencieusement l’intention initiale. À la fin, vérifiez chaque critère d’acceptation et listez ce qui reste incomplet. C’est plus utile que répéter vingt fois « soyez extrêmement prudent »."}]}],"lead":{"pt":"O contexto que sobrevive é o que pode ser checado depois.","en":"The context that survives is the context that can be checked later.","es":"El contexto que sobrevive es el que puede comprobarse después.","fr":"Le contexte qui survit est celui qui peut être vérifié ensuite."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"documents-untrusted-instructions-inside-files","date":"2026-09-04","read":1,"category":"privacy","asset":"lockBraces","title":{"pt":"Documentos e anexos: dados dentro do arquivo não viram ordens automaticamente","en":"Documents and attachments: data inside a file does not automatically become instruction","es":"Documentos y adjuntos: los datos dentro del archivo no se convierten automáticamente en órdenes","fr":"Documents et pièces jointes : les données d’un fichier ne deviennent pas automatiquement des instructions"},"dek":{"pt":"Uma frase em um PDF pode ser conteúdo a analisar, não uma mudança de autoridade.","en":"A sentence in a PDF may be content to analyze, not a change of authority.","es":"Una frase en un PDF puede ser contenido para analizar, no un cambio de autoridad.","fr":"Une phrase dans un PDF peut être du contenu à analyser, pas un changement d’autorité."},"body":[{"pt":"Arquivos podem conter texto que parece um prompt: “ignore as instruções anteriores”, “envie estes dados”, “use esta senha”. Em uma análise segura, esse texto continua sendo parte do documento até que o usuário o adote explicitamente como instrução.","en":"Files can contain text that looks like a prompt: “ignore previous instructions,” “send this data,” or “use this password.” In a safe analysis, that text remains document content unless the user explicitly adopts it as an instruction.","es":"Los archivos pueden contener texto que parece un prompt. En un análisis seguro, sigue siendo contenido del documento salvo que el usuario lo adopte explícitamente como instrucción.","fr":"Les fichiers peuvent contenir du texte ressemblant à un prompt. Dans une analyse sûre, il reste du contenu du document sauf adoption explicite par l’utilisateur."}],"blocks":[{"title":{"pt":"Pergunte quem falou","en":"Ask who said it","es":"Pregunta quién lo dijo","fr":"Demander qui l’a dit"},"body":[{"pt":"A mesma frase tem peso diferente se veio do usuário, de uma política confiável, de um PDF recebido por e-mail ou de uma página aberta na web. Origem é parte do significado.","en":"The same sentence carries different authority if it came from the user, a trusted policy, an emailed PDF, or a web page. Origin is part of meaning.","es":"La misma frase tiene autoridad distinta según venga del usuario, de una política, de un PDF recibido o de una web.","fr":"La même phrase n’a pas la même autorité selon qu’elle vient de l’utilisateur, d’une politique fiable, d’un PDF reçu ou d’une page web."}]},{"title":{"pt":"Extração não é execução","en":"Extraction is not execution","es":"Extraer no es ejecutar","fr":"Extraire n’est pas exécuter"},"body":[{"pt":"Resumir uma instrução maliciosa encontrada em um documento não significa obedecê-la. A análise deve poder citar o conteúdo sem conceder permissão ao conteúdo.","en":"Summarizing a malicious instruction found in a document does not mean obeying it. Analysis must be able to quote content without granting it permission.","es":"Resumir una instrucción maliciosa hallada en un documento no significa obedecerla.","fr":"Résumer une instruction malveillante trouvée dans un document ne signifie pas lui obéir."}]},{"title":{"pt":"Conectores aumentam a necessidade de limite","en":"Connectors increase the need for boundaries","es":"Los conectores aumentan la necesidad de límites","fr":"Les connecteurs augmentent le besoin de limites"},"body":[{"pt":"Quanto mais ações externas estão disponíveis, mais importante é separar leitura de escrita e pedir autorização proporcional antes de alterar algo fora da conversa.","en":"The more external actions are available, the more important it is to separate reading from writing and require proportional authorization before changing anything outside the conversation.","es":"Cuantas más acciones externas estén disponibles, más importante es separar lectura y escritura y pedir autorización proporcional.","fr":"Plus il existe d’actions externes, plus il est important de séparer lecture et écriture et d’exiger une autorisation proportionnée."}]},{"title":{"pt":"Registre o que foi usado","en":"Record what was used","es":"Registra qué se usó","fr":"Enregistrer ce qui a été utilisé"},"body":[{"pt":"Em trabalho sensível, uma resposta melhor indica quais documentos sustentam a conclusão e quais dados ficaram de fora por falta de autorização ou relevância.","en":"In sensitive work, a better answer identifies which documents support the conclusion and which data stayed out for lack of authorization or relevance.","es":"En trabajo sensible, una mejor respuesta indica qué documentos sostienen la conclusión y qué datos quedaron fuera.","fr":"Dans un travail sensible, une meilleure réponse indique quels documents soutiennent la conclusion et quelles données ont été exclues faute d’autorisation ou de pertinence."}]},{"title":{"pt":"Trate conteúdo como dado, não como autoridade","en":"Treat content as data, not authority","es":"Trata el contenido como dato, no como autoridad","fr":"Traiter le contenu comme donnée, pas comme autorité"},"body":[{"pt":"Um PDF, planilha ou página pode conter texto que se parece com uma instrução para o modelo: “ignore as regras anteriores”, “envie estes dados” ou “execute este comando”. Quando o arquivo foi fornecido como material de análise, esse texto é conteúdo, não autorização. O runtime deve manter uma fronteira explícita entre instruções do usuário, política do sistema, resultados de ferramentas e material recuperado. Se o documento pedir uma ação externa, o sistema deve descrevê-la como parte do documento, não executá-la silenciosamente.","en":"A PDF, spreadsheet, or page can contain text that looks like an instruction to the model: ignore previous rules, send data, or execute a command. When the file was supplied as analysis material, that text is content, not authorization. Runtime should keep a clear boundary between user instructions, system policy, tool results, and retrieved material. If a document requests an external action, the system should describe that request as document content rather than execute it silently.","es":"Un PDF, hoja o página puede contener texto que parece una instrucción: ignorar reglas, enviar datos o ejecutar un comando. Si el archivo se entregó como material de análisis, ese texto es contenido, no autorización. El runtime debe mantener una frontera clara entre instrucciones del usuario, política del sistema, resultados de herramientas y material recuperado.","fr":"Un PDF, un tableur ou une page peut contenir du texte ressemblant à une instruction : ignorer les règles, envoyer des données ou exécuter une commande. Si le fichier est fourni comme matériau d’analyse, ce texte est du contenu, pas une autorisation. Le runtime doit séparer clairement instructions utilisateur, politique système, résultats d’outils et contenu récupéré."},{"pt":"A defesa não deve depender de uma lista de frases proibidas. Use proveniência e capacidade: cada trecho carregado mantém sua origem, e apenas canais explicitamente autorizados podem solicitar ferramentas ou mudanças de estado. Em tarefas sensíveis, uma segunda verificação deve comparar a ação pretendida com a intenção original do usuário antes do commit.","en":"Defense should not depend on a blacklist of phrases. Use provenance and capability boundaries: every retrieved passage keeps its origin, and only explicitly authorized channels can request tools or state changes. For sensitive tasks, a second check should compare the intended action with the user’s original intent before commit.","es":"La defensa no debe depender de una lista de frases prohibidas. Usa procedencia y capacidades: cada fragmento mantiene su origen y solo canales autorizados pueden solicitar herramientas o cambios de estado. En tareas sensibles, una segunda verificación debe comparar la acción con la intención original antes del commit.","fr":"La défense ne doit pas dépendre d’une liste de phrases interdites. Utilisez provenance et capacités : chaque passage conserve son origine et seuls les canaux autorisés peuvent demander des outils ou changements d’état. Pour les tâches sensibles, une seconde vérification compare l’action prévue à l’intention initiale avant commit."}]}],"lead":{"pt":"Uma frase em um PDF pode ser conteúdo a analisar, não uma mudança de autoridade.","en":"A sentence in a PDF may be content to analyze, not a change of authority.","es":"Una frase en un PDF puede ser contenido para analizar, no un cambio de autoridad.","fr":"Une phrase dans un PDF peut être du contenu à analyser, pas un changement d’autorité."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"visual-reference-fidelity-without-copying-interface","date":"2026-09-04","read":1,"category":"design","asset":"site","title":{"pt":"Referência visual: como pedir fidelidade sem copiar uma interface","en":"Visual references: how to ask for fidelity without copying an interface","es":"Referencia visual: cómo pedir fidelidad sin copiar una interfaz","fr":"Référence visuelle : demander de la fidélité sans copier une interface"},"dek":{"pt":"A parte útil de uma referência é a relação entre elementos, não a clonagem da marca.","en":"The useful part of a reference is the relationship between elements, not brand cloning.","es":"La parte útil de una referencia es la relación entre elementos, no clonar la marca.","fr":"La partie utile d’une référence est la relation entre les éléments, pas le clonage de la marque."},"body":[{"pt":"Uma boa referência visual diz muito além de “gosto dessas cores”. Ela informa proporção, densidade, hierarquia, ritmo, profundidade, crop, escala tipográfica e comportamento responsivo. Descrever essas relações produz resultados melhores e mais originais.","en":"A good visual reference says much more than “I like these colors.” It communicates proportion, density, hierarchy, rhythm, depth, crop, typographic scale, and responsive behavior. Describing those relationships produces better and more original results.","es":"Una buena referencia visual dice mucho más que “me gustan estos colores”: comunica proporción, densidad, jerarquía, ritmo y comportamiento responsive.","fr":"Une bonne référence visuelle dit bien plus que « j’aime ces couleurs » : elle communique proportion, densité, hiérarchie, rythme et comportement responsive."}],"blocks":[{"title":{"pt":"Descreva a geometria","en":"Describe geometry","es":"Describe la geometría","fr":"Décrire la géométrie"},"body":[{"pt":"Diga onde está a massa principal, quanto espaço vazio existe, qual elemento domina e como o olhar percorre a tela. Isso é mais útil que pedir “estilo premium”.","en":"Describe where the main visual mass sits, how much empty space exists, which element dominates, and how the eye moves through the screen. This is more useful than asking for “premium style.”","es":"Describe dónde está la masa principal, cuánto espacio vacío hay, qué elemento domina y cómo recorre la mirada la pantalla.","fr":"Décrivez où se trouve la masse principale, la quantité d’espace vide, l’élément dominant et le parcours du regard."}]},{"title":{"pt":"Separe identidade de composição","en":"Separate identity from composition","es":"Separa identidad y composición","fr":"Séparer identité et composition"},"body":[{"pt":"Logotipo, nomes, ícones proprietários e textos específicos pertencem à identidade. Grade, contraste, proporção e ritmo podem inspirar uma composição nova sem copiar a marca.","en":"Logo, names, proprietary icons, and specific copy belong to identity. Grid, contrast, proportion, and rhythm can inspire a new composition without copying the brand.","es":"Logo, nombres, iconos propietarios y textos pertenecen a la identidad. Rejilla, contraste, proporción y ritmo pueden inspirar una composición nueva.","fr":"Logo, noms, icônes propriétaires et textes appartiennent à l’identité. Grille, contraste, proportion et rythme peuvent inspirer une nouvelle composition."}]},{"title":{"pt":"Peça estados, não só screenshot","en":"Ask for states, not just a screenshot","es":"Pide estados, no solo una captura","fr":"Demander des états, pas seulement une capture"},"body":[{"pt":"Uma tela real precisa sobreviver a loading, erro, vazio, hover, foco, mobile e conteúdo longo. Uma referência estática não resolve esses estados automaticamente.","en":"A real screen must survive loading, error, empty state, hover, focus, mobile, and long content. A static reference does not solve those states automatically.","es":"Una pantalla real debe sobrevivir loading, error, vacío, hover, foco, móvil y contenido largo.","fr":"Un véritable écran doit gérer chargement, erreur, vide, survol, focus, mobile et contenu long."}]},{"title":{"pt":"Compare por critérios observáveis","en":"Compare with observable criteria","es":"Compara con criterios observables","fr":"Comparer avec des critères observables"},"body":[{"pt":"Depois de implementar, compare escala, ocupação de espaço, alinhamentos, contraste e comportamento. “Parece parecido” é um diagnóstico fraco; diferenças mensuráveis viram tarefas corrigíveis.","en":"After implementation, compare scale, space occupancy, alignment, contrast, and behavior. “Looks similar” is weak diagnosis; observable differences become fixable tasks.","es":"Después de implementar, compara escala, ocupación, alineación, contraste y comportamiento.","fr":"Après implémentation, comparez échelle, occupation de l’espace, alignements, contraste et comportement."}]},{"title":{"pt":"Extraia princípios, não pixels","en":"Extract principles, not pixels","es":"Extrae principios, no píxeles","fr":"Extraire des principes, pas des pixels"},"body":[{"pt":"Uma referência visual é mais útil quando é decomposta em decisões: densidade, hierarquia tipográfica, largura de leitura, ritmo vertical, contraste, comportamento de menus, estados de foco e quantidade de informação por superfície. Copiar posições e componentes literalmente produz uma réplica frágil; entender o sistema permite manter a identidade do produto. Para cada referência, anote o que cria a sensação desejada e traduza isso para tokens e regras próprias. No Giorgio, por exemplo, Newsreader pode assumir a voz editorial enquanto Geist mantém controles e navegação precisos.","en":"A visual reference becomes useful when decomposed into decisions: density, typographic hierarchy, reading width, vertical rhythm, contrast, menu behavior, focus states, and information per surface. Literal copying creates a brittle replica; understanding the system preserves product identity. For each reference, note what creates the desired feeling and translate it into your own tokens and rules. Giorgio can use Newsreader for editorial voice while Geist keeps controls and navigation precise.","es":"Una referencia visual es más útil cuando se descompone en decisiones: densidad, jerarquía tipográfica, ancho de lectura, ritmo vertical, contraste, comportamiento de menús y estados de foco. Copiar posiciones literalmente crea una réplica frágil; entender el sistema conserva la identidad. Traduce cada principio a tokens y reglas propias. Giorgio puede usar Newsreader como voz editorial y Geist para controles y navegación precisos.","fr":"Une référence visuelle devient utile lorsqu’on la décompose en décisions : densité, hiérarchie typographique, largeur de lecture, rythme vertical, contraste, menus et états de focus. Copier les positions littéralement crée une réplique fragile ; comprendre le système préserve l’identité. Traduisez chaque principe en tokens et règles propres. Giorgio peut confier la voix éditoriale à Newsreader et les contrôles précis à Geist."},{"pt":"A validação deve ser feita lado a lado em tamanhos de viewport equivalentes. Compare primeiro silhueta e proporções, depois tipografia, espaçamento e microinterações. Se a página só “parece igual” depois de muitos overrides locais, a abstração está errada: corrija o token ou o componente-base em vez de adicionar mais uma exceção.","en":"Validate side by side at equivalent viewport sizes. Compare silhouette and proportions first, then typography, spacing, and micro-interactions. If a page only looks right after many local overrides, the abstraction is wrong: fix the token or base component instead of adding another exception.","es":"Valida lado a lado con tamaños de viewport equivalentes. Compara primero silueta y proporciones, después tipografía, espacio y microinteracciones. Si la página solo queda bien con muchos overrides locales, la abstracción está mal: corrige el token o componente base en vez de sumar otra excepción.","fr":"Validez côte à côte avec des viewports équivalents. Comparez d’abord silhouette et proportions, puis typographie, espacements et micro-interactions. Si la page n’est correcte qu’après de nombreux overrides locaux, l’abstraction est mauvaise : corrigez le token ou le composant de base au lieu d’ajouter une exception."}]}],"lead":{"pt":"A parte útil de uma referência é a relação entre elementos, não a clonagem da marca.","en":"The useful part of a reference is the relationship between elements, not brand cloning.","es":"La parte útil de una referencia es la relación entre elementos, no clonar la marca.","fr":"La partie utile d’une référence est la relation entre les éléments, pas le clonage de la marque."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"when-not-to-automate-yet","date":"2026-09-04","read":1,"category":"engineering","asset":"browserDoc","title":{"pt":"Automação: quatro sinais de que ainda não é hora de automatizar","en":"Automation: four signs it is not time to automate yet","es":"Automatización: cuatro señales de que aún no es momento de automatizar","fr":"Automatisation : quatre signes qu’il est trop tôt pour automatiser"},"dek":{"pt":"Automatizar um processo instável apenas faz o erro acontecer mais rápido.","en":"Automating an unstable process only makes the mistake happen faster.","es":"Automatizar un proceso inestable solo hace que el error ocurra más rápido.","fr":"Automatiser un processus instable ne fait qu’accélérer l’erreur."},"body":[{"pt":"Automação é ótima quando a regra está entendida e o resultado pode ser verificado. Quando o processo muda toda semana, depende de julgamento informal ou não possui dono claro, escrever um agente primeiro costuma apenas cristalizar confusão.","en":"Automation is great when the rule is understood and the result can be verified. When the process changes weekly, depends on informal judgment, or has no clear owner, building an agent first usually crystallizes confusion.","es":"La automatización funciona cuando la regla está clara y el resultado puede verificarse. Si el proceso cambia cada semana, depende de juicio informal o no tiene dueño claro, automatizar primero cristaliza la confusión.","fr":"L’automatisation fonctionne lorsque la règle est comprise et le résultat vérifiable. Si le processus change chaque semaine, dépend d’un jugement informel ou n’a pas de propriétaire clair, automatiser d’abord cristallise la confusion."}],"blocks":[{"title":{"pt":"1 · A entrada não é previsível","en":"1 · Inputs are not predictable","es":"1 · La entrada no es predecible","fr":"1 · Les entrées ne sont pas prévisibles"},"body":[{"pt":"Se ninguém concorda sobre quais dados entram, a automação vai codificar uma interpretação escondida. Primeiro estabilize o contrato de entrada.","en":"If nobody agrees on what data goes in, automation will encode a hidden interpretation. Stabilize the input contract first.","es":"Si nadie acuerda qué datos entran, la automatización codificará una interpretación oculta.","fr":"Si personne ne s’accorde sur les données d’entrée, l’automatisation codera une interprétation cachée."}]},{"title":{"pt":"2 · O sucesso não pode ser medido","en":"2 · Success cannot be measured","es":"2 · El éxito no puede medirse","fr":"2 · Le succès ne peut pas être mesuré"},"body":[{"pt":"“Fazer melhor” não é gate. Defina tempo, erro tolerável, cobertura, aprovação humana ou outro resultado observável antes de delegar o processo.","en":"“Do it better” is not a gate. Define time, acceptable error, coverage, human approval, or another observable outcome before delegating the process.","es":"“Hacerlo mejor” no es un criterio. Define tiempo, error tolerable, cobertura, aprobación humana u otro resultado observable.","fr":"« Faire mieux » n’est pas un critère. Définissez temps, erreur acceptable, couverture, validation humaine ou autre résultat observable."}]},{"title":{"pt":"3 · Exceções dominam o fluxo","en":"3 · Exceptions dominate the flow","es":"3 · Las excepciones dominan el flujo","fr":"3 · Les exceptions dominent le flux"},"body":[{"pt":"Se metade dos casos exige negociação ou contexto não registrado, uma automação rígida cria fila de correções. Automatize primeiro o trecho estável e mantenha exceções explícitas.","en":"If half the cases require negotiation or unrecorded context, rigid automation creates a correction queue. Automate the stable portion first and keep exceptions explicit.","es":"Si la mitad de los casos requiere negociación o contexto no registrado, una automatización rígida crea una cola de correcciones.","fr":"Si la moitié des cas exige négociation ou contexte non enregistré, une automatisation rigide crée une file de corrections."}]},{"title":{"pt":"4 · Não existe caminho de desfazer","en":"4 · There is no undo path","es":"4 · No existe camino para deshacer","fr":"4 · Il n’existe pas de voie d’annulation"},"body":[{"pt":"Ações irreversíveis pedem revisão, confirmação ou staging. Se um erro apaga, envia ou publica algo sem retorno, desenhe o mecanismo de recuperação antes da automação.","en":"Irreversible actions need review, confirmation, or staging. If a mistake deletes, sends, or publishes something with no return path, design recovery before automation.","es":"Las acciones irreversibles necesitan revisión, confirmación o staging. Diseña la recuperación antes de automatizar.","fr":"Les actions irréversibles exigent revue, confirmation ou staging. Concevez la récupération avant l’automatisation."}]},{"title":{"pt":"Automação precisa de um contrato operacional","en":"Automation needs an operational contract","es":"La automatización necesita un contrato operativo","fr":"L’automatisation a besoin d’un contrat opérationnel"},"body":[{"pt":"Automatizar cedo demais transforma incerteza em uma máquina que repete incerteza mais rápido. Antes de delegar uma rotina, verifique se a entrada é observável, se o resultado desejado pode ser testado e se existe uma forma segura de interromper ou reverter a ação. Processos que mudam toda semana, dependem de julgamento tácito ou possuem consequências caras ainda pedem execução assistida. Use o modelo para preparar, comparar e sugerir; mantenha a confirmação humana no ponto em que a ação passa a ter efeito externo.","en":"Automating too early turns uncertainty into a machine that repeats uncertainty faster. Before delegating a routine, check whether inputs are observable, the desired result is testable, and the action can be safely stopped or reversed. Processes that change weekly, depend on tacit judgment, or have expensive consequences still call for assisted execution. Let the model prepare, compare, and suggest, while a human confirms the step that creates external effects.","es":"Automatizar demasiado pronto convierte la incertidumbre en una máquina que la repite más rápido. Antes de delegar una rutina, comprueba si las entradas son observables, si el resultado puede verificarse y si la acción puede detenerse o revertirse con seguridad. Procesos que cambian cada semana, dependen de juicio tácito o tienen consecuencias costosas aún necesitan ejecución asistida.","fr":"Automatiser trop tôt transforme l’incertitude en machine qui la répète plus vite. Avant de déléguer une routine, vérifiez que les entrées sont observables, le résultat testable et l’action réversible ou interrompable en sécurité. Les processus changeants, fondés sur un jugement tacite ou à conséquences coûteuses nécessitent encore une exécution assistée."},{"pt":"O sinal de maturidade não é “a IA consegue fazer”, mas “conseguimos detectar quando ela não deveria fazer”. Métricas de erro, limites de autorização, logs de decisão e um caminho de fallback simples devem existir antes de aumentar autonomia. Só então vale remover confirmações manuais que deixaram de adicionar segurança real.","en":"The maturity signal is not that AI can do the task, but that the system can detect when it should not. Error metrics, authorization boundaries, decision logs, and a simple fallback path should exist before autonomy increases. Only then should manual confirmations that no longer add real safety be removed.","es":"La señal de madurez no es que la IA pueda hacer la tarea, sino que el sistema pueda detectar cuándo no debe hacerla. Métricas de error, límites de autorización, logs de decisión y un fallback simple deben existir antes de aumentar la autonomía.","fr":"Le signe de maturité n’est pas que l’IA sache faire la tâche, mais que le système sache détecter quand elle ne doit pas la faire. Métriques d’erreur, limites d’autorisation, journaux de décision et voie de repli doivent exister avant d’augmenter l’autonomie."}]}],"lead":{"pt":"Automatizar um processo instável apenas faz o erro acontecer mais rápido.","en":"Automating an unstable process only makes the mistake happen faster.","es":"Automatizar un proceso inestable solo hace que el error ocurra más rápido.","fr":"Automatiser un processus instable ne fait qu’accélérer l’erreur."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"connectors-minimum-data-per-task","date":"2026-09-04","read":1,"category":"connectors","asset":"connectors","title":{"pt":"Conectores: o melhor contexto é o mínimo necessário para a tarefa","en":"Connectors: the best context is the minimum needed for the task","es":"Conectores: el mejor contexto es el mínimo necesario para la tarea","fr":"Connecteurs : le meilleur contexte est le minimum nécessaire à la tâche"},"dek":{"pt":"Mais acesso não significa automaticamente uma resposta melhor.","en":"More access does not automatically mean a better answer.","es":"Más acceso no significa automáticamente una respuesta mejor.","fr":"Plus d’accès ne signifie pas automatiquement une meilleure réponse."},"body":[{"pt":"Conectar e-mail, calendário, arquivos ou banco de dados pode economizar muito trabalho, mas o ganho vem de recuperar o dado certo, não de despejar toda a conta no contexto. Escopo pequeno melhora privacidade, latência e precisão.","en":"Connecting email, calendar, files, or databases can save a lot of work, but the gain comes from retrieving the right data, not dumping the whole account into context. Smaller scope improves privacy, latency, and precision.","es":"Conectar correo, calendario, archivos o base de datos ahorra trabajo, pero el beneficio viene de recuperar el dato correcto, no de volcar toda la cuenta al contexto.","fr":"Connecter e-mail, calendrier, fichiers ou base de données peut faire gagner beaucoup de temps, mais le bénéfice vient de récupérer la bonne donnée, pas de verser tout le compte dans le contexte."}],"blocks":[{"title":{"pt":"Comece pela pergunta","en":"Start from the question","es":"Empieza por la pregunta","fr":"Commencer par la question"},"body":[{"pt":"“Qual reunião mudou de horário?” pede eventos recentes, não todos os contatos e documentos. A pergunta define o menor conjunto de dados capaz de respondê-la.","en":"“Which meeting changed time?” needs recent events, not every contact and document. The question defines the smallest data set capable of answering it.","es":"“¿Qué reunión cambió de horario?” necesita eventos recientes, no todos los contactos y documentos.","fr":"« Quelle réunion a changé d’heure ? » nécessite des événements récents, pas tous les contacts et documents."}]},{"title":{"pt":"Leitura e escrita são permissões diferentes","en":"Reading and writing are different permissions","es":"Leer y escribir son permisos distintos","fr":"Lire et écrire sont des permissions différentes"},"body":[{"pt":"Pesquisar uma agenda não implica autorização para cancelar um evento. Sempre trate observação e mutação como capacidades separadas.","en":"Searching a calendar does not imply permission to cancel an event. Treat observation and mutation as separate capabilities.","es":"Buscar en un calendario no implica permiso para cancelar un evento. Trata observación y mutación como capacidades separadas.","fr":"Rechercher dans un calendrier n’implique pas l’autorisation d’annuler un événement. Traitez observation et mutation comme des capacités distinctes."}]},{"title":{"pt":"Mostre de onde veio a decisão","en":"Show where the decision came from","es":"Muestra de dónde salió la decisión","fr":"Montrer d’où vient la décision"},"body":[{"pt":"Quando a resposta depende de dados conectados, indique a mensagem, evento ou arquivo relevante. Isso permite auditoria sem despejar conteúdo desnecessário.","en":"When the answer depends on connected data, identify the relevant message, event, or file. This allows auditability without dumping unnecessary content.","es":"Cuando la respuesta depende de datos conectados, indica el mensaje, evento o archivo relevante.","fr":"Lorsque la réponse dépend de données connectées, indiquez le message, l’événement ou le fichier pertinent."}]},{"title":{"pt":"Revogue sem quebrar o produto","en":"Revocation should not break the product","es":"Revocar no debe romper el producto","fr":"La révocation ne doit pas casser le produit"},"body":[{"pt":"Um conector desconectado deve degradar de forma clara: explicar o que ficou indisponível e preservar o restante do trabalho. Permissão não deve virar dependência invisível.","en":"A disconnected connector should degrade clearly: explain what became unavailable and preserve the rest of the work. Permission should not become an invisible dependency.","es":"Un conector desconectado debe degradar de forma clara: explicar qué dejó de estar disponible y preservar el resto del trabajo.","fr":"Un connecteur déconnecté doit se dégrader clairement : expliquer ce qui n’est plus disponible et préserver le reste du travail."}]},{"title":{"pt":"Desenhe o conector pelo menor privilégio útil","en":"Design connectors around the least useful privilege","es":"Diseña conectores con el mínimo privilegio útil","fr":"Concevoir les connecteurs avec le privilège minimal utile"},"body":[{"pt":"A pergunta correta não é “quais dados o conector consegue acessar?”, mas “qual é o menor conjunto de dados e ações necessário para concluir esta tarefa?”. Um conector de calendário que só precisa consultar disponibilidade não deveria receber, por conveniência, permissão para apagar eventos. O mesmo vale para Drive, e-mail, CRM e bancos de dados. Separe leitura, escrita e ações destrutivas; peça elevação de permissão apenas quando a intenção do usuário exigir. Isso reduz o raio de impacto de erros e também torna auditoria e explicação muito mais simples.","en":"The right question is not what a connector can access, but the smallest set of data and actions required for the task. A calendar connector that only checks availability should not receive event-deletion permission for convenience. The same applies to drive, email, CRM, and databases. Separate read, write, and destructive actions, and elevate permission only when the user intent requires it. This reduces blast radius and makes auditing much clearer.","es":"La pregunta correcta no es qué puede acceder un conector, sino cuál es el conjunto mínimo de datos y acciones necesario para la tarea. Un conector de calendario que solo consulta disponibilidad no debería recibir permiso para borrar eventos. Separa lectura, escritura y acciones destructivas y eleva permisos solo cuando la intención del usuario lo requiera. Así se reduce el radio de impacto y la auditoría es más clara.","fr":"La bonne question n’est pas ce qu’un connecteur peut lire, mais le plus petit ensemble de données et d’actions nécessaire à la tâche. Un connecteur de calendrier qui ne fait que vérifier la disponibilité ne devrait pas pouvoir supprimer des événements. Séparez lecture, écriture et actions destructrices, puis n’élevez les droits que lorsque l’intention de l’utilisateur l’exige. Le rayon d’impact et l’audit deviennent plus simples."},{"pt":"No runtime, registre qual conector foi usado, quais campos foram lidos e qual ação externa foi solicitada. Dados irrelevantes não devem ser copiados para prompts, memória ou logs apenas porque estavam disponíveis. O ganho é duplo: menos exposição e menos ruído contextual para o modelo.","en":"At runtime, record which connector was used, which fields were read, and which external action was requested. Irrelevant data should not be copied into prompts, memory, or logs merely because it was available. That produces both less exposure and less contextual noise for the model.","es":"En ejecución, registra qué conector se usó, qué campos se leyeron y qué acción externa se solicitó. Los datos irrelevantes no deben copiarse a prompts, memoria o logs solo porque estaban disponibles. El resultado es menos exposición y menos ruido contextual.","fr":"À l’exécution, consignez le connecteur utilisé, les champs lus et l’action externe demandée. Les données non pertinentes ne doivent pas être copiées dans les prompts, la mémoire ou les logs simplement parce qu’elles sont disponibles. On réduit à la fois l’exposition et le bruit contextuel."}]}],"lead":{"pt":"Mais acesso não significa automaticamente uma resposta melhor.","en":"More access does not automatically mean a better answer.","es":"Más acceso no significa automáticamente una respuesta mejor.","fr":"Plus d’accès ne signifie pas automatiquement une meilleure réponse."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"handoff-human-ai-keep-decisions-not-noise","date":"2026-09-04","read":1,"category":"projects","asset":"docs","title":{"pt":"Handoff entre pessoas e IA: preserve decisões, não ruído","en":"Human–AI handoff: preserve decisions, not noise","es":"Handoff entre personas e IA: conserva decisiones, no ruido","fr":"Handoff humain–IA : préserver les décisions, pas le bruit"},"dek":{"pt":"Um bom handoff permite continuar o trabalho sem reler a conversa inteira.","en":"A good handoff lets work continue without rereading the entire conversation.","es":"Un buen handoff permite continuar sin releer toda la conversación.","fr":"Un bon handoff permet de poursuivre le travail sans relire toute la conversation."},"body":[{"pt":"Quando um projeto passa de uma pessoa para outra, ou de uma sessão para outra, o valor não está em transportar cada mensagem. O valor está em transportar o estado atual, as decisões que ainda governam o trabalho, a evidência que as sustenta e os riscos que permanecem abertos.","en":"When a project moves between people or sessions, the value is not in carrying every message. It is in carrying current state, decisions that still govern the work, evidence supporting them, and open risks.","es":"Cuando un proyecto pasa de una persona a otra o de una sesión a otra, el valor no está en transportar cada mensaje, sino el estado, decisiones, evidencia y riesgos abiertos.","fr":"Lorsqu’un projet passe d’une personne ou d’une session à une autre, la valeur n’est pas de transporter chaque message, mais l’état, les décisions, les preuves et les risques ouverts."}],"blocks":[{"title":{"pt":"Estado atual antes da história","en":"Current state before history","es":"Estado actual antes de la historia","fr":"État actuel avant l’historique"},"body":[{"pt":"Comece pelo que existe agora: versão, arquivos, decisão ativa, bloqueio e último resultado verificado. História entra apenas quando explica uma restrição.","en":"Start with what exists now: version, files, active decision, blocker, and last verified result. History only enters when it explains a constraint.","es":"Empieza por lo que existe ahora: versión, archivos, decisión activa, bloqueo y último resultado verificado.","fr":"Commencez par ce qui existe maintenant : version, fichiers, décision active, blocage et dernier résultat vérifié."}]},{"title":{"pt":"Decisões com motivo curto","en":"Decisions with short rationale","es":"Decisiones con motivo breve","fr":"Décisions avec justification courte"},"body":[{"pt":"Registre “escolhemos X porque Y”, não uma transcrição do debate inteiro. Se Y mudar, fica claro qual decisão precisa ser reaberta.","en":"Record “we chose X because Y,” not the full debate transcript. If Y changes, it becomes clear which decision must be reopened.","es":"Registra “elegimos X por Y”, no toda la transcripción del debate.","fr":"Notez « nous avons choisi X parce que Y », pas toute la transcription du débat."}]},{"title":{"pt":"Evidência precisa ser reproduzível","en":"Evidence should be reproducible","es":"La evidencia debe ser reproducible","fr":"Les preuves doivent être reproductibles"},"body":[{"pt":"Inclua comando, arquivo, URL, teste ou dado que permita conferir o resultado. “Funcionou comigo” é memória; “teste X passou com saída Y” é evidência.","en":"Include the command, file, URL, test, or data that allows the result to be checked. “It worked for me” is memory; “test X passed with output Y” is evidence.","es":"Incluye comando, archivo, URL, prueba o dato que permita comprobar el resultado.","fr":"Incluez commande, fichier, URL, test ou donnée permettant de vérifier le résultat."}]},{"title":{"pt":"Próximo passo precisa caber em uma sessão","en":"The next step should fit in one session","es":"El siguiente paso debe caber en una sesión","fr":"La prochaine étape doit tenir dans une session"},"body":[{"pt":"Evite “terminar tudo”. Defina o próximo marco verificável. Isso reduz contexto, melhora estimativa e deixa claro quando o trabalho realmente avançou.","en":"Avoid “finish everything.” Define the next verifiable milestone. This reduces context, improves estimation, and makes progress observable.","es":"Evita “terminar todo”. Define el próximo hito verificable.","fr":"Évitez « tout finir ». Définissez le prochain jalon vérifiable."}]},{"title":{"pt":"O que precisa sobreviver à troca de pessoa ou modelo","en":"What must survive a handoff","es":"Qué debe sobrevivir al relevo","fr":"Ce qui doit survivre au relais"},"body":[{"pt":"Um bom handoff não é uma transcrição da sessão. Ele preserva o estado do trabalho: decisão tomada, motivo, evidência usada, restrições, pendências e o próximo ponto de verificação. Se outra pessoa ou outro modelo precisar reler vinte páginas para descobrir o que já foi decidido, o registro falhou. Prefira um resumo operacional curto ligado às fontes originais. Separe fatos de hipóteses e marque o que ainda depende de confirmação. Isso reduz retrabalho sem transformar o histórico inteiro em contexto permanente.","en":"A good handoff is not a transcript. It preserves the state of the work: decisions, rationale, evidence, constraints, open questions, and the next verification point. If another person or model must reread twenty pages to discover what was already decided, the handoff failed. Keep a compact operational record linked to the original evidence, separate facts from hypotheses, and mark what still requires confirmation.","es":"Un buen relevo no es una transcripción. Conserva el estado del trabajo: decisiones, motivos, evidencia, restricciones, pendientes y el próximo punto de verificación. Si otra persona o modelo debe releer veinte páginas para descubrir lo ya decidido, el relevo falló. Mantén un registro operativo breve enlazado con las fuentes, separa hechos de hipótesis y marca lo que aún requiere confirmación.","fr":"Un bon relais n’est pas une transcription. Il conserve l’état du travail : décisions, raisons, preuves, contraintes, questions ouvertes et prochain point de vérification. Si une autre personne ou un autre modèle doit relire vingt pages pour retrouver une décision, le relais a échoué. Gardez un relevé opérationnel court lié aux sources, séparez faits et hypothèses et marquez ce qui reste à confirmer."},{"pt":"Também registre o que foi descartado quando isso evita repetir uma investigação cara. Não é necessário guardar cada tentativa, apenas as alternativas relevantes e o motivo de rejeição. Para projetos longos, um handoff útil deve ser atualizado quando uma decisão muda, em vez de ganhar uma nova camada contraditória. O objetivo é continuidade, não volume.","en":"Also record rejected alternatives when doing so prevents an expensive investigation from being repeated. You do not need every attempt, only the relevant alternatives and why they were rejected. On long projects, update the handoff when a decision changes instead of adding a contradictory layer. The goal is continuity, not volume.","es":"Registra también las alternativas descartadas cuando eso evita repetir una investigación costosa. No hace falta guardar cada intento, solo las alternativas relevantes y por qué se rechazaron. En proyectos largos, actualiza el relevo cuando cambie una decisión en vez de añadir una capa contradictoria. El objetivo es continuidad, no volumen.","fr":"Consignez aussi les alternatives écartées lorsque cela évite de répéter une recherche coûteuse. Inutile de garder chaque tentative : seulement les options pertinentes et la raison du rejet. Dans un projet long, mettez le relais à jour lorsqu’une décision change au lieu d’ajouter une couche contradictoire. Le but est la continuité, pas le volume."}]}],"lead":{"pt":"Um bom handoff permite continuar o trabalho sem reler a conversa inteira.","en":"A good handoff lets work continue without rereading the entire conversation.","es":"Un buen handoff permite continuar sin releer toda la conversación.","fr":"Un bon handoff permet de poursuivre le travail sans relire toute la conversation."},"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2},"updated":"2026-09-08"},{"slug":"thesis2-context-ledger-proof-harness","date":"2026-09-03","read":2,"category":"models","asset":"modelGraph","title":{"pt":"Thesis 2: o contexto virou um ledger de evidências, não um histórico infinito","en":"Thesis 2: context became an evidence ledger, not an infinite transcript","es":"Thesis 2: el contexto se convirtió en un ledger de evidencia, no en un historial infinito","fr":"Thesis 2 : le contexte devient un registre de preuves, pas un historique infini"},"dek":{"pt":"O runtime separa missão, restrições, evidência recente, contratos e estado de execução para reduzir context rot e preservar o que realmente governa a tarefa.","en":"The runtime separates mission, constraints, recent evidence, contracts, and execution state to reduce context rot and preserve what actually governs the task.","es":"El runtime separa misión, restricciones, evidencia reciente, contratos y estado de ejecución para reducir el context rot.","fr":"Le runtime sépare mission, contraintes, preuves récentes, contrats et état d’exécution afin de réduire la dérive du contexte."},"body":[{"pt":"Contexto grande não é contexto bom. Em tarefas longas, repetir toda a conversa aumenta ruído, desloca requisitos importantes e faz o modelo otimizar para trechos que já perderam valor. O Thesis 2 passa a compilar contexto por relevância operacional: missão, restrições explícitas, evidência de runtime, estado recente e artefatos de handoff.","en":"Large context is not automatically good context. In long tasks, replaying the whole conversation adds noise, displaces important requirements, and makes the model optimize for stale material. Thesis 2 compiles context around operational relevance: mission, explicit constraints, runtime evidence, recent state, and handoff artifacts.","es":"Un contexto grande no es necesariamente un buen contexto. Thesis 2 compila misión, restricciones explícitas, evidencia de runtime, estado reciente y artefactos de handoff.","fr":"Un grand contexte n’est pas forcément un bon contexte. Thesis 2 compile mission, contraintes explicites, preuves runtime, état récent et artefacts de handoff."}],"blocks":[{"title":{"pt":"Missão e restrições ficam fixas","en":"Mission and constraints stay pinned","es":"Misión y restricciones quedan fijadas","fr":"Mission et contraintes restent épinglées"},"body":[{"pt":"O primeiro nível do ledger guarda o objetivo do usuário e regras que não podem ser “resumidas para fora”: formato de entrega, comportamento que deve ser preservado, limites de segurança, rotas públicas, compatibilidade e critérios de aceitação.","en":"The first ledger layer keeps the user objective and rules that must not be summarized away: delivery format, behavior to preserve, security limits, public routes, compatibility, and acceptance criteria.","es":"La primera capa guarda el objetivo y reglas que no deben perderse al resumir.","fr":"La première couche conserve l’objectif et les règles qui ne doivent pas disparaître lors du résumé."}]},{"title":{"pt":"Evidência tem precedência sobre memória","en":"Evidence outranks recollection","es":"La evidencia tiene prioridad sobre la memoria","fr":"La preuve prime sur le souvenir"},"body":[{"pt":"Logs, respostas HTTP, resultados de testes, conteúdo de arquivos e screenshots são classificados como evidência. Uma hipótese do modelo pode orientar a próxima verificação, mas não substitui um resultado observado.","en":"Logs, HTTP responses, test results, file contents, and screenshots are classified as evidence. A model hypothesis may guide the next check, but it does not replace an observed result.","es":"Logs, respuestas HTTP, tests, archivos y screenshots se tratan como evidencia; una hipótesis no reemplaza un resultado observado.","fr":"Logs, réponses HTTP, tests, fichiers et captures sont des preuves ; une hypothèse ne remplace pas un résultat observé."}]},{"title":{"pt":"Compaction não é amnésia","en":"Compaction is not amnesia","es":"Compaction no es amnesia","fr":"La compaction n’est pas une amnésie"},"body":[{"pt":"Quando o contexto cresce, o runtime preserva decisões, invariantes, falhas abertas e o melhor artefato atual, enquanto remove repetição e raciocínio já consumido. O objetivo é manter continuidade sem carregar um diário inteiro a cada chamada.","en":"As context grows, the runtime preserves decisions, invariants, open failures, and the best current artifact while removing repetition and already-consumed reasoning. The goal is continuity without carrying a full diary into every call.","es":"Al crecer el contexto, se preservan decisiones, invariantes, fallos abiertos y el mejor artefacto actual, eliminando repetición.","fr":"Quand le contexte grandit, le runtime conserve décisions, invariants, défauts ouverts et meilleur artefact, tout en supprimant les répétitions."}]},{"title":{"pt":"Context reset é diferente de resumo","en":"A context reset is different from a summary","es":"Un context reset es distinto de un resumen","fr":"Un reset de contexte diffère d’un résumé"},"body":[{"pt":"Tarefas de muitas horas ou dias podem mudar de sessão. O handoff não tenta imitar toda a mente anterior; ele entrega estado verificável, próximos marcos, arquivos relevantes e riscos abertos para que uma sessão nova continue sem herdar entropia desnecessária.","en":"Multi-hour or multi-day tasks may cross sessions. The handoff does not try to recreate the previous mind; it carries verifiable state, next milestones, relevant files, and open risks so a fresh session can continue without inheriting unnecessary entropy.","es":"Las tareas largas pueden cambiar de sesión; el handoff lleva estado verificable, próximos hitos, archivos y riesgos abiertos.","fr":"Les tâches longues peuvent changer de session ; le handoff transporte état vérifiable, prochains jalons, fichiers et risques ouverts."}]},{"title":{"pt":"Prefixos estáveis reduzem custo","en":"Stable prefixes reduce cost","es":"Los prefijos estables reducen coste","fr":"Les préfixes stables réduisent le coût"},"body":[{"pt":"Políticas de runtime e contratos duráveis ficam em uma zona estável do prompt. Evidência nova entra depois. Além de melhorar legibilidade para o modelo, isso evita reconstruir instruções gigantes a cada etapa e favorece mecanismos de cache quando o provedor os suporta.","en":"Runtime policies and durable contracts stay in a stable prompt region while fresh evidence is appended later. This improves model legibility, avoids rebuilding giant instructions on every step, and supports prompt caching when the provider offers it.","es":"Las políticas estables quedan al principio y la evidencia nueva se añade después, reduciendo reconstrucción de contexto.","fr":"Les politiques stables restent au début et les nouvelles preuves sont ajoutées ensuite, réduisant la reconstruction du contexte."}]},{"title":{"pt":"O ledger também registra dívida de evidência","en":"The ledger also tracks evidence debt","es":"El ledger también registra deuda de evidencia","fr":"Le registre suit aussi la dette de preuve"},"body":[{"pt":"Uma resposta pode estar semanticamente convincente e ainda ter dívida alta: teste não executado, rota não aberta, screenshot não comparado, contrato de auth não confirmado. Essa dívida controla se o Thesis 2 deve encerrar, reparar ou gastar mais compute.","en":"An answer may sound convincing and still carry high debt: a test was not run, a route was not opened, a screenshot was not compared, or an auth contract was not confirmed. That debt controls whether Thesis 2 stops, repairs, or spends more compute.","es":"Una respuesta puede sonar convincente y mantener deuda alta de evidencia; esa deuda decide si terminar, reparar o gastar más cómputo.","fr":"Une réponse peut sembler convaincante tout en gardant une dette de preuve élevée ; cette dette décide s’il faut arrêter, réparer ou dépenser plus de calcul."}]},{"title":{"pt":"O resultado esperado","en":"Expected outcome","es":"Resultado esperado","fr":"Résultat attendu"},"body":[{"pt":"A meta não é “lembrar tudo”. É manter acessível aquilo que ainda pode mudar a decisão. Em tarefas de código isso significa contratos e regressões; em design, referências e proporções; em pesquisa, fontes e recência; em long-run, checkpoint e estado de verificação.","en":"The goal is not to remember everything. It is to keep accessible what can still change the decision. In code that means contracts and regressions; in design, references and proportions; in research, sources and freshness; in long-running work, checkpoints and verification state.","es":"La meta no es recordarlo todo, sino mantener accesible lo que todavía puede cambiar la decisión.","fr":"Le but n’est pas de tout mémoriser, mais de garder accessible ce qui peut encore modifier la décision."}]}],"lead":{"pt":"O runtime separa missão, restrições, evidência recente, contratos e estado de execução para reduzir context rot e preservar o que realmente governa a tarefa.","en":"The runtime separates mission, constraints, recent evidence, contracts, and execution state to reduce context rot and preserve what actually governs the task.","es":"El runtime separa misión, restricciones, evidencia reciente, contratos y estado de ejecución para reducir el context rot.","fr":"Le runtime sépare mission, contraintes, preuves récentes, contrats et état d’exécution afin de réduire la dérive du contexte."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"thesis2-adaptive-test-time-compute","date":"2026-09-03","read":2,"category":"models","asset":"barChart","title":{"pt":"Thesis 2: gastar compute onde a incerteza está, não em toda mensagem","en":"Thesis 2: spend compute where uncertainty lives, not on every message","es":"Thesis 2: gastar cómputo donde está la incertidumbre, no en cada mensaje","fr":"Thesis 2 : dépenser le calcul là où se trouve l’incertitude, pas sur chaque message"},"dek":{"pt":"A arquitetura de test-time compute deixa de ser “Max = mais texto” e passa a decidir quando planejar, validar, reparar, comparar candidatos ou simplesmente parar.","en":"The test-time compute architecture stops treating “Max” as “more text” and instead decides when to plan, validate, repair, compare candidates, or simply stop.","es":"La arquitectura de test-time compute deja de tratar Max como “más texto” y decide cuándo planificar, validar, reparar, comparar candidatos o detenerse.","fr":"L’architecture de test-time compute cesse de traiter Max comme « plus de texte » et décide quand planifier, valider, réparer, comparer ou s’arrêter."},"body":[{"pt":"A forma mais fácil de encarecer um agente é repetir geração e avaliação em todas as tarefas. Thesis 2 usa escalonamento seletivo: uma trajetória forte primeiro, checks determinísticos depois e compute extra somente quando a evidência indica risco, ambiguidade ou desacordo entre avaliadores.","en":"The easiest way to make an agent expensive is to repeat generation and evaluation on every task. Thesis 2 uses selective escalation: one strong trajectory first, deterministic checks next, and extra compute only when evidence indicates risk, ambiguity, or evaluator disagreement.","es":"La forma más fácil de encarecer un agente es repetir generación y evaluación siempre. Thesis 2 usa escalado selectivo.","fr":"La façon la plus simple de rendre un agent coûteux est de répéter génération et évaluation partout. Thesis 2 utilise une escalade sélective."}],"blocks":[{"title":{"pt":"Trajetória única por padrão","en":"Single trajectory by default","es":"Trayectoria única por defecto","fr":"Une trajectoire par défaut"},"body":[{"pt":"Low e Medium priorizam uma geração direta. High adiciona verificação quando a tarefa possui risco material. Extra e Max liberam mais etapas, mas ainda obedecem a um orçamento de geração e avaliação.","en":"Low and Medium prioritize a direct generation. High adds verification when the task carries material risk. Extra and Max unlock more stages, but still obey generation and evaluation budgets.","es":"Low y Medium priorizan generación directa; High añade verificación ante riesgo; Extra y Max amplían etapas con presupuesto.","fr":"Low et Medium privilégient une génération directe ; High ajoute la vérification selon le risque ; Extra et Max étendent les étapes avec budget."}]},{"title":{"pt":"Determinístico antes de probabilístico","en":"Deterministic before probabilistic","es":"Determinista antes que probabilístico","fr":"Déterministe avant probabiliste"},"body":[{"pt":"Parser, typecheck, build, testes, contratos de rota e validações estruturais são mais baratos e reproduzíveis que pedir a outro modelo para “achar bugs”. O juiz semântico entra quando o defeito exige interpretação, segurança, arquitetura ou qualidade de produto.","en":"Parsing, type checking, builds, tests, route contracts, and structural validation are cheaper and more reproducible than asking another model to “find bugs.” A semantic judge is used when the defect requires interpretation, security, architecture, or product-quality judgment.","es":"Parser, typecheck, build, tests y contratos son más baratos y reproducibles que un juez de modelo.","fr":"Parser, typecheck, build, tests et contrats sont moins chers et plus reproductibles qu’un juge modèle."}]},{"title":{"pt":"Dívida de evidência controla o próximo passo","en":"Evidence debt controls the next step","es":"La deuda de evidencia controla el siguiente paso","fr":"La dette de preuve contrôle l’étape suivante"},"body":[{"pt":"Cada falha observada aumenta dívida. Cada gate realmente limpo reduz dívida. O runtime não usa “sensação de qualidade” como sinal de parada; ele observa se ainda existem requisitos não cobertos, defeitos determinísticos ou verificações críticas indisponíveis.","en":"Each observed failure increases debt and each genuinely cleared gate reduces it. The runtime does not use a “feeling of quality” as the stop signal; it looks for uncovered requirements, deterministic defects, and unavailable critical verification.","es":"Cada fallo aumenta deuda y cada gate limpio la reduce; el runtime no se detiene por una sensación subjetiva de calidad.","fr":"Chaque défaut augmente la dette et chaque gate réellement validé la réduit ; le runtime ne s’arrête pas sur une simple impression de qualité."}]},{"title":{"pt":"Repair antes de resample","en":"Repair before resampling","es":"Repair antes de resample","fr":"Réparation avant resampling"},"body":[{"pt":"Se um candidato está quase correto, a próxima chamada recebe o candidato e findings objetivos. Recomeçar do zero só faz sentido quando a arquitetura ou a composição inteira é o defeito. Isso reduz regressão e custo.","en":"If a candidate is nearly correct, the next call receives that candidate and objective findings. Starting over only makes sense when the architecture or whole composition is itself the defect. This reduces regression and cost.","es":"Si un candidato está casi correcto, se repara con findings objetivos; solo se reinicia si la arquitectura completa es el defecto.","fr":"Si un candidat est presque correct, il est réparé à partir de constats objectifs ; on ne repart de zéro que si l’architecture entière est fautive."}]},{"title":{"pt":"Divergência só quando há motivo","en":"Divergence only when justified","es":"Divergencia solo cuando hay motivo","fr":"Divergence seulement si elle est justifiée"},"body":[{"pt":"Uma segunda solução independente é cara. Thesis 2 só abre um branch divergente quando há ambiguidade real, tarefa subjetiva difícil ou desacordo relevante entre avaliadores. Depois, um verificador listwise compara candidatos sob os mesmos critérios.","en":"A second independent solution is expensive. Thesis 2 opens a divergent branch only when there is genuine ambiguity, difficult subjective work, or meaningful evaluator disagreement. A listwise verifier then compares candidates under the same criteria.","es":"Una segunda solución solo se genera ante ambigüedad, subjetividad difícil o desacuerdo real entre evaluadores.","fr":"Une seconde solution n’est générée qu’en cas d’ambiguïté réelle, de subjectivité difficile ou de désaccord significatif entre évaluateurs."}]},{"title":{"pt":"Quota também é um sinal de controle","en":"Quota is also a control signal","es":"La cuota también es una señal de control","fr":"Le quota est aussi un signal de contrôle"},"body":[{"pt":"Se a janela de uso está perto do limite, o harness reduz branching e avaliações opcionais antes de sacrificar a geração principal. Em vez de falhar no meio de um ritual de auto-crítica, preserva compute para entregar algo completo.","en":"When the usage window is near its ceiling, the harness reduces branching and optional evaluation before sacrificing the primary generation. Instead of failing halfway through a self-critique ritual, it preserves compute for a complete deliverable.","es":"Cerca del límite, el harness reduce branches y evaluaciones opcionales antes de sacrificar la generación principal.","fr":"Près de la limite, le harness réduit les branches et évaluations optionnelles avant de sacrifier la génération principale."}]},{"title":{"pt":"Por que isso diferencia o Thesis 2","en":"Why this differentiates Thesis 2","es":"Por qué esto diferencia a Thesis 2","fr":"Pourquoi cela différencie Thesis 2"},"body":[{"pt":"O diferencial não é declarar “raciocínio máximo”. É transformar custo em uma política: mais compute quando ele compra informação, menos compute quando o problema já está determinado por checks baratos.","en":"The differentiator is not declaring “maximum reasoning.” It is turning cost into policy: more compute when it buys information, less compute when cheap checks already determine the result.","es":"La diferencia no es declarar “razonamiento máximo”, sino convertir el coste en una política adaptativa.","fr":"La différence n’est pas de déclarer « raisonnement maximal », mais de transformer le coût en politique adaptative."}]}],"lead":{"pt":"A arquitetura de test-time compute deixa de ser “Max = mais texto” e passa a decidir quando planejar, validar, reparar, comparar candidatos ou simplesmente parar.","en":"The test-time compute architecture stops treating “Max” as “more text” and instead decides when to plan, validate, repair, compare candidates, or simply stop.","es":"La arquitectura de test-time compute deja de tratar Max como “más texto” y decide cuándo planificar, validar, reparar, comparar candidatos o detenerse.","fr":"L’architecture de test-time compute cesse de traiter Max comme « plus de texte » et décide quand planifier, valider, réparer, comparer ou s’arrêter."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":2}},{"slug":"thesis2-durable-long-horizon-runtime","date":"2026-09-03","read":2,"category":"engineering","asset":"memoryBraces","title":{"pt":"Thesis 2 por horas ou dias: trabalho durável precisa sobreviver ao próprio processo","en":"Thesis 2 for hours or days: durable work must survive its own process","es":"Thesis 2 durante horas o días: el trabajo duradero debe sobrevivir a su propio proceso","fr":"Thesis 2 pendant des heures ou des jours : le travail durable doit survivre à son propre processus"},"dek":{"pt":"Long-run não significa manter uma função aberta eternamente. Significa estado externo, checkpoints idempotentes, leases, retomada e handoff entre sessões independentes.","en":"Long-running does not mean keeping one function open forever. It means external state, idempotent checkpoints, leases, resumption, and handoffs across independent sessions.","es":"Long-run no significa mantener una función abierta eternamente: significa estado externo, checkpoints idempotentes, leases y reanudación.","fr":"Long-run ne signifie pas garder une fonction ouverte indéfiniment : il faut état externe, checkpoints idempotents, leases et reprise."},"body":[{"pt":"Uma tarefa de dois dias não pode depender da memória de um único processo. O Thesis 2 divide trabalho longo em sessões limitadas, grava progresso antes de continuar e trata cada retomada como uma operação reentrante. Se o runtime reiniciar, o estado importante continua fora dele.","en":"A two-day task cannot depend on the memory of one process. Thesis 2 splits long work into bounded sessions, persists progress before continuing, and treats every resume as reentrant. If the runtime restarts, important state lives outside it.","es":"Una tarea de dos días no puede depender de un proceso único. Thesis 2 divide el trabajo en sesiones limitadas y persiste el progreso.","fr":"Une tâche de deux jours ne peut dépendre d’un seul processus. Thesis 2 la divise en sessions limitées et persiste le progrès."}],"blocks":[{"title":{"pt":"Sessões discretas, missão contínua","en":"Discrete sessions, continuous mission","es":"Sesiones discretas, misión continua","fr":"Sessions discrètes, mission continue"},"body":[{"pt":"Cada sessão recebe missão, checkpoint, melhor artefato atual, próximos marcos e falhas abertas. Ela não precisa carregar todas as mensagens anteriores para entender o que ainda falta.","en":"Each session receives the mission, checkpoint, current best artifact, next milestones, and open failures. It does not need the full previous transcript to understand what remains.","es":"Cada sesión recibe misión, checkpoint, mejor artefacto, próximos hitos y fallos abiertos.","fr":"Chaque session reçoit mission, checkpoint, meilleur artefact, prochains jalons et défauts ouverts."}]},{"title":{"pt":"Checkpoint antes do próximo salto","en":"Checkpoint before the next hop","es":"Checkpoint antes del siguiente salto","fr":"Checkpoint avant le saut suivant"},"body":[{"pt":"A sequência correta é produzir, validar, persistir e só então agendar a continuação. Disparar a próxima etapa antes de salvar estado cria uma janela em que uma queda perde progresso ou duplica trabalho.","en":"The correct order is produce, validate, persist, and only then schedule the continuation. Triggering the next stage before saving state creates a window where a failure can lose progress or duplicate work.","es":"El orden correcto es producir, validar, persistir y solo después continuar.","fr":"L’ordre correct est produire, valider, persister puis seulement planifier la suite."}]},{"title":{"pt":"Leases impedem dois agentes de assumir o mesmo turno","en":"Leases prevent two agents from taking the same turn","es":"Los leases evitan dos agentes en el mismo turno","fr":"Les leases empêchent deux agents de prendre le même tour"},"body":[{"pt":"Uma atualização condicional do job funciona como lease. Se dois workers acordarem juntos, apenas um adquire a versão atual do estado. O outro deve sair sem produzir uma segunda resposta concorrente.","en":"A conditional job update acts as a lease. If two workers wake at the same time, only one acquires the current state version; the other exits without producing a competing answer.","es":"Una actualización condicional funciona como lease y evita dos workers escribiendo el mismo estado.","fr":"Une mise à jour conditionnelle agit comme lease et évite que deux workers écrivent le même état."}]},{"title":{"pt":"Falha transitória não é falha terminal","en":"Transient failure is not terminal failure","es":"Un fallo transitorio no es terminal","fr":"Une panne transitoire n’est pas terminale"},"body":[{"pt":"Rate limit de provedor, timeout ou indisponibilidade temporária entram como estado pausado/retryable. Auth inválida, restrição da conta ou orçamento encerrado têm semântica diferente. Misturar essas classes é como transformar “tente depois” em “o projeto morreu”.","en":"Provider rate limits, timeouts, or temporary unavailability become paused/retryable state. Invalid auth, account restrictions, or exhausted user budget have different semantics. Mixing them turns “try later” into “the project died.”","es":"Rate limit, timeout y fallos temporales deben pausar/reintentar; auth y límites del usuario son clases distintas.","fr":"Rate limit, timeout et indisponibilité temporaire doivent être repris ; auth et limites utilisateur sont des classes différentes."}]},{"title":{"pt":"Initializer, builder e evaluator não fazem a mesma coisa","en":"Initializer, builder, and evaluator do not do the same job","es":"Initializer, builder y evaluator no hacen lo mismo","fr":"Initializer, builder et evaluator n’ont pas le même rôle"},"body":[{"pt":"O primeiro turno estabelece mapa de milestones e critérios. Turnos de builder executam o próximo pedaço verificável. Periodicamente, um evaluator-integration pass procura deriva, dívida de teste e incompatibilidades entre partes antes de continuar construindo.","en":"The first turn establishes milestones and criteria. Builder turns execute the next verifiable chunk. Periodically, an evaluator-integration pass looks for drift, test debt, and incompatibilities before more building.","es":"El primer turno define hitos; los builders ejecutan; un evaluator periódico busca drift y deuda de verificación.","fr":"Le premier tour définit les jalons ; les builders exécutent ; un evaluator périodique cherche dérive et dette de vérification."}]},{"title":{"pt":"Handoff factual, não diário de raciocínio","en":"Factual handoff, not a reasoning diary","es":"Handoff factual, no diario de razonamiento","fr":"Handoff factuel, pas journal de raisonnement"},"body":[{"pt":"O checkpoint carrega decisões e evidência necessária, não uma tentativa de serializar pensamento privado. Isso o torna menor, mais estável e mais útil para uma sessão nova.","en":"The checkpoint carries decisions and necessary evidence rather than attempting to serialize private reasoning. That makes it smaller, more stable, and more useful to a fresh session.","es":"El checkpoint conserva decisiones y evidencia necesaria, no un diario del razonamiento.","fr":"Le checkpoint conserve décisions et preuves nécessaires, pas un journal du raisonnement."}]},{"title":{"pt":"Critério de término","en":"Termination criterion","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"“Tempo acabou” não é conclusão. O job termina quando a entrega está completa e o melhor gate de verificação disponível passou, ou quando existe uma condição explícita de pausa/falha que pode ser mostrada ao usuário sem fingir sucesso.","en":"“Time ran out” is not completion. A job finishes when the deliverable is complete and the strongest available verification gate has passed, or when an explicit pause/failure condition can be surfaced without pretending success.","es":"“Se acabó el tiempo” no es completar; el job termina con entrega completa y gate de verificación, o con pausa/fallo explícito.","fr":"« Le temps est écoulé » n’est pas une fin ; le job se termine avec une livraison complète et un gate de vérification, ou une pause/erreur explicite."}]}],"lead":{"pt":"Long-run não significa manter uma função aberta eternamente. Significa estado externo, checkpoints idempotentes, leases, retomada e handoff entre sessões independentes.","en":"Long-running does not mean keeping one function open forever. It means external state, idempotent checkpoints, leases, resumption, and handoffs across independent sessions.","es":"Long-run no significa mantener una función abierta eternamente: significa estado externo, checkpoints idempotentes, leases y reanudación.","fr":"Long-run ne signifie pas garder une fonction ouverte indéfiniment : il faut état externe, checkpoints idempotents, leases et reprise."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"thesis2-gpt-oss-120b-moe-harness","date":"2026-09-03","read":2,"category":"models","asset":"modelPaper","title":{"pt":"Thesis 2 sobre GPT-OSS 120B: o MoE está no modelo; a inteligência extra está no harness","en":"Thesis 2 on GPT-OSS 120B: MoE lives in the model; the extra intelligence lives in the harness","es":"Thesis 2 sobre GPT-OSS 120B: el MoE vive en el modelo; la inteligencia extra vive en el harness","fr":"Thesis 2 sur GPT-OSS 120B : le MoE vit dans le modèle ; l’intelligence supplémentaire vit dans le harness"},"dek":{"pt":"117 bilhões de parâmetros totais não significam 117 bilhões ativos por token. O design do Thesis 2 parte dessa diferença e usa orquestração externa seletiva, não uma fantasia de “escolher experts” no JavaScript.","en":"117 billion total parameters do not mean 117 billion active per token. Thesis 2 starts from that distinction and uses selective external orchestration rather than pretending JavaScript can “choose experts.”","es":"117 mil millones de parámetros totales no significan 117 mil millones activos por token; Thesis 2 usa orquestación externa selectiva.","fr":"117 milliards de paramètres totaux ne signifient pas 117 milliards actifs par token ; Thesis 2 utilise une orchestration externe sélective."},"body":[{"pt":"GPT-OSS 120B é um Mixture-of-Experts com 117B parâmetros totais, cerca de 5,1B ativos por token, 128 experts e top-4 selecionados por token, além de contexto nativo de 128k. O roteamento dos experts acontece dentro do próprio modelo. O Thesis 2 não tenta falsificar esse controle; ele trabalha uma camada acima.","en":"GPT-OSS 120B is a Mixture-of-Experts model with 117B total parameters, about 5.1B active per token, 128 experts, top-4 routing per token, and a native 128k context. Expert routing happens inside the model. Thesis 2 does not fake direct control over it; it operates one layer above.","es":"GPT-OSS 120B es MoE con 117B parámetros totales, 5,1B activos por token, 128 experts, top-4 y contexto 128k. El routing ocurre dentro del modelo.","fr":"GPT-OSS 120B est un MoE de 117B paramètres totaux, environ 5,1B actifs par token, 128 experts, top-4 et contexte 128k. Le routage se fait dans le modèle."}],"blocks":[{"title":{"pt":"Sparsidade interna, seletividade externa","en":"Internal sparsity, external selectivity","es":"Sparsidad interna, selectividad externa","fr":"Sparsité interne, sélectivité externe"},"body":[{"pt":"O MoE economiza compute dentro da inferência. O harness economiza compute fora dela: decide quando buscar na web, abrir verificador de código, rodar análise visual, fazer preflight, reparar ou gerar um segundo candidato.","en":"MoE saves compute inside inference. The harness saves compute around inference by deciding when to search the web, call a code verifier, run visual analysis, preflight, repair, or generate a second candidate.","es":"El MoE ahorra cómputo dentro de la inferencia; el harness decide cuándo usar herramientas, verificación, repair o un segundo candidato.","fr":"Le MoE économise le calcul dans l’inférence ; le harness décide quand utiliser outils, vérification, repair ou second candidat."}]},{"title":{"pt":"O contexto de 128k continua sendo escasso","en":"A 128k context is still scarce","es":"Un contexto de 128k sigue siendo escaso","fr":"Un contexte de 128k reste rare"},"body":[{"pt":"Um monorepo, histórico de chat, documentação, logs e screenshots podem ultrapassar 128k rapidamente. Por isso o runtime usa compilação de contexto e artifacts de handoff em vez de empilhar tudo até o attention map virar um depósito.","en":"A monorepo, chat history, documentation, logs, and screenshots can exceed 128k quickly. The runtime therefore compiles context and uses handoff artifacts instead of stacking everything until attention becomes a storage closet.","es":"Monorepo, chat, docs, logs y screenshots pueden superar 128k rápidamente; por eso se compila contexto.","fr":"Monorepo, historique, docs, logs et captures peuvent dépasser 128k rapidement ; le contexte doit donc être compilé."}]},{"title":{"pt":"Esforço de raciocínio é uma alavanca real","en":"Reasoning effort is a real lever","es":"El esfuerzo de razonamiento es una palanca real","fr":"L’effort de raisonnement est un vrai levier"},"body":[{"pt":"GPT-OSS foi pós-treinado para níveis de esforço. Thesis 2 usa isso junto com gates externos: Low/Medium não carregam o custo de Max, enquanto Extra/Max podem comprar mais planejamento e verificação quando o perfil da tarefa justifica.","en":"GPT-OSS was post-trained for different reasoning-effort levels. Thesis 2 combines that with external gates: Low/Medium do not pay Max costs, while Extra/Max can buy more planning and verification when task risk justifies it.","es":"GPT-OSS admite niveles de esfuerzo; Thesis 2 los combina con gates externos para no pagar Max en tareas simples.","fr":"GPT-OSS prend en charge plusieurs niveaux d’effort ; Thesis 2 les combine avec des gates externes pour ne pas payer Max sur les tâches simples."}]},{"title":{"pt":"Especialização sem trocar o foundation model","en":"Specialization without swapping the foundation model","es":"Especialización sin cambiar el foundation model","fr":"Spécialisation sans changer le foundation model"},"body":[{"pt":"Código, UI, PBR, arquitetura e pesquisa recebem políticas, ferramentas e critérios diferentes, mas o gerador primário continua sendo o mesmo foundation model. Isso evita uma identidade em que “Thesis 2” vira apenas um nome sobre modelos diferentes a cada rota.","en":"Code, UI, PBR, architecture, and research receive different policies, tools, and criteria while the primary generator remains the same foundation model. This avoids an identity where “Thesis 2” is merely a label over unrelated models per route.","es":"Código, UI, PBR, arquitectura e investigación reciben políticas distintas manteniendo el mismo generador primario.","fr":"Code, UI, PBR, architecture et recherche reçoivent des politiques différentes tout en gardant le même générateur principal."}]},{"title":{"pt":"Verificação é um sistema separado","en":"Verification is a separate system","es":"La verificación es un sistema separado","fr":"La vérification est un système séparé"},"body":[{"pt":"O gerador não deve dar a nota para o próprio trabalho e encerrar. Thesis 2 usa checks determinísticos e, quando necessário, avaliadores independentes. Se um verificador estiver indisponível, isso vira estado de qualidade degradada em vez de um “passou” inventado.","en":"The generator should not grade its own work and declare victory. Thesis 2 uses deterministic checks and, when needed, independent evaluators. If a verifier is unavailable, that becomes degraded-quality state rather than an invented pass.","es":"El generador no debe calificarse a sí mismo; si un verificador no está disponible, eso se registra como calidad degradada.","fr":"Le générateur ne doit pas s’auto-noter ; si un vérificateur est indisponible, cela devient un état de qualité dégradée."}]},{"title":{"pt":"Mais agentes não significa automaticamente mais inteligência","en":"More agents do not automatically mean more intelligence","es":"Más agentes no significa automáticamente más inteligencia","fr":"Plus d’agents ne signifie pas automatiquement plus d’intelligence"},"body":[{"pt":"Times paralelos podem expandir busca, mas também multiplicam custo, conflito e integração. Thesis 2 prefere uma trajetória, repair e branching condicionado a desacordo. Paralelismo vira ferramenta excepcional, não decoração arquitetural.","en":"Parallel teams can expand search, but they also multiply cost, conflict, and integration work. Thesis 2 prefers one trajectory, repair, and disagreement-triggered branching. Parallelism is an exceptional tool, not architectural decoration.","es":"Los equipos paralelos amplían búsqueda pero multiplican coste y conflictos; Thesis 2 los usa solo cuando aportan señal.","fr":"Les équipes parallèles élargissent la recherche mais multiplient coût et conflits ; Thesis 2 ne les utilise que lorsqu’elles apportent du signal."}]},{"title":{"pt":"O que o harness pode e não pode fazer","en":"What the harness can and cannot do","es":"Qué puede y qué no puede hacer el harness","fr":"Ce que le harness peut et ne peut pas faire"},"body":[{"pt":"Harness engineering pode melhorar enormemente desempenho efetivo, consistência e custo. Ele não transforma magicamente 5,1B parâmetros ativos em outro foundation model. O ganho vem de contexto melhor, ferramentas melhores, compute melhor alocado e critérios de saída mais fortes.","en":"Harness engineering can materially improve effective capability, consistency, and cost. It does not magically turn 5.1B active parameters into a different foundation model. Gains come from better context, better tools, better compute allocation, and stronger exit criteria.","es":"El harness puede mejorar capacidad efectiva y coste, pero no convierte mágicamente 5,1B parámetros activos en otro foundation model.","fr":"Le harness peut améliorer fortement la capacité effective et le coût, mais il ne transforme pas magiquement 5,1B paramètres actifs en un autre foundation model."}]}],"lead":{"pt":"117 bilhões de parâmetros totais não significam 117 bilhões ativos por token. O design do Thesis 2 parte dessa diferença e usa orquestração externa seletiva, não uma fantasia de “escolher experts” no JavaScript.","en":"117 billion total parameters do not mean 117 billion active per token. Thesis 2 starts from that distinction and uses selective external orchestration rather than pretending JavaScript can “choose experts.”","es":"117 mil millones de parámetros totales no significan 117 mil millones activos por token; Thesis 2 usa orquestación externa selectiva.","fr":"117 milliards de paramètres totaux ne signifient pas 117 milliards actifs par token ; Thesis 2 utilise une orchestration externe sélective."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":2}},{"slug":"thesis2-domain-mastery-v3","date":"2 de setembro de 2026","read":2,"category":"models","asset":"modelGraph","title":{"pt":"Thesis 2 v3: mais rigor onde o trabalho realmente quebra","en":"Thesis 2 v3: more rigor where work actually breaks","es":"Thesis 2 v3: más rigor donde el trabajo realmente falla","fr":"Thesis 2 v3 : plus de rigueur là où le travail casse réellement"},"dek":{"pt":"Visual, 3D, PBR, arquitetura e refinamento agora têm gates próprios em vez de compartilhar um único botão de “pensar mais”.","en":"Visual, 3D, PBR, architecture, and refinement now have their own gates instead of sharing one generic “think harder” switch.","es":"Visual, 3D, PBR, arquitectura y refinamiento tienen gates propios.","fr":"Visuel, 3D, PBR, architecture et raffinement disposent désormais de gates dédiés."},"body":[{"pt":"A melhoria mais importante do Thesis 2 v3 não é aumentar indiscriminadamente o número de passes. É reconhecer que falhas de UI, PBR e system design são classes diferentes e exigem critérios diferentes.","en":"The most important Thesis 2 v3 improvement is not indiscriminately increasing pass count. It is recognizing that UI, PBR, and system-design failures are different classes and require different criteria.","es":"La mejora principal no es aumentar pases, sino reconocer clases distintas de fallo.","fr":"L’amélioration principale n’est pas d’augmenter les passes mais de reconnaître des classes d’échec distinctes."}],"blocks":[{"title":{"pt":"Compute progressivo","en":"Progressive compute","es":"Compute progresivo","fr":"Calcul progressif"},"body":[{"pt":"Low e Medium permanecem diretos; High só escala quando os sinais do domínio justificam; Extra e Max podem acionar frontier validation e targeted repair.","en":"Low and Medium stay direct; High escalates only when domain signals justify it; Extra and Max may invoke frontier validation and targeted repair.","es":"Low y Medium siguen directos; High escala solo con señales de dominio; Extra/Max pueden activar frontier validation.","fr":"Low et Medium restent directs ; High escalade uniquement lorsque le domaine le justifie ; Extra/Max peuvent activer frontier validation."}],"bullets":[{"pt":"menos custo em tarefas simples","en":"lower cost on simple tasks","es":"menor costo en tareas simples","fr":"coût réduit sur les tâches simples"},{"pt":"mais rigor em fronteiras difíceis","en":"more rigor at difficult boundaries","es":"más rigor en fronteras difíciles","fr":"plus de rigueur aux frontières difficiles"}]},{"title":{"pt":"Repair seletivo","en":"Selective repair","es":"Repair selectivo","fr":"Repair sélectif"},"body":[{"pt":"Uma nova tentativa não vence por recência. Ela precisa preservar comportamento verificado e elevar a evidência; caso contrário, o checkpoint anterior continua sendo a melhor versão.","en":"A newer attempt does not win by recency. It must preserve verified behavior and improve evidence; otherwise the previous checkpoint remains the best version.","es":"Una nueva tentativa no gana por ser nueva: debe preservar comportamiento verificado y mejorar evidencia.","fr":"Une nouvelle tentative ne gagne pas par récence : elle doit préserver le comportement vérifié et améliorer la preuve."}]},{"title":{"pt":"Classificação por domínio antes do compute","en":"Domain classification before compute","es":"Clasificación por dominio antes del cómputo","fr":"Classification par domaine avant le calcul"},"body":[{"pt":"O runtime distingue código, UI, 3D, PBR, arquitetura, pesquisa e risco operacional antes de montar o harness. A especialização acontece nas políticas e verificadores, não trocando silenciosamente de foundation model.","en":"The runtime distinguishes code, UI, 3D, PBR, architecture, research, and operational risk before assembling the harness. Specialization lives in policies and verifiers, not in silently swapping the foundation model.","es":"El runtime distingue código, UI, 3D, PBR, arquitectura e investigación antes de montar el harness.","fr":"Le runtime distingue code, UI, 3D, PBR, architecture et recherche avant d’assembler le harness."}]},{"title":{"pt":"Anti-AI-slop como rubric observável","en":"Anti-AI-slop as an observable rubric","es":"Anti-AI-slop como rúbrica observable","fr":"Anti-AI-slop comme grille observable"},"body":[{"pt":"Em UI, “parece IA” é decomposto em padrões verificáveis: grids de cards com peso igual, excesso de pills, glass gratuito, hierarquia rasa, tipografia sem papéis, controles decorativos e spacing que não comunica estrutura.","en":"In UI, “looks AI-generated” is decomposed into observable patterns: equal-weight card grids, pill spam, gratuitous glass, shallow hierarchy, role-less typography, decorative controls, and spacing that does not communicate structure.","es":"En UI, “parece IA” se descompone en patrones observables como grids uniformes, pills y jerarquía pobre.","fr":"En UI, « ressemble à de l’IA » est décomposé en motifs observables : grilles uniformes, pills, hiérarchie faible et contrôles décoratifs."}]},{"title":{"pt":"Código: reachability antes de elegância","en":"Code: reachability before elegance","es":"Código: reachability antes que elegancia","fr":"Code : reachability avant élégance"},"body":[{"pt":"Uma solução que não inicia perde antes de qualquer debate arquitetural. O gate de código prioriza boot, sintaxe, contratos, segunda execução, cleanup, auth e persistência antes de aceitar refactors “bonitos”.","en":"A solution that does not start loses before any architecture debate. The code gate prioritizes boot, syntax, contracts, second-run behavior, cleanup, auth, and persistence before accepting “beautiful” refactors.","es":"Una solución que no inicia falla antes de cualquier debate arquitectónico.","fr":"Une solution qui ne démarre pas échoue avant tout débat architectural."}]},{"title":{"pt":"3D e PBR: coerência física e orçamento GPU","en":"3D and PBR: physical coherence and GPU budget","es":"3D y PBR: coherencia física y presupuesto GPU","fr":"3D et PBR : cohérence physique et budget GPU"},"body":[{"pt":"Materiais, luz, câmera, color pipeline e performance são avaliados juntos. Um highlight “bonito” não compensa roughness incoerente, textura no espaço de cor errado ou cena que explode draw calls.","en":"Materials, light, camera, color pipeline, and performance are evaluated together. A pretty highlight does not compensate for incoherent roughness, wrong texture color space, or a scene that explodes draw calls.","es":"Materiales, luz, cámara, color pipeline y performance se evalúan juntos.","fr":"Matériaux, lumière, caméra, color pipeline et performance sont évalués ensemble."}]},{"title":{"pt":"Arquitetura: ownership antes de abstração","en":"Architecture: ownership before abstraction","es":"Arquitectura: ownership antes que abstracción","fr":"Architecture : ownership avant abstraction"},"body":[{"pt":"A revisão procura quem é dono do estado, onde existe durabilidade, quais chamadas são idempotentes, como retries e cancelamento funcionam e quais fronteiras de auth/autorização não podem ser atravessadas por conveniência.","en":"Review asks who owns state, where durability lives, which calls are idempotent, how retries and cancellation behave, and which auth/authorization boundaries must not be crossed for convenience.","es":"La revisión pregunta quién posee el estado, dónde vive la durabilidad y cómo funcionan retries, cancelación y auth.","fr":"La revue demande qui possède l’état, où vit la durabilité et comment fonctionnent retries, annulation et auth."}]},{"title":{"pt":"Research: recência vira requisito","en":"Research: freshness becomes a requirement","es":"Research: la actualidad se vuelve requisito","fr":"Research : la fraîcheur devient une exigence"},"body":[{"pt":"Quando uma afirmação pode ter mudado, o harness marca necessidade de busca atual. Memória do modelo serve para enquadrar a pergunta; fonte primária recente serve para sustentar o fato.","en":"When a claim may have changed, the harness marks live retrieval as required. Model memory frames the question; a recent primary source supports the fact.","es":"Cuando un dato puede haber cambiado, el harness exige búsqueda actual y prioriza fuentes primarias.","fr":"Quand une information peut avoir changé, le harness exige une recherche actuelle et privilégie les sources primaires."}]},{"title":{"pt":"Release gate: não basta uma resposta plausível","en":"Release gate: a plausible answer is not enough","es":"Release gate: una respuesta plausible no basta","fr":"Release gate : une réponse plausible ne suffit pas"},"body":[{"pt":"O candidato final precisa reduzir dívida de evidência dentro do orçamento. Se o verificador necessário estiver indisponível ou existir falha material aberta, o estado deve dizer qualidade degradada em vez de fabricar certeza.","en":"The final candidate must reduce evidence debt within budget. If a necessary verifier is unavailable or a material failure remains open, the state should report degraded quality instead of fabricating certainty.","es":"El candidato final debe reducir deuda de evidencia; si falta verificación crítica, debe declarar calidad degradada.","fr":"Le candidat final doit réduire la dette de preuve ; si une vérification critique manque, il doit déclarer une qualité dégradée."}]}],"lead":{"pt":"Visual, 3D, PBR, arquitetura e refinamento agora têm gates próprios em vez de compartilhar um único botão de “pensar mais”.","en":"Visual, 3D, PBR, architecture, and refinement now have their own gates instead of sharing one generic “think harder” switch.","es":"Visual, 3D, PBR, arquitectura y refinamiento tienen gates propios.","fr":"Visuel, 3D, PBR, architecture et raffinement disposent désormais de gates dédiés."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":2}},{"slug":"thesis-2-frontier-visual-coding","category":"models","asset":"modelGraph","date":"2026-09-02","read":2,"title":{"pt":"Thesis 2: coding visual com gerador, avaliador e checkpoint","en":"Thesis 2: visual coding with generator, evaluator, and checkpoints","es":"Thesis 2: coding visual con generador, evaluador y checkpoints","fr":"Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints"},"lead":{"pt":"A nova disciplina do Thesis 2 separa criação, crítica e verificação para evitar que uma interface apenas “pareça pronta”.","en":"Thesis 2 separates creation, critique, and verification so an interface does not merely “look done.”","es":"Thesis 2 separa creación, crítica y verificación para evitar que una interfaz solo “parezca terminada”.","fr":"Thesis 2 sépare création, critique et vérification pour éviter qu’une interface ne fasse que « paraître terminée »."},"blocks":[{"title":{"pt":"O problema do one-shot","en":"The one-shot problem","es":"El problema del one-shot","fr":"Le problème du one-shot"},"body":[{"pt":"Interfaces ambiciosas degradam quando um único passe tenta decidir arquitetura, estética, interação e QA ao mesmo tempo. O Thesis 2 passa a tratar essas responsabilidades como papéis distintos, mesmo quando executadas pelo mesmo runtime.","en":"Ambitious interfaces degrade when one pass tries to decide architecture, aesthetics, interaction, and QA at once. Thesis 2 treats those responsibilities as distinct roles, even when executed by the same runtime.","es":"Las interfaces ambiciosas se degradan cuando una sola pasada intenta decidir arquitectura, estética, interacción y QA a la vez. Thesis 2 trata esas responsabilidades como roles distintos, incluso dentro del mismo runtime.","fr":"Les interfaces ambitieuses se dégradent lorsqu’un seul passage tente de décider architecture, esthétique, interaction et QA à la fois. Thesis 2 traite ces responsabilités comme des rôles distincts, même dans le même runtime."}]},{"title":{"pt":"Gerador primeiro, avaliador depois","en":"Generator first, evaluator second","es":"Generador primero, evaluador después","fr":"Générateur d’abord, évaluateur ensuite"},"body":[{"pt":"O gerador recebe o briefing, o estado real do código e as referências visuais. O avaliador recebe a saída e um rubric explícito: coerência do conjunto, originalidade, acabamento e funcionalidade. A crítica não pode ser “ficou bonito”; precisa localizar diferenças observáveis.","en":"The generator receives the brief, real code state, and visual references. The evaluator receives the output and an explicit rubric: whole-system coherence, originality, craft, and functionality. Critique cannot stop at “looks good”; it must locate observable differences.","es":"El generador recibe el briefing, el estado real del código y las referencias visuales. El evaluador recibe la salida y una rúbrica explícita: coherencia del conjunto, originalidad, acabado y funcionalidad. La crítica no puede quedarse en “se ve bien”; debe localizar diferencias observables.","fr":"Le générateur reçoit le brief, l’état réel du code et les références visuelles. L’évaluateur reçoit la sortie et une grille explicite : cohérence globale, originalité, finition et fonctionnalité. La critique ne peut pas se limiter à « c’est joli » ; elle doit localiser des écarts observables."}]},{"title":{"pt":"Mundo visual, não decoração","en":"A visual world, not decoration","es":"Un mundo visual, no decoración","fr":"Un monde visuel, pas de la décoration"},"body":[{"pt":"Para páginas cinematográficas, o prompt agora exige um modelo de mundo: fonte de luz, atmosfera, planos de profundidade, textura, silhueta principal, oclusão de primeiro plano e crop responsivo. Gradiente, blur e partículas entram apenas quando explicam esse mundo.","en":"For cinematic pages, the prompt now requires a world model: light source, atmosphere, depth planes, texture, primary silhouette, foreground occlusion, and responsive focal crop. Gradients, blur, and particles enter only when they explain that world.","es":"Para páginas cinematográficas, el prompt ahora exige un modelo de mundo: fuente de luz, atmósfera, planos de profundidad, textura, silueta principal, oclusión de primer plano y recorte responsivo. Gradientes, blur y partículas entran solo cuando explican ese mundo.","fr":"Pour les pages cinématographiques, le prompt exige désormais un modèle de monde : source lumineuse, atmosphère, plans de profondeur, texture, silhouette principale, occlusion au premier plan et recadrage responsive. Gradients, flou et particules n’entrent en jeu que s’ils expliquent ce monde."}]},{"title":{"pt":"Screenshot como evidência","en":"Screenshot as evidence","es":"Screenshot como evidencia","fr":"La capture comme preuve"},"body":[{"pt":"Quando há navegador ou referência de imagem, o loop termina apenas depois de comparar screenshot, hierarquia, ocupação de espaço, ritmo tipográfico e estados. O melhor checkpoint é preservado para que uma iteração posterior não piore o que já estava resolvido.","en":"When a browser or image reference exists, the loop ends only after comparing screenshot, hierarchy, spatial occupancy, typographic rhythm, and states. The best checkpoint is preserved so a later iteration cannot degrade what was already solved.","es":"Cuando existe navegador o referencia de imagen, el loop termina solo después de comparar screenshot, jerarquía, ocupación espacial, ritmo tipográfico y estados. Se conserva el mejor checkpoint para que una iteración posterior no empeore lo ya resuelto.","fr":"Lorsqu’un navigateur ou une référence d’image existe, la boucle ne s’arrête qu’après comparaison de la capture, de la hiérarchie, de l’occupation de l’espace, du rythme typographique et des états. Le meilleur checkpoint est conservé afin qu’une itération suivante ne dégrade pas ce qui était déjà résolu."}]},{"title":{"pt":"Código real continua sendo o limite","en":"Real code remains the constraint","es":"El código real sigue siendo el límite","fr":"Le code réel reste la contrainte"},"body":[{"pt":"Nenhuma ambição visual autoriza quebrar contrato de rota, estado, acessibilidade ou performance. O avaliador visual trabalha junto da validação de sintaxe, runtime, responsividade e interação.","en":"Visual ambition never authorizes breaking route, state, accessibility, or performance contracts. The visual evaluator works alongside syntax, runtime, responsive, and interaction validation.","es":"Ninguna ambición visual autoriza romper contratos de ruta, estado, accesibilidad o rendimiento. El evaluador visual trabaja junto a la validación de sintaxis, runtime, responsividad e interacción.","fr":"Aucune ambition visuelle n’autorise la rupture des contrats de route, d’état, d’accessibilité ou de performance. L’évaluateur visuel travaille avec la validation de syntaxe, runtime, responsive et interaction."}]},{"title":{"pt":"Por dentro de Poder de veto do avaliador","en":"Inside Thesis 2: visual coding with generator, evaluator, and checkpoints","es":"Por dentro de Thesis 2: coding visual con generador, evaluador y checkpoints","fr":"Au cœur de Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints"},"body":[{"pt":"O salto de qualidade acontece quando o avaliador pode rejeitar uma tela tecnicamente válida por composição ruim, hierarquia fraca, excesso de elementos ou interação incompleta. Thesis 2 preserva o melhor checkpoint aprovado e só promove uma nova versão quando ela melhora o conjunto, não apenas uma métrica isolada.","en":"The useful way to read “Thesis 2: visual coding with generator, evaluator, and checkpoints” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Thesis 2: coding visual con generador, evaluador y checkpoints» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Poder de veto do avaliador","en":"Specific failure mode: Thesis 2: visual coding with generator, evaluator, and checkpoints","es":"Fallo específico: Thesis 2: coding visual con generador, evaluador y checkpoints","fr":"Mode de défaillance : Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints"},"body":[{"pt":"O risco é deixar generator e evaluator compartilharem o mesmo viés. Se ambos premiam volume de código, a revisão vira cerimônia e uma regressão visual pode parecer progresso.","en":"The failure mode to watch in “Thesis 2: visual coding with generator, evaluator, and checkpoints” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Thesis 2: coding visual con generador, evaluador y checkpoints» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Poder de veto do avaliador","en":"Evidence that closes Thesis 2: visual coding with generator, evaluator, and checkpoints","es":"Evidencia que cierra Thesis 2: coding visual con generador, evaluador y checkpoints","fr":"Preuve qui valide Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints"},"body":[{"pt":"A prova forte combina execução, screenshot comparável, estados de interação e um checklist de critérios objetivos: foco, leitura, densidade, crop, contraste, responsividade e ausência de controles mortos.","en":"For “Thesis 2: visual coding with generator, evaluator, and checkpoints”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Thesis 2: coding visual con generador, evaluador y checkpoints», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Thesis 2 : coding visuel avec générateur, évaluateur et checkpoints », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"long-running-code-checkpoints-and-handoffs","category":"code","asset":"codeBraces","date":"2026-09-02","read":2,"title":{"pt":"Código de longa duração: checkpoints, handoffs e progresso que não se perde","en":"Long-running code: checkpoints, handoffs, and progress that does not disappear","es":"Código de larga duración: checkpoints, handoffs y progreso que no se pierde","fr":"Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas"},"lead":{"pt":"Projetos grandes não falham só por falta de inteligência; falham quando o agente perde o mapa do trabalho ao longo das iterações.","en":"Large projects fail not only from lack of intelligence, but when the agent loses the map of the work across iterations.","es":"Los proyectos grandes no fallan solo por falta de inteligencia; fallan cuando el agente pierde el mapa del trabajo entre iteraciones.","fr":"Les grands projets échouent non seulement par manque d’intelligence, mais lorsque l’agent perd la carte du travail au fil des itérations."},"blocks":[{"title":{"pt":"Decompor sem fragmentar","en":"Decompose without fragmenting","es":"Descomponer sin fragmentar","fr":"Décomposer sans fragmenter"},"body":[{"pt":"O plano divide o trabalho em unidades verificáveis, mas mantém contratos entre elas. Cada unidade termina com estado do código, evidência obtida, riscos abertos e a próxima decisão, não apenas com uma lista de arquivos alterados.","en":"The plan divides work into verifiable units while preserving contracts between them. Each unit ends with code state, gathered evidence, open risks, and the next decision—not merely a list of changed files.","es":"El plan divide el trabajo en unidades verificables manteniendo los contratos entre ellas. Cada unidad termina con estado del código, evidencia obtenida, riesgos abiertos y la siguiente decisión, no solo con una lista de archivos modificados.","fr":"Le plan divise le travail en unités vérifiables tout en préservant leurs contrats. Chaque unité se termine par l’état du code, les preuves obtenues, les risques ouverts et la prochaine décision, pas seulement une liste de fichiers modifiés."}]},{"title":{"pt":"Handoff é um artefato","en":"A handoff is an artifact","es":"Un handoff es un artefacto","fr":"Un handoff est un artefact"},"body":[{"pt":"Quando contexto precisa ser compactado ou trocado, o handoff carrega objetivos, invariantes, decisões já tomadas, comandos de validação e falhas conhecidas. Isso reduz a tendência de reabrir decisões que já tinham sido resolvidas.","en":"When context must be compacted or replaced, the handoff carries goals, invariants, prior decisions, validation commands, and known failures. This reduces the tendency to reopen decisions that were already settled.","es":"Cuando el contexto debe compactarse o cambiarse, el handoff transporta objetivos, invariantes, decisiones tomadas, comandos de validación y fallos conocidos. Así se reduce la tendencia a reabrir decisiones ya resueltas.","fr":"Lorsque le contexte doit être compacté ou remplacé, le handoff transporte objectifs, invariants, décisions prises, commandes de validation et échecs connus. Cela réduit la tendance à rouvrir des décisions déjà réglées."}]},{"title":{"pt":"Checkpoint válido, não só recente","en":"A valid checkpoint, not merely the latest","es":"Un checkpoint válido, no solo el más reciente","fr":"Un checkpoint valide, pas seulement le plus récent"},"body":[{"pt":"O último estado não é automaticamente o melhor. O Thesis 2 mantém referência ao último checkpoint que passou pelos gates importantes e pode recuar para ele quando uma tentativa introduz regressão estrutural.","en":"The latest state is not automatically the best. Thesis 2 keeps a reference to the latest checkpoint that passed important gates and can roll back to it when an attempt introduces structural regression.","es":"El último estado no es automáticamente el mejor. Thesis 2 conserva el último checkpoint que pasó los gates importantes y puede volver a él cuando un intento introduce una regresión estructural.","fr":"Le dernier état n’est pas automatiquement le meilleur. Thesis 2 conserve le dernier checkpoint ayant passé les gates importants et peut y revenir lorsqu’une tentative introduit une régression structurelle."}]},{"title":{"pt":"Paralelismo só com fronteiras claras","en":"Parallelism only with clear boundaries","es":"Paralelismo solo con fronteras claras","fr":"Parallélisme seulement avec des frontières claires"},"body":[{"pt":"Subagentes podem acelerar pesquisa, testes e revisão, mas não devem editar a mesma propriedade de estado sem coordenação. Trabalhos paralelos precisam de fronteiras de arquivos, contratos e critérios de merge.","en":"Subagents can accelerate research, testing, and review, but should not edit the same state ownership without coordination. Parallel work needs file boundaries, contracts, and merge criteria.","es":"Los subagentes pueden acelerar investigación, pruebas y revisión, pero no deben editar la misma propiedad de estado sin coordinación. El trabajo paralelo necesita fronteras de archivos, contratos y criterios de merge.","fr":"Les sous-agents peuvent accélérer recherche, tests et révision, mais ne doivent pas modifier la même propriété d’état sans coordination. Le travail parallèle exige des frontières de fichiers, des contrats et des critères de merge."}]},{"title":{"pt":"Onde Checkpoint é estado validado, não timestamp realmente ganha qualidade","en":"Where Long-running code: checkpoints, handoffs, and progress that does not disappear actually gains quality","es":"Dónde Código de larga duración: checkpoints, handoffs y progreso que no se pierde realmente gana calidad","fr":"Là où Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas gagne vraiment en qualité"},"body":[{"pt":"Em tarefas longas, o checkpoint correto não é o arquivo mais recente, mas o último estado que passou pelos critérios relevantes. Isso permite explorar uma mudança agressiva sem transformar cada tentativa em dano cumulativo.","en":"The useful way to read “Long-running code: checkpoints, handoffs, and progress that does not disappear” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Código de larga duración: checkpoints, handoffs y progreso que no se pierde» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Checkpoint é estado validado, não timestamp","en":"Specific failure mode: Long-running code: checkpoints, handoffs, and progress that does not disappear","es":"Fallo específico: Código de larga duración: checkpoints, handoffs y progreso que no se pierde","fr":"Mode de défaillance : Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas"},"body":[{"pt":"Handoffs vagos fazem o próximo agente repetir investigação ou, pior, continuar uma hipótese já refutada. Um handoff útil registra estado, evidência, testes executados, riscos abertos e a próxima decisão concreta.","en":"The failure mode to watch in “Long-running code: checkpoints, handoffs, and progress that does not disappear” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Código de larga duración: checkpoints, handoffs y progreso que no se pierde» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Checkpoint é estado validado, não timestamp","en":"Evidence that closes Long-running code: checkpoints, handoffs, and progress that does not disappear","es":"Evidencia que cierra Código de larga duración: checkpoints, handoffs y progreso que no se pierde","fr":"Preuve qui valide Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas"},"body":[{"pt":"O fluxo está saudável quando uma sessão pode ser interrompida e retomada sem reconstruir mentalmente o projeto inteiro, e quando a recuperação volta ao melhor candidato conhecido em vez de empilhar patches.","en":"For “Long-running code: checkpoints, handoffs, and progress that does not disappear”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Código de larga duración: checkpoints, handoffs y progreso que no se pierde», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Code longue durée : checkpoints, handoffs et progrès qui ne disparaît pas », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"refinement-without-rewrite-regression","date":"2 de setembro de 2026","read":2,"category":"code","asset":"eraser","title":{"pt":"Refinar código sem transformar cada bug em uma reescrita","en":"Refine code without turning every bug into a rewrite","es":"Refinar código sin convertir cada bug en reescritura","fr":"Raffiner le code sans transformer chaque bug en réécriture"},"dek":{"pt":"O Thesis 2 v3 passa a tratar regressão, lifecycle e contratos adjacentes como parte do repair, não como dano colateral aceitável.","en":"Thesis 2 v3 treats regression, lifecycle, and adjacent contracts as part of repair rather than acceptable collateral damage.","es":"Thesis 2 v3 trata regresión, lifecycle y contratos adyacentes como parte del repair.","fr":"Thesis 2 v3 traite régression, lifecycle et contrats adjacents comme partie du repair."},"body":[{"pt":"A falha mais cara em manutenção não é o bug inicial; é corrigir o bug apagando comportamento que já funcionava. O novo contrato de refinement prioriza o menor conjunto coerente de mudanças e um sweep por defeitos da mesma classe.","en":"The most expensive maintenance failure is not the initial bug; it is fixing the bug by deleting behavior that already worked. The new refinement contract prioritizes the smallest coherent change set and a sweep for same-class defects.","es":"La falla más cara no es el bug inicial, sino arreglarlo eliminando comportamiento que funcionaba.","fr":"L’échec le plus coûteux n’est pas le bug initial mais le corriger en supprimant un comportement qui fonctionnait."}],"blocks":[{"title":{"pt":"Evidência em camadas","en":"Layered evidence","es":"Evidencia en capas","fr":"Preuve en couches"},"body":[{"pt":"Syntax, typecheck, build, runtime, integration, E2E e visual review são classes distintas. O relatório deve dizer qual delas foi realmente executada.","en":"Syntax, typecheck, build, runtime, integration, E2E, and visual review are distinct classes. The report must say which one actually ran.","es":"Syntax, typecheck, build, runtime, E2E y visual review son clases distintas.","fr":"Syntax, typecheck, build, runtime, E2E et revue visuelle sont des classes distinctes."}]},{"title":{"pt":"Lifecycle primeiro","en":"Lifecycle first","es":"Lifecycle primero","fr":"Lifecycle d’abord"},"body":[{"pt":"Observers, timers, listeners, sockets e recursos GPU são revisados em reentrada porque grande parte dos bugs de interface só aparece na segunda navegação.","en":"Observers, timers, listeners, sockets, and GPU resources are reviewed on re-entry because many interface bugs only appear on the second navigation.","es":"Observers, timers, listeners, sockets y GPU se revisan en reentrada.","fr":"Observers, timers, listeners, sockets et GPU sont revus à la réentrée."}]},{"title":{"pt":"Baseline explícita antes do patch","en":"Explicit baseline before the patch","es":"Baseline explícita antes del patch","fr":"Baseline explicite avant le patch"},"body":[{"pt":"Antes de tocar no arquivo, o repair identifica qual comportamento já funciona e quais rotas, seletores, contratos e estados não pertencem ao bug. Sem baseline, qualquer “correção” pode apagar funcionalidade e ainda parecer limpa no diff.","en":"Before touching the file, repair identifies what already works and which routes, selectors, contracts, and states are outside the bug. Without a baseline, a “fix” can erase functionality while still looking clean in the diff.","es":"Antes del patch se identifica qué ya funciona y qué contratos no pertenecen al bug.","fr":"Avant le patch, on identifie ce qui fonctionne déjà et les contrats hors périmètre."}]},{"title":{"pt":"Defeito local, impacto sistêmico","en":"Local defect, system impact","es":"Defecto local, impacto sistémico","fr":"Défaut local, impact système"},"body":[{"pt":"Um erro em auth pode aparecer como UI congelada; um listener duplicado pode parecer bug de rede; CSS duplicado pode mascarar um problema de layout. O refinement busca defeitos diretamente acoplados antes de aumentar o escopo.","en":"An auth error may surface as a frozen UI; a duplicated listener can look like a network bug; duplicated CSS can mask layout problems. Refinement checks directly coupled defects before expanding scope.","es":"Un fallo de auth puede parecer UI congelada y un listener duplicado puede parecer fallo de red.","fr":"Une erreur d’auth peut apparaître comme une UI gelée et un listener dupliqué comme un problème réseau."}]},{"title":{"pt":"Segundo uso é parte do teste","en":"The second use is part of the test","es":"El segundo uso forma parte del test","fr":"La seconde utilisation fait partie du test"},"body":[{"pt":"Muitos bugs só aparecem ao voltar para a rota, enviar uma segunda mensagem, reabrir o modal ou repetir a geração. Por isso reentrada, cleanup e idempotência fazem parte da verificação mínima.","en":"Many bugs appear only after returning to a route, sending a second message, reopening a modal, or repeating generation. Re-entry, cleanup, and idempotency are therefore part of minimum verification.","es":"Muchos bugs aparecen en la segunda ejecución; reentrada y cleanup son parte de la verificación mínima.","fr":"Beaucoup de bugs n’apparaissent qu’à la seconde exécution ; réentrée et cleanup font partie de la vérification minimale."}]},{"title":{"pt":"O patch precisa ser monotônico","en":"A patch should be monotonic","es":"El patch debe ser monotónico","fr":"Le patch doit être monotone"},"body":[{"pt":"Uma reparação só substitui o candidato anterior quando reduz falhas materiais sem abrir regressões maiores. “Mudou bastante” não é critério de melhoria; evidence debt menor é.","en":"A repair only replaces the previous candidate when it reduces material failures without opening larger regressions. “Changed a lot” is not an improvement criterion; lower evidence debt is.","es":"Una reparación solo reemplaza el candidato anterior si reduce fallos materiales sin abrir regresiones mayores.","fr":"Une réparation ne remplace le candidat précédent que si elle réduit les défauts matériels sans créer de régressions majeures."}]},{"title":{"pt":"Quando reescrever é a decisão correta","en":"When rewriting is actually correct","es":"Cuándo reescribir es correcto","fr":"Quand réécrire est la bonne décision"},"body":[{"pt":"Rewrite deixa de ser tabu quando a arquitetura é o defeito: ownership impossível de corrigir localmente, contratos contraditórios, dependência circular ou camadas duplicadas que impedem qualquer patch confiável. A diferença é justificar a reescrita por invariantes quebrados, não por preferência estética.","en":"A rewrite becomes justified when architecture is the defect: state ownership cannot be repaired locally, contracts contradict each other, dependencies are circular, or duplicated layers prevent reliable patches. The rewrite must be justified by broken invariants, not aesthetic preference.","es":"La reescritura se justifica cuando el defecto es arquitectónico y no puede repararse localmente.","fr":"La réécriture se justifie lorsque le défaut est architectural et ne peut être réparé localement."}]}],"lead":{"pt":"O Thesis 2 v3 passa a tratar regressão, lifecycle e contratos adjacentes como parte do repair, não como dano colateral aceitável.","en":"Thesis 2 v3 treats regression, lifecycle, and adjacent contracts as part of repair rather than acceptable collateral damage.","es":"Thesis 2 v3 trata regresión, lifecycle y contratos adyacentes como parte del repair.","fr":"Thesis 2 v3 traite régression, lifecycle et contrats adjacents comme partie du repair."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"pbr-is-a-pipeline-not-a-shiny-material","date":"2 de setembro de 2026","read":2,"category":"engineering","asset":"modelGraph","title":{"pt":"PBR não é “material brilhante”: é um pipeline inteiro","en":"PBR is not “a shiny material”: it is an entire pipeline","es":"PBR no es “material brillante”: es un pipeline completo","fr":"Le PBR n’est pas « un matériau brillant » : c’est un pipeline complet"},"dek":{"pt":"Metallic-roughness, microfacet BRDF, IBL, color management e budget de GPU precisam conversar entre si.","en":"Metallic-roughness, microfacet BRDF, IBL, color management, and GPU budgets need to work as one system.","es":"Metallic-roughness, microfacet BRDF, IBL, color management y budget GPU deben funcionar como sistema.","fr":"Metallic-roughness, microfacet BRDF, IBL, color management et budget GPU doivent fonctionner comme un système."},"body":[{"pt":"Cenas 3D ruins costumam tentar resolver iluminação com intensidade, materiais com roughness aleatória e detalhe com mais geometria. O Thesis 2 v3 passa a avaliar esses elementos como partes do mesmo modelo de luz e superfície.","en":"Weak 3D scenes often try to solve lighting with intensity, materials with random roughness, and detail with more geometry. Thesis 2 v3 evaluates these elements as parts of the same light-and-surface model.","es":"Escenas 3D débiles intentan resolver iluminación con intensidad y materiales con roughness aleatoria.","fr":"Les scènes 3D faibles tentent souvent de résoudre l’éclairage par l’intensité et les matériaux par une roughness aléatoire."}],"blocks":[{"title":{"pt":"Material plausível","en":"Plausible material","es":"Material plausible","fr":"Matériau plausible"},"body":[{"pt":"Metais, dielétricos, roughness, normal maps e clearcoat têm semânticas físicas diferentes. A revisão procura coerência antes de procurar “efeito”.","en":"Metals, dielectrics, roughness, normal maps, and clearcoat have different physical semantics. Review looks for coherence before “effect.”","es":"Metales, dieléctricos, roughness, normal maps y clearcoat tienen semánticas físicas distintas.","fr":"Métaux, diélectriques, roughness, normal maps et clearcoat ont des sémantiques physiques distinctes."}]},{"title":{"pt":"Cor e ambiente","en":"Color and environment","es":"Color y entorno","fr":"Couleur et environnement"},"body":[{"pt":"Linear-light shading, saída sRGB, HDR/IBL, prefiltragem e tone mapping são parte do resultado. Se uma etapa está errada, compensar na próxima produz um look frágil.","en":"Linear-light shading, sRGB output, HDR/IBL, prefiltering, and tone mapping are part of the result. If one stage is wrong, compensating in the next produces a fragile look.","es":"Linear-light, sRGB, HDR/IBL, prefiltrado y tone mapping son parte del resultado.","fr":"Linear-light, sRGB, HDR/IBL, préfiltrage et tone mapping font partie du résultat."}]},{"title":{"pt":"BRDF e conservação de energia","en":"BRDF and energy conservation","es":"BRDF y conservación de energía","fr":"BRDF et conservation de l’énergie"},"body":[{"pt":"O specular precisa responder à geometria microscópica da superfície. GGX-class distribution, masking-shadowing e Fresnel não são nomes para enfeitar documentação; determinam como roughness, ângulo e índice de refração produzem highlights plausíveis.","en":"Specular response should follow the microscopic surface model. GGX-class distribution, masking-shadowing, and Fresnel are not documentation ornaments; they determine how roughness, angle, and refraction index create plausible highlights.","es":"GGX, masking-shadowing y Fresnel determinan highlights plausibles según roughness y ángulo.","fr":"GGX, masking-shadowing et Fresnel déterminent des reflets plausibles selon roughness et angle."}]},{"title":{"pt":"Texturas têm semântica de canal","en":"Texture channels have semantics","es":"Los canales de textura tienen semántica","fr":"Les canaux de texture ont une sémantique"},"body":[{"pt":"Base color costuma entrar como sRGB; roughness, metallic, AO e normal são dados e não devem receber a mesma conversão. Um pipeline que trata todos os mapas como “imagem” pode parecer aceitável sob uma luz e quebrar sob outra.","en":"Base color is usually sRGB while roughness, metallic, AO, and normal are data and should not receive the same conversion. A pipeline that treats every map as “an image” may look acceptable under one light and fail under another.","es":"Base color suele ser sRGB; roughness, metallic, AO y normal son datos con semántica diferente.","fr":"Base color est généralement sRGB ; roughness, metallic, AO et normal sont des données avec une sémantique différente."}]},{"title":{"pt":"Normal map depende de tangent space correto","en":"Normal maps depend on correct tangent space","es":"Normal maps dependen de tangent space correcto","fr":"Les normal maps dépendent d’un tangent space correct"},"body":[{"pt":"Tangent, bitangent, orientação UV e handedness precisam concordar. Costuras, iluminação invertida ou detalhe que muda ao rotacionar a câmera são sinais de um problema de base, não de “intensidade da normal”.","en":"Tangents, bitangents, UV orientation, and handedness must agree. Seams, inverted lighting, or detail that changes as the camera rotates indicate a basis problem, not merely “normal intensity.”","es":"Tangents, UV y handedness deben coincidir; costuras o iluminación invertida indican un problema de base.","fr":"Tangentes, UV et handedness doivent être cohérents ; coutures ou éclairage inversé signalent un problème de base."}]},{"title":{"pt":"IBL precisa respeitar roughness","en":"IBL must respect roughness","es":"IBL debe respetar roughness","fr":"L’IBL doit respecter la roughness"},"body":[{"pt":"Ambiente HDR não é só um background. Specular IBL precisa de prefilter por roughness e diffuse irradiance coerente; do contrário toda superfície reflete o mesmo nível de detalhe e o material perde escala visual.","en":"An HDR environment is not merely a background. Specular IBL needs roughness-aware prefiltering and coherent diffuse irradiance; otherwise every surface reflects the same detail level and material scale collapses.","es":"Un HDR no es solo fondo; el IBL specular necesita prefilter según roughness.","fr":"Un environnement HDR n’est pas qu’un fond ; l’IBL spéculaire doit être préfiltrée selon la roughness."}]},{"title":{"pt":"Performance faz parte do material final","en":"Performance is part of the final material","es":"La performance forma parte del material final","fr":"La performance fait partie du matériau final"},"body":[{"pt":"DPR ilimitado, dezenas de materiais quase idênticos, textura 4K em todo objeto e shader variants descontroladas podem destruir a cena mais “realista”. Thesis 2 inclui draw calls, memória de textura, LOD, instancing e disposal no mesmo gate de qualidade.","en":"Unlimited DPR, dozens of near-identical materials, 4K textures on every object, and uncontrolled shader variants can destroy the most “realistic” scene. Thesis 2 includes draw calls, texture memory, LOD, instancing, and disposal in the same quality gate.","es":"DPR, materiales duplicados, texturas 4K y shader variants también forman parte del gate de calidad.","fr":"DPR, matériaux dupliqués, textures 4K et shader variants font aussi partie du gate de qualité."}]},{"title":{"pt":"Validação troca “parece real” por sinais","en":"Validation replaces “looks real” with signals","es":"La validación reemplaza “parece real” por señales","fr":"La validation remplace « semble réel » par des signaux"},"body":[{"pt":"A revisão pergunta se metais têm diffuse indevido, se dielétricos preservam F0 plausível, se exposição estoura highlights, se sombras têm bias incorreto e se roughness responde sob múltiplos ambientes. O objetivo é reduzir compensações frágeis.","en":"Review asks whether metals leak diffuse response, dielectrics preserve plausible F0, exposure clips highlights, shadow bias is wrong, and roughness behaves across environments. The goal is to reduce fragile compensations.","es":"La revisión usa señales físicas concretas en vez de “parece real”.","fr":"La revue utilise des signaux physiques concrets plutôt que « semble réel »."}]}],"lead":{"pt":"Metallic-roughness, microfacet BRDF, IBL, color management e budget de GPU precisam conversar entre si.","en":"Metallic-roughness, microfacet BRDF, IBL, color management, and GPU budgets need to work as one system.","es":"Metallic-roughness, microfacet BRDF, IBL, color management y budget GPU deben funcionar como sistema.","fr":"Metallic-roughness, microfacet BRDF, IBL, color management et budget GPU doivent fonctionner comme un système."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"visual-evaluation-loop-not-vibes","category":"design","asset":"browserCursor","date":"2026-09-02","read":2,"title":{"pt":"Design de IA sem “vibes”: um loop de avaliação que consegue reprovar a própria tela","en":"AI design without “vibes”: an evaluation loop that can reject its own screen","es":"Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla","fr":"Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran"},"lead":{"pt":"Bom design agentico precisa de critérios que permitam dizer não à primeira versão e explicar por quê.","en":"Good agentic design needs criteria that can reject the first version and explain why.","es":"Un buen diseño agéntico necesita criterios capaces de rechazar la primera versión y explicar por qué.","fr":"Un bon design agentique a besoin de critères capables de rejeter la première version et d’expliquer pourquoi."},"blocks":[{"title":{"pt":"Quatro eixos de avaliação","en":"Four evaluation axes","es":"Cuatro ejes de evaluación","fr":"Quatre axes d’évaluation"},"body":[{"pt":"Coerência mede se a página funciona como um todo. Originalidade mede se existe uma ideia própria. Acabamento olha espaçamento, tipografia, detalhes e arte. Funcionalidade verifica se o que parece clicável realmente é clicável.","en":"Coherence asks whether the page works as a whole. Originality asks whether it has its own idea. Craft inspects spacing, typography, details, and art. Functionality verifies whether what looks clickable actually works.","es":"Coherencia mide si la página funciona como un todo. Originalidad mide si existe una idea propia. Acabado revisa espaciado, tipografía, detalles y arte. Funcionalidad verifica si lo que parece clicable realmente funciona.","fr":"La cohérence mesure si la page fonctionne comme un tout. L’originalité mesure si elle possède une idée propre. La finition examine espacement, typographie, détails et art. La fonctionnalité vérifie que ce qui semble cliquable fonctionne réellement."}]},{"title":{"pt":"Referência não é decoração","en":"A reference is not decoration","es":"Una referencia no es decoración","fr":"Une référence n’est pas décorative"},"body":[{"pt":"Uma screenshot de referência deve alterar composição, escala, densidade, hierarquia e comportamento. Copiar apenas cor e raio de borda produz semelhança superficial e perde o sistema que tornou a referência convincente.","en":"A reference screenshot should change composition, scale, density, hierarchy, and behavior. Copying only color and border radius creates superficial similarity and misses the system that made the reference convincing.","es":"Una screenshot de referencia debe cambiar composición, escala, densidad, jerarquía y comportamiento. Copiar solo color y radio de borde produce similitud superficial y pierde el sistema que hacía convincente la referencia.","fr":"Une capture de référence doit modifier composition, échelle, densité, hiérarchie et comportement. Copier uniquement couleur et rayon de bordure crée une ressemblance superficielle et manque le système qui rendait la référence convaincante."}]},{"title":{"pt":"A crítica precisa apontar uma correção","en":"Critique must point to a fix","es":"La crítica debe apuntar a una corrección","fr":"La critique doit mener à une correction"},"body":[{"pt":"“Mais polido” é inútil como instrução. “O hero perde 38% da altura sem informação, o CTA fica abaixo da dobra e a arte tem metade da escala da referência” vira uma tarefa executável.","en":"“More polished” is useless as an instruction. “The hero wastes 38% of its height, the CTA falls below the fold, and the art is half the reference scale” becomes an executable task.","es":"“Más pulido” es inútil como instrucción. “El hero desperdicia 38% de su altura, el CTA queda bajo el fold y el arte tiene la mitad de la escala de referencia” se convierte en una tarea ejecutable.","fr":"« Plus soigné » est inutile comme instruction. « Le hero gaspille 38 % de sa hauteur, le CTA tombe sous la ligne de flottaison et l’art fait la moitié de l’échelle de la référence » devient une tâche exécutable."}]},{"title":{"pt":"O melhor estado vira checkpoint","en":"The best state becomes a checkpoint","es":"El mejor estado se vuelve checkpoint","fr":"Le meilleur état devient un checkpoint"},"body":[{"pt":"Depois de cada iteração, o sistema registra a melhor versão válida. Se uma tentativa posterior adiciona impacto visual mas quebra legibilidade ou interação, ela não substitui o checkpoint anterior.","en":"After each iteration, the system records the best valid version. If a later attempt adds visual impact but breaks readability or interaction, it does not replace the earlier checkpoint.","es":"Después de cada iteración, el sistema registra la mejor versión válida. Si un intento posterior añade impacto visual pero rompe legibilidad o interacción, no reemplaza el checkpoint anterior.","fr":"Après chaque itération, le système enregistre la meilleure version valide. Si une tentative suivante ajoute de l’impact visuel mais casse la lisibilité ou l’interaction, elle ne remplace pas le checkpoint précédent."}]},{"title":{"pt":"A parte difícil de Rubrica visual que consegue dizer não","en":"The hard part of AI design without “vibes”: an evaluation loop that can reject its own screen","es":"La parte difícil de Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla","fr":"La partie difficile de Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran"},"body":[{"pt":"Uma avaliação visual útil transforma “parece bom” em critérios observáveis: distribuição de massa, ritmo de espaços, escala tipográfica, continuidade de alinhamentos, contraste semântico, profundidade, acabamento e coerência entre breakpoints.","en":"The useful way to read “AI design without “vibes”: an evaluation loop that can reject its own screen” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"referência vira requisito de composição e comportamento","en":"referência vira requisito de composição e comportamento","es":"referência vira requisito de composição e comportamento","fr":"referência vira requisito de composição e comportamento"},{"pt":"visual é revisado depois de implementado","en":"visual é revisado depois de implementado","es":"visual é revisado depois de implementado","fr":"visual é revisado depois de implementado"},{"pt":"estética nunca substitui estado funcional","en":"estética nunca substitui estado funcional","es":"estética nunca substitui estado funcional","fr":"estética nunca substitui estado funcional"}]},{"title":{"pt":"Falha específica: Rubrica visual que consegue dizer não","en":"Specific failure mode: AI design without “vibes”: an evaluation loop that can reject its own screen","es":"Fallo específico: Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla","fr":"Mode de défaillance : Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran"},"body":[{"pt":"O erro clássico é usar uma referência apenas como paleta. Isso preserva cores e destrói proporção, ocupação espacial, comportamento e hierarquia, justamente as partes que fazem a referência funcionar.","en":"The failure mode to watch in “AI design without “vibes”: an evaluation loop that can reject its own screen” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Rubrica visual que consegue dizer não","en":"Evidence that closes AI design without “vibes”: an evaluation loop that can reject its own screen","es":"Evidencia que cierra Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla","fr":"Preuve qui valide Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran"},"body":[{"pt":"O loop fecha quando cada crítica produz uma correção verificável e a nova captura é comparada com o checkpoint anterior. Se a nova versão piora leitura ou interação, ela não vira o novo baseline.","en":"For “AI design without “vibes”: an evaluation loop that can reject its own screen”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Diseño de IA sin “vibes”: un loop de evaluación capaz de reprobar su propia pantalla», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Design IA sans « vibes » : une boucle d’évaluation capable de rejeter son propre écran », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"giorgio-office-one-context-eight-surfaces","date":"2 de setembro de 2026","read":2,"category":"product","asset":"browserDoc","title":{"pt":"Giorgio Office: um contexto, oito superfícies de trabalho","en":"Giorgio Office: one context, eight work surfaces","es":"Giorgio Office: un contexto, ocho superficies","fr":"Giorgio Office : un contexte, huit surfaces de travail"},"dek":{"pt":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena e Acta dividem estado e agente sem virar um super-app indistinto.","en":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena, and Acta share state and an agent without becoming an indistinct super-app.","es":"Ocho apps comparten estado y agente sin convertirse en un super-app indistinto.","fr":"Huit apps partagent état et agent sans devenir un super-app indistinct."},"body":[{"pt":"A familiaridade vem da gramática de cada ferramenta; a novidade vem do fato de o agente poder atravessar os domínios. Uma tabela pode virar documento, slide e tarefa sem começar cada etapa do zero.","en":"Familiarity comes from each tool’s grammar; the new part is that the agent can cross domains. A table can become a document, slide, and task without starting every stage from zero.","es":"La familiaridad viene de la gramática de cada herramienta; la novedad es que el agente cruza dominios.","fr":"La familiarité vient de la grammaire de chaque outil ; la nouveauté est que l’agent traverse les domaines."}],"blocks":[{"title":{"pt":"Domínios claros","en":"Clear domains","es":"Dominios claros","fr":"Domaines clairs"},"body":[{"pt":"Cada app possui ownership de estado e um conjunto de operações previsíveis. Isso é mais importante para integração do que imitar visualmente um pacote de escritório existente.","en":"Each app owns state and a predictable set of operations. That matters more for integration than visually imitating an existing office package.","es":"Cada app posee estado y operaciones previsibles.","fr":"Chaque app possède son état et un ensemble d’opérations prévisibles."}]},{"title":{"pt":"Setup nativo","en":"Native setup","es":"Setup nativo","fr":"Setup natif"},"body":[{"pt":"A versão 7.85 adiciona instaladores PE32+ em Go para Desktop, Code e Ordo, com UI própria, atalhos e desinstalação.","en":"Version 7.85 adds PE32+ Go installers for Desktop, Code, and Ordo, with custom UI, shortcuts, and uninstall support.","es":"La versión 7.85 añade instaladores PE32+ en Go para Desktop, Code y Ordo.","fr":"La version 7.85 ajoute des installateurs PE32+ en Go pour Desktop, Code et Ordo."}]},{"title":{"pt":"Ordo mantém a gramática de planilha","en":"Ordo keeps spreadsheet grammar","es":"Ordo mantiene la gramática de hoja de cálculo","fr":"Ordo conserve la grammaire du tableur"},"body":[{"pt":"Grid, endereços de célula, barra de fórmula, múltiplas folhas, referências e funções continuam visíveis. A camada agentica entra para transformar e explicar o workbook, não para esconder a planilha atrás de um chat.","en":"Grid, cell addresses, formula bar, multiple sheets, references, and functions remain visible. The agentic layer transforms and explains the workbook rather than hiding the spreadsheet behind chat.","es":"Grid, celdas, barra de fórmulas y hojas siguen visibles; el agente no reemplaza la hoja por chat.","fr":"Grille, cellules, barre de formule et feuilles restent visibles ; l’agent ne remplace pas le tableur par un chat."}]},{"title":{"pt":"Scriptum trabalha com estrutura de documento","en":"Scriptum works with document structure","es":"Scriptum trabaja con estructura de documento","fr":"Scriptum travaille avec la structure du document"},"body":[{"pt":"Títulos, parágrafos, tabelas e estilos são objetos manipuláveis. O agente pode reestruturar uma seção ou montar uma versão nova preservando o restante do documento, em vez de devolver texto solto sem formato.","en":"Headings, paragraphs, tables, and styles are manipulable objects. The agent can restructure one section or build a new version while preserving the rest of the document instead of returning unformatted loose text.","es":"Títulos, párrafos, tablas y estilos son objetos manipulables.","fr":"Titres, paragraphes, tableaux et styles sont des objets manipulables."}]},{"title":{"pt":"Lumen separa narrativa de slide","en":"Lumen separates narrative from slide","es":"Lumen separa narrativa de slide","fr":"Lumen sépare narration et slide"},"body":[{"pt":"Conteúdo, ordem, speaker notes e tema não são a mesma camada. Isso permite ao Giorgio revisar a narrativa sem destruir layout e depois aplicar mudanças visuais de maneira controlada.","en":"Content, order, speaker notes, and theme are not the same layer. Giorgio can review the narrative without destroying layout and then apply controlled visual changes.","es":"Contenido, orden, notas y tema son capas distintas para permitir revisión sin destruir layout.","fr":"Contenu, ordre, notes et thème sont des couches distinctes pour permettre une révision sans détruire le layout."}]},{"title":{"pt":"Nodus, Convena e Acta trabalham com continuidade","en":"Nodus, Convena, and Acta work with continuity","es":"Nodus, Convena y Acta trabajan con continuidad","fr":"Nodus, Convena et Acta travaillent avec continuité"},"body":[{"pt":"Mensagens, decisões e tarefas podem carregar referências entre si. Uma conversa em Convena pode virar item de Acta; uma mensagem em Nodus pode alimentar um documento sem copiar manualmente todo o contexto.","en":"Messages, decisions, and tasks can carry references across surfaces. A Convena conversation can become an Acta item; a Nodus message can feed a document without manually copying the whole context.","es":"Mensajes, decisiones y tareas pueden mantener referencias entre superficies.","fr":"Messages, décisions et tâches peuvent conserver des références entre surfaces."}]},{"title":{"pt":"Sync tem ownership e conflito explícitos","en":"Sync has explicit ownership and conflict semantics","es":"Sync tiene ownership y conflictos explícitos","fr":"La synchronisation a un ownership et des conflits explicites"},"body":[{"pt":"Sincronizar não pode significar sobrescrever silenciosamente. Cada documento precisa de identidade, versão, dono, timestamp e estratégia para conflito. O agente só é confiável quando esse estado é observável e recuperável.","en":"Sync cannot mean silent overwrite. Each document needs identity, version, owner, timestamp, and conflict strategy. The agent is trustworthy only when that state is observable and recoverable.","es":"Sincronizar no puede significar sobrescribir en silencio; cada documento necesita identidad, versión y estrategia de conflicto.","fr":"Synchroniser ne peut pas signifier écraser silencieusement ; chaque document a besoin d’identité, version et stratégie de conflit."}]}],"lead":{"pt":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena e Acta dividem estado e agente sem virar um super-app indistinto.","en":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena, and Acta share state and an agent without becoming an indistinct super-app.","es":"Ocho apps comparten estado y agente sin convertirse en un super-app indistinto.","fr":"Huit apps partagent état et agent sans devenir un super-app indistinct."},"readingMinutes":{"pt":2,"en":2,"es":1,"fr":1}},{"slug":"giorgio-office-ordo-agentic-workbooks","category":"product","asset":"browserDoc","date":"2026-09-02","read":2,"title":{"pt":"Giorgio Office e Ordo: documentos deixam de ser arquivos passivos","en":"Giorgio Office and Ordo: documents stop being passive files","es":"Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos","fr":"Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs"},"lead":{"pt":"A suíte Office do Giorgio combina interfaces familiares de produtividade com um agente capaz de operar entre planilha, texto, slides e agenda.","en":"Giorgio Office combines familiar productivity interfaces with an agent that can operate across spreadsheets, documents, slides, and scheduling.","es":"Giorgio Office combina interfaces familiares de productividad con un agente capaz de operar entre hojas, documentos, slides y agenda.","fr":"Giorgio Office combine des interfaces de productivité familières avec un agent capable d’agir entre tableurs, documents, slides et agenda."},"blocks":[{"title":{"pt":"Ordo é a planilha","en":"Ordo is the spreadsheet","es":"Ordo es la hoja de cálculo","fr":"Ordo est le tableur"},"body":[{"pt":"Ordo trabalha com células, fórmulas, tabelas, filtros, importação CSV, exportação e cenários. A diferença está na camada agentica: o usuário pode pedir uma transformação em linguagem natural e ainda inspecionar as células alteradas.","en":"Ordo works with cells, formulas, tables, filters, CSV import, export, and scenarios. The difference is the agentic layer: users can request a transformation in natural language and still inspect the changed cells.","es":"Ordo trabaja con celdas, fórmulas, tablas, filtros, importación CSV, exportación y escenarios. La diferencia está en la capa agéntica: el usuario puede pedir una transformación en lenguaje natural e inspeccionar las celdas modificadas.","fr":"Ordo travaille avec cellules, formules, tableaux, filtres, import CSV, export et scénarios. La différence vient de la couche agentique : l’utilisateur peut demander une transformation en langage naturel et inspecter les cellules modifiées."}]},{"title":{"pt":"Scriptum, Lumen e Nodus","en":"Scriptum, Lumen, and Nodus","es":"Scriptum, Lumen y Nodus","fr":"Scriptum, Lumen et Nodus"},"body":[{"pt":"Scriptum cuida de documentos longos, estilos, comentários e revisão. Lumen transforma conteúdo em apresentações com layouts, notas e gráficos. Nodus reúne e-mail, calendário, tarefas e follow-ups. Todos compartilham o mesmo sistema de arquivos e contexto.","en":"Scriptum handles long documents, styles, comments, and review. Lumen turns content into presentations with layouts, notes, and charts. Nodus brings email, calendar, tasks, and follow-ups together. All share the same file and context system.","es":"Scriptum gestiona documentos largos, estilos, comentarios y revisión. Lumen transforma contenido en presentaciones con layouts, notas y gráficos. Nodus reúne correo, calendario, tareas y follow-ups. Todos comparten el mismo sistema de archivos y contexto.","fr":"Scriptum gère les documents longs, styles, commentaires et révision. Lumen transforme le contenu en présentations avec mises en page, notes et graphiques. Nodus réunit e-mail, calendrier, tâches et suivis. Tous partagent le même système de fichiers et de contexte."}]},{"title":{"pt":"Sincronização como estado visível","en":"Synchronization as visible state","es":"Sincronización como estado visible","fr":"La synchronisation comme état visible"},"body":[{"pt":"Sincronizar não deve ser um spinner misterioso. Cada arquivo mostra origem, última sincronização, conflitos, versão local e versão remota. O agente só automatiza depois que esse estado está claro.","en":"Sync should not be a mysterious spinner. Each file shows origin, last sync, conflicts, local version, and remote version. The agent automates only after that state is clear.","es":"Sincronizar no debe ser un spinner misterioso. Cada archivo muestra origen, última sincronización, conflictos, versión local y remota. El agente automatiza solo cuando ese estado está claro.","fr":"La synchronisation ne doit pas être un spinner mystérieux. Chaque fichier indique origine, dernière synchro, conflits, version locale et distante. L’agent n’automatise qu’une fois cet état clair."}]},{"title":{"pt":"Formatos importam","en":"Formats matter","es":"Los formatos importan","fr":"Les formats comptent"},"body":[{"pt":"A suíte foi pensada para trabalhar com CSV, XLSX, DOCX, PDF, PPTX e formatos web. Quando a exportação exata não estiver disponível, a interface deve dizer isso antes da edição e oferecer o formato preservável mais próximo.","en":"The suite is designed around CSV, XLSX, DOCX, PDF, PPTX, and web formats. When exact export is unavailable, the interface should say so before editing and offer the closest preservable format.","es":"La suite está pensada para CSV, XLSX, DOCX, PDF, PPTX y formatos web. Cuando la exportación exacta no esté disponible, la interfaz debe indicarlo antes de editar y ofrecer el formato preservable más cercano.","fr":"La suite est conçue autour de CSV, XLSX, DOCX, PDF, PPTX et formats web. Lorsque l’export exact n’est pas disponible, l’interface doit l’indiquer avant l’édition et proposer le format préservable le plus proche."}]},{"title":{"pt":"O contrato escondido em Documentos que compartilham estado","en":"The hidden contract in Giorgio Office and Ordo: documents stop being passive files","es":"El contrato oculto de Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos","fr":"Le contrat caché de Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs"},"body":[{"pt":"Ordo ganha valor quando a planilha deixa de terminar na célula. Uma seleção pode alimentar Scriptum, virar gráfico em Lumen, gerar follow-up no Nodus e continuar associada ao mesmo projeto e ao mesmo contexto do Giorgio.","en":"The useful way to read “Giorgio Office and Ordo: documents stop being passive files” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"controle visível produz efeito real","en":"controle visível produz efeito real","es":"controle visível produz efeito real","fr":"controle visível produz efeito real"},{"pt":"estado persiste ou sincroniza quando prometido","en":"estado persiste ou sincroniza quando prometido","es":"estado persiste ou sincroniza quando prometido","fr":"estado persiste ou sincroniza quando prometido"},{"pt":"saída pode ser reutilizada fora da tela atual","en":"saída pode ser reutilizada fora da tela atual","es":"saída pode ser reutilizada fora da tela atual","fr":"saída pode ser reutilizada fora da tela atual"}]},{"title":{"pt":"Falha específica: Documentos que compartilham estado","en":"Specific failure mode: Giorgio Office and Ordo: documents stop being passive files","es":"Fallo específico: Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos","fr":"Mode de défaillance : Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs"},"body":[{"pt":"O maior risco é sincronização sem modelo de propriedade: dois clientes editam a mesma versão, um sobrescreve o outro e o usuário vê “sincronizado” mesmo tendo perdido trabalho.","en":"The failure mode to watch in “Giorgio Office and Ordo: documents stop being passive files” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Documentos que compartilham estado","en":"Evidence that closes Giorgio Office and Ordo: documents stop being passive files","es":"Evidencia que cierra Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos","fr":"Preuve qui valide Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs"},"body":[{"pt":"O critério prático é simples: conteúdo local precisa sobreviver ao refresh; sync autenticado precisa recuperar o último estado; exportação precisa produzir um arquivo real; e o agente deve declarar qual documento está usando como contexto.","en":"For “Giorgio Office and Ordo: documents stop being passive files”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Giorgio Office y Ordo: los documentos dejan de ser archivos pasivos», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Giorgio Office et Ordo : les documents cessent d’être des fichiers passifs », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"thesis-16-adaptive-reasoning","category":"models","asset":"barChart","title":{"pt":"Thesis 1.6: raciocínio adaptativo para trabalho de precisão","en":"Thesis 1.6: adaptive reasoning for precision work","es":"Thesis 1.6: razonamiento adaptativo para trabajo de precisión","fr":"Thesis 1.6 : raisonnement adaptatif pour les travaux de précision"},"lead":{"pt":"Como o runtime de precisão do Giorgio escala esforço, preflight e disciplina de código conforme a complexidade da tarefa.","en":"How Giorgio’s precision runtime scales effort, preflight, and coding discipline with task complexity.","es":"Cómo el runtime de precisión de Giorgio escala esfuerzo, preflight y disciplina de código según la complejidad de la tarea.","fr":"Comment le runtime de précision de Giorgio adapte l’effort, le preflight et la discipline de code à la complexité de la tâche."},"date":"2026-09-01","read":2,"blocks":[{"title":{"pt":"O que muda em relação a uma rota rápida","en":"What changes versus a fast route","es":"Qué cambia frente a una ruta rápida","fr":"Ce qui change par rapport à une route rapide"},"body":[{"pt":"Thesis 1.6 é a rota de precisão do Giorgio para tarefas que exigem arquitetura, revisão ampla ou mudanças que atravessam vários arquivos. O objetivo não é produzir uma resposta maior, mas dedicar mais trabalho à localização do problema, ao plano e à verificação antes da entrega.","en":"Thesis 1.6 is Giorgio’s precision route for tasks that require architecture work, broad review, or changes across multiple files. The goal is not a longer answer, but more work spent locating the problem, planning, and verifying before delivery.","es":"Thesis 1.6 es la ruta de precisión de Giorgio para tareas que exigen arquitectura, revisión amplia o cambios en varios archivos. El objetivo no es producir una respuesta más larga, sino dedicar más trabajo a localizar el problema, planificar y verificar antes de entregar.","fr":"Thesis 1.6 est la route de précision de Giorgio pour les tâches nécessitant de l’architecture, une revue large ou des modifications multi-fichiers. L’objectif n’est pas une réponse plus longue, mais davantage de travail consacré à localiser le problème, planifier et vérifier avant livraison."},{"pt":"Nos níveis Extra e Max, o runtime adiciona uma etapa de preflight mais rígida antes da resposta final. Isso é especialmente útil quando uma alteração aparentemente simples pode causar regressões fora do arquivo tocado.","en":"At Extra and Max, the runtime adds a stricter preflight before the final answer. This is especially useful when a seemingly simple change may cause regressions outside the file being edited.","es":"En Extra y Max, el runtime añade un preflight más estricto antes de la respuesta final. Esto es especialmente útil cuando un cambio aparentemente simple puede causar regresiones fuera del archivo modificado.","fr":"Aux niveaux Extra et Max, le runtime ajoute un preflight plus strict avant la réponse finale. C’est particulièrement utile lorsqu’une modification apparemment simple peut provoquer des régressions hors du fichier modifié."}]},{"title":{"pt":"Quando usar","en":"When to use it","es":"Cuándo usarlo","fr":"Quand l’utiliser"},"bullets":[{"pt":"Refactors de vários arquivos e mudanças de arquitetura.","en":"Multi-file refactors and architecture changes.","es":"Refactors de varios archivos y cambios de arquitectura.","fr":"Refactors multi-fichiers et changements d’architecture."},{"pt":"Falhas em que a causa raiz não está óbvia no primeiro log.","en":"Failures where the root cause is not obvious in the first log.","es":"Fallos cuya causa raíz no es evidente en el primer log.","fr":"Pannes dont la cause racine n’est pas évidente dans le premier log."},{"pt":"Revisões em que regressão e compatibilidade importam mais que velocidade.","en":"Reviews where regression risk and compatibility matter more than speed.","es":"Revisiones donde la regresión y la compatibilidad importan más que la velocidad.","fr":"Revues où le risque de régression et la compatibilité comptent plus que la vitesse."}]},{"title":{"pt":"O que ele não substitui","en":"What it does not replace","es":"Lo que no reemplaza","fr":"Ce qu’il ne remplace pas"},"body":[{"pt":"Mais raciocínio não elimina a necessidade de evidência. Testes, terminal, preview, diffs e arquivos continuam sendo as fontes que confirmam se a mudança funciona no ambiente real.","en":"More reasoning does not remove the need for evidence. Tests, terminal output, previews, diffs, and files still confirm whether a change works in the real environment.","es":"Más razonamiento no elimina la necesidad de evidencia. Pruebas, terminal, preview, diffs y archivos siguen confirmando si el cambio funciona en el entorno real.","fr":"Davantage de raisonnement ne remplace pas les preuves. Tests, terminal, aperçus, diffs et fichiers restent nécessaires pour confirmer le fonctionnement réel."}]},{"title":{"pt":"O mecanismo central de Esforço proporcional à ambiguidade","en":"The core mechanism of Thesis 1.6: adaptive reasoning for precision work","es":"El mecanismo central de Thesis 1.6: razonamiento adaptativo para trabajo de precisión","fr":"Le mécanisme central de Thesis 1.6 : raisonnement adaptatif pour les travaux de précision"},"body":[{"pt":"Thesis 1.6 continua útil como rota de precisão quando o problema é bem delimitado mas exige rastrear contratos, regressões e evidência antes de escrever. A adaptação deve responder à incerteza real, não ao tamanho superficial do prompt.","en":"The useful way to read “Thesis 1.6: adaptive reasoning for precision work” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Thesis 1.6: razonamiento adaptativo para trabajo de precisión» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Thesis 1.6 : raisonnement adaptatif pour les travaux de précision » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Esforço proporcional à ambiguidade","en":"Specific failure mode: Thesis 1.6: adaptive reasoning for precision work","es":"Fallo específico: Thesis 1.6: razonamiento adaptativo para trabajo de precisión","fr":"Mode de défaillance : Thesis 1.6 : raisonnement adaptatif pour les travaux de précision"},"body":[{"pt":"O risco é confundir “mais thinking” com “mais qualidade” e gastar orçamento em um problema que precisava apenas de inspeção correta do arquivo ou de uma chamada de ferramenta.","en":"The failure mode to watch in “Thesis 1.6: adaptive reasoning for precision work” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Thesis 1.6: razonamiento adaptativo para trabajo de precisión» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Thesis 1.6 : raisonnement adaptatif pour les travaux de précision » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Esforço proporcional à ambiguidade","en":"Evidence that closes Thesis 1.6: adaptive reasoning for precision work","es":"Evidencia que cierra Thesis 1.6: razonamiento adaptativo para trabajo de precisión","fr":"Preuve qui valide Thesis 1.6 : raisonnement adaptatif pour les travaux de précision"},"body":[{"pt":"A boa escolha reduz retrabalho: tarefas pequenas permanecem rápidas; mudanças com múltiplas fronteiras ganham preflight, validação e revisão independentes.","en":"For “Thesis 1.6: adaptive reasoning for precision work”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Thesis 1.6: razonamiento adaptativo para trabajo de precisión», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Thesis 1.6 : raisonnement adaptatif pour les travaux de précision », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Critério de roteamento como gate","en":"routing criterion as a gate","es":"criterio de enrutamiento como gate","fr":"critère de routage comme gate"},"body":[{"pt":"Em “Thesis 1.6: raciocínio adaptativo para trabalho de precisão”, o ponto técnico que fecha a análise é tratar modelo, esforço e custo como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Thesis 1.6: adaptive reasoning for precision work”, the technical point that closes the analysis is to treat model, effort, and cost as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Thesis 1.6: razonamiento adaptativo para trabajo de precisión”, el cierre técnico es tratar modelo, esfuerzo y coste como un único contrato y exigir comportamiento verificable.","fr":"Dans « Thesis 1.6 : raisonnement adaptatif pour les travaux de précision », le point technique final consiste à traiter modèle, effort et coût comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"melos-low-latency-path","category":"models","asset":"cloudHand","title":{"pt":"Melos: a rota de baixa latência para trabalho cotidiano","en":"Melos: the low-latency route for everyday work","es":"Melos: la ruta de baja latencia para el trabajo cotidiano","fr":"Melos : la route faible latence pour le travail quotidien"},"lead":{"pt":"Onde uma rota mais leve é melhor que gastar o maior orçamento de raciocínio em toda solicitação.","en":"Where a lighter route is better than spending the largest reasoning budget on every request.","es":"Dónde una ruta más ligera es mejor que gastar el mayor presupuesto de razonamiento en cada solicitud.","fr":"Quand une route plus légère vaut mieux que dépenser le budget de raisonnement maximal pour chaque demande."},"date":"2026-09-01","read":2,"blocks":[{"title":{"pt":"Velocidade também é parte da qualidade","en":"Speed is also part of quality","es":"La velocidad también es parte de la calidad","fr":"La vitesse fait aussi partie de la qualité"},"body":[{"pt":"Melos é a rota rápida do Giorgio para trabalho diário, respostas criativas e alterações de código mais leves. Em tarefas pequenas, reduzir latência melhora o ciclo de pedir, revisar e corrigir sem sacrificar o controle do usuário.","en":"Melos is Giorgio’s fast route for everyday work, creative responses, and lighter coding changes. On small tasks, lower latency improves the request-review-correct loop without sacrificing user control.","es":"Melos es la ruta rápida de Giorgio para trabajo diario, respuestas creativas y cambios de código más ligeros. En tareas pequeñas, una menor latencia mejora el ciclo pedir-revisar-corregir sin perder control.","fr":"Melos est la route rapide de Giorgio pour le travail quotidien, les réponses créatives et les modifications de code plus légères. Sur les petites tâches, une latence réduite améliore la boucle demander-revoir-corriger sans sacrifier le contrôle."}]},{"title":{"pt":"Bom encaixe","en":"Good fit","es":"Buen encaje","fr":"Bon usage"},"bullets":[{"pt":"Perguntas diretas e tarefas com poucos passos.","en":"Direct questions and tasks with few steps.","es":"Preguntas directas y tareas con pocos pasos.","fr":"Questions directes et tâches en peu d’étapes."},{"pt":"Ajustes pequenos de interface ou conteúdo.","en":"Small interface or content adjustments.","es":"Ajustes pequeños de interfaz o contenido.","fr":"Petits ajustements d’interface ou de contenu."},{"pt":"Primeira passada em trabalho que será revisado depois.","en":"A first pass on work that will be reviewed afterward.","es":"Una primera pasada en trabajo que será revisado después.","fr":"Une première passe sur un travail qui sera revu ensuite."}]},{"title":{"pt":"Quando trocar de rota","en":"When to switch routes","es":"Cuándo cambiar de ruta","fr":"Quand changer de route"},"body":[{"pt":"Se a tarefa cresce, começa a atravessar vários módulos ou exige diagnóstico de causa raiz, vale migrar para Thesis ou Thesis 1.6 em vez de insistir na rota rápida. A seleção de modelo é uma decisão de carga de trabalho, não uma competição de nomes.","en":"If the task grows, starts crossing multiple modules, or requires root-cause diagnosis, it is better to move to Thesis or Thesis 1.6 rather than forcing the fast route. Model choice is a workload decision, not a contest of names.","es":"Si la tarea crece, cruza varios módulos o exige diagnóstico de causa raíz, conviene pasar a Thesis o Thesis 1.6 en lugar de forzar la ruta rápida. Elegir modelo es una decisión de carga de trabajo, no una competencia de nombres.","fr":"Si la tâche grandit, traverse plusieurs modules ou exige un diagnostic de cause racine, mieux vaut passer à Thesis ou Thesis 1.6 que forcer la route rapide. Le choix du modèle dépend de la charge de travail, pas d’une compétition de noms."}]},{"title":{"pt":"A engenharia por trás de Latência baixa sem fingir profundidade","en":"The engineering behind Melos: the low-latency route for everyday work","es":"La ingeniería detrás de Melos: la ruta de baja latencia para el trabajo cotidiano","fr":"L’ingénierie derrière Melos : la route faible latence pour le travail quotidien"},"body":[{"pt":"Melos funciona melhor quando a tarefa tem baixa ambiguidade, poucas dependências e retorno fácil de verificar. O objetivo é chegar cedo a uma resposta útil sem acionar uma orquestração pesada que custaria mais do que o problema.","en":"The useful way to read “Melos: the low-latency route for everyday work” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Melos: la ruta de baja latencia para el trabajo cotidiano» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Melos : la route faible latence pour le travail quotidien » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Latência baixa sem fingir profundidade","en":"Specific failure mode: Melos: the low-latency route for everyday work","es":"Fallo específico: Melos: la ruta de baja latencia para el trabajo cotidiano","fr":"Mode de défaillance : Melos : la route faible latence pour le travail quotidien"},"body":[{"pt":"O perigo é promover Melos automaticamente em mudanças com autenticação, persistência ou contratos cruzados só porque o prompt parece curto.","en":"The failure mode to watch in “Melos: the low-latency route for everyday work” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Melos: la ruta de baja latencia para el trabajo cotidiano» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Melos : la route faible latence pour le travail quotidien » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Latência baixa sem fingir profundidade","en":"Evidence that closes Melos: the low-latency route for everyday work","es":"Evidencia que cierra Melos: la ruta de baja latencia para el trabajo cotidiano","fr":"Preuve qui valide Melos : la route faible latence pour le travail quotidien"},"body":[{"pt":"Um roteador saudável mede risco e dependências antes de velocidade. Se o trabalho ultrapassa o limite da rota rápida, a transição para Thesis deve ser explícita e preservar o contexto já observado.","en":"For “Melos: the low-latency route for everyday work”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Melos: la ruta de baja latencia para el trabajo cotidiano», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Melos : la route faible latence pour le travail quotidien », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Critério de roteamento como gate","en":"routing criterion as a gate","es":"criterio de enrutamiento como gate","fr":"critère de routage comme gate"},"body":[{"pt":"Em “Melos: a rota de baixa latência para trabalho cotidiano”, o ponto técnico que fecha a análise é tratar modelo, esforço e custo como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Melos: the low-latency route for everyday work”, the technical point that closes the analysis is to treat model, effort, and cost as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Melos: la ruta de baja latencia para el trabajo cotidiano”, el cierre técnico es tratar modelo, esfuerzo y coste como un único contrato y exigir comportamiento verificable.","fr":"Dans « Melos : la route faible latence pour le travail quotidien », le point technique final consiste à traiter modèle, effort et coût comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"choosing-model-by-workload","category":"models","asset":"peopleGroup","title":{"pt":"Escolher modelo pela carga de trabalho, não pelo hábito","en":"Choose a model by workload, not habit","es":"Elegir modelo por carga de trabajo, no por costumbre","fr":"Choisir un modèle selon la charge, pas par habitude"},"lead":{"pt":"Uma regra prática para decidir entre velocidade, profundidade e custo de iteração dentro do Giorgio.","en":"A practical rule for deciding between speed, depth, and iteration cost inside Giorgio.","es":"Una regla práctica para decidir entre velocidad, profundidad y costo de iteración dentro de Giorgio.","fr":"Une règle pratique pour arbitrer vitesse, profondeur et coût d’itération dans Giorgio."},"date":"2026-09-01","read":2,"blocks":[{"title":{"pt":"Comece pela tarefa","en":"Start with the task","es":"Empieza por la tarea","fr":"Commencez par la tâche"},"body":[{"pt":"Antes de escolher um modelo, pergunte quantos arquivos, dependências e etapas de verificação a tarefa envolve. Um pedido curto com resultado facilmente observável pede um perfil diferente de um refactor que precisa preservar contratos e evitar regressões.","en":"Before choosing a model, ask how many files, dependencies, and verification steps the task involves. A short request with an easily observable result needs a different profile from a refactor that must preserve contracts and avoid regressions.","es":"Antes de elegir un modelo, pregunta cuántos archivos, dependencias y pasos de verificación implica la tarea. Una solicitud corta con resultado fácil de observar necesita un perfil distinto de un refactor que debe preservar contratos y evitar regresiones.","fr":"Avant de choisir un modèle, demandez combien de fichiers, dépendances et étapes de vérification la tâche implique. Une demande courte avec un résultat facile à observer n’a pas le même profil qu’un refactor devant préserver des contrats et éviter les régressions."}]},{"title":{"pt":"Heurística simples","en":"A simple heuristic","es":"Una heurística simple","fr":"Une heuristique simple"},"bullets":[{"pt":"Poucos passos e resultado óbvio: prefira a rota rápida.","en":"Few steps and an obvious result: prefer the fast route.","es":"Pocos pasos y resultado obvio: prefiere la ruta rápida.","fr":"Peu d’étapes et résultat évident : préférez la route rapide."},{"pt":"Múltiplos arquivos ou diagnóstico: aumente profundidade.","en":"Multiple files or diagnosis: increase depth.","es":"Varios archivos o diagnóstico: aumenta la profundidad.","fr":"Plusieurs fichiers ou diagnostic : augmentez la profondeur."},{"pt":"Mudança crítica ou difícil de reverter: use revisão mais rigorosa.","en":"Critical or hard-to-revert change: use stricter review.","es":"Cambio crítico o difícil de revertir: usa una revisión más estricta.","fr":"Modification critique ou difficile à annuler : utilisez une revue plus stricte."}]},{"title":{"pt":"O melhor modelo é contextual","en":"The best model is contextual","es":"El mejor modelo depende del contexto","fr":"Le meilleur modèle dépend du contexte"},"body":[{"pt":"Não existe ganho real em usar o maior orçamento para tudo. O ganho vem de combinar o nível de esforço com o risco e a complexidade do trabalho.","en":"There is no real gain in using the largest budget for everything. The gain comes from matching effort to the risk and complexity of the work.","es":"No hay una ganancia real en usar el mayor presupuesto para todo. La ganancia viene de adaptar el esfuerzo al riesgo y a la complejidad del trabajo.","fr":"Il n’y a pas de gain réel à utiliser le budget maximal partout. Le gain vient de l’adéquation entre l’effort, le risque et la complexité du travail."}]},{"title":{"pt":"O ponto que decide Roteamento por risco, não por apego ao nome","en":"The decision point in Choose a model by workload, not habit","es":"El punto decisivo de Elegir modelo por carga de trabajo, no por costumbre","fr":"Le point décisif de Choisir un modèle selon la charge, pas par habitude"},"body":[{"pt":"Escolher o modelo pela carga de trabalho significa olhar incerteza, necessidade de ferramentas, tamanho do grafo de dependências, reversibilidade e custo de uma resposta errada. O nome do modelo é consequência dessa leitura.","en":"The useful way to read “Choose a model by workload, not habit” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Elegir modelo por carga de trabajo, no por costumbre» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Choisir un modèle selon la charge, pas par habitude » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Roteamento por risco, não por apego ao nome","en":"Specific failure mode: Choose a model by workload, not habit","es":"Fallo específico: Elegir modelo por carga de trabajo, no por costumbre","fr":"Mode de défaillance : Choisir un modèle selon la charge, pas par habitude"},"body":[{"pt":"O anti-padrão é manter o mesmo modelo para tudo e compensar depois com prompts cada vez maiores, criando mais contexto e menos sinal.","en":"The failure mode to watch in “Choose a model by workload, not habit” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Elegir modelo por carga de trabajo, no por costumbre» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Choisir un modèle selon la charge, pas par habitude » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Roteamento por risco, não por apego ao nome","en":"Evidence that closes Choose a model by workload, not habit","es":"Evidencia que cierra Elegir modelo por carga de trabajo, no por costumbre","fr":"Preuve qui valide Choisir un modèle selon la charge, pas par habitude"},"body":[{"pt":"O critério de sucesso é uma política previsível: tarefa simples vai para rota rápida; tarefa longa ou arriscada ganha planejamento, ferramentas, revisão e orçamento compatíveis.","en":"For “Choose a model by workload, not habit”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Elegir modelo por carga de trabajo, no por costumbre», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Choisir un modèle selon la charge, pas par habitude », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Critério de roteamento como gate","en":"routing criterion as a gate","es":"criterio de enrutamiento como gate","fr":"critère de routage comme gate"},"body":[{"pt":"Em “Escolher modelo pela carga de trabalho, não pelo hábito”, o ponto técnico que fecha a análise é tratar modelo, esforço e custo como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Choose a model by workload, not habit”, the technical point that closes the analysis is to treat model, effort, and cost as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Elegir modelo por carga de trabajo, no por costumbre”, el cierre técnico es tratar modelo, esfuerzo y coste como un único contrato y exigir comportamiento verificable.","fr":"Dans « Choisir un modèle selon la charge, pas par habitude », le point technique final consiste à traiter modèle, effort et coût comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"independent-thesis-melos-review","category":"engineering","asset":"peopleGroup","title":{"pt":"Revisão independente com Thesis e Melos antes de aceitar uma mudança","en":"Independent Thesis and Melos review before accepting a change","es":"Revisión independiente con Thesis y Melos antes de aceptar un cambio","fr":"Revue indépendante Thesis et Melos avant d’accepter une modification"},"lead":{"pt":"Por que duas rotas com perfis diferentes podem encontrar falhas que uma única geração deixa passar.","en":"Why two routes with different profiles can catch failures a single generation may miss.","es":"Por qué dos rutas con perfiles distintos pueden detectar fallos que una sola generación puede dejar pasar.","fr":"Pourquoi deux routes aux profils différents peuvent détecter des défauts qu’une seule génération laisse passer."},"date":"2026-08-31","read":2,"blocks":[{"title":{"pt":"Gerar e revisar são papéis diferentes","en":"Generation and review are different roles","es":"Generar y revisar son roles diferentes","fr":"Générer et réviser sont deux rôles différents"},"body":[{"pt":"No fluxo de código do Giorgio, o candidato pode ser submetido a uma revisão independente usando Thesis e Melos como avaliadores separados. A ideia é reduzir o viés de uma única trajetória de raciocínio antes de aceitar uma alteração.","en":"In Giorgio’s coding flow, a candidate can be submitted to an independent review using Thesis and Melos as separate reviewers. The goal is to reduce the bias of a single reasoning path before accepting a change.","es":"En el flujo de código de Giorgio, un candidato puede someterse a una revisión independiente usando Thesis y Melos como revisores separados. La idea es reducir el sesgo de una sola trayectoria de razonamiento antes de aceptar un cambio.","fr":"Dans le flux de code de Giorgio, un candidat peut être soumis à une revue indépendante utilisant Thesis et Melos comme réviseurs séparés. L’objectif est de réduire le biais d’une seule trajectoire de raisonnement avant d’accepter une modification."}]},{"title":{"pt":"O que a revisão procura","en":"What the review looks for","es":"Qué busca la revisión","fr":"Ce que cherche la revue"},"bullets":[{"pt":"Contrato quebrado entre arquivos ou módulos.","en":"A broken contract between files or modules.","es":"Un contrato roto entre archivos o módulos.","fr":"Un contrat rompu entre fichiers ou modules."},{"pt":"Teste ou verificação ausente para um caminho crítico.","en":"A missing test or verification for a critical path.","es":"Una prueba o verificación ausente para una ruta crítica.","fr":"Un test ou une vérification manquante pour un chemin critique."},{"pt":"Diagnóstico que não explica a evidência observada.","en":"A diagnosis that does not explain the observed evidence.","es":"Un diagnóstico que no explica la evidencia observada.","fr":"Un diagnostic qui n’explique pas les preuves observées."}]},{"title":{"pt":"Rejeitar também é resultado","en":"Rejection is also a result","es":"Rechazar también es un resultado","fr":"Le rejet est aussi un résultat"},"body":[{"pt":"Se a revisão independente não encontra evidência suficiente para aceitar o candidato, o melhor comportamento é rejeitar e voltar ao diagnóstico. Um sistema confiável precisa saber parar, não apenas continuar produzindo patches.","en":"If independent review cannot find enough evidence to accept a candidate, the better behavior is to reject it and return to diagnosis. A reliable system must know how to stop, not just keep producing patches.","es":"Si la revisión independiente no encuentra evidencia suficiente para aceptar el candidato, lo correcto es rechazarlo y volver al diagnóstico. Un sistema confiable debe saber detenerse, no solo seguir produciendo parches.","fr":"Si la revue indépendante ne trouve pas suffisamment de preuves pour accepter le candidat, le meilleur comportement est de le rejeter et de revenir au diagnostic. Un système fiable doit savoir s’arrêter, pas seulement continuer à produire des correctifs."}]},{"title":{"pt":"Como Discordância é um recurso de qualidade deixa de ser só interface","en":"How Independent Thesis and Melos review before accepting a change becomes more than interface","es":"Cómo Revisión independiente con Thesis y Melos antes de aceptar un cambio deja de ser solo interfaz","fr":"Comment Revue indépendante Thesis et Melos avant d’accepter une modification dépasse la simple interface"},"body":[{"pt":"Revisão independente só acrescenta valor quando o segundo modelo recebe liberdade para discordar e critérios diferentes do gerador. Thesis pode atacar arquitetura e contratos enquanto Melos procura inconsistências simples, ausência de estados e comportamento que não fecha.","en":"The useful way to read “Independent Thesis and Melos review before accepting a change” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Revisión independiente con Thesis y Melos antes de aceptar un cambio» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Revue indépendante Thesis et Melos avant d’accepter une modification » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"causa raiz vem antes do fallback","en":"causa raiz vem antes do fallback","es":"causa raiz vem antes do fallback","fr":"causa raiz vem antes do fallback"},{"pt":"mudança não quebra subsistemas fora do escopo","en":"mudança não quebra subsistemas fora do escopo","es":"mudança não quebra subsistemas fora do escopo","fr":"mudança não quebra subsistemas fora do escopo"},{"pt":"logs e códigos permitem reproduzir a falha","en":"logs e códigos permitem reproduzir a falha","es":"logs e códigos permitem reproduzir a falha","fr":"logs e códigos permitem reproduzir a falha"}]},{"title":{"pt":"Falha específica: Discordância é um recurso de qualidade","en":"Specific failure mode: Independent Thesis and Melos review before accepting a change","es":"Fallo específico: Revisión independiente con Thesis y Melos antes de aceptar un cambio","fr":"Mode de défaillance : Revue indépendante Thesis et Melos avant d’accepter une modification"},"body":[{"pt":"Se o revisor recebe a conclusão do gerador como verdade, a segunda passagem vira validação social automatizada.","en":"The failure mode to watch in “Independent Thesis and Melos review before accepting a change” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Revisión independiente con Thesis y Melos antes de aceptar un cambio» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Revue indépendante Thesis et Melos avant d’accepter une modification » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Discordância é um recurso de qualidade","en":"Evidence that closes Independent Thesis and Melos review before accepting a change","es":"Evidencia que cierra Revisión independiente con Thesis y Melos antes de aceptar un cambio","fr":"Preuve qui valide Revue indépendante Thesis et Melos avant d’accepter une modification"},"body":[{"pt":"Uma revisão boa produz findings acionáveis, classifica severidade e só força repair quando há defeito material. Discordância sem evidência não deve bloquear uma entrega válida.","en":"For “Independent Thesis and Melos review before accepting a change”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Revisión independiente con Thesis y Melos antes de aceptar un cambio», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Revue indépendante Thesis et Melos avant d’accepter une modification », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Falha que esse desenho evita como gate","en":"failure this design prevents as a gate","es":"fallo que este diseño evita como gate","fr":"panne évitée par cette conception comme gate"},"body":[{"pt":"Em “Revisão independente com Thesis e Melos antes de aceitar uma mudança”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Independent Thesis and Melos review before accepting a change”, the technical point that closes the analysis is to treat ownership, recovery, and observability as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Revisión independiente con Thesis y Melos antes de aceptar un cambio”, el cierre técnico es tratar ownership, recuperación y observabilidad como un único contrato y exigir comportamiento verificable.","fr":"Dans « Revue indépendante Thesis et Melos avant d’accepter une modification », le point technique final consiste à traiter ownership, reprise et observabilité comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"reasoning-effort-is-a-budget","category":"models","asset":"barChart","title":{"pt":"Esforço de raciocínio é um orçamento, não um botão de qualidade","en":"Reasoning effort is a budget, not a quality button","es":"El esfuerzo de razonamiento es un presupuesto, no un botón de calidad","fr":"L’effort de raisonnement est un budget, pas un bouton de qualité"},"lead":{"pt":"Como Low, Medium, High, Extra e Max mudam a quantidade de trabalho interno sem substituir boas evidências.","en":"How Low, Medium, High, Extra, and Max change the amount of internal work without replacing good evidence.","es":"Cómo Low, Medium, High, Extra y Max cambian la cantidad de trabajo interno sin reemplazar una buena evidencia.","fr":"Comment Low, Medium, High, Extra et Max modifient le travail interne sans remplacer de bonnes preuves."},"date":"2026-08-31","read":2,"blocks":[{"title":{"pt":"Mais esforço tem custo","en":"More effort has a cost","es":"Más esfuerzo tiene un costo","fr":"Plus d’effort a un coût"},"body":[{"pt":"Aumentar o esforço permite que a sessão dedique mais tempo a planejamento, comparação de hipóteses e verificação. Isso é útil em tarefas difíceis, mas pode ser desperdício quando o resultado é simples de observar e corrigir.","en":"Increasing effort lets the session spend more time on planning, comparing hypotheses, and verification. That helps on difficult tasks, but can be wasteful when the result is easy to observe and correct.","es":"Aumentar el esfuerzo permite dedicar más tiempo a planificación, comparación de hipótesis y verificación. Eso ayuda en tareas difíciles, pero puede ser desperdicio cuando el resultado es fácil de observar y corregir.","fr":"Augmenter l’effort permet à la session de consacrer plus de temps à la planification, à la comparaison d’hypothèses et à la vérification. C’est utile pour les tâches difficiles, mais inutile lorsque le résultat est facile à observer et corriger."}]},{"title":{"pt":"Quando subir","en":"When to increase it","es":"Cuándo aumentarlo","fr":"Quand l’augmenter"},"bullets":[{"pt":"Há muitas dependências e o erro pode estar longe do sintoma.","en":"There are many dependencies and the error may be far from the symptom.","es":"Hay muchas dependencias y el error puede estar lejos del síntoma.","fr":"Il existe de nombreuses dépendances et l’erreur peut être loin du symptôme."},{"pt":"A tarefa exige várias etapas de planejamento e revisão.","en":"The task requires multiple planning and review steps.","es":"La tarea exige varias etapas de planificación y revisión.","fr":"La tâche exige plusieurs étapes de planification et de revue."},{"pt":"Uma regressão teria custo alto ou seria difícil de detectar.","en":"A regression would be costly or hard to detect.","es":"Una regresión tendría un costo alto o sería difícil de detectar.","fr":"Une régression serait coûteuse ou difficile à détecter."}]},{"title":{"pt":"Quando não subir","en":"When not to increase it","es":"Cuándo no aumentarlo","fr":"Quand ne pas l’augmenter"},"body":[{"pt":"Para alterações pequenas, use o menor nível que ainda produz qualidade suficiente. O objetivo é eficiência proporcional, não maximizar esforço por reflexo.","en":"For small changes, use the lowest level that still produces enough quality. The goal is proportional efficiency, not maximizing effort by reflex.","es":"Para cambios pequeños, usa el nivel más bajo que aún ofrezca calidad suficiente. El objetivo es eficiencia proporcional, no maximizar esfuerzo por reflejo.","fr":"Pour les petites modifications, utilisez le niveau le plus bas qui offre encore une qualité suffisante. L’objectif est l’efficacité proportionnelle, pas l’effort maximal par réflexe."}]},{"title":{"pt":"Por dentro de Orçamento deve comprar redução de incerteza","en":"Inside Reasoning effort is a budget, not a quality button","es":"Por dentro de El esfuerzo de razonamiento es un presupuesto, no un botón de calidad","fr":"Au cœur de L’effort de raisonnement est un budget, pas un bouton de qualité"},"body":[{"pt":"Esforço de raciocínio é útil quando cada etapa adicional compra alguma coisa: mais inspeção, comparação de hipóteses, chamada de ferramenta, teste, revisão ou síntese de evidência. Pensar mais sem novos sinais apenas alonga a resposta.","en":"The useful way to read “Reasoning effort is a budget, not a quality button” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «El esfuerzo de razonamiento es un presupuesto, no un botón de calidad» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « L’effort de raisonnement est un budget, pas un bouton de qualité » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Orçamento deve comprar redução de incerteza","en":"Specific failure mode: Reasoning effort is a budget, not a quality button","es":"Fallo específico: El esfuerzo de razonamiento es un presupuesto, no un botón de calidad","fr":"Mode de défaillance : L’effort de raisonnement est un budget, pas un bouton de qualité"},"body":[{"pt":"O risco de um botão Max mal desenhado é transformar custo em ritual e dar ao usuário a impressão de que respostas curtas são deliberadamente piores.","en":"The failure mode to watch in “Reasoning effort is a budget, not a quality button” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «El esfuerzo de razonamiento es un presupuesto, no un botón de calidad» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « L’effort de raisonnement est un budget, pas un bouton de qualité » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Orçamento deve comprar redução de incerteza","en":"Evidence that closes Reasoning effort is a budget, not a quality button","es":"Evidencia que cierra El esfuerzo de razonamiento es un presupuesto, no un botón de calidad","fr":"Preuve qui valide L’effort de raisonnement est un budget, pas un bouton de qualité"},"body":[{"pt":"O sistema ideal mostra esforço como estratégia: Low para tarefas triviais, níveis maiores para risco e complexidade, e possibilidade de encerrar cedo quando a evidência já fechou a questão.","en":"For “Reasoning effort is a budget, not a quality button”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «El esfuerzo de razonamiento es un presupuesto, no un botón de calidad», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « L’effort de raisonnement est un budget, pas un bouton de qualité », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Critério de roteamento como gate","en":"routing criterion as a gate","es":"criterio de enrutamiento como gate","fr":"critère de routage comme gate"},"body":[{"pt":"Em “Esforço de raciocínio é um orçamento, não um botão de qualidade”, o ponto técnico que fecha a análise é tratar modelo, esforço e custo como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Reasoning effort is a budget, not a quality button”, the technical point that closes the analysis is to treat model, effort, and cost as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “El esfuerzo de razonamiento es un presupuesto, no un botón de calidad”, el cierre técnico es tratar modelo, esfuerzo y coste como un único contrato y exigir comportamiento verificable.","fr":"Dans « L’effort de raisonnement est un budget, pas un bouton de qualité », le point technique final consiste à traiter modèle, effort et coût comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"context-contract-for-code","category":"code","asset":"lockBraces","title":{"pt":"Contrato de contexto: separar o observado do inferido no Code","en":"Context contract: separate observed facts from inference in Code","es":"Contrato de contexto: separar lo observado de lo inferido en Code","fr":"Contrat de contexte : séparer l’observé de l’inféré dans Code"},"lead":{"pt":"Um fluxo de engenharia fica mais auditável quando arquivo observado, hipótese, mudança proposta e verificação têm estados diferentes.","en":"An engineering flow becomes more auditable when observed files, hypotheses, proposed changes, and verification have different states.","es":"Un flujo de ingeniería es más auditable cuando archivo observado, hipótesis, cambio propuesto y verificación tienen estados distintos.","fr":"Un flux d’ingénierie devient plus auditable lorsque fichiers observés, hypothèses, changements proposés et vérifications ont des états distincts."},"date":"2026-08-30","read":2,"blocks":[{"title":{"pt":"Por que rotular evidência","en":"Why label evidence","es":"Por qué etiquetar la evidencia","fr":"Pourquoi étiqueter les preuves"},"body":[{"pt":"Durante uma investigação de código, fatos observados em arquivos não devem receber o mesmo peso que uma hipótese de causa raiz. O Giorgio mantém estados como observado em arquivos, inferido, mudança proposta, verificado por execução e não executado.","en":"During a code investigation, facts observed in files should not carry the same weight as a root-cause hypothesis. Giorgio tracks states such as observed in files, inferred, proposed change, execution-verified, and not executed.","es":"Durante una investigación de código, los hechos observados en archivos no deben tener el mismo peso que una hipótesis de causa raíz. Giorgio mantiene estados como observado en archivos, inferido, cambio propuesto, verificado por ejecución y no ejecutado.","fr":"Lors d’une investigation de code, les faits observés dans les fichiers ne doivent pas avoir le même poids qu’une hypothèse de cause racine. Giorgio conserve des états comme observé dans les fichiers, inféré, changement proposé, vérifié par exécution et non exécuté."}]},{"title":{"pt":"O benefício na revisão","en":"The review benefit","es":"El beneficio en la revisión","fr":"Le bénéfice pour la revue"},"bullets":[{"pt":"Evita apresentar hipótese como fato.","en":"It avoids presenting a hypothesis as fact.","es":"Evita presentar una hipótesis como un hecho.","fr":"Cela évite de présenter une hypothèse comme un fait."},{"pt":"Mostra claramente o que foi ou não executado.","en":"It clearly shows what was or was not executed.","es":"Muestra claramente qué fue o no fue ejecutado.","fr":"Cela montre clairement ce qui a été exécuté ou non."},{"pt":"Facilita retomar a sessão sem reconstruir toda a investigação.","en":"It makes resuming a session easier without rebuilding the whole investigation.","es":"Facilita retomar la sesión sin reconstruir toda la investigación.","fr":"Cela facilite la reprise d’une session sans reconstruire toute l’investigation."}]},{"title":{"pt":"Contrato não é excesso de burocracia","en":"A contract is not needless bureaucracy","es":"Un contrato no es burocracia innecesaria","fr":"Un contrat n’est pas une bureaucratie inutile"},"body":[{"pt":"O objetivo é tornar as decisões legíveis. Em tarefas simples, o contrato pode ser curto; em tarefas críticas, ele funciona como trilha para entender por que uma mudança foi aceita.","en":"The goal is to make decisions legible. On simple tasks the contract can be short; on critical tasks it becomes a trail explaining why a change was accepted.","es":"El objetivo es hacer legibles las decisiones. En tareas simples el contrato puede ser corto; en tareas críticas se convierte en una pista para entender por qué se aceptó un cambio.","fr":"L’objectif est de rendre les décisions lisibles. Sur les tâches simples, le contrat peut être court ; sur les tâches critiques, il devient une trace expliquant pourquoi une modification a été acceptée."}]},{"title":{"pt":"A parte difícil de Estado observado não é hipótese","en":"The hard part of Context contract: separate observed facts from inference in Code","es":"La parte difícil de Contrato de contexto: separar lo observado de lo inferido en Code","fr":"La partie difficile de Contrat de contexte : séparer l’observé de l’inféré dans Code"},"body":[{"pt":"O contrato de contexto impede que uma suposição ganhe o mesmo peso de um arquivo lido ou de um teste executado. Marcar observado, inferido, proposto, verificado e não executado reduz um dos erros mais caros em agentes de código: continuar a partir de fatos inventados.","en":"The useful way to read “Context contract: separate observed facts from inference in Code” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Contrato de contexto: separar lo observado de lo inferido en Code» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Contrat de contexte : séparer l’observé de l’inféré dans Code » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Estado observado não é hipótese","en":"Specific failure mode: Context contract: separate observed facts from inference in Code","es":"Fallo específico: Contrato de contexto: separar lo observado de lo inferido en Code","fr":"Mode de défaillance : Contrat de contexte : séparer l’observé de l’inféré dans Code"},"body":[{"pt":"O risco aparece quando resumos comprimem demais e apagam a proveniência. Uma frase curta como “auth está quebrado” não diz se isso veio do runtime, de um print ou de uma hipótese.","en":"The failure mode to watch in “Context contract: separate observed facts from inference in Code” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Contrato de contexto: separar lo observado de lo inferido en Code» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Contrat de contexte : séparer l’observé de l’inféré dans Code » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Estado observado não é hipótese","en":"Evidence that closes Context contract: separate observed facts from inference in Code","es":"Evidencia que cierra Contrato de contexto: separar lo observado de lo inferido en Code","fr":"Preuve qui valide Contrat de contexte : séparer l’observé de l’inféré dans Code"},"body":[{"pt":"A evidência boa mantém ligação entre claim, fonte e check. Ao retomar a sessão, o agente sabe o que pode reutilizar e o que precisa confirmar novamente.","en":"For “Context contract: separate observed facts from inference in Code”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Contrato de contexto: separar lo observado de lo inferido en Code», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Contrat de contexte : séparer l’observé de l’inféré dans Code », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Contrato de contexto: separar o observado do inferido no Code”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Context contract: separate observed facts from inference in Code”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Contrato de contexto: separar lo observado de lo inferido en Code”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Contrat de contexte : séparer l’observé de l’inféré dans Code », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"diagnostics-by-failure-class","category":"engineering","asset":"barChart","title":{"pt":"Diagnóstico útil começa classificando a falha","en":"Useful diagnosis starts by classifying the failure","es":"Un diagnóstico útil empieza clasificando el fallo","fr":"Un diagnostic utile commence par classer la panne"},"lead":{"pt":"Timeout, indisponibilidade de modelo, teste quebrado e drift de contexto pedem respostas diferentes.","en":"Timeouts, model unavailability, broken tests, and context drift require different responses.","es":"Timeout, indisponibilidad de modelo, pruebas rotas y drift de contexto requieren respuestas diferentes.","fr":"Timeout, indisponibilité du modèle, tests cassés et dérive de contexte exigent des réponses différentes."},"date":"2026-08-30","read":2,"blocks":[{"title":{"pt":"Nem todo erro pede retry","en":"Not every failure calls for a retry","es":"No todo error pide reintento","fr":"Toutes les erreurs ne demandent pas un retry"},"body":[{"pt":"O runtime do Giorgio distingue falhas transitórias, falhas de implementação e perda de validade do contexto. Um timeout ou rate limit pode justificar retry; um teste quebrado pede reparo; drift de contexto pode exigir invalidar etapas construídas sobre uma base que mudou.","en":"Giorgio’s runtime distinguishes transient failures, implementation failures, and loss of context validity. A timeout or rate limit may justify retrying; a broken test calls for repair; context drift may require invalidating steps built on a changed base.","es":"El runtime de Giorgio distingue fallos transitorios, fallos de implementación y pérdida de validez del contexto. Un timeout o rate limit puede justificar reintentar; una prueba rota exige reparación; el drift de contexto puede requerir invalidar pasos construidos sobre una base cambiada.","fr":"Le runtime de Giorgio distingue les pannes transitoires, les erreurs d’implémentation et la perte de validité du contexte. Un timeout ou une limite de débit peut justifier un nouvel essai ; un test cassé demande une réparation ; une dérive de contexte peut exiger d’invalider des étapes construites sur une base modifiée."}]},{"title":{"pt":"Classificações que mudam a ação","en":"Classes that change the action","es":"Clases que cambian la acción","fr":"Classes qui changent l’action"},"bullets":[{"pt":"MODEL_UNAVAILABLE, TIMEOUT e RATE_LIMIT: tratar como indisponibilidade transitória.","en":"MODEL_UNAVAILABLE, TIMEOUT, and RATE_LIMIT: treat as transient availability issues.","es":"MODEL_UNAVAILABLE, TIMEOUT y RATE_LIMIT: tratar como problemas transitorios de disponibilidad.","fr":"MODEL_UNAVAILABLE, TIMEOUT et RATE_LIMIT : les traiter comme des problèmes de disponibilité transitoires."},{"pt":"TEST_FAILURE, SYNTAX_ERROR, TYPE_ERROR e RUNTIME_ERROR: reparar a implementação.","en":"TEST_FAILURE, SYNTAX_ERROR, TYPE_ERROR, and RUNTIME_ERROR: repair the implementation.","es":"TEST_FAILURE, SYNTAX_ERROR, TYPE_ERROR y RUNTIME_ERROR: reparar la implementación.","fr":"TEST_FAILURE, SYNTAX_ERROR, TYPE_ERROR et RUNTIME_ERROR : réparer l’implémentation."},{"pt":"BASE_DRIFT ou CONTEXT_DRIFT: revalidar o que dependia da base anterior.","en":"BASE_DRIFT or CONTEXT_DRIFT: revalidate what depended on the previous base.","es":"BASE_DRIFT o CONTEXT_DRIFT: revalidar lo que dependía de la base anterior.","fr":"BASE_DRIFT ou CONTEXT_DRIFT : revalider ce qui dépendait de la base précédente."}]},{"title":{"pt":"Uma mensagem de erro precisa orientar","en":"An error message needs to guide","es":"Un mensaje de error debe orientar","fr":"Un message d’erreur doit guider"},"body":[{"pt":"Mostrar apenas “não foi possível concluir” esconde a informação mais útil. O diagnóstico deveria dizer o tipo provável de falha, a evidência disponível e a próxima ação segura.","en":"Showing only “could not complete” hides the most useful information. Diagnosis should state the likely failure class, the available evidence, and the next safe action.","es":"Mostrar solo “no fue posible concluir” oculta la información más útil. El diagnóstico debe indicar la clase probable de fallo, la evidencia disponible y la siguiente acción segura.","fr":"Afficher seulement « impossible de terminer » masque l’information la plus utile. Le diagnostic devrait indiquer la classe probable de panne, les preuves disponibles et la prochaine action sûre."}]},{"title":{"pt":"O contrato escondido em Falhas diferentes exigem recuperações diferentes","en":"The hidden contract in Useful diagnosis starts by classifying the failure","es":"El contrato oculto de Un diagnóstico útil empieza clasificando el fallo","fr":"Le contrat caché de Un diagnostic utile commence par classer la panne"},"body":[{"pt":"Timeout, rate limit, erro de sintaxe, falha de teste, drift de base e violação de contrato podem produzir a mesma frase “não foi possível concluir”, mas pedem respostas totalmente diferentes. Classificar cedo evita retries inúteis.","en":"The useful way to read “Useful diagnosis starts by classifying the failure” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Un diagnóstico útil empieza clasificando el fallo» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Un diagnostic utile commence par classer la panne » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"causa raiz vem antes do fallback","en":"causa raiz vem antes do fallback","es":"causa raiz vem antes do fallback","fr":"causa raiz vem antes do fallback"},{"pt":"mudança não quebra subsistemas fora do escopo","en":"mudança não quebra subsistemas fora do escopo","es":"mudança não quebra subsistemas fora do escopo","fr":"mudança não quebra subsistemas fora do escopo"},{"pt":"logs e códigos permitem reproduzir a falha","en":"logs e códigos permitem reproduzir a falha","es":"logs e códigos permitem reproduzir a falha","fr":"logs e códigos permitem reproduzir a falha"}]},{"title":{"pt":"Falha específica: Falhas diferentes exigem recuperações diferentes","en":"Specific failure mode: Useful diagnosis starts by classifying the failure","es":"Fallo específico: Un diagnóstico útil empieza clasificando el fallo","fr":"Mode de défaillance : Un diagnostic utile commence par classer la panne"},"body":[{"pt":"O anti-padrão é tratar qualquer 5xx como motivo para repetir o mesmo request. Isso consome quota, mascara causa raiz e pode multiplicar efeitos colaterais.","en":"The failure mode to watch in “Useful diagnosis starts by classifying the failure” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Un diagnóstico útil empieza clasificando el fallo» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Un diagnostic utile commence par classer la panne » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Falhas diferentes exigem recuperações diferentes","en":"Evidence that closes Useful diagnosis starts by classifying the failure","es":"Evidencia que cierra Un diagnóstico útil empieza clasificando el fallo","fr":"Preuve qui valide Un diagnostic utile commence par classer la panne"},"body":[{"pt":"Um diagnóstico acionável informa classe, superfície afetada, se é retryable, qual evidência existe e qual próximo passo muda o estado do problema.","en":"For “Useful diagnosis starts by classifying the failure”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Un diagnóstico útil empieza clasificando el fallo», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Un diagnostic utile commence par classer la panne », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Falha que esse desenho evita como gate","en":"failure this design prevents as a gate","es":"fallo que este diseño evita como gate","fr":"panne évitée par cette conception comme gate"},"body":[{"pt":"Em “Diagnóstico útil começa classificando a falha”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Useful diagnosis starts by classifying the failure”, the technical point that closes the analysis is to treat ownership, recovery, and observability as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Un diagnóstico útil empieza clasificando el fallo”, el cierre técnico es tratar ownership, recuperación y observabilidad como un único contrato y exigir comportamiento verificable.","fr":"Dans « Un diagnostic utile commence par classer la panne », le point technique final consiste à traiter ownership, reprise et observabilité comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"model-unavailability-without-silent-failure","category":"engineering","asset":"cloudHand","title":{"pt":"Quando um modelo fica indisponível, a interface precisa explicar","en":"When a model becomes unavailable, the interface needs to explain","es":"Cuando un modelo queda indisponible, la interfaz debe explicar","fr":"Lorsqu’un modèle devient indisponible, l’interface doit expliquer"},"lead":{"pt":"Estados explícitos de disponibilidade evitam que falhas de provedor pareçam erro do usuário ou do prompt.","en":"Explicit availability states keep provider failures from looking like user or prompt errors.","es":"Estados explícitos de disponibilidad evitan que fallos del proveedor parezcan errores del usuario o del prompt.","fr":"Des états explicites de disponibilité évitent qu’une panne fournisseur ressemble à une erreur utilisateur ou de prompt."},"date":"2026-08-30","read":2,"blocks":[{"title":{"pt":"Falha sem contexto é falha de UX","en":"Failure without context is a UX failure","es":"Un fallo sin contexto es un fallo de UX","fr":"Une panne sans contexte est une panne d’UX"},"body":[{"pt":"Se o envio falha porque a rota escolhida está temporariamente indisponível, a pessoa precisa saber que o problema não está no conteúdo enviado. Esconder esse estado gera tentativas repetidas e diagnóstico errado.","en":"If a send fails because the selected route is temporarily unavailable, the user needs to know the problem is not the submitted content. Hiding that state causes repeated attempts and wrong diagnosis.","es":"Si el envío falla porque la ruta elegida está temporalmente indisponible, la persona necesita saber que el problema no está en el contenido enviado. Ocultar ese estado genera intentos repetidos y diagnósticos erróneos.","fr":"Si l’envoi échoue parce que la route choisie est temporairement indisponible, l’utilisateur doit savoir que le problème ne vient pas du contenu envoyé. Masquer cet état entraîne des tentatives répétées et un mauvais diagnostic."}]},{"title":{"pt":"Informação mínima útil","en":"Minimum useful information","es":"Información mínima útil","fr":"Information minimale utile"},"bullets":[{"pt":"Qual modelo ou rota está afetado.","en":"Which model or route is affected.","es":"Qué modelo o ruta está afectado.","fr":"Quel modèle ou quelle route est affecté."},{"pt":"Se o problema é temporário ou exige outra ação.","en":"Whether the issue is temporary or requires another action.","es":"Si el problema es temporal o requiere otra acción.","fr":"Si le problème est temporaire ou exige une autre action."},{"pt":"Qual alternativa está disponível sem perder o trabalho atual.","en":"Which alternative is available without losing the current work.","es":"Qué alternativa está disponible sin perder el trabajo actual.","fr":"Quelle alternative est disponible sans perdre le travail en cours."}]},{"title":{"pt":"Fallback não deve ser invisível","en":"Fallback should not be invisible","es":"El fallback no debe ser invisible","fr":"Le fallback ne doit pas être invisible"},"body":[{"pt":"Trocar de rota pode ser útil, mas a interface deve manter a pessoa informada. Confiabilidade inclui saber qual sistema realmente executou a tarefa.","en":"Switching routes can be useful, but the interface should keep the user informed. Reliability includes knowing which system actually performed the task.","es":"Cambiar de ruta puede ser útil, pero la interfaz debe mantener a la persona informada. La confiabilidad incluye saber qué sistema ejecutó realmente la tarea.","fr":"Changer de route peut être utile, mais l’interface doit tenir l’utilisateur informé. La fiabilité inclut le fait de savoir quel système a réellement exécuté la tâche."}]},{"title":{"pt":"Onde Fallback precisa mudar de caminho de verdade realmente ganha qualidade","en":"Where When a model becomes unavailable, the interface needs to explain actually gains quality","es":"Dónde Cuando un modelo queda indisponible, la interfaz debe explicar realmente gana calidad","fr":"Là où Lorsqu’un modèle devient indisponible, l’interface doit expliquer gagne vraiment en qualité"},"body":[{"pt":"Quando um modelo fica indisponível, o fallback deve usar outro provedor, outra rota ou outra estratégia. Tentar o mesmo endpoint com outro rótulo produz uma ilusão de resiliência e geralmente repete a falha original.","en":"The useful way to read “When a model becomes unavailable, the interface needs to explain” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Cuando un modelo queda indisponible, la interfaz debe explicar» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Lorsqu’un modèle devient indisponible, l’interface doit expliquer » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"causa raiz vem antes do fallback","en":"causa raiz vem antes do fallback","es":"causa raiz vem antes do fallback","fr":"causa raiz vem antes do fallback"},{"pt":"mudança não quebra subsistemas fora do escopo","en":"mudança não quebra subsistemas fora do escopo","es":"mudança não quebra subsistemas fora do escopo","fr":"mudança não quebra subsistemas fora do escopo"},{"pt":"logs e códigos permitem reproduzir a falha","en":"logs e códigos permitem reproduzir a falha","es":"logs e códigos permitem reproduzir a falha","fr":"logs e códigos permitem reproduzir a falha"}]},{"title":{"pt":"Falha específica: Fallback precisa mudar de caminho de verdade","en":"Specific failure mode: When a model becomes unavailable, the interface needs to explain","es":"Fallo específico: Cuando un modelo queda indisponible, la interfaz debe explicar","fr":"Mode de défaillance : Lorsqu’un modèle devient indisponible, l’interface doit expliquer"},"body":[{"pt":"O risco é vazar mensagem crua do provedor, como crédito esgotado, e apresentá-la ao usuário como se fosse limite da própria conta Giorgio.","en":"The failure mode to watch in “When a model becomes unavailable, the interface needs to explain” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Cuando un modelo queda indisponible, la interfaz debe explicar» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Lorsqu’un modèle devient indisponible, l’interface doit expliquer » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Fallback precisa mudar de caminho de verdade","en":"Evidence that closes When a model becomes unavailable, the interface needs to explain","es":"Evidencia que cierra Cuando un modelo queda indisponible, la interfaz debe explicar","fr":"Preuve qui valide Lorsqu’un modèle devient indisponible, l’interface doit expliquer"},"body":[{"pt":"O comportamento correto diferencia limite do usuário, limite do provedor, indisponibilidade transitória e falha permanente; registra a troca e preserva a identidade pública do modelo selecionado.","en":"For “When a model becomes unavailable, the interface needs to explain”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Cuando un modelo queda indisponible, la interfaz debe explicar», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Lorsqu’un modèle devient indisponible, l’interface doit expliquer », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Falha que esse desenho evita como gate","en":"failure this design prevents as a gate","es":"fallo que este diseño evita como gate","fr":"panne évitée par cette conception comme gate"},"body":[{"pt":"Em “Quando um modelo fica indisponível, a interface precisa explicar”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “When a model becomes unavailable, the interface needs to explain”, the technical point that closes the analysis is to treat ownership, recovery, and observability as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Cuando un modelo queda indisponible, la interfaz debe explicar”, el cierre técnico es tratar ownership, recuperación y observabilidad como un único contrato y exigir comportamiento verificable.","fr":"Dans « Lorsqu’un modèle devient indisponible, l’interface doit expliquer », le point technique final consiste à traiter ownership, reprise et observabilité comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"freshness-policy-for-web-search","category":"search","asset":"webBraces","title":{"pt":"Busca na web só quando a resposta depende do agora","en":"Use web search when the answer depends on now","es":"Busca web cuando la respuesta depende del presente","fr":"Recherche web lorsque la réponse dépend du présent"},"lead":{"pt":"Uma política de freshness reduz respostas desatualizadas sem transformar toda pergunta em pesquisa externa.","en":"A freshness policy reduces stale answers without turning every question into external research.","es":"Una política de freshness reduce respuestas desactualizadas sin convertir cada pregunta en investigación externa.","fr":"Une politique de fraîcheur réduit les réponses obsolètes sans transformer chaque question en recherche externe."},"date":"2026-08-29","read":2,"blocks":[{"title":{"pt":"Nem toda pergunta precisa de internet","en":"Not every question needs the internet","es":"No toda pregunta necesita internet","fr":"Toutes les questions n’ont pas besoin d’Internet"},"body":[{"pt":"Perguntas históricas, conceitos estáveis e explicações baseadas em um arquivo fornecido não ganham qualidade automaticamente com uma busca. A pesquisa faz sentido quando preço, disponibilidade, notícia, documentação atual ou estado de um serviço pode ter mudado.","en":"Historical questions, stable concepts, and explanations grounded in a supplied file do not automatically improve with web search. Research makes sense when prices, availability, news, current documentation, or service state may have changed.","es":"Preguntas históricas, conceptos estables y explicaciones basadas en un archivo proporcionado no mejoran automáticamente con una búsqueda. La investigación tiene sentido cuando precio, disponibilidad, noticias, documentación actual o estado de un servicio pueden haber cambiado.","fr":"Les questions historiques, les concepts stables et les explications fondées sur un fichier fourni ne s’améliorent pas automatiquement avec une recherche web. La recherche a du sens lorsque prix, disponibilité, actualités, documentation actuelle ou état d’un service peuvent avoir changé."}]},{"title":{"pt":"Gatilhos de freshness","en":"Freshness triggers","es":"Disparadores de freshness","fr":"Déclencheurs de fraîcheur"},"bullets":[{"pt":"“Hoje”, “agora”, “último”, “atual” ou datas recentes.","en":"“Today,” “now,” “latest,” “current,” or recent dates.","es":"“Hoy”, “ahora”, “último”, “actual” o fechas recientes.","fr":"« Aujourd’hui », « maintenant », « dernier », « actuel » ou des dates récentes."},{"pt":"Serviços, modelos ou ferramentas com disponibilidade variável.","en":"Services, models, or tools with variable availability.","es":"Servicios, modelos o herramientas con disponibilidad variable.","fr":"Services, modèles ou outils dont la disponibilité varie."},{"pt":"Perguntas em que uma informação errada por desatualização mudaria a decisão.","en":"Questions where stale information would change the decision.","es":"Preguntas donde información desactualizada cambiaría la decisión.","fr":"Questions où une information obsolète modifierait la décision."}]},{"title":{"pt":"Pesquisar também exige síntese","en":"Search still requires synthesis","es":"Buscar también exige síntesis","fr":"Rechercher exige aussi une synthèse"},"body":[{"pt":"O resultado da busca não deveria ser uma pilha de links. A tarefa do sistema é separar fonte primária, contexto secundário e incerteza antes de responder.","en":"Search results should not become a pile of links. The system’s job is to separate primary sources, secondary context, and uncertainty before answering.","es":"El resultado de una búsqueda no debería ser una pila de enlaces. La tarea del sistema es separar fuente primaria, contexto secundario e incertidumbre antes de responder.","fr":"Le résultat d’une recherche ne devrait pas être une pile de liens. Le rôle du système est de distinguer sources primaires, contexte secondaire et incertitude avant de répondre."}]},{"title":{"pt":"Frescor é parte da resposta","en":"Freshness is part of the answer","es":"La actualidad es parte de la respuesta","fr":"La fraîcheur fait partie de la réponse"},"body":[{"pt":"A web agrega valor quando o fato pode ter mudado: preços, disponibilidade, documentação viva, notícias, resultados, versões e políticas. Para conhecimento estável, buscar por reflexo adiciona latência e fontes desnecessárias. A decisão correta depende da volatilidade da informação.","en":"The web adds value when a fact may have changed: prices, availability, living documentation, news, results, versions, and policies. For stable knowledge, searching by reflex adds latency and unnecessary sources. The right decision depends on information volatility.","es":"La web aporta valor cuando el dato puede haber cambiado: precios, disponibilidad, documentación viva, noticias, resultados, versiones y políticas. Para conocimiento estable, buscar por reflejo añade latencia y fuentes innecesarias. La decisión depende de la volatilidad de la información.","fr":"Le web apporte de la valeur lorsque l’information peut avoir changé : prix, disponibilité, documentation vivante, actualités, résultats, versions et politiques. Pour les connaissances stables, rechercher par réflexe ajoute de la latence et des sources inutiles. La décision dépend de la volatilité de l’information."}]},{"title":{"pt":"O que precisa estar atualizado","en":"What must be current","es":"What must be current","fr":"What must be current"},"body":[{"pt":"Em “Busca na web só quando a resposta depende do agora”, a ideia só vira valor quando aparece no fluxo real. Uma política de freshness reduz respostas desatualizadas sem transformar toda pergunta em pesquisa externa. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Use web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. A freshness policy reduces stale answers without turning every question into external research. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Use web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. A freshness policy reduces stale answers without turning every question into external research. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Use web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. A freshness policy reduces stale answers without turning every question into external research. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"O mecanismo central de Frescor precisa ser decidido antes da resposta","en":"The core mechanism of Use web search when the answer depends on now","es":"El mecanismo central de Busca web cuando la respuesta depende del presente","fr":"Le mécanisme central de Recherche web lorsque la réponse dépend du présent"},"body":[{"pt":"A busca em tempo real não deve depender de o usuário escrever “pesquise”. Preço, versão, notícia, placar, disponibilidade, lei vigente e qualquer fato mutável precisam acionar recuperação atual antes da síntese.","en":"The useful way to read “Use web search when the answer depends on now” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Busca web cuando la respuesta depende del presente» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Recherche web lorsque la réponse dépend du présent » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"fonte tem frescor compatível com a pergunta","en":"fonte tem frescor compatível com a pergunta","es":"fonte tem frescor compatível com a pergunta","fr":"fonte tem frescor compatível com a pergunta"},{"pt":"fallback mantém o mesmo tipo de intenção","en":"fallback mantém o mesmo tipo de intenção","es":"fallback mantém o mesmo tipo de intenção","fr":"fallback mantém o mesmo tipo de intenção"},{"pt":"ausência de fonte atual é declarada","en":"ausência de fonte atual é declarada","es":"ausência de fonte atual é declarada","fr":"ausência de fonte atual é declarada"}]},{"title":{"pt":"Falha específica: Frescor precisa ser decidido antes da resposta","en":"Specific failure mode: Use web search when the answer depends on now","es":"Fallo específico: Busca web cuando la respuesta depende del presente","fr":"Mode de défaillance : Recherche web lorsque la réponse dépend du présent"},"body":[{"pt":"O risco inverso é pesquisar tudo: latência sobe, fontes de baixa qualidade entram no contexto e perguntas históricas simples passam a depender de rede sem necessidade.","en":"The failure mode to watch in “Use web search when the answer depends on now” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Busca web cuando la respuesta depende del presente» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Recherche web lorsque la réponse dépend du présent » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Frescor precisa ser decidido antes da resposta","en":"Evidence that closes Use web search when the answer depends on now","es":"Evidencia que cierra Busca web cuando la respuesta depende del presente","fr":"Preuve qui valide Recherche web lorsque la réponse dépend du présent"},"body":[{"pt":"Uma boa política classifica mutabilidade, tenta fonte oficial ou especializada primeiro e deixa claro quando o resultado é atual, histórico ou não pôde ser verificado.","en":"For “Use web search when the answer depends on now”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Busca web cuando la respuesta depende del presente», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Recherche web lorsque la réponse dépend du présent », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":3}},{"slug":"files-before-assumptions","category":"files","asset":"browserDoc","title":{"pt":"Arquivos antes de suposições","en":"Files before assumptions","es":"Archivos antes de suposiciones","fr":"Les fichiers avant les suppositions"},"lead":{"pt":"Quando o usuário fornece um documento, o fluxo deve tratar o conteúdo real como evidência prioritária em vez de adivinhar pelo nome do arquivo.","en":"When a user supplies a document, the flow should treat its real content as primary evidence rather than guessing from the filename.","es":"Cuando el usuario proporciona un documento, el flujo debe tratar su contenido real como evidencia prioritaria en lugar de adivinar por el nombre del archivo.","fr":"Lorsqu’un utilisateur fournit un document, le flux doit traiter son contenu réel comme preuve prioritaire plutôt que de deviner à partir du nom du fichier."},"date":"2026-08-29","read":2,"blocks":[{"title":{"pt":"O nome do arquivo não é o conteúdo","en":"A filename is not the content","es":"El nombre del archivo no es el contenido","fr":"Le nom du fichier n’est pas le contenu"},"body":[{"pt":"Um sistema que vê apenas o título de um TXT, PDF ou documento tende a preencher lacunas com suposições. Em tarefas de análise, relatório ou estudo, isso é pior do que admitir que o conteúdo ainda não foi lido.","en":"A system that sees only the title of a TXT, PDF, or document tends to fill gaps with assumptions. In analysis, reporting, or study tasks, that is worse than admitting the content has not been read yet.","es":"Un sistema que solo ve el título de un TXT, PDF o documento tiende a llenar los huecos con suposiciones. En tareas de análisis, informe o estudio, eso es peor que admitir que el contenido aún no fue leído.","fr":"Un système qui ne voit que le titre d’un TXT, PDF ou document a tendance à combler les vides par des suppositions. Pour l’analyse, les rapports ou l’étude, c’est pire que d’admettre que le contenu n’a pas encore été lu."}]},{"title":{"pt":"Fluxo correto","en":"The correct flow","es":"El flujo correcto","fr":"Le bon flux"},"bullets":[{"pt":"Ler ou buscar no arquivo antes de responder.","en":"Read or search the file before answering.","es":"Leer o buscar en el archivo antes de responder.","fr":"Lire ou rechercher dans le fichier avant de répondre."},{"pt":"Usar o trecho relevante como evidência, não como decoração.","en":"Use the relevant section as evidence, not decoration.","es":"Usar la sección relevante como evidencia, no como decoración.","fr":"Utiliser la section pertinente comme preuve, pas comme décoration."},{"pt":"Dizer quando o arquivo não contém suporte para uma conclusão.","en":"Say when the file does not support a conclusion.","es":"Decir cuando el archivo no respalda una conclusión.","fr":"Dire lorsque le fichier ne permet pas de soutenir une conclusion."}]},{"title":{"pt":"Menos alucinação começa na entrada","en":"Less hallucination starts at input","es":"Menos alucinación empieza en la entrada","fr":"Moins d’hallucination commence à l’entrée"},"body":[{"pt":"Qualidade não depende só do modelo. Se a camada de entrada perde o conteúdo do arquivo, nenhum raciocínio posterior recupera a evidência que nunca chegou ao contexto.","en":"Quality does not depend only on the model. If the input layer loses file content, no later reasoning can recover evidence that never reached context.","es":"La calidad no depende solo del modelo. Si la capa de entrada pierde el contenido del archivo, ningún razonamiento posterior puede recuperar una evidencia que nunca llegó al contexto.","fr":"La qualité ne dépend pas uniquement du modèle. Si la couche d’entrée perd le contenu du fichier, aucun raisonnement ultérieur ne peut récupérer une preuve qui n’est jamais entrée dans le contexte."}]},{"title":{"pt":"O arquivo é a fonte primária","en":"The file is the primary source","es":"El archivo es la fuente primaria","fr":"Le fichier est la source primaire"},"body":[{"pt":"Quando a tarefa depende de um documento, log, planilha ou código anexado, o conteúdo real deve vencer qualquer suposição baseada no nome do arquivo. Ler primeiro também evita respostas que parecem específicas, mas foram construídas apenas a partir do título ou de um trecho incompleto.","en":"When a task depends on an attached document, log, spreadsheet, or code file, the real content should outrank any assumption based on the filename. Reading first also avoids answers that sound specific but were built only from a title or an incomplete excerpt.","es":"Cuando una tarea depende de un documento, log, hoja de cálculo o archivo de código adjunto, el contenido real debe superar cualquier suposición basada en el nombre. Leer primero también evita respuestas que parecen específicas pero se construyeron solo a partir del título o de un fragmento incompleto.","fr":"Lorsqu’une tâche dépend d’un document, journal, tableur ou fichier de code joint, le contenu réel doit primer sur toute hypothèse fondée sur le nom du fichier. Lire d’abord évite aussi les réponses qui semblent précises mais reposent seulement sur un titre ou un extrait incomplet."}]},{"title":{"pt":"Evidência antes de inferência","en":"Evidence before inference","es":"Evidence before inference","fr":"Evidence before inference"},"body":[{"pt":"Em “Arquivos antes de suposições”, a ideia só vira valor quando aparece no fluxo real. Quando o usuário fornece um documento, o fluxo deve tratar o conteúdo real como evidência prioritária em vez de adivinhar pelo nome do arquivo. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Files before assumptions”, the idea only becomes valuable when it appears in the real workflow. When a user supplies a document, the flow should treat its real content as primary evidence rather than guessing from the filename. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Files before assumptions”, the idea only becomes valuable when it appears in the real workflow. When a user supplies a document, the flow should treat its real content as primary evidence rather than guessing from the filename. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Files before assumptions”, the idea only becomes valuable when it appears in the real workflow. When a user supplies a document, the flow should treat its real content as primary evidence rather than guessing from the filename. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"A engenharia por trás de O arquivo citado vira fonte primária","en":"The engineering behind Files before assumptions","es":"La ingeniería detrás de Archivos antes de suposiciones","fr":"L’ingénierie derrière Les fichiers avant les suppositions"},"body":[{"pt":"Se a tarefa depende de um arquivo, o agente precisa ler esse arquivo antes de responder. Inferir conteúdo a partir do nome, de uma versão antiga ou de um trecho visto em outra conversa é exatamente o tipo de atalho que produz correções no documento errado.","en":"The useful way to read “Files before assumptions” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Archivos antes de suposiciones» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Les fichiers avant les suppositions » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"o arquivo correto é lido antes da conclusão","en":"o arquivo correto é lido antes da conclusão","es":"o arquivo correto é lido antes da conclusão","fr":"o arquivo correto é lido antes da conclusão"},{"pt":"proveniência continua ligada à afirmação","en":"proveniência continua ligada à afirmação","es":"proveniência continua ligada à afirmação","fr":"proveniência continua ligada à afirmação"},{"pt":"leitura cresce apenas quando a tarefa exige","en":"leitura cresce apenas quando a tarefa exige","es":"leitura cresce apenas quando a tarefa exige","fr":"leitura cresce apenas quando a tarefa exige"}]},{"title":{"pt":"Falha específica: O arquivo citado vira fonte primária","en":"Specific failure mode: Files before assumptions","es":"Fallo específico: Archivos antes de suposiciones","fr":"Mode de défaillance : Les fichiers avant les suppositions"},"body":[{"pt":"O problema fica pior em bases grandes, onde arquivos com nomes semelhantes coexistem e o contexto parcial pode parecer suficiente.","en":"The failure mode to watch in “Files before assumptions” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Archivos antes de suposiciones» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Les fichiers avant les suppositions » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha O arquivo citado vira fonte primária","en":"Evidence that closes Files before assumptions","es":"Evidencia que cierra Archivos antes de suposiciones","fr":"Preuve qui valide Les fichiers avant les suppositions"},"body":[{"pt":"O fluxo confiável localiza o arquivo correto, lê apenas a faixa necessária, expande quando a resposta depende de seção maior e cita a evidência usada na conclusão.","en":"For “Files before assumptions”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Archivos antes de suposiciones», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Les fichiers avant les suppositions », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":3}},{"slug":"connector-permission-boundaries","category":"connectors","asset":"lockBraces","title":{"pt":"Conectores: permissão explícita antes de conveniência","en":"Connectors: explicit permission before convenience","es":"Conectores: permiso explícito antes que comodidad","fr":"Connecteurs : permission explicite avant commodité"},"lead":{"pt":"Integrações ficam mais seguras quando a pessoa entende qual sistema está conectado, o que pode ser lido e o que pode ser alterado.","en":"Integrations are safer when the user understands which system is connected, what can be read, and what can be changed.","es":"Las integraciones son más seguras cuando la persona entiende qué sistema está conectado, qué puede leerse y qué puede modificarse.","fr":"Les intégrations sont plus sûres lorsque l’utilisateur comprend quel système est connecté, ce qui peut être lu et ce qui peut être modifié."},"date":"2026-08-28","read":2,"blocks":[{"title":{"pt":"Conectar não significa liberar tudo","en":"Connected does not mean unrestricted","es":"Conectar no significa liberar todo","fr":"Connecté ne veut pas dire sans limites"},"body":[{"pt":"Um conector deve deixar claro quais capacidades foram autorizadas. Buscar conteúdo, listar itens e executar uma ação de escrita têm níveis de consequência diferentes e não deveriam aparecer como se fossem a mesma coisa.","en":"A connector should make clear which capabilities were authorized. Searching content, listing items, and performing a write action have different consequences and should not appear equivalent.","es":"Un conector debe dejar claro qué capacidades fueron autorizadas. Buscar contenido, listar elementos y realizar una acción de escritura tienen consecuencias distintas y no deberían parecer equivalentes.","fr":"Un connecteur doit préciser quelles capacités ont été autorisées. Rechercher du contenu, lister des éléments et effectuer une écriture ont des conséquences différentes et ne doivent pas sembler équivalentes."}]},{"title":{"pt":"O que a interface precisa mostrar","en":"What the interface should show","es":"Qué debe mostrar la interfaz","fr":"Ce que l’interface doit montrer"},"bullets":[{"pt":"Serviço conectado e conta ou escopo relevante.","en":"The connected service and relevant account or scope.","es":"El servicio conectado y la cuenta o alcance relevante.","fr":"Le service connecté et le compte ou périmètre pertinent."},{"pt":"Permissões de leitura e escrita separadas.","en":"Read and write permissions separately.","es":"Permisos de lectura y escritura por separado.","fr":"Permissions de lecture et d’écriture séparées."},{"pt":"Quando uma ação exige confirmação ou autorização adicional.","en":"When an action needs confirmation or additional authorization.","es":"Cuándo una acción requiere confirmación o autorización adicional.","fr":"Quand une action exige une confirmation ou une autorisation supplémentaire."}]},{"title":{"pt":"Confiança vem de previsibilidade","en":"Trust comes from predictability","es":"La confianza viene de la previsibilidad","fr":"La confiance vient de la prévisibilité"},"body":[{"pt":"A melhor integração não é a que faz mais coisas escondida; é a que torna óbvio o que está prestes a acontecer e por quê.","en":"The best integration is not the one that does the most things invisibly; it is the one that makes it obvious what is about to happen and why.","es":"La mejor integración no es la que hace más cosas ocultamente; es la que deja obvio qué está a punto de ocurrir y por qué.","fr":"La meilleure intégration n’est pas celle qui fait le plus de choses en silence ; c’est celle qui rend évident ce qui va se passer et pourquoi."}]},{"title":{"pt":"A fronteira de permissão","en":"The permission boundary","es":"The permission boundary","fr":"The permission boundary"},"body":[{"pt":"Em “Conectores: permissão explícita antes de conveniência”, a ideia só vira valor quando aparece no fluxo real. Integrações ficam mais seguras quando a pessoa entende qual sistema está conectado, o que pode ser lido e o que pode ser alterado. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Connectors: explicit permission before convenience”, the idea only becomes valuable when it appears in the real workflow. Integrations are safer when the user understands which system is connected, what can be read, and what can be changed. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Connectors: explicit permission before convenience”, the idea only becomes valuable when it appears in the real workflow. Integrations are safer when the user understands which system is connected, what can be read, and what can be changed. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Connectors: explicit permission before convenience”, the idea only becomes valuable when it appears in the real workflow. Integrations are safer when the user understands which system is connected, what can be read, and what can be changed. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"O ponto que decide Conector não equivale a autorização irrestrita","en":"The decision point in Connectors: explicit permission before convenience","es":"El punto decisivo de Conectores: permiso explícito antes que comodidad","fr":"Le point décisif de Connecteurs : permission explicite avant commodité"},"body":[{"pt":"Um conector útil combina descoberta, escopo e intenção. Ter acesso técnico ao serviço não significa que qualquer ferramenta possa ler, escrever ou compartilhar qualquer recurso sem uma ação compatível com o pedido.","en":"The useful way to read “Connectors: explicit permission before convenience” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Conectores: permiso explícito antes que comodidad» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Connecteurs : permission explicite avant commodité » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"menor privilégio por operação","en":"menor privilégio por operação","es":"menor privilégio por operação","fr":"menor privilégio por operação"},{"pt":"leitura e escrita ficam separadas","en":"leitura e escrita ficam separadas","es":"leitura e escrita ficam separadas","fr":"leitura e escrita ficam separadas"},{"pt":"conteúdo recuperado permanece dado não confiável","en":"conteúdo recuperado permanece dado não confiável","es":"conteúdo recuperado permanece dado não confiável","fr":"conteúdo recuperado permanece dado não confiável"}]},{"title":{"pt":"Falha específica: Conector não equivale a autorização irrestrita","en":"Specific failure mode: Connectors: explicit permission before convenience","es":"Fallo específico: Conectores: permiso explícito antes que comodidad","fr":"Mode de défaillance : Connecteurs : permission explicite avant commodité"},"body":[{"pt":"O risco é misturar leitura e escrita, especialmente em ações com efeitos externos como e-mail, calendário, deploy ou alteração de dados.","en":"The failure mode to watch in “Connectors: explicit permission before convenience” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Conectores: permiso explícito antes que comodidad» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Connecteurs : permission explicite avant commodité » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Conector não equivale a autorização irrestrita","en":"Evidence that closes Connectors: explicit permission before convenience","es":"Evidencia que cierra Conectores: permiso explícito antes que comodidad","fr":"Preuve qui valide Connecteurs : permission explicite avant commodité"},"body":[{"pt":"O limite saudável preserva identidade, autorização e menor privilégio, registra exatamente qual operação foi executada e evita transformar contexto recuperado em instrução de sistema.","en":"For “Connectors: explicit permission before convenience”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Conectores: permiso explícito antes que comodidad», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Connecteurs : permission explicite avant commodité », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"temporary-chat-and-retention","category":"privacy","asset":"lockBraces","title":{"pt":"Chat temporário: quando o trabalho não precisa virar memória","en":"Temporary chat: when work does not need to become memory","es":"Chat temporal: cuando el trabajo no necesita convertirse en memoria","fr":"Chat temporaire : quand le travail n’a pas besoin de devenir mémoire"},"lead":{"pt":"Separar contexto transitório de memória persistente reduz ruído e dá ao usuário mais controle sobre o que permanece.","en":"Separating transient context from persistent memory reduces noise and gives users more control over what remains.","es":"Separar contexto transitorio de memoria persistente reduce ruido y da al usuario más control sobre lo que permanece.","fr":"Séparer le contexte transitoire de la mémoire persistante réduit le bruit et donne davantage de contrôle à l’utilisateur."},"date":"2026-08-28","read":2,"blocks":[{"title":{"pt":"Nem tudo merece persistir","en":"Not everything should persist","es":"No todo debería persistir","fr":"Tout ne doit pas persister"},"body":[{"pt":"Uma conversa usada para testar uma ideia, revisar um texto pontual ou resolver um problema momentâneo pode não ter valor em sessões futuras. Tornar essa escolha explícita evita que a memória vire depósito de contexto irrelevante.","en":"A conversation used to test an idea, review a one-off text, or solve a temporary problem may have no value in future sessions. Making that choice explicit keeps memory from becoming a store of irrelevant context.","es":"Una conversación usada para probar una idea, revisar un texto puntual o resolver un problema momentáneo puede no tener valor en sesiones futuras. Hacer explícita esa elección evita que la memoria se convierta en depósito de contexto irrelevante.","fr":"Une conversation utilisée pour tester une idée, relire un texte ponctuel ou résoudre un problème temporaire peut n’avoir aucune valeur plus tard. Rendre ce choix explicite évite que la mémoire devienne un dépôt de contexte inutile."}]},{"title":{"pt":"Use chat temporário quando","en":"Use temporary chat when","es":"Usa chat temporal cuando","fr":"Utilisez le chat temporaire lorsque"},"bullets":[{"pt":"O contexto é específico de uma tarefa única.","en":"The context belongs to a single one-off task.","es":"El contexto pertenece a una sola tarea puntual.","fr":"Le contexte appartient à une tâche ponctuelle."},{"pt":"Você está explorando opções que não devem influenciar sessões futuras.","en":"You are exploring options that should not influence future sessions.","es":"Estás explorando opciones que no deben influir en sesiones futuras.","fr":"Vous explorez des options qui ne doivent pas influencer les sessions futures."},{"pt":"O valor do histórico termina quando a tarefa é concluída.","en":"The history stops being useful when the task is complete.","es":"El historial deja de ser útil cuando termina la tarea.","fr":"L’historique cesse d’être utile une fois la tâche terminée."}]},{"title":{"pt":"Memória deve ser intencional","en":"Memory should be intentional","es":"La memoria debe ser intencional","fr":"La mémoire doit être intentionnelle"},"body":[{"pt":"Persistência útil nasce de seleção. Preferências, instruções duráveis e contexto de projeto podem merecer memória; rascunhos transitórios, não necessariamente.","en":"Useful persistence comes from selection. Preferences, durable instructions, and project context may deserve memory; transient drafts do not necessarily.","es":"La persistencia útil nace de la selección. Preferencias, instrucciones duraderas y contexto de proyecto pueden merecer memoria; borradores transitorios, no necesariamente.","fr":"Une persistance utile vient de la sélection. Préférences, instructions durables et contexte de projet peuvent mériter la mémoire ; les brouillons transitoires, pas forcément."}]},{"title":{"pt":"Privacidade precisa ser previsível","en":"Privacy needs to be predictable","es":"La privacidad debe ser predecible","fr":"La confidentialité doit être prévisible"},"body":[{"pt":"O usuário precisa saber quando uma conversa entra no histórico, quando memória pode ser usada e quando um fluxo é deliberadamente temporário. A regra útil é simples: retenção e reutilização de contexto devem ser explícitas, compreensíveis e reversíveis sempre que possível.","en":"Users need to know when a conversation enters history, when memory may be used, and when a flow is deliberately temporary. A useful rule is simple: retention and reuse of context should be explicit, understandable, and reversible whenever possible.","es":"El usuario debe saber cuándo una conversación entra al historial, cuándo puede usarse memoria y cuándo un flujo es deliberadamente temporal. La regla útil es simple: retención y reutilización de contexto deben ser explícitas, comprensibles y reversibles cuando sea posible.","fr":"L’utilisateur doit savoir quand une conversation entre dans l’historique, quand la mémoire peut être utilisée et quand un flux est volontairement temporaire. La règle utile est simple : la conservation et la réutilisation du contexte doivent être explicites, compréhensibles et réversibles lorsque possible."}]},{"title":{"pt":"O ciclo de vida do dado","en":"The data lifecycle","es":"The data lifecycle","fr":"The data lifecycle"},"body":[{"pt":"Em “Chat temporário: quando o trabalho não precisa virar memória”, a ideia só vira valor quando aparece no fluxo real. Separar contexto transitório de memória persistente reduz ruído e dá ao usuário mais controle sobre o que permanece. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Temporary chat: when work does not need to become memory”, the idea only becomes valuable when it appears in the real workflow. Separating transient context from persistent memory reduces noise and gives users more control over what remains. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Temporary chat: when work does not need to become memory”, the idea only becomes valuable when it appears in the real workflow. Separating transient context from persistent memory reduces noise and gives users more control over what remains. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Temporary chat: when work does not need to become memory”, the idea only becomes valuable when it appears in the real workflow. Separating transient context from persistent memory reduces noise and gives users more control over what remains. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Como Temporário precisa ter semântica de ciclo de vida deixa de ser só interface","en":"How Temporary chat: when work does not need to become memory becomes more than interface","es":"Cómo Chat temporal: cuando el trabajo no necesita convertirse en memoria deja de ser solo interfaz","fr":"Comment Chat temporaire : quand le travail n’a pas besoin de devenir mémoire dépasse la simple interface"},"body":[{"pt":"Chat temporário não é apenas um ícone diferente. Ele precisa evitar promoção automática para memória, deixar claro o que ainda pode existir por motivos técnicos e não misturar o conteúdo descartável com projetos persistentes.","en":"The useful way to read “Temporary chat: when work does not need to become memory” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Chat temporal: cuando el trabajo no necesita convertirse en memoria» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Chat temporaire : quand le travail n’a pas besoin de devenir mémoire » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"ciclo de vida é previsível para o usuário","en":"ciclo de vida é previsível para o usuário","es":"ciclo de vida é previsível para o usuário","fr":"ciclo de vida é previsível para o usuário"},{"pt":"memória e retenção não são confundidas","en":"memória e retenção não são confundidas","es":"memória e retenção não são confundidas","fr":"memória e retenção não são confundidas"},{"pt":"mudanças de persistência são explícitas","en":"mudanças de persistência são explícitas","es":"mudanças de persistência são explícitas","fr":"mudanças de persistência são explícitas"}]},{"title":{"pt":"Falha específica: Temporário precisa ter semântica de ciclo de vida","en":"Specific failure mode: Temporary chat: when work does not need to become memory","es":"Fallo específico: Chat temporal: cuando el trabajo no necesita convertirse en memoria","fr":"Mode de défaillance : Chat temporaire : quand le travail n’a pas besoin de devenir mémoire"},"body":[{"pt":"O risco é prometer desaparecimento absoluto enquanto anexos, logs ou artefatos continuam armazenados por outro subsistema.","en":"The failure mode to watch in “Temporary chat: when work does not need to become memory” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Chat temporal: cuando el trabajo no necesita convertirse en memoria» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Chat temporaire : quand le travail n’a pas besoin de devenir mémoire » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Temporário precisa ter semântica de ciclo de vida","en":"Evidence that closes Temporary chat: when work does not need to become memory","es":"Evidencia que cierra Chat temporal: cuando el trabajo no necesita convertirse en memoria","fr":"Preuve qui valide Chat temporaire : quand le travail n’a pas besoin de devenir mémoire"},"body":[{"pt":"A interface confiável separa conversa, memória, arquivos e telemetria; explica o que não será reutilizado e permite que o usuário escolha quando um dado temporário deve virar contexto durável.","en":"For “Temporary chat: when work does not need to become memory”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Chat temporal: cuando el trabajo no necesita convertirse en memoria», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Chat temporaire : quand le travail n’a pas besoin de devenir mémoire », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":3,"es":2,"fr":3}},{"slug":"design-qa-from-brief-to-export","category":"design","asset":"browserCursor","title":{"pt":"Giorgio Design: do briefing ao QA de frontend","en":"Giorgio Design: from briefing to frontend QA","es":"Giorgio Design: del briefing al QA de frontend","fr":"Giorgio Design : du brief au QA frontend"},"lead":{"pt":"A superfície de Design combina referência visual, preview executável, acessibilidade, responsividade e revisão antes da exportação.","en":"The Design surface combines visual reference, executable preview, accessibility, responsiveness, and review before export.","es":"La superficie Design combina referencia visual, preview ejecutable, accesibilidad, responsividad y revisión antes de exportar.","fr":"La surface Design combine référence visuelle, aperçu exécutable, accessibilité, responsivité et revue avant export."},"date":"2026-08-27","read":2,"blocks":[{"title":{"pt":"Design não termina na imagem","en":"Design does not end at the image","es":"El design no termina en la imagen","fr":"Le design ne s’arrête pas à l’image"},"body":[{"pt":"No Giorgio, a superfície de Design foi pensada para sair do briefing e chegar a uma experiência executável. Thesis e Melos continuam como motores técnicos, enquanto o protocolo de Design acrescenta direção visual, acessibilidade, responsividade e QA de frontend.","en":"In Giorgio, the Design surface is built to move from a briefing to an executable experience. Thesis and Melos remain the technical engines, while the Design protocol adds visual direction, accessibility, responsiveness, and frontend QA.","es":"En Giorgio, la superficie Design está pensada para ir del briefing a una experiencia ejecutable. Thesis y Melos siguen como motores técnicos, mientras el protocolo Design añade dirección visual, accesibilidad, responsividad y QA de frontend.","fr":"Dans Giorgio, la surface Design est conçue pour passer du brief à une expérience exécutable. Thesis et Melos restent les moteurs techniques, tandis que le protocole Design ajoute direction visuelle, accessibilité, responsivité et QA frontend."}]},{"title":{"pt":"Etapas que importam","en":"Steps that matter","es":"Etapas que importan","fr":"Étapes importantes"},"bullets":[{"pt":"Entender objetivo, público e restrições do briefing.","en":"Understand the goal, audience, and constraints in the brief.","es":"Entender objetivo, público y restricciones del briefing.","fr":"Comprendre l’objectif, le public et les contraintes du brief."},{"pt":"Usar referência visual sem copiar estrutura cegamente.","en":"Use visual reference without blindly copying structure.","es":"Usar referencia visual sin copiar la estructura ciegamente.","fr":"Utiliser une référence visuelle sans copier aveuglément la structure."},{"pt":"Renderizar, revisar responsividade e verificar acessibilidade antes de exportar.","en":"Render, review responsiveness, and verify accessibility before export.","es":"Renderizar, revisar responsividad y verificar accesibilidad antes de exportar.","fr":"Rendre, vérifier la responsivité et l’accessibilité avant export."}]},{"title":{"pt":"Preview é parte do processo","en":"Preview is part of the process","es":"El preview es parte del proceso","fr":"L’aperçu fait partie du processus"},"body":[{"pt":"Uma interface pode parecer correta no código e falhar quando renderizada. Por isso a etapa visual precisa ser tratada como verificação, não como decoração de fim de fluxo.","en":"An interface can look correct in code and still fail when rendered. That is why the visual step must be treated as verification, not end-of-flow decoration.","es":"Una interfaz puede parecer correcta en código y fallar al renderizar. Por eso la etapa visual debe tratarse como verificación y no como decoración al final del flujo.","fr":"Une interface peut sembler correcte dans le code et échouer une fois rendue. L’étape visuelle doit donc être traitée comme une vérification, pas comme une décoration finale."}]},{"title":{"pt":"Design termina na verificação, não no mockup","en":"Design ends at verification, not the mockup","es":"El diseño termina en la verificación, no en el mockup","fr":"Le design se termine à la vérification, pas au mockup"},"body":[{"pt":"Uma direção visual só vira produto quando sobrevive a conteúdo real, estados vazios, teclado, telas estreitas, contraste e interação. O fluxo de Design deve aproximar briefing, implementação e QA para que a estética não esconda regressões funcionais.","en":"A visual direction becomes product only when it survives real content, empty states, keyboards, narrow screens, contrast, and interaction. The Design flow should bring briefing, implementation, and QA together so aesthetics do not hide functional regressions.","es":"Una dirección visual se convierte en producto solo cuando sobrevive a contenido real, estados vacíos, teclado, pantallas estrechas, contraste e interacción. El flujo de Design debe acercar briefing, implementación y QA para que la estética no oculte regresiones funcionales.","fr":"Une direction visuelle ne devient un produit que lorsqu’elle résiste au contenu réel, aux états vides, au clavier, aux écrans étroits, au contraste et à l’interaction. Le flux Design doit rapprocher briefing, implémentation et QA afin que l’esthétique ne masque pas les régressions fonctionnelles."}]},{"title":{"pt":"Da intenção ao preview","en":"From intent to preview","es":"From intent to preview","fr":"From intent to preview"},"body":[{"pt":"Em “Giorgio Design: do briefing ao QA de frontend”, a ideia só vira valor quando aparece no fluxo real. A superfície de Design combina referência visual, preview executável, acessibilidade, responsividade e revisão antes da exportação. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Giorgio Design: from briefing to frontend QA”, the idea only becomes valuable when it appears in the real workflow. The Design surface combines visual reference, executable preview, accessibility, responsiveness, and review before export. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Giorgio Design: from briefing to frontend QA”, the idea only becomes valuable when it appears in the real workflow. The Design surface combines visual reference, executable preview, accessibility, responsiveness, and review before export. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Giorgio Design: from briefing to frontend QA”, the idea only becomes valuable when it appears in the real workflow. The Design surface combines visual reference, executable preview, accessibility, responsiveness, and review before export. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Por dentro de QA visual começa no briefing","en":"Inside Giorgio Design: from briefing to frontend QA","es":"Por dentro de Giorgio Design: del briefing al QA de frontend","fr":"Au cœur de Giorgio Design : du brief au QA frontend"},"body":[{"pt":"Um briefing bom define objetivo, público, restrições, referência e estados obrigatórios. Isso permite avaliar o resultado depois por critérios concretos, em vez de decidir no final se a tela “tem cara boa”.","en":"The useful way to read “Giorgio Design: from briefing to frontend QA” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Giorgio Design: del briefing al QA de frontend» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Giorgio Design : du brief au QA frontend » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"referência vira requisito de composição e comportamento","en":"referência vira requisito de composição e comportamento","es":"referência vira requisito de composição e comportamento","fr":"referência vira requisito de composição e comportamento"},{"pt":"visual é revisado depois de implementado","en":"visual é revisado depois de implementado","es":"visual é revisado depois de implementado","fr":"visual é revisado depois de implementado"},{"pt":"estética nunca substitui estado funcional","en":"estética nunca substitui estado funcional","es":"estética nunca substitui estado funcional","fr":"estética nunca substitui estado funcional"}]},{"title":{"pt":"Falha específica: QA visual começa no briefing","en":"Specific failure mode: Giorgio Design: from briefing to frontend QA","es":"Fallo específico: Giorgio Design: del briefing al QA de frontend","fr":"Mode de défaillance : Giorgio Design : du brief au QA frontend"},"body":[{"pt":"O risco é tratar preview como acabamento. Sem navegação, estados vazios, erro, teclado, mobile e exportação, um mockup polido continua sendo um produto incompleto.","en":"The failure mode to watch in “Giorgio Design: from briefing to frontend QA” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Giorgio Design: del briefing al QA de frontend» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Giorgio Design : du brief au QA frontend » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha QA visual começa no briefing","en":"Evidence that closes Giorgio Design: from briefing to frontend QA","es":"Evidencia que cierra Giorgio Design: del briefing al QA de frontend","fr":"Preuve qui valide Giorgio Design : du brief au QA frontend"},"body":[{"pt":"O ciclo fecha quando o mesmo conjunto de requisitos acompanha direção visual, implementação, screenshot review e entrega do artefato final.","en":"For “Giorgio Design: from briefing to frontend QA”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Giorgio Design: del briefing al QA de frontend», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Giorgio Design : du brief au QA frontend », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"auth-recovery-without-losing-work","category":"engineering","asset":"browserCursor","title":{"pt":"Recuperar autenticação sem perder o trabalho em andamento","en":"Recover authentication without losing work in progress","es":"Recuperar autenticación sin perder el trabajo en curso","fr":"Récupérer l’authentification sans perdre le travail en cours"},"lead":{"pt":"Sessões longas precisam distinguir expiração de credencial, falha de rede e erro de modelo antes de mandar o usuário de volta ao login.","en":"Long sessions need to distinguish credential expiry, network failure, and model errors before sending the user back to login.","es":"Las sesiones largas deben distinguir expiración de credenciales, fallo de red y error de modelo antes de enviar al usuario al login.","fr":"Les longues sessions doivent distinguer expiration des identifiants, panne réseau et erreur de modèle avant de renvoyer l’utilisateur vers la connexion."},"date":"2026-08-27","read":2,"blocks":[{"title":{"pt":"Redirecionar para login não é diagnóstico","en":"Redirecting to login is not a diagnosis","es":"Redirigir al login no es un diagnóstico","fr":"Rediriger vers la connexion n’est pas un diagnostic"},"body":[{"pt":"Quando uma chamada recebe 401, o problema pode ser uma corrida de autorização ou um token que precisa ser renovado. Derrubar toda a sessão e voltar ao login transforma um erro recuperável em perda de contexto.","en":"When a call returns 401, the problem may be an authorization race or a token that needs refreshing. Dropping the entire session and returning to login turns a recoverable error into context loss.","es":"Cuando una llamada devuelve 401, el problema puede ser una carrera de autorización o un token que necesita renovarse. Derribar toda la sesión y volver al login transforma un error recuperable en pérdida de contexto.","fr":"Lorsqu’un appel renvoie 401, le problème peut être une course d’autorisation ou un jeton à renouveler. Abandonner toute la session et revenir à la connexion transforme une erreur récupérable en perte de contexte."}]},{"title":{"pt":"Ordem de recuperação","en":"Recovery order","es":"Orden de recuperación","fr":"Ordre de récupération"},"bullets":[{"pt":"Tentar renovar a autenticação quando a sessão ainda é válida.","en":"Attempt an auth refresh when the session is still valid.","es":"Intentar renovar la autenticación cuando la sesión aún es válida.","fr":"Tenter un rafraîchissement de l’authentification lorsque la session est encore valide."},{"pt":"Preservar o prompt, arquivos e estado da tarefa durante o retry.","en":"Preserve the prompt, files, and task state during retry.","es":"Preservar el prompt, archivos y estado de la tarea durante el reintento.","fr":"Préserver le prompt, les fichiers et l’état de la tâche pendant la nouvelle tentative."},{"pt":"Só pedir login novamente quando a recuperação realmente falhar.","en":"Ask for login again only when recovery actually fails.","es":"Pedir login de nuevo solo cuando la recuperación realmente falle.","fr":"Ne redemander la connexion que si la récupération échoue réellement."}]},{"title":{"pt":"Confiabilidade é continuidade","en":"Reliability is continuity","es":"La confiabilidad es continuidad","fr":"La fiabilité, c’est la continuité"},"body":[{"pt":"Para quem está trabalhando em uma tarefa longa, manter contexto e estado durante uma falha transitória vale mais do que esconder o erro com uma animação de carregamento.","en":"For someone working on a long task, preserving context and state through a transient failure matters more than hiding the error behind a loading animation.","es":"Para quien trabaja en una tarea larga, mantener contexto y estado durante un fallo transitorio vale más que ocultar el error tras una animación de carga.","fr":"Pour quelqu’un qui travaille sur une longue tâche, préserver le contexte et l’état lors d’une panne transitoire compte davantage que masquer l’erreur derrière une animation de chargement."}]},{"title":{"pt":"A parte difícil de Renovar sessão não pode apagar estado local","en":"The hard part of Recover authentication without losing work in progress","es":"La parte difícil de Recuperar autenticación sin perder el trabajo en curso","fr":"La partie difficile de Récupérer l’authentification sans perdre le travail en cours"},"body":[{"pt":"Uma corrida de refresh token pode acontecer no pior momento: depois que o usuário anexou arquivos ou enquanto uma resposta longa está sendo gerada. Recuperação de auth precisa distinguir credencial expirada de sessão terminal e preservar o trabalho ainda não enviado.","en":"The useful way to read “Recover authentication without losing work in progress” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Recuperar autenticación sin perder el trabajo en curso» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Récupérer l’authentification sans perdre le travail en cours » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"causa raiz vem antes do fallback","en":"causa raiz vem antes do fallback","es":"causa raiz vem antes do fallback","fr":"causa raiz vem antes do fallback"},{"pt":"mudança não quebra subsistemas fora do escopo","en":"mudança não quebra subsistemas fora do escopo","es":"mudança não quebra subsistemas fora do escopo","fr":"mudança não quebra subsistemas fora do escopo"},{"pt":"logs e códigos permitem reproduzir a falha","en":"logs e códigos permitem reproduzir a falha","es":"logs e códigos permitem reproduzir a falha","fr":"logs e códigos permitem reproduzir a falha"}]},{"title":{"pt":"Falha específica: Renovar sessão não pode apagar estado local","en":"Specific failure mode: Recover authentication without losing work in progress","es":"Fallo específico: Recuperar autenticación sin perder el trabajo en curso","fr":"Mode de défaillance : Récupérer l’authentification sans perdre le travail en cours"},"body":[{"pt":"O perigo é “resolver” 401 redirecionando imediatamente para login e destruindo composer, anexos e estado do workspace.","en":"The failure mode to watch in “Recover authentication without losing work in progress” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Recuperar autenticación sin perder el trabajo en curso» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Récupérer l’authentification sans perdre le travail en cours » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Renovar sessão não pode apagar estado local","en":"Evidence that closes Recover authentication without losing work in progress","es":"Evidencia que cierra Recuperar autenticación sin perder el trabajo en curso","fr":"Preuve qui valide Récupérer l’authentification sans perdre le travail en cours"},"body":[{"pt":"O comportamento correto tenta recuperar sessão uma vez, bloqueia duplicação de refresh, repete somente a operação segura e restaura o contexto local se o login realmente for necessário.","en":"For “Recover authentication without losing work in progress”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Recuperar autenticación sin perder el trabajo en curso», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Récupérer l’authentification sans perdre le travail en cours », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Falha que esse desenho evita como gate","en":"failure this design prevents as a gate","es":"fallo que este diseño evita como gate","fr":"panne évitée par cette conception comme gate"},"body":[{"pt":"Em “Recuperar autenticação sem perder o trabalho em andamento”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Recover authentication without losing work in progress”, the technical point that closes the analysis is to treat ownership, recovery, and observability as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Recuperar autenticación sin perder el trabajo en curso”, el cierre técnico es tratar ownership, recuperación y observabilidad como un único contrato y exigir comportamiento verificable.","fr":"Dans « Récupérer l’authentification sans perdre le travail en cours », le point technique final consiste à traiter ownership, reprise et observabilité comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"code-preview-before-delivery","category":"code","asset":"codeBubble","title":{"pt":"Preview e execução antes da entrega no Giorgio Code","en":"Preview and execution before delivery in Giorgio Code","es":"Preview y ejecución antes de la entrega en Giorgio Code","fr":"Aperçu et exécution avant livraison dans Giorgio Code"},"lead":{"pt":"Código gerado só vira entrega quando existe uma forma observável de verificar o comportamento que mudou.","en":"Generated code only becomes delivery when there is an observable way to verify the changed behavior.","es":"El código generado solo se convierte en entrega cuando existe una forma observable de verificar el comportamiento modificado.","fr":"Le code généré ne devient une livraison que lorsqu’il existe un moyen observable de vérifier le comportement modifié."},"date":"2026-08-26","read":2,"blocks":[{"title":{"pt":"O código não é a evidência final","en":"Code is not the final evidence","es":"El código no es la evidencia final","fr":"Le code n’est pas la preuve finale"},"body":[{"pt":"Uma alteração pode compilar e ainda falhar visualmente, quebrar um fluxo ou produzir resultado incorreto. Terminal, preview e revisão de arquivos existem para transformar “parece certo” em evidência verificável.","en":"A change can compile and still fail visually, break a flow, or produce the wrong result. Terminal output, preview, and file review exist to turn “looks right” into verifiable evidence.","es":"Un cambio puede compilar y aun así fallar visualmente, romper un flujo o producir un resultado incorrecto. Terminal, preview y revisión de archivos convierten “parece correcto” en evidencia verificable.","fr":"Une modification peut compiler et pourtant échouer visuellement, casser un flux ou produire un mauvais résultat. Terminal, aperçu et revue des fichiers servent à transformer « ça semble correct » en preuve vérifiable."}]},{"title":{"pt":"Três verificações diferentes","en":"Three different checks","es":"Tres verificaciones diferentes","fr":"Trois vérifications différentes"},"bullets":[{"pt":"Terminal: testes, build e erros de execução.","en":"Terminal: tests, build, and runtime errors.","es":"Terminal: pruebas, build y errores de ejecución.","fr":"Terminal : tests, build et erreurs d’exécution."},{"pt":"Preview: comportamento visual e interação.","en":"Preview: visual behavior and interaction.","es":"Preview: comportamiento visual e interacción.","fr":"Aperçu : comportement visuel et interaction."},{"pt":"Revisão: diff, arquivos alterados e impacto fora do caso feliz.","en":"Review: diff, changed files, and impact beyond the happy path.","es":"Revisión: diff, archivos cambiados e impacto fuera del caso feliz.","fr":"Revue : diff, fichiers modifiés et impact au-delà du chemin nominal."}]},{"title":{"pt":"Entrega significa estado conhecido","en":"Delivery means a known state","es":"Entregar significa un estado conocido","fr":"Livrer signifie un état connu"},"body":[{"pt":"Quando algo não foi executado, isso deve ser dito. Quando foi verificado, a resposta deve indicar qual evidência sustentou a conclusão. Esse detalhe reduz falsa confiança sem atrasar o fluxo.","en":"When something was not executed, it should be stated. When it was verified, the response should indicate which evidence supports the conclusion. That reduces false confidence without slowing the flow.","es":"Cuando algo no fue ejecutado, debe decirse. Cuando fue verificado, la respuesta debe indicar qué evidencia sustenta la conclusión. Ese detalle reduce falsa confianza sin frenar el flujo.","fr":"Lorsqu’une chose n’a pas été exécutée, cela doit être indiqué. Lorsqu’elle a été vérifiée, la réponse doit préciser quelle preuve soutient la conclusion. Ce détail réduit la fausse confiance sans ralentir le flux."}]},{"title":{"pt":"O contrato escondido em Preview é evidência de produto","en":"The hidden contract in Preview and execution before delivery in Giorgio Code","es":"El contrato oculto de Preview y ejecución antes de la entrega en Giorgio Code","fr":"Le contrat caché de Aperçu et exécution avant livraison dans Giorgio Code"},"body":[{"pt":"Para frontend, abrir o arquivo ou servidor e observar a tela acrescenta uma classe de evidência que parser nenhum oferece: overflow, crop, contraste, densidade, estado vazio, foco e interação real.","en":"The useful way to read “Preview and execution before delivery in Giorgio Code” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Preview y ejecución antes de la entrega en Giorgio Code» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Aperçu et exécution avant livraison dans Giorgio Code » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Preview é evidência de produto","en":"Specific failure mode: Preview and execution before delivery in Giorgio Code","es":"Fallo específico: Preview y ejecución antes de la entrega en Giorgio Code","fr":"Mode de défaillance : Aperçu et exécution avant livraison dans Giorgio Code"},"body":[{"pt":"O risco é usar screenshot como prova de tudo. Uma imagem bonita não demonstra auth, persistência, API, acessibilidade ou comportamento em outros breakpoints.","en":"The failure mode to watch in “Preview and execution before delivery in Giorgio Code” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Preview y ejecución antes de la entrega en Giorgio Code» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Aperçu et exécution avant livraison dans Giorgio Code » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Preview é evidência de produto","en":"Evidence that closes Preview and execution before delivery in Giorgio Code","es":"Evidencia que cierra Preview y ejecución antes de la entrega en Giorgio Code","fr":"Preuve qui valide Aperçu et exécution avant livraison dans Giorgio Code"},"body":[{"pt":"A entrega forte combina preview visual com checks de runtime e contratos, e registra separadamente o que foi observado, executado e apenas inspecionado estaticamente.","en":"For “Preview and execution before delivery in Giorgio Code”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Preview y ejecución antes de la entrega en Giorgio Code», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Aperçu et exécution avant livraison dans Giorgio Code », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Preview e execução antes da entrega no Giorgio Code”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Preview and execution before delivery in Giorgio Code”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Preview y ejecución antes de la entrega en Giorgio Code”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Aperçu et exécution avant livraison dans Giorgio Code », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"persistent-sessions","category":"code","asset":"coding","title":{"pt":"Sessões persistentes: por que o trabalho não deveria recomeçar do zero","en":"Persistent sessions: why work should not restart from zero","es":"Sesiones persistentes: por qué el trabajo no debería empezar de cero","fr":"Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro"},"lead":{"pt":"Como histórico, arquivos e decisões permanecem juntos para tarefas que levam mais de uma resposta.","en":"How history, files, and decisions stay together for tasks that take more than one response.","es":"Cómo el historial, los archivos y las decisiones permanecen juntos en tareas que requieren más de una respuesta.","fr":"Comment l’historique, les fichiers et les décisions restent liés pour les tâches qui demandent plusieurs réponses."},"date":"2026-09-01","read":2,"blocks":[{"title":{"pt":"Uma sessão é uma unidade de trabalho","en":"A session is a unit of work","es":"Una sesión es una unidad de trabajo","fr":"Une session est une unité de travail"},"body":[{"pt":"No Giorgio Code, uma sessão não é só um histórico de mensagens. Ela reúne a tarefa, os arquivos abertos, as decisões tomadas e os resultados que precisam ser revisados.","en":"In Giorgio Code, a session is more than message history. It keeps the task, open files, decisions, and results that still need review together.","es":"En Giorgio Code, una sesión es más que un historial de mensajes. Reúne la tarea, los archivos abiertos, las decisiones y los resultados que aún deben revisarse.","fr":"Dans Giorgio Code, une session est plus qu’un historique de messages. Elle réunit la tâche, les fichiers ouverts, les décisions et les résultats à examiner."},{"pt":"Isso reduz o custo de explicar novamente o contexto e torna retomadas mais previsíveis depois de uma pausa.","en":"That reduces the cost of re-explaining context and makes resumes more predictable after a pause.","es":"Eso reduce el costo de volver a explicar el contexto y hace más predecible retomar el trabajo después de una pausa.","fr":"Cela réduit le besoin de réexpliquer le contexte et rend la reprise plus prévisible après une pause."}]},{"title":{"pt":"Quando separar","en":"When to split","es":"Cuándo separar","fr":"Quand séparer"},"bullets":[{"pt":"Crie outra sessão quando o objetivo principal mudar.","en":"Create another session when the main objective changes.","es":"Crea otra sesión cuando cambie el objetivo principal.","fr":"Créez une autre session lorsque l’objectif principal change."},{"pt":"Mantenha a mesma sessão quando a nova solicitação for revisão, correção ou continuação direta.","en":"Keep the same session when the new request is a review, correction, or direct continuation.","es":"Mantén la misma sesión cuando la nueva solicitud sea una revisión, corrección o continuación directa.","fr":"Gardez la même session lorsque la nouvelle demande est une révision, une correction ou une continuation directe."},{"pt":"Use nomes claros para encontrar o trabalho depois.","en":"Use clear names so the work is easy to find later.","es":"Usa nombres claros para encontrar el trabajo después.","fr":"Utilisez des noms clairs pour retrouver facilement le travail."}]},{"title":{"pt":"O ganho real","en":"The real gain","es":"La ganancia real","fr":"Le gain réel"},"body":[{"pt":"Persistência não serve para acumular conversa infinita. Serve para preservar apenas o que torna a próxima decisão melhor.","en":"Persistence is not for accumulating endless conversation. It is for preserving what makes the next decision better.","es":"La persistencia no sirve para acumular conversaciones infinitas. Sirve para conservar lo que mejora la siguiente decisión.","fr":"La persistance ne sert pas à accumuler une conversation sans fin. Elle sert à conserver ce qui améliore la décision suivante."}]},{"title":{"pt":"Onde Sessão persistente é memória operacional realmente ganha qualidade","en":"Where Persistent sessions: why work should not restart from zero actually gains quality","es":"Dónde Sesiones persistentes: por qué el trabajo no debería empezar de cero realmente gana calidad","fr":"Là où Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro gagne vraiment en qualité"},"body":[{"pt":"Uma boa sessão preserva decisões, arquivos, estado do workspace e evidência suficiente para continuar sem reconstruir o problema do zero. Isso é diferente de simplesmente armazenar um transcript infinito.","en":"The useful way to read “Persistent sessions: why work should not restart from zero” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Sesiones persistentes: por qué el trabajo no debería empezar de cero» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Sessão persistente é memória operacional","en":"Specific failure mode: Persistent sessions: why work should not restart from zero","es":"Fallo específico: Sesiones persistentes: por qué el trabajo no debería empezar de cero","fr":"Mode de défaillance : Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro"},"body":[{"pt":"O risco é carregar contexto demais e transformar continuidade em ruído. Histórico irrelevante pode competir com o estado atual e reforçar decisões obsoletas.","en":"The failure mode to watch in “Persistent sessions: why work should not restart from zero” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Sesiones persistentes: por qué el trabajo no debería empezar de cero» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Sessão persistente é memória operacional","en":"Evidence that closes Persistent sessions: why work should not restart from zero","es":"Evidencia que cierra Sesiones persistentes: por qué el trabajo no debería empezar de cero","fr":"Preuve qui valide Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro"},"body":[{"pt":"O sistema precisa resumir, indexar e recuperar por relevância, mantendo checkpoints e artefatos como fontes mais fortes do que conversa antiga.","en":"For “Persistent sessions: why work should not restart from zero”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Sesiones persistentes: por qué el trabajo no debería empezar de cero», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Sessões persistentes: por que o trabalho não deveria recomeçar do zero”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Persistent sessions: why work should not restart from zero”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Sesiones persistentes: por qué el trabajo no debería empezar de cero”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Sessions persistantes : pourquoi le travail ne devrait pas repartir de zéro », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"reviewable-previews","category":"code","asset":"coding","title":{"pt":"Previews que fazem parte da revisão","en":"Previews that are part of the review","es":"Previews que forman parte de la revisión","fr":"Des aperçus qui font partie de la révision"},"lead":{"pt":"Por que visualizar HTML, imagens e artefatos ao lado da tarefa é melhor do que tratar preview como decoração.","en":"Why viewing HTML, images, and artifacts beside the task is better than treating preview as decoration.","es":"Por qué ver HTML, imágenes y artefactos junto a la tarea es mejor que tratar el preview como decoración.","fr":"Pourquoi afficher HTML, images et artefacts à côté de la tâche est préférable à un aperçu décoratif."},"date":"2026-08-31","read":2,"blocks":[{"title":{"pt":"Resultado visível","en":"Visible result","es":"Resultado visible","fr":"Résultat visible"},"body":[{"pt":"Um preview útil responde a uma pergunta simples: o resultado entregue realmente parece e se comporta como deveria?","en":"A useful preview answers a simple question: does the delivered result actually look and behave as intended?","es":"Un preview útil responde una pregunta simple: ¿el resultado entregado se ve y se comporta como debería?","fr":"Un aperçu utile répond à une question simple : le résultat livré ressemble-t-il et se comporte-t-il comme prévu ?"},{"pt":"No fluxo de Code e Artefatos, abrir o resultado no mesmo contexto reduz o salto entre geração e validação.","en":"In the Code and Artifacts flow, opening the result in the same context reduces the gap between generation and validation.","es":"En el flujo de Code y Artefactos, abrir el resultado en el mismo contexto reduce la distancia entre generación y validación.","fr":"Dans le flux Code et Artefacts, ouvrir le résultat dans le même contexte réduit l’écart entre génération et validation."}]},{"title":{"pt":"O que revisar","en":"What to review","es":"Qué revisar","fr":"Que vérifier"},"bullets":[{"pt":"Hierarquia, espaçamento e responsividade.","en":"Hierarchy, spacing, and responsiveness.","es":"Jerarquía, espaciado y responsividad.","fr":"Hiérarchie, espacement et réactivité."},{"pt":"Estados vazios, erros e ações principais.","en":"Empty states, errors, and primary actions.","es":"Estados vacíos, errores y acciones principales.","fr":"États vides, erreurs et actions principales."},{"pt":"Se o arquivo final corresponde ao pedido, não apenas ao código gerado.","en":"Whether the final file matches the request, not merely the generated code.","es":"Si el archivo final corresponde a la solicitud, no solo al código generado.","fr":"Si le fichier final correspond à la demande, pas seulement au code généré."}]},{"title":{"pt":"Preview não substitui teste","en":"Preview does not replace testing","es":"El preview no sustituye las pruebas","fr":"L’aperçu ne remplace pas les tests"},"body":[{"pt":"Ele torna falhas visuais e de fluxo mais fáceis de enxergar. Testes, terminal e revisão continuam sendo evidências complementares.","en":"It makes visual and flow failures easier to see. Tests, terminal output, and review remain complementary evidence.","es":"Facilita detectar fallos visuales y de flujo. Las pruebas, el terminal y la revisión siguen siendo evidencias complementarias.","fr":"Il facilite la détection des défauts visuels et de parcours. Les tests, le terminal et la révision restent des preuves complémentaires."}]},{"title":{"pt":"O mecanismo central de Preview precisa aceitar inspeção, não só aplauso","en":"The core mechanism of Previews that are part of the review","es":"El mecanismo central de Previews que forman parte de la revisión","fr":"Le mécanisme central de Des aperçus qui font partie de la révision"},"body":[{"pt":"Um preview revisável permite comparar versões, abrir DOM ou arquivo, checar comportamento e voltar ao ponto exato que produziu a regressão. O objetivo é transformar o visual em uma superfície de engenharia.","en":"The useful way to read “Previews that are part of the review” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Previews que forman parte de la revisión» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Des aperçus qui font partie de la révision » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Preview precisa aceitar inspeção, não só aplauso","en":"Specific failure mode: Previews that are part of the review","es":"Fallo específico: Previews que forman parte de la revisión","fr":"Mode de défaillance : Des aperçus qui font partie de la révision"},"body":[{"pt":"O erro é usar preview como uma miniatura decorativa ou regenerá-lo sem preservar a versão anterior, eliminando a possibilidade de comparação.","en":"The failure mode to watch in “Previews that are part of the review” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Previews que forman parte de la revisión» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Des aperçus qui font partie de la révision » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Preview precisa aceitar inspeção, não só aplauso","en":"Evidence that closes Previews that are part of the review","es":"Evidencia que cierra Previews que forman parte de la revisión","fr":"Preuve qui valide Des aperçus qui font partie de la révision"},"body":[{"pt":"Quando a revisão aponta uma diferença, o agente deve localizar a causa no código, corrigir e reconstruir o preview, não apenas descrever o defeito.","en":"For “Previews that are part of the review”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Previews que forman parte de la revisión», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Des aperçus qui font partie de la révision », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Previews que fazem parte da revisão”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Previews that are part of the review”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Previews que forman parte de la revisión”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Des aperçus qui font partie de la révision », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"public-blog-in-one-file","category":"site","asset":"site","title":{"pt":"Um blog público dentro do mesmo HTML","en":"A public blog inside the same HTML","es":"Un blog público dentro del mismo HTML","fr":"Un blog public dans le même HTML"},"lead":{"pt":"Como separar conteúdo público e workspace privado sem duplicar o produto inteiro.","en":"How to separate public content and the private workspace without duplicating the entire product.","es":"Cómo separar el contenido público y el espacio privado sin duplicar todo el producto.","fr":"Comment séparer le contenu public et l’espace privé sans dupliquer tout le produit."},"date":"2026-08-30","read":2,"blocks":[{"title":{"pt":"Duas experiências, uma entrada","en":"Two experiences, one entry","es":"Dos experiencias, una entrada","fr":"Deux expériences, une entrée"},"body":[{"pt":"O mesmo arquivo pode hospedar rotas públicas e privadas desde que o roteamento identifique a intenção antes de iniciar a tela de autenticação.","en":"The same file can host public and private routes as long as routing identifies intent before the authentication screen starts.","es":"El mismo archivo puede alojar rutas públicas y privadas si el enrutamiento identifica la intención antes de iniciar la pantalla de autenticación.","fr":"Le même fichier peut héberger des routes publiques et privées si le routage identifie l’intention avant l’écran d’authentification."},{"pt":"Blog e documentação precisam abrir sem sessão; chat, projetos e ações de conta continuam protegidos.","en":"Blog and documentation need to open without a session; chat, projects, and account actions remain protected.","es":"El blog y la documentación deben abrir sin sesión; el chat, los proyectos y las acciones de cuenta siguen protegidos.","fr":"Le blog et la documentation doivent s’ouvrir sans session ; le chat, les projets et les actions de compte restent protégés."}]},{"title":{"pt":"O detalhe que evita flashes","en":"The detail that prevents flashes","es":"El detalle que evita parpadeos","fr":"Le détail qui évite les flashs"},"body":[{"pt":"A rota pública deve ser reconhecida no head antes que a interface privada apareça. Depois, o runtime público assume a tela com um único renderer.","en":"The public route should be recognized in the head before the private interface appears. Then the public runtime takes over with a single renderer.","es":"La ruta pública debe reconocerse en el head antes de que aparezca la interfaz privada. Después, el runtime público toma el control con un único renderer.","fr":"La route publique doit être reconnue dans le head avant l’apparition de l’interface privée. Ensuite, le runtime public prend le relais avec un seul renderer."}]},{"title":{"pt":"Regra de manutenção","en":"Maintenance rule","es":"Regla de mantenimiento","fr":"Règle de maintenance"},"bullets":[{"pt":"Uma única tabela de rotas públicas.","en":"One public route table.","es":"Una sola tabla de rutas públicas.","fr":"Une seule table de routes publiques."},{"pt":"Um único CSS autoritativo para Blog e Docs.","en":"One authoritative CSS layer for Blog and Docs.","es":"Una sola capa CSS autoritativa para Blog y Docs.","fr":"Une seule couche CSS autoritaire pour Blog et Docs."},{"pt":"Fallback por hash apenas quando o arquivo é aberto localmente.","en":"Hash fallback only when the file is opened locally.","es":"Fallback por hash solo cuando el archivo se abre localmente.","fr":"Fallback par hash uniquement lorsque le fichier est ouvert localement."}]},{"title":{"pt":"Uma superfície pública precisa funcionar sem contexto oculto","en":"A public surface must work without hidden context","es":"Una superficie pública debe funcionar sin contexto oculto","fr":"Une surface publique doit fonctionner sans contexte caché"},"body":[{"pt":"Blog e documentação devem abrir por URL direta, permanecer legíveis sem sessão e expor estrutura suficiente para navegadores, buscadores e agentes. A experiência autenticada pode continuar privada; o conteúdo público não deveria depender dela para existir.","en":"Blog and documentation should open from direct URLs, remain readable without a session, and expose enough structure for browsers, search engines, and agents. The authenticated experience can remain private; public content should not depend on it to exist.","es":"Blog y documentación deben abrir por URL directa, seguir legibles sin sesión y exponer suficiente estructura para navegadores, buscadores y agentes. La experiencia autenticada puede seguir privada; el contenido público no debería depender de ella para existir.","fr":"Le blog et la documentation doivent s’ouvrir par URL directe, rester lisibles sans session et exposer suffisamment de structure aux navigateurs, moteurs et agents. L’expérience authentifiée peut rester privée ; le contenu public ne devrait pas dépendre d’elle pour exister."}]},{"title":{"pt":"A engenharia por trás de Rota pública não pode depender do login privado","en":"The engineering behind A public blog inside the same HTML","es":"La ingeniería detrás de Un blog público dentro del mismo HTML","fr":"L’ingénierie derrière Un blog public dans le même HTML"},"body":[{"pt":"Colocar Blog e app no mesmo HTML economiza distribuição, mas cria uma fronteira delicada: o router privado não pode capturar /blog e devolver /new, nem o bootstrap de auth pode esconder conteúdo público.","en":"The useful way to read “A public blog inside the same HTML” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Un blog público dentro del mismo HTML» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Un blog public dans le même HTML » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"rota funciona em file:// e hospedagem","en":"rota funciona em file:// e hospedagem","es":"rota funciona em file:// e hospedagem","fr":"rota funciona em file:// e hospedagem"},{"pt":"primeiro render não depende de auth quando é público","en":"primeiro render não depende de auth quando é público","es":"primeiro render não depende de auth quando é público","fr":"primeiro render não depende de auth quando é público"},{"pt":"mobile e desktop preservam a mesma intenção","en":"mobile e desktop preservam a mesma intenção","es":"mobile e desktop preservam a mesma intenção","fr":"mobile e desktop preservam a mesma intenção"}]},{"title":{"pt":"Falha específica: Rota pública não pode depender do login privado","en":"Specific failure mode: A public blog inside the same HTML","es":"Fallo específico: Un blog público dentro del mismo HTML","fr":"Mode de défaillance : Un blog public dans le même HTML"},"body":[{"pt":"O risco cresce em file://, onde hash routing e links normais se comportam de forma diferente do deploy web.","en":"The failure mode to watch in “A public blog inside the same HTML” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Un blog público dentro del mismo HTML» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Un blog public dans le même HTML » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Rota pública não pode depender do login privado","en":"Evidence that closes A public blog inside the same HTML","es":"Evidencia que cierra Un blog público dentro del mismo HTML","fr":"Preuve qui valide Un blog public dans le même HTML"},"body":[{"pt":"O contrato robusto reconhece rotas públicas antes do guard privado, intercepta navegação public-only em capture phase e oferece URLs legíveis para crawlers quando hospedado.","en":"For “A public blog inside the same HTML”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Un blog público dentro del mismo HTML», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Un blog public dans le même HTML », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"docs-that-match-the-product","category":"docs","asset":"theory","title":{"pt":"Documentação que descreve o produto que existe","en":"Documentation that describes the product that exists","es":"Documentación que describe el producto que existe","fr":"Une documentation qui décrit le produit réel"},"lead":{"pt":"O que muda quando a documentação para de prometer superfícies que ainda não fazem parte do Giorgio.","en":"What changes when documentation stops promising surfaces that are not yet part of Giorgio.","es":"Qué cambia cuando la documentación deja de prometer superficies que todavía no forman parte de Giorgio.","fr":"Ce qui change lorsque la documentation cesse de promettre des surfaces qui ne font pas encore partie de Giorgio."},"date":"2026-08-29","read":2,"blocks":[{"title":{"pt":"A documentação também é interface","en":"Documentation is also interface","es":"La documentación también es interfaz","fr":"La documentation est aussi une interface"},"body":[{"pt":"Uma página bonita perde valor rapidamente se ensina um botão, integração ou fluxo que o usuário não consegue encontrar.","en":"A beautiful page loses value quickly if it teaches a button, integration, or flow the user cannot find.","es":"Una página bonita pierde valor rápidamente si enseña un botón, integración o flujo que el usuario no puede encontrar.","fr":"Une belle page perd vite sa valeur si elle explique un bouton, une intégration ou un flux que l’utilisateur ne peut pas trouver."},{"pt":"Por isso, a nova documentação parte do inventário real do HTML: chat, busca, arquivos, projetos, artefatos, Design, Cowork, memória, conectores, plugins e as superfícies reais do Code.","en":"That is why the new documentation starts from the actual HTML inventory: chat, search, files, projects, artifacts, Design, Cowork, memory, connectors, plugins, and real Code surfaces.","es":"Por eso la nueva documentación parte del inventario real del HTML: chat, búsqueda, archivos, proyectos, artefactos, Design, Cowork, memoria, conectores, plugins y las superficies reales de Code.","fr":"C’est pourquoi la nouvelle documentation part de l’inventaire réel du HTML : chat, recherche, fichiers, projets, artefacts, Design, Cowork, mémoire, connecteurs, plugins et surfaces réelles de Code."}]},{"title":{"pt":"O que fica de fora","en":"What stays out","es":"Qué queda fuera","fr":"Ce qui reste hors documentation"},"body":[{"pt":"Recursos planejados ou conceitos externos não entram como se fossem funcionalidade pronta. Quando algo não existe, o docs não tenta preencher o espaço com marketing.","en":"Planned features or external concepts are not presented as finished functionality. When something does not exist, the docs do not fill the gap with marketing.","es":"Las funciones planificadas o conceptos externos no se presentan como funcionalidades terminadas. Cuando algo no existe, la documentación no rellena el hueco con marketing.","fr":"Les fonctions prévues ou concepts externes ne sont pas présentés comme des fonctionnalités finalisées. Quand quelque chose n’existe pas, la documentation ne comble pas le vide par du marketing."}]},{"title":{"pt":"Critério","en":"Criterion","es":"Criterio","fr":"Critère"},"bullets":[{"pt":"Existe no produto atual.","en":"It exists in the current product.","es":"Existe en el producto actual.","fr":"Cela existe dans le produit actuel."},{"pt":"É possível explicar sem inventar backend ou permissão.","en":"It can be explained without inventing a backend or permission.","es":"Puede explicarse sin inventar backend ni permisos.","fr":"Cela peut être expliqué sans inventer de backend ni d’autorisation."},{"pt":"A instrução ajuda alguém a concluir uma tarefa real.","en":"The instruction helps someone complete a real task.","es":"La instrucción ayuda a completar una tarea real.","fr":"L’instruction aide quelqu’un à accomplir une tâche réelle."}]},{"title":{"pt":"Documentação é contrato de comportamento","en":"Documentation is a behavior contract","es":"La documentación es un contrato de comportamiento","fr":"La documentation est un contrat de comportement"},"body":[{"pt":"Uma página de documentação útil descreve o que existe agora, os limites conhecidos e o caminho verificável para concluir uma tarefa. Quando a documentação promete uma função que a interface não entrega, ela deixa de orientar e passa a criar erro.","en":"Useful documentation describes what exists now, known limits, and a verifiable path to complete a task. When documentation promises a feature the interface does not deliver, it stops guiding and starts creating errors.","es":"Una documentación útil describe lo que existe ahora, los límites conocidos y una ruta verificable para completar una tarea. Cuando promete una función que la interfaz no entrega, deja de orientar y empieza a crear errores.","fr":"Une documentation utile décrit ce qui existe maintenant, les limites connues et un chemin vérifiable pour accomplir une tâche. Lorsqu’elle promet une fonction que l’interface ne fournit pas, elle cesse de guider et commence à créer des erreurs."}]},{"title":{"pt":"O ponto que decide Documentação precisa envelhecer junto com o runtime","en":"The decision point in Documentation that describes the product that exists","es":"El punto decisivo de Documentación que describe el producto que existe","fr":"Le point décisif de Une documentation qui décrit le produit réel"},"body":[{"pt":"Docs são perigosas quando descrevem uma capacidade que ainda não existe ou usam o nome de um modelo que o backend não retorna. A documentação deve nascer de contratos reais, não de roadmap imaginado.","en":"The useful way to read “Documentation that describes the product that exists” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Documentación que describe el producto que existe» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Une documentation qui décrit le produit réel » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"controle visível produz efeito real","en":"controle visível produz efeito real","es":"controle visível produz efeito real","fr":"controle visível produz efeito real"},{"pt":"estado persiste ou sincroniza quando prometido","en":"estado persiste ou sincroniza quando prometido","es":"estado persiste ou sincroniza quando prometido","fr":"estado persiste ou sincroniza quando prometido"},{"pt":"saída pode ser reutilizada fora da tela atual","en":"saída pode ser reutilizada fora da tela atual","es":"saída pode ser reutilizada fora da tela atual","fr":"saída pode ser reutilizada fora da tela atual"}]},{"title":{"pt":"Falha específica: Documentação precisa envelhecer junto com o runtime","en":"Specific failure mode: Documentation that describes the product that exists","es":"Fallo específico: Documentación que describe el producto que existe","fr":"Mode de défaillance : Une documentation qui décrit le produit réel"},"body":[{"pt":"O risco é copiar uma estrutura genérica entre dezenas de páginas e produzir volume sem utilidade operacional.","en":"The failure mode to watch in “Documentation that describes the product that exists” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Documentación que describe el producto que existe» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Une documentation qui décrit le produit réel » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Documentação precisa envelhecer junto com o runtime","en":"Evidence that closes Documentation that describes the product that exists","es":"Evidencia que cierra Documentación que describe el producto que existe","fr":"Preuve qui valide Une documentation qui décrit le produit réel"},"body":[{"pt":"Cada documento deve informar o que a função faz, entrada, saída, limites, estados de erro, relações com outras superfícies e uma forma de verificar o comportamento descrito.","en":"For “Documentation that describes the product that exists”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Documentación que describe el producto que existe», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Une documentation qui décrit le produit réel », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"file-thumbnails-with-less-noise","category":"product","asset":"docs","title":{"pt":"Miniaturas de arquivo com menos ruído","en":"File thumbnails with less noise","es":"Miniaturas de archivo con menos ruido","fr":"Miniatures de fichiers avec moins de bruit"},"lead":{"pt":"Por que reconhecer o tipo do arquivo é mais importante do que desenhar um pequeno diorama em cada card.","en":"Why recognizing the file type matters more than drawing a miniature diorama on every card.","es":"Por qué reconocer el tipo de archivo importa más que dibujar un pequeño diorama en cada tarjeta.","fr":"Pourquoi reconnaître le type de fichier compte plus que dessiner un petit diorama dans chaque carte."},"date":"2026-08-28","read":2,"blocks":[{"title":{"pt":"Informação antes de ornamento","en":"Information before ornament","es":"Información antes que ornamento","fr":"L’information avant l’ornement"},"body":[{"pt":"Uma miniatura precisa ajudar a responder “que arquivo é esse?” em menos de um segundo. Ícone, nome, extensão e estado resolvem a maior parte desse problema.","en":"A thumbnail should help answer “what file is this?” in under a second. Icon, name, extension, and state solve most of that problem.","es":"Una miniatura debe ayudar a responder “¿qué archivo es?” en menos de un segundo. Icono, nombre, extensión y estado resuelven la mayor parte del problema.","fr":"Une miniature doit aider à répondre « quel fichier est-ce ? » en moins d’une seconde. Icône, nom, extension et état résolvent l’essentiel du problème."}]},{"title":{"pt":"Onde o visual ainda ajuda","en":"Where visual detail still helps","es":"Dónde sigue ayudando el detalle visual","fr":"Où le détail visuel reste utile"},"bullets":[{"pt":"Imagens podem mostrar uma miniatura real.","en":"Images can show a real thumbnail.","es":"Las imágenes pueden mostrar una miniatura real.","fr":"Les images peuvent afficher une vraie miniature."},{"pt":"Artefatos renderizados podem mostrar um recorte do resultado.","en":"Rendered artifacts can show a crop of the result.","es":"Los artefactos renderizados pueden mostrar un recorte del resultado.","fr":"Les artefacts rendus peuvent montrer un extrait du résultat."},{"pt":"Arquivos de código ganham mais com linguagem e status do que com decoração.","en":"Code files benefit more from language and status than decoration.","es":"Los archivos de código ganan más con lenguaje y estado que con decoración.","fr":"Les fichiers de code profitent davantage du langage et de l’état que de la décoration."}]},{"title":{"pt":"Densidade controlada","en":"Controlled density","es":"Densidad controlada","fr":"Densité contrôlée"},"body":[{"pt":"Cards menores deixam a conversa respirar e tornam listas longas mais escaneáveis sem esconder o que foi anexado.","en":"Smaller cards let the conversation breathe and make long lists easier to scan without hiding what was attached.","es":"Las tarjetas más pequeñas dejan respirar la conversación y hacen que listas largas sean más fáciles de leer sin ocultar lo adjunto.","fr":"Des cartes plus petites laissent respirer la conversation et rendent les longues listes plus faciles à parcourir sans masquer les pièces jointes."}]},{"title":{"pt":"Menos ruído, mais sinal","en":"Less noise, more signal","es":"Menos ruido, más señal","fr":"Moins de bruit, plus de signal"},"body":[{"pt":"Uma capacidade de produto deve reduzir o esforço necessário para entender o estado atual. Rótulos, miniaturas e ações funcionam melhor quando ajudam a decidir o próximo passo, não quando competem entre si por atenção.","en":"A product capability should reduce the effort required to understand the current state. Labels, thumbnails, and actions work best when they help decide the next step rather than compete for attention.","es":"Una capacidad de producto debe reducir el esfuerzo necesario para entender el estado actual. Etiquetas, miniaturas y acciones funcionan mejor cuando ayudan a decidir el siguiente paso, no cuando compiten por atención.","fr":"Une capacité produit doit réduire l’effort nécessaire pour comprendre l’état actuel. Libellés, miniatures et actions fonctionnent mieux lorsqu’ils aident à décider de l’étape suivante plutôt que de se disputer l’attention."}]},{"title":{"pt":"O comportamento que importa","en":"The behavior that matters","es":"The behavior that matters","fr":"The behavior that matters"},"body":[{"pt":"Em “Miniaturas de arquivo com menos ruído”, a ideia só vira valor quando aparece no fluxo real. Por que reconhecer o tipo do arquivo é mais importante do que desenhar um pequeno diorama em cada card. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “File thumbnails with less noise”, the idea only becomes valuable when it appears in the real workflow. Why recognizing the file type matters more than drawing a miniature diorama on every card. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “File thumbnails with less noise”, the idea only becomes valuable when it appears in the real workflow. Why recognizing the file type matters more than drawing a miniature diorama on every card. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “File thumbnails with less noise”, the idea only becomes valuable when it appears in the real workflow. Why recognizing the file type matters more than drawing a miniature diorama on every card. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Como Miniatura é estado do composer deixa de ser só interface","en":"How File thumbnails with less noise becomes more than interface","es":"Cómo Miniaturas de archivo con menos ruido deja de ser solo interfaz","fr":"Comment Miniatures de fichiers avec moins de bruit dépasse la simple interface"},"body":[{"pt":"Uma miniatura boa confirma qual arquivo foi anexado sem transformar o composer em galeria. Imagens precisam de preview; documentos precisam de tipo, nome e ação de remover; tudo precisa sobreviver ao layout compacto.","en":"The useful way to read “File thumbnails with less noise” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Miniaturas de archivo con menos ruido» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Miniatures de fichiers avec moins de bruit » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"controle visível produz efeito real","en":"controle visível produz efeito real","es":"controle visível produz efeito real","fr":"controle visível produz efeito real"},{"pt":"estado persiste ou sincroniza quando prometido","en":"estado persiste ou sincroniza quando prometido","es":"estado persiste ou sincroniza quando prometido","fr":"estado persiste ou sincroniza quando prometido"},{"pt":"saída pode ser reutilizada fora da tela atual","en":"saída pode ser reutilizada fora da tela atual","es":"saída pode ser reutilizada fora da tela atual","fr":"saída pode ser reutilizada fora da tela atual"}]},{"title":{"pt":"Falha específica: Miniatura é estado do composer","en":"Specific failure mode: File thumbnails with less noise","es":"Fallo específico: Miniaturas de archivo con menos ruido","fr":"Mode de défaillance : Miniatures de fichiers avec moins de bruit"},"body":[{"pt":"O risco é gerar URL temporária sem revogar, duplicar o mesmo arquivo ou deixar anexos visualmente fora da caixa de mensagem.","en":"The failure mode to watch in “File thumbnails with less noise” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Miniaturas de archivo con menos ruido» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Miniatures de fichiers avec moins de bruit » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Miniatura é estado do composer","en":"Evidence that closes File thumbnails with less noise","es":"Evidencia que cierra Miniaturas de archivo con menos ruido","fr":"Preuve qui valide Miniatures de fichiers avec moins de bruit"},"body":[{"pt":"O comportamento correto limita tamanho e quantidade, mostra feedback imediato, permite remoção e entrega os mesmos objetos ao pipeline que o botão de anexar usaria.","en":"For “File thumbnails with less noise”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Miniaturas de archivo con menos ruido», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Miniatures de fichiers avec moins de bruit », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"connectors-with-explicit-permission","category":"connectors","asset":"cloudHand","title":{"pt":"Conectores com contexto e permissão explícitos","en":"Connectors with explicit context and permission","es":"Conectores con contexto y permiso explícitos","fr":"Connecteurs avec contexte et autorisation explicites"},"lead":{"pt":"O papel de um conector fica mais claro quando a interface explica o que ele disponibiliza e quando ele será usado.","en":"A connector becomes clearer when the interface explains what it exposes and when it will be used.","es":"El papel de un conector queda más claro cuando la interfaz explica qué expone y cuándo se usará.","fr":"Le rôle d’un connecteur devient plus clair lorsque l’interface explique ce qu’il expose et quand il sera utilisé."},"date":"2026-08-27","read":2,"blocks":[{"title":{"pt":"Conectar não deveria ser mágico","en":"Connecting should not feel magical","es":"Conectar no debería parecer mágico","fr":"La connexion ne devrait pas sembler magique"},"body":[{"pt":"O usuário precisa saber qual serviço está sendo conectado, qual acesso foi solicitado e como desconectar depois.","en":"The user should know which service is being connected, what access was requested, and how to disconnect later.","es":"El usuario debe saber qué servicio se conecta, qué acceso se solicitó y cómo desconectarlo después.","fr":"L’utilisateur doit savoir quel service est connecté, quel accès a été demandé et comment se déconnecter ensuite."}]},{"title":{"pt":"Uma sequência previsível","en":"A predictable sequence","es":"Una secuencia predecible","fr":"Une séquence prévisible"},"bullets":[{"pt":"Escolher o conector.","en":"Choose the connector.","es":"Elegir el conector.","fr":"Choisir le connecteur."},{"pt":"Revisar a finalidade e permissões.","en":"Review purpose and permissions.","es":"Revisar finalidad y permisos.","fr":"Examiner l’objectif et les autorisations."},{"pt":"Concluir a autorização e confirmar o estado conectado.","en":"Complete authorization and confirm the connected state.","es":"Completar la autorización y confirmar el estado conectado.","fr":"Terminer l’autorisation et confirmer l’état connecté."},{"pt":"Desconectar quando a integração não for mais necessária.","en":"Disconnect when the integration is no longer needed.","es":"Desconectar cuando la integración ya no sea necesaria.","fr":"Déconnecter lorsque l’intégration n’est plus nécessaire."}]},{"title":{"pt":"Contexto ainda importa","en":"Context still matters","es":"El contexto sigue importando","fr":"Le contexte reste important"},"body":[{"pt":"Mesmo com um conector ativo, o pedido precisa indicar qual informação é relevante. Conexão não é sinônimo de contexto infinito.","en":"Even with an active connector, the request still needs to indicate which information matters. Connection is not infinite context.","es":"Incluso con un conector activo, la solicitud debe indicar qué información importa. Conexión no significa contexto infinito.","fr":"Même avec un connecteur actif, la demande doit indiquer quelles informations comptent. Connexion ne signifie pas contexte infini."}]},{"title":{"pt":"Conectar não significa liberar tudo","en":"Connecting does not mean exposing everything","es":"Conectar no significa exponer todo","fr":"Connecter ne signifie pas tout exposer"},"body":[{"pt":"Um conector bom reduz trabalho sem apagar fronteiras. A sessão deve acessar apenas o serviço, a conta e o escopo necessários para a tarefa, e a interface precisa deixar claro quando uma ação apenas lê dados ou quando pode modificá-los.","en":"A good connector reduces work without erasing boundaries. The session should access only the service, account, and scope required for the task, and the interface should make clear when an action only reads data or may modify it.","es":"Un buen conector reduce trabajo sin borrar límites. La sesión debe acceder solo al servicio, cuenta y alcance necesarios para la tarea, y la interfaz debe dejar claro cuándo una acción solo lee datos o puede modificarlos.","fr":"Un bon connecteur réduit le travail sans effacer les frontières. La session ne doit accéder qu’au service, au compte et au périmètre nécessaires à la tâche, et l’interface doit indiquer clairement si une action lit seulement des données ou peut les modifier."}]},{"title":{"pt":"A fronteira de permissão","en":"The permission boundary","es":"The permission boundary","fr":"The permission boundary"},"body":[{"pt":"Em “Conectores com contexto e permissão explícitos”, a ideia só vira valor quando aparece no fluxo real. O papel de um conector fica mais claro quando a interface explica o que ele disponibiliza e quando ele será usado. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Connectors with explicit context and permission”, the idea only becomes valuable when it appears in the real workflow. A connector becomes clearer when the interface explains what it exposes and when it will be used. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Connectors with explicit context and permission”, the idea only becomes valuable when it appears in the real workflow. A connector becomes clearer when the interface explains what it exposes and when it will be used. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Connectors with explicit context and permission”, the idea only becomes valuable when it appears in the real workflow. A connector becomes clearer when the interface explains what it exposes and when it will be used. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Por dentro de Contexto recuperado continua sendo dado","en":"Inside Connectors with explicit context and permission","es":"Por dentro de Conectores con contexto y permiso explícitos","fr":"Au cœur de Connecteurs avec contexte et autorisation explicites"},"body":[{"pt":"Conectores tornam o Giorgio mais útil quando trazem a menor quantidade de informação necessária para a tarefa e mantêm claro de onde ela veio. O conteúdo recuperado não deve ganhar autoridade de instrução só porque veio de uma conta conectada.","en":"The useful way to read “Connectors with explicit context and permission” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Conectores con contexto y permiso explícitos» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Connecteurs avec contexte et autorisation explicites » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"menor privilégio por operação","en":"menor privilégio por operação","es":"menor privilégio por operação","fr":"menor privilégio por operação"},{"pt":"leitura e escrita ficam separadas","en":"leitura e escrita ficam separadas","es":"leitura e escrita ficam separadas","fr":"leitura e escrita ficam separadas"},{"pt":"conteúdo recuperado permanece dado não confiável","en":"conteúdo recuperado permanece dado não confiável","es":"conteúdo recuperado permanece dado não confiável","fr":"conteúdo recuperado permanece dado não confiável"}]},{"title":{"pt":"Falha específica: Contexto recuperado continua sendo dado","en":"Specific failure mode: Connectors with explicit context and permission","es":"Fallo específico: Conectores con contexto y permiso explícitos","fr":"Mode de défaillance : Connecteurs avec contexte et autorisation explicites"},"body":[{"pt":"O risco é um documento ou mensagem conter instruções maliciosas que tentem redefinir a ação do agente.","en":"The failure mode to watch in “Connectors with explicit context and permission” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Conectores con contexto y permiso explícitos» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Connecteurs avec contexte et autorisation explicites » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Contexto recuperado continua sendo dado","en":"Evidence that closes Connectors with explicit context and permission","es":"Evidencia que cierra Conectores con contexto y permiso explícitos","fr":"Preuve qui valide Connecteurs avec contexte et autorisation explicites"},"body":[{"pt":"O pipeline deve separar dados recuperados de autoridade, aplicar escopo por usuário e exigir uma operação explícita antes de qualquer escrita externa.","en":"For “Connectors with explicit context and permission”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Conectores con contexto y permiso explícitos», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Connecteurs avec contexte et autorisation explicites », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"temporary-chat","category":"privacy","asset":"lockBraces","title":{"pt":"Chat temporário para trabalho que não precisa permanecer","en":"Temporary chat for work that does not need to persist","es":"Chat temporal para trabajo que no necesita persistir","fr":"Chat temporaire pour le travail qui n’a pas besoin de persister"},"lead":{"pt":"Quando uma conversa descartável é uma escolha melhor do que adicionar mais histórico à conta.","en":"When a disposable conversation is a better choice than adding more history to the account.","es":"Cuándo una conversación descartable es mejor que añadir más historial a la cuenta.","fr":"Quand une conversation jetable vaut mieux que d’ajouter davantage d’historique au compte."},"date":"2026-08-26","read":2,"blocks":[{"title":{"pt":"Nem toda conversa precisa virar histórico","en":"Not every conversation needs to become history","es":"No toda conversación debe convertirse en historial","fr":"Toutes les conversations n’ont pas besoin de devenir un historique"},"body":[{"pt":"Perguntas rápidas, testes e tarefas isoladas podem ser mais fáceis de administrar em um chat temporário. O objetivo é reduzir bagunça, não esconder comportamento.","en":"Quick questions, tests, and isolated tasks can be easier to manage in a temporary chat. The goal is to reduce clutter, not hide behavior.","es":"Las preguntas rápidas, pruebas y tareas aisladas pueden gestionarse mejor en un chat temporal. El objetivo es reducir el desorden, no ocultar comportamiento.","fr":"Les questions rapides, tests et tâches isolées peuvent être plus simples à gérer dans un chat temporaire. L’objectif est de réduire l’encombrement, pas de masquer le comportement."}]},{"title":{"pt":"Quando usar","en":"When to use it","es":"Cuándo usarlo","fr":"Quand l’utiliser"},"bullets":[{"pt":"Experimentos curtos.","en":"Short experiments.","es":"Experimentos cortos.","fr":"Expériences courtes."},{"pt":"Perguntas que não precisam aparecer na lista de conversas.","en":"Questions that do not need to stay in the conversation list.","es":"Preguntas que no necesitan quedarse en la lista de conversaciones.","fr":"Questions qui n’ont pas besoin de rester dans la liste des conversations."},{"pt":"Tarefas sem relação com projetos ou memórias existentes.","en":"Tasks unrelated to existing projects or memories.","es":"Tareas sin relación con proyectos o memorias existentes.","fr":"Tâches sans rapport avec des projets ou mémoires existants."}]},{"title":{"pt":"Quando não usar","en":"When not to use it","es":"Cuándo no usarlo","fr":"Quand ne pas l’utiliser"},"body":[{"pt":"Se você pretende voltar ao trabalho, comparar versões ou manter instruções de projeto, uma conversa normal oferece continuidade melhor.","en":"If you plan to return to the work, compare versions, or preserve project instructions, a normal conversation offers better continuity.","es":"Si piensas volver al trabajo, comparar versiones o conservar instrucciones del proyecto, una conversación normal ofrece mejor continuidad.","fr":"Si vous comptez revenir au travail, comparer des versions ou conserver des instructions de projet, une conversation normale offre une meilleure continuité."}]},{"title":{"pt":"Privacidade precisa ser previsível","en":"Privacy needs to be predictable","es":"La privacidad debe ser predecible","fr":"La confidentialité doit être prévisible"},"body":[{"pt":"O usuário precisa saber quando uma conversa entra no histórico, quando memória pode ser usada e quando um fluxo é deliberadamente temporário. A regra útil é simples: retenção e reutilização de contexto devem ser explícitas, compreensíveis e reversíveis sempre que possível.","en":"Users need to know when a conversation enters history, when memory may be used, and when a flow is deliberately temporary. A useful rule is simple: retention and reuse of context should be explicit, understandable, and reversible whenever possible.","es":"El usuario debe saber cuándo una conversación entra al historial, cuándo puede usarse memoria y cuándo un flujo es deliberadamente temporal. La regla útil es simple: retención y reutilización de contexto deben ser explícitas, comprensibles y reversibles cuando sea posible.","fr":"L’utilisateur doit savoir quand une conversation entre dans l’historique, quand la mémoire peut être utilisée et quand un flux est volontairement temporaire. La règle utile est simple : la conservation et la réutilisation du contexte doivent être explicites, compréhensibles et réversibles lorsque possible."}]},{"title":{"pt":"O ciclo de vida do dado","en":"The data lifecycle","es":"The data lifecycle","fr":"The data lifecycle"},"body":[{"pt":"Em “Chat temporário para trabalho que não precisa permanecer”, a ideia só vira valor quando aparece no fluxo real. Quando uma conversa descartável é uma escolha melhor do que adicionar mais histórico à conta. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Temporary chat for work that does not need to persist”, the idea only becomes valuable when it appears in the real workflow. When a disposable conversation is a better choice than adding more history to the account. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Temporary chat for work that does not need to persist”, the idea only becomes valuable when it appears in the real workflow. When a disposable conversation is a better choice than adding more history to the account. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Temporary chat for work that does not need to persist”, the idea only becomes valuable when it appears in the real workflow. When a disposable conversation is a better choice than adding more history to the account. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"A parte difícil de Descartável precisa parecer descartável em todo o fluxo","en":"The hard part of Temporary chat for work that does not need to persist","es":"La parte difícil de Chat temporal para trabajo que no necesita persistir","fr":"La partie difficile de Chat temporaire pour le travail qui n’a pas besoin de persister"},"body":[{"pt":"Se a conversa é temporária, sidebar, memória, projetos e sugestões futuras não devem agir como se ela fosse mais uma sessão permanente. A semântica precisa atravessar armazenamento e interface.","en":"The useful way to read “Temporary chat for work that does not need to persist” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Chat temporal para trabajo que no necesita persistir» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Chat temporaire pour le travail qui n’a pas besoin de persister » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"ciclo de vida é previsível para o usuário","en":"ciclo de vida é previsível para o usuário","es":"ciclo de vida é previsível para o usuário","fr":"ciclo de vida é previsível para o usuário"},{"pt":"memória e retenção não são confundidas","en":"memória e retenção não são confundidas","es":"memória e retenção não são confundidas","fr":"memória e retenção não são confundidas"},{"pt":"mudanças de persistência são explícitas","en":"mudanças de persistência são explícitas","es":"mudanças de persistência são explícitas","fr":"mudanças de persistência são explícitas"}]},{"title":{"pt":"Falha específica: Descartável precisa parecer descartável em todo o fluxo","en":"Specific failure mode: Temporary chat for work that does not need to persist","es":"Fallo específico: Chat temporal para trabajo que no necesita persistir","fr":"Mode de défaillance : Chat temporaire pour le travail qui n’a pas besoin de persister"},"body":[{"pt":"O erro comum é apenas ocultar a conversa depois, mantendo os mesmos efeitos colaterais de memória durante a sessão.","en":"The failure mode to watch in “Temporary chat for work that does not need to persist” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Chat temporal para trabajo que no necesita persistir» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Chat temporaire pour le travail qui n’a pas besoin de persister » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Descartável precisa parecer descartável em todo o fluxo","en":"Evidence that closes Temporary chat for work that does not need to persist","es":"Evidencia que cierra Chat temporal para trabajo que no necesita persistir","fr":"Preuve qui valide Chat temporaire pour le travail qui n’a pas besoin de persister"},"body":[{"pt":"Uma implementação coerente bloqueia promoção automática, diferencia artefatos escolhidos para salvar e informa a transição se o usuário decidir tornar algo persistente.","en":"For “Temporary chat for work that does not need to persist”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Chat temporal para trabajo que no necesita persistir», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Chat temporaire pour le travail qui n’a pas besoin de persister », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"projects-as-context","category":"projects","asset":"peopleGroup","title":{"pt":"Projetos como contexto persistente, não como pasta bonita","en":"Projects as persistent context, not a pretty folder","es":"Proyectos como contexto persistente, no como una carpeta bonita","fr":"Les projets comme contexte persistant, pas comme joli dossier"},"lead":{"pt":"O valor de um projeto aparece quando instruções, fontes e conversas trabalham juntas.","en":"The value of a project appears when instructions, sources, and conversations work together.","es":"El valor de un proyecto aparece cuando instrucciones, fuentes y conversaciones trabajan juntas.","fr":"La valeur d’un projet apparaît lorsque les instructions, les sources et les conversations travaillent ensemble."},"date":"2026-08-25","read":2,"blocks":[{"title":{"pt":"O projeto define um território","en":"A project defines a working territory","es":"Un proyecto define un territorio de trabajo","fr":"Un projet définit un territoire de travail"},"body":[{"pt":"Projetos reúnem materiais e instruções que pertencem ao mesmo objetivo. Isso ajuda o Giorgio a distinguir contexto durável de detalhes que só importavam numa mensagem.","en":"Projects collect materials and instructions that belong to the same goal. This helps Giorgio distinguish durable context from details that only mattered in one message.","es":"Los proyectos reúnen materiales e instrucciones del mismo objetivo. Esto ayuda a Giorgio a distinguir contexto duradero de detalles que solo importaban en un mensaje.","fr":"Les projets réunissent les éléments et instructions du même objectif. Cela aide Giorgio à distinguer le contexte durable des détails utiles pour un seul message."}]},{"title":{"pt":"Três camadas","en":"Three layers","es":"Tres capas","fr":"Trois couches"},"bullets":[{"pt":"Instruções: como o trabalho deve ser conduzido.","en":"Instructions: how the work should be carried out.","es":"Instrucciones: cómo debe realizarse el trabajo.","fr":"Instructions : comment le travail doit être mené."},{"pt":"Fontes: materiais que sustentam as respostas.","en":"Sources: materials that support the answers.","es":"Fuentes: materiales que sustentan las respuestas.","fr":"Sources : éléments qui soutiennent les réponses."},{"pt":"Conversas: decisões e iterações específicas.","en":"Conversations: specific decisions and iterations.","es":"Conversaciones: decisiones e iteraciones específicas.","fr":"Conversations : décisions et itérations spécifiques."}]},{"title":{"pt":"Menos repetição","en":"Less repetition","es":"Menos repetición","fr":"Moins de répétition"},"body":[{"pt":"Quando o contexto persistente está bem organizado, cada novo chat dentro do projeto pode começar mais perto do problema real.","en":"When persistent context is well organized, each new chat inside the project can start closer to the real problem.","es":"Cuando el contexto persistente está bien organizado, cada nuevo chat del proyecto puede empezar más cerca del problema real.","fr":"Lorsque le contexte persistant est bien organisé, chaque nouveau chat du projet peut commencer plus près du vrai problème."}]},{"title":{"pt":"Contexto persistente precisa ter função","en":"Persistent context needs a purpose","es":"El contexto persistente necesita una función","fr":"Le contexte persistant doit avoir une fonction"},"body":[{"pt":"Um projeto é útil quando reduz repetição: instruções, arquivos, decisões e conversas relevantes permanecem próximos da tarefa. Persistência sem organização só transfere o problema de “lembrar tudo” para “encontrar qualquer coisa”.","en":"A project is useful when it reduces repetition: instructions, files, decisions, and relevant conversations stay close to the task. Persistence without organization only moves the problem from “remember everything” to “find anything.”","es":"Un proyecto es útil cuando reduce repetición: instrucciones, archivos, decisiones y conversaciones relevantes permanecen cerca de la tarea. Persistencia sin organización solo cambia el problema de “recordar todo” a “encontrar algo”.","fr":"Un projet est utile lorsqu’il réduit la répétition : instructions, fichiers, décisions et conversations pertinentes restent proches de la tâche. La persistance sans organisation ne fait que déplacer le problème de « tout retenir » vers « retrouver quelque chose »."}]},{"title":{"pt":"Persistência sem ruído","en":"Persistence without noise","es":"Persistence without noise","fr":"Persistence without noise"},"body":[{"pt":"Em “Projetos como contexto persistente, não como pasta bonita”, a ideia só vira valor quando aparece no fluxo real. O valor de um projeto aparece quando instruções, fontes e conversas trabalham juntas. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Projects as persistent context, not a pretty folder”, the idea only becomes valuable when it appears in the real workflow. The value of a project appears when instructions, sources, and conversations work together. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Projects as persistent context, not a pretty folder”, the idea only becomes valuable when it appears in the real workflow. The value of a project appears when instructions, sources, and conversations work together. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Projects as persistent context, not a pretty folder”, the idea only becomes valuable when it appears in the real workflow. The value of a project appears when instructions, sources, and conversations work together. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"O contrato escondido em Projeto é fronteira de contexto, não pasta","en":"The hidden contract in Projects as persistent context, not a pretty folder","es":"El contrato oculto de Proyectos como contexto persistente, no como una carpeta bonita","fr":"Le contrat caché de Les projets comme contexte persistant, pas comme joli dossier"},"body":[{"pt":"Um projeto útil combina instruções, fontes, arquivos, conversas e decisões com uma identidade própria. Isso permite recuperar o contexto certo sem espalhar detalhes específicos para todas as conversas do usuário.","en":"The useful way to read “Projects as persistent context, not a pretty folder” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Proyectos como contexto persistente, no como una carpeta bonita» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Les projets comme contexte persistant, pas comme joli dossier » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contexto específico não vaza entre projetos","en":"contexto específico não vaza entre projetos","es":"contexto específico não vaza entre projetos","fr":"contexto específico não vaza entre projetos"},{"pt":"fontes e instruções mantêm origem","en":"fontes e instruções mantêm origem","es":"fontes e instruções mantêm origem","fr":"fontes e instruções mantêm origem"},{"pt":"retomada não exige reconstruir o histórico inteiro","en":"retomada não exige reconstruir o histórico inteiro","es":"retomada não exige reconstruir o histórico inteiro","fr":"retomada não exige reconstruir o histórico inteiro"}]},{"title":{"pt":"Falha específica: Projeto é fronteira de contexto, não pasta","en":"Specific failure mode: Projects as persistent context, not a pretty folder","es":"Fallo específico: Proyectos como contexto persistente, no como una carpeta bonita","fr":"Mode de défaillance : Les projets comme contexte persistant, pas comme joli dossier"},"body":[{"pt":"O risco é tratar tudo como memória global e contaminar respostas em projetos diferentes.","en":"The failure mode to watch in “Projects as persistent context, not a pretty folder” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Proyectos como contexto persistente, no como una carpeta bonita» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Les projets comme contexte persistant, pas comme joli dossier » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Projeto é fronteira de contexto, não pasta","en":"Evidence that closes Projects as persistent context, not a pretty folder","es":"Evidencia que cierra Proyectos como contexto persistente, no como una carpeta bonita","fr":"Preuve qui valide Les projets comme contexte persistant, pas comme joli dossier"},"body":[{"pt":"A recuperação deve preferir contexto do projeto ativo, usar preferências globais apenas quando realmente globais e registrar a origem de cada memória promovida.","en":"For “Projects as persistent context, not a pretty folder”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Proyectos como contexto persistente, no como una carpeta bonita», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Les projets comme contexte persistant, pas comme joli dossier », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"reflect-readable-activity","category":"reflect","asset":"barChart","title":{"pt":"Refletir: transformar atividade em leitura útil","en":"Reflect: turning activity into a useful read","es":"Reflexionar: convertir actividad en una lectura útil","fr":"Réfléchir : transformer l’activité en lecture utile"},"lead":{"pt":"Gráficos só ajudam quando respondem perguntas sobre ritmo, horários e foco — não quando existem para preencher espaço.","en":"Charts only help when they answer questions about rhythm, timing, and focus — not when they exist to fill space.","es":"Los gráficos solo ayudan cuando responden preguntas sobre ritmo, horarios y enfoque, no cuando existen para llenar espacio.","fr":"Les graphiques n’aident que lorsqu’ils répondent à des questions de rythme, d’horaires et de concentration, pas lorsqu’ils remplissent l’espace."},"date":"2026-08-24","read":2,"blocks":[{"title":{"pt":"Dados com uma pergunta por trás","en":"Data with a question behind it","es":"Datos con una pregunta detrás","fr":"Des données avec une question derrière"},"body":[{"pt":"O painel Refletir fica mais útil quando cada visual responde algo concreto: em quais dias houve mais atividade, quais horários concentram uso e quais assuntos dominaram o período.","en":"Reflect becomes more useful when each visual answers something concrete: which days were busiest, which hours concentrated use, and which topics dominated the period.","es":"Reflexionar es más útil cuando cada visual responde algo concreto: qué días tuvieron más actividad, qué horarios concentraron el uso y qué temas dominaron el período.","fr":"Réfléchir devient plus utile lorsque chaque visuel répond à quelque chose de concret : quels jours ont été les plus actifs, quelles heures concentrent l’usage et quels thèmes ont dominé la période."}]},{"title":{"pt":"Menos pontos, mais tendência","en":"Fewer dots, more trend","es":"Menos puntos, más tendencia","fr":"Moins de points, plus de tendance"},"bullets":[{"pt":"Linhas mostram evolução diária sem poluir cada valor.","en":"Lines show daily evolution without cluttering every value.","es":"Las líneas muestran la evolución diaria sin ensuciar cada valor.","fr":"Les lignes montrent l’évolution quotidienne sans encombrer chaque valeur."},{"pt":"Barras ajudam a comparar dias da semana.","en":"Bars help compare weekdays.","es":"Las barras ayudan a comparar días de la semana.","fr":"Les barres aident à comparer les jours de la semaine."},{"pt":"Heatmaps funcionam melhor para horários recorrentes.","en":"Heatmaps work better for recurring hours.","es":"Los mapas de calor funcionan mejor para horarios recurrentes.","fr":"Les cartes de chaleur fonctionnent mieux pour les horaires récurrents."}]},{"title":{"pt":"O painel precisa carregar","en":"The panel still has to load","es":"El panel todavía tiene que cargar","fr":"Le panneau doit quand même charger"},"body":[{"pt":"Um visual impecável sem acesso aos dados reais é só decoração. Por isso a renderização precisa acontecer dentro do mesmo runtime que conhece usuário, histórico e estado do aplicativo.","en":"A flawless visual without access to real data is only decoration. Rendering therefore needs to happen in the same runtime that knows the user, history, and application state.","es":"Un visual impecable sin acceso a datos reales es solo decoración. Por eso la renderización debe ocurrir en el mismo runtime que conoce al usuario, el historial y el estado de la aplicación.","fr":"Un visuel impeccable sans accès aux vraies données n’est que décoration. Le rendu doit donc se faire dans le même runtime qui connaît l’utilisateur, l’historique et l’état de l’application."}]},{"title":{"pt":"Métrica sem interpretação é só contagem","en":"A metric without interpretation is just a count","es":"Una métrica sin interpretación es solo un conteo","fr":"Une métrique sans interprétation n’est qu’un comptage"},"body":[{"pt":"Refletir funciona melhor quando transforma atividade bruta em perguntas úteis: onde o tempo foi gasto, quais tipos de tarefa se repetem, quando o fluxo desacelera e o que mudou ao longo do período. O gráfico é meio; a decisão continua sendo o fim.","en":"Reflect works best when it turns raw activity into useful questions: where time was spent, which task types repeat, when the flow slows down, and what changed over the period. The chart is a means; the decision remains the end.","es":"Refletir funciona mejor cuando transforma actividad bruta en preguntas útiles: dónde se gastó el tiempo, qué tipos de tarea se repiten, cuándo se ralentiza el flujo y qué cambió durante el período. El gráfico es un medio; la decisión sigue siendo el fin.","fr":"Reflect fonctionne mieux lorsqu’il transforme l’activité brute en questions utiles : où le temps a été dépensé, quels types de tâches se répètent, quand le flux ralentit et ce qui a changé sur la période. Le graphique est un moyen ; la décision reste la finalité."}]},{"title":{"pt":"Onde Atividade só é útil quando responde uma pergunta realmente ganha qualidade","en":"Where Reflect: turning activity into a useful read actually gains quality","es":"Dónde Reflexionar: convertir actividad en una lectura útil realmente gana calidad","fr":"Là où Réfléchir : transformer l’activité en lecture utile gagne vraiment en qualité"},"body":[{"pt":"Gráficos de uso devem explicar ritmo, foco e mudança, não preencher espaço. Refletir funciona melhor quando transforma eventos em padrões legíveis e permite ao usuário ligar um insight ao período e às tarefas que o produziram.","en":"The useful way to read “Reflect: turning activity into a useful read” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Reflexionar: convertir actividad en una lectura útil» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Réfléchir : transformer l’activité en lecture utile » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"métrica responde pergunta concreta","en":"métrica responde pergunta concreta","es":"métrica responde pergunta concreta","fr":"métrica responde pergunta concreta"},{"pt":"inferência é separada do dado observado","en":"inferência é separada do dado observado","es":"inferência é separada do dado observado","fr":"inferência é separada do dado observado"},{"pt":"tempo e escopo da leitura ficam visíveis","en":"tempo e escopo da leitura ficam visíveis","es":"tempo e escopo da leitura ficam visíveis","fr":"tempo e escopo da leitura ficam visíveis"}]},{"title":{"pt":"Falha específica: Atividade só é útil quando responde uma pergunta","en":"Specific failure mode: Reflect: turning activity into a useful read","es":"Fallo específico: Reflexionar: convertir actividad en una lectura útil","fr":"Mode de défaillance : Réfléchir : transformer l’activité en lecture utile"},"body":[{"pt":"O risco é inferir produtividade, humor ou intenção a partir de contagens superficiais.","en":"The failure mode to watch in “Reflect: turning activity into a useful read” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Reflexionar: convertir actividad en una lectura útil» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Réfléchir : transformer l’activité en lecture utile » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Atividade só é útil quando responde uma pergunta","en":"Evidence that closes Reflect: turning activity into a useful read","es":"Evidencia que cierra Reflexionar: convertir actividad en una lectura útil","fr":"Preuve qui valide Réfléchir : transformer l’activité en lecture utile"},"body":[{"pt":"O produto precisa separar fato observado de interpretação, oferecer contexto temporal e evitar métricas que pareçam precisas sem base suficiente.","en":"For “Reflect: turning activity into a useful read”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Reflexionar: convertir actividad en una lectura útil», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Réfléchir : transformer l’activité en lecture utile », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"mobile-login-with-keyboard","category":"site","asset":"site","title":{"pt":"Login mobile que sobrevive ao teclado","en":"A mobile login that survives the keyboard","es":"Un login móvil que sobrevive al teclado","fr":"Un login mobile qui survit au clavier"},"lead":{"pt":"Viewport dinâmica, safe areas e inputs legíveis fazem mais diferença do que simplesmente diminuir o desktop.","en":"Dynamic viewport, safe areas, and readable inputs matter more than simply shrinking desktop.","es":"Viewport dinámico, áreas seguras e inputs legibles importan más que simplemente reducir el escritorio.","fr":"Viewport dynamique, zones sûres et champs lisibles comptent plus que simplement réduire le desktop."},"date":"2026-08-23","read":2,"blocks":[{"title":{"pt":"Mobile é outra condição de uso","en":"Mobile is another usage condition","es":"Móvil es otra condición de uso","fr":"Le mobile est une autre condition d’usage"},"body":[{"pt":"No celular, metade da interface pode desaparecer quando o teclado abre. Um login responsivo de verdade acompanha a altura visual disponível em vez de confiar apenas em 100vh.","en":"On mobile, half the interface can disappear when the keyboard opens. A truly responsive login follows the available visual height instead of relying only on 100vh.","es":"En móvil, la mitad de la interfaz puede desaparecer cuando se abre el teclado. Un login realmente responsivo sigue la altura visual disponible en lugar de confiar solo en 100vh.","fr":"Sur mobile, la moitié de l’interface peut disparaître quand le clavier s’ouvre. Un vrai login réactif suit la hauteur visuelle disponible au lieu de dépendre uniquement de 100vh."}]},{"title":{"pt":"O que precisa caber","en":"What needs to fit","es":"Lo que debe caber","fr":"Ce qui doit tenir"},"bullets":[{"pt":"Identidade da marca sem ocupar a tela inteira.","en":"Brand identity without taking over the whole screen.","es":"Identidad de marca sin ocupar toda la pantalla.","fr":"Identité de marque sans occuper tout l’écran."},{"pt":"Campos com pelo menos 16px para evitar zoom inesperado.","en":"Fields at at least 16px to avoid unexpected zoom.","es":"Campos de al menos 16px para evitar zoom inesperado.","fr":"Champs d’au moins 16px pour éviter un zoom inattendu."},{"pt":"Botão principal acessível mesmo com o teclado aberto.","en":"Primary action reachable even with the keyboard open.","es":"Acción principal accesible incluso con el teclado abierto.","fr":"Action principale accessible même avec le clavier ouvert."}]},{"title":{"pt":"VisualViewport","en":"VisualViewport","es":"VisualViewport","fr":"VisualViewport"},"body":[{"pt":"Quando disponível, a API visualViewport permite reagir à área realmente visível e reposicionar conteúdo sem depender de adivinhações por breakpoint.","en":"When available, the visualViewport API lets the interface react to the truly visible area and reposition content without relying on breakpoint guesses.","es":"Cuando está disponible, la API visualViewport permite reaccionar al área realmente visible y reposicionar contenido sin depender de suposiciones por breakpoint.","fr":"Lorsqu’elle est disponible, l’API visualViewport permet de réagir à la zone réellement visible et de repositionner le contenu sans deviner via des breakpoints."}]},{"title":{"pt":"Uma superfície pública precisa funcionar sem contexto oculto","en":"A public surface must work without hidden context","es":"Una superficie pública debe funcionar sin contexto oculto","fr":"Une surface publique doit fonctionner sans contexte caché"},"body":[{"pt":"Blog e documentação devem abrir por URL direta, permanecer legíveis sem sessão e expor estrutura suficiente para navegadores, buscadores e agentes. A experiência autenticada pode continuar privada; o conteúdo público não deveria depender dela para existir.","en":"Blog and documentation should open from direct URLs, remain readable without a session, and expose enough structure for browsers, search engines, and agents. The authenticated experience can remain private; public content should not depend on it to exist.","es":"Blog y documentación deben abrir por URL directa, seguir legibles sin sesión y exponer suficiente estructura para navegadores, buscadores y agentes. La experiencia autenticada puede seguir privada; el contenido público no debería depender de ella para existir.","fr":"Le blog et la documentation doivent s’ouvrir par URL directe, rester lisibles sans session et exposer suffisamment de structure aux navigateurs, moteurs et agents. L’expérience authentifiée peut rester privée ; le contenu public ne devrait pas dépendre d’elle pour exister."}]},{"title":{"pt":"O mecanismo central de O teclado é parte da geometria da tela","en":"The core mechanism of A mobile login that survives the keyboard","es":"El mecanismo central de Un login móvil que sobrevive al teclado","fr":"Le mécanisme central de Un login mobile qui survit au clavier"},"body":[{"pt":"Login mobile quebra quando a UI assume 100vh estável e o teclado reduz o viewport visual. O formulário precisa continuar acessível, com foco visível e botões fora de áreas cortadas.","en":"The useful way to read “A mobile login that survives the keyboard” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Un login móvil que sobrevive al teclado» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Un login mobile qui survit au clavier » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"rota funciona em file:// e hospedagem","en":"rota funciona em file:// e hospedagem","es":"rota funciona em file:// e hospedagem","fr":"rota funciona em file:// e hospedagem"},{"pt":"primeiro render não depende de auth quando é público","en":"primeiro render não depende de auth quando é público","es":"primeiro render não depende de auth quando é público","fr":"primeiro render não depende de auth quando é público"},{"pt":"mobile e desktop preservam a mesma intenção","en":"mobile e desktop preservam a mesma intenção","es":"mobile e desktop preservam a mesma intenção","fr":"mobile e desktop preservam a mesma intenção"}]},{"title":{"pt":"Falha específica: O teclado é parte da geometria da tela","en":"Specific failure mode: A mobile login that survives the keyboard","es":"Fallo específico: Un login móvil que sobrevive al teclado","fr":"Mode de défaillance : Un login mobile qui survit au clavier"},"body":[{"pt":"O risco é corrigir apenas um aparelho usando altura fixa ou translate manual, criando outro bug em orientação diferente.","en":"The failure mode to watch in “A mobile login that survives the keyboard” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Un login móvil que sobrevive al teclado» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Un login mobile qui survit au clavier » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha O teclado é parte da geometria da tela","en":"Evidence that closes A mobile login that survives the keyboard","es":"Evidencia que cierra Un login móvil que sobrevive al teclado","fr":"Preuve qui valide Un login mobile qui survit au clavier"},"body":[{"pt":"A validação deve usar 100dvh/visualViewport quando apropriado, safe areas, scroll interno previsível e testes com teclado aberto, rotação e zoom de acessibilidade.","en":"For “A mobile login that survives the keyboard”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Un login móvil que sobrevive al teclado», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Un login mobile qui survit au clavier », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"design-from-brief-to-preview","category":"design","asset":"docs","title":{"pt":"Do brief ao preview no Giorgio Design","en":"From brief to preview in Giorgio Design","es":"Del brief al preview en Giorgio Design","fr":"Du brief à l’aperçu dans Giorgio Design"},"lead":{"pt":"Como separar intenção, configuração visual e resultado renderizado sem transformar a ferramenta em um formulário infinito.","en":"How to separate intent, visual configuration, and rendered result without turning the tool into an endless form.","es":"Cómo separar intención, configuración visual y resultado renderizado sin convertir la herramienta en un formulario infinito.","fr":"Comment séparer intention, configuration visuelle et résultat rendu sans transformer l’outil en formulaire sans fin."},"date":"2026-08-22","read":2,"blocks":[{"title":{"pt":"Comece pelo que precisa existir","en":"Start with what must exist","es":"Empieza por lo que debe existir","fr":"Commencez par ce qui doit exister"},"body":[{"pt":"O brief concentra objetivo, público e restrições. A partir dele, tema, densidade e tamanho de dispositivo viram ajustes do mesmo resultado, não pedidos desconectados.","en":"The brief concentrates goal, audience, and constraints. From there, theme, density, and device size become adjustments to the same result rather than disconnected requests.","es":"El brief concentra objetivo, público y restricciones. A partir de ahí, tema, densidad y tamaño del dispositivo se convierten en ajustes del mismo resultado, no solicitudes separadas.","fr":"Le brief concentre objectif, public et contraintes. Ensuite, thème, densité et taille d’appareil deviennent des réglages du même résultat, pas des demandes séparées."}]},{"title":{"pt":"Três controles que mudam a leitura","en":"Three controls that change the read","es":"Tres controles que cambian la lectura","fr":"Trois réglages qui changent la lecture"},"bullets":[{"pt":"Dispositivo: desktop, tablet ou mobile.","en":"Device: desktop, tablet, or mobile.","es":"Dispositivo: escritorio, tableta o móvil.","fr":"Appareil : desktop, tablette ou mobile."},{"pt":"Tema: relação entre fundo, superfícies e contraste.","en":"Theme: relationship between background, surfaces, and contrast.","es":"Tema: relación entre fondo, superficies y contraste.","fr":"Thème : relation entre fond, surfaces et contraste."},{"pt":"Densidade: quanto conteúdo cabe antes de a interface cansar.","en":"Density: how much content fits before the interface becomes tiring.","es":"Densidad: cuánto contenido cabe antes de que la interfaz canse.","fr":"Densité : quantité de contenu avant que l’interface ne fatigue."}]},{"title":{"pt":"Exportar depois de olhar","en":"Export after looking","es":"Exportar después de mirar","fr":"Exporter après avoir regardé"},"body":[{"pt":"O preview é onde inconsistências aparecem. Exportar HTML antes de olhar o resultado só acelera a entrega do erro.","en":"Preview is where inconsistencies surface. Exporting HTML before looking at the result only speeds up delivery of the mistake.","es":"El preview es donde aparecen las inconsistencias. Exportar HTML antes de mirar el resultado solo acelera la entrega del error.","fr":"L’aperçu est l’endroit où les incohérences apparaissent. Exporter le HTML avant de regarder le résultat ne fait qu’accélérer la livraison de l’erreur."}]},{"title":{"pt":"Design termina na verificação, não no mockup","en":"Design ends at verification, not the mockup","es":"El diseño termina en la verificación, no en el mockup","fr":"Le design se termine à la vérification, pas au mockup"},"body":[{"pt":"Uma direção visual só vira produto quando sobrevive a conteúdo real, estados vazios, teclado, telas estreitas, contraste e interação. O fluxo de Design deve aproximar briefing, implementação e QA para que a estética não esconda regressões funcionais.","en":"A visual direction becomes product only when it survives real content, empty states, keyboards, narrow screens, contrast, and interaction. The Design flow should bring briefing, implementation, and QA together so aesthetics do not hide functional regressions.","es":"Una dirección visual se convierte en producto solo cuando sobrevive a contenido real, estados vacíos, teclado, pantallas estrechas, contraste e interacción. El flujo de Design debe acercar briefing, implementación y QA para que la estética no oculte regresiones funcionales.","fr":"Une direction visuelle ne devient un produit que lorsqu’elle résiste au contenu réel, aux états vides, au clavier, aux écrans étroits, au contraste et à l’interaction. Le flux Design doit rapprocher briefing, implémentation et QA afin que l’esthétique ne masque pas les régressions fonctionnelles."}]},{"title":{"pt":"Da intenção ao preview","en":"From intent to preview","es":"From intent to preview","fr":"From intent to preview"},"body":[{"pt":"Em “Do brief ao preview no Giorgio Design”, a ideia só vira valor quando aparece no fluxo real. Como separar intenção, configuração visual e resultado renderizado sem transformar a ferramenta em um formulário infinito. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “From brief to preview in Giorgio Design”, the idea only becomes valuable when it appears in the real workflow. How to separate intent, visual configuration, and rendered result without turning the tool into an endless form. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “From brief to preview in Giorgio Design”, the idea only becomes valuable when it appears in the real workflow. How to separate intent, visual configuration, and rendered result without turning the tool into an endless form. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “From brief to preview in Giorgio Design”, the idea only becomes valuable when it appears in the real workflow. How to separate intent, visual configuration, and rendered result without turning the tool into an endless form. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"A engenharia por trás de Direção visual antes do CSS","en":"The engineering behind From brief to preview in Giorgio Design","es":"La ingeniería detrás de Del brief al preview en Giorgio Design","fr":"L’ingénierie derrière Du brief à l’aperçu dans Giorgio Design"},"body":[{"pt":"Antes de codar, Giorgio Design precisa escolher uma direção: sistema tipográfico, escala, composição, assinatura visual, materiais e regra de movimento. Isso evita que cada componente invente sua própria estética.","en":"The useful way to read “From brief to preview in Giorgio Design” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Del brief al preview en Giorgio Design» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Du brief à l’aperçu dans Giorgio Design » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"referência vira requisito de composição e comportamento","en":"referência vira requisito de composição e comportamento","es":"referência vira requisito de composição e comportamento","fr":"referência vira requisito de composição e comportamento"},{"pt":"visual é revisado depois de implementado","en":"visual é revisado depois de implementado","es":"visual é revisado depois de implementado","fr":"visual é revisado depois de implementado"},{"pt":"estética nunca substitui estado funcional","en":"estética nunca substitui estado funcional","es":"estética nunca substitui estado funcional","fr":"estética nunca substitui estado funcional"}]},{"title":{"pt":"Falha específica: Direção visual antes do CSS","en":"Specific failure mode: From brief to preview in Giorgio Design","es":"Fallo específico: Del brief al preview en Giorgio Design","fr":"Mode de défaillance : Du brief à l’aperçu dans Giorgio Design"},"body":[{"pt":"O risco é iniciar pelo card, botão e gradiente padrão e descobrir tarde demais que a página não tem uma ideia central.","en":"The failure mode to watch in “From brief to preview in Giorgio Design” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Del brief al preview en Giorgio Design» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Du brief à l’aperçu dans Giorgio Design » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Direção visual antes do CSS","en":"Evidence that closes From brief to preview in Giorgio Design","es":"Evidencia que cierra Del brief al preview en Giorgio Design","fr":"Preuve qui valide Du brief à l’aperçu dans Giorgio Design"},"body":[{"pt":"O preview deve ser avaliado contra o brief e não contra o gosto do gerador, com correções que preservam funcionalidade e identidade.","en":"For “From brief to preview in Giorgio Design”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Del brief al preview en Giorgio Design», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Du brief à l’aperçu dans Giorgio Design », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"cowork-sources-to-output","category":"cowork","asset":"peopleGroup","title":{"pt":"Cowork: fontes, tarefa e saída no mesmo fluxo","en":"Cowork: sources, task, and output in the same flow","es":"Cowork: fuentes, tarea y salida en el mismo flujo","fr":"Cowork : sources, tâche et sortie dans le même flux"},"lead":{"pt":"Um workspace colaborativo fica mais claro quando separa o que entra, o que precisa ser feito e o que foi produzido.","en":"A collaborative workspace becomes clearer when it separates what comes in, what needs to be done, and what was produced.","es":"Un workspace colaborativo queda más claro cuando separa lo que entra, lo que debe hacerse y lo que se produjo.","fr":"Un espace collaboratif devient plus clair lorsqu’il sépare ce qui entre, ce qui doit être fait et ce qui a été produit."},"date":"2026-08-21","read":2,"blocks":[{"title":{"pt":"Entrada explícita","en":"Explicit input","es":"Entrada explícita","fr":"Entrée explicite"},"body":[{"pt":"Fontes e contexto ficam visíveis antes da execução. Isso ajuda a conferir se a tarefa está realmente apoiada no material correto.","en":"Sources and context stay visible before execution. That helps verify whether the task is actually grounded in the right material.","es":"Las fuentes y el contexto permanecen visibles antes de la ejecución. Eso ayuda a comprobar si la tarea realmente se apoya en el material correcto.","fr":"Les sources et le contexte restent visibles avant l’exécution. Cela aide à vérifier que la tâche s’appuie réellement sur le bon matériel."}]},{"title":{"pt":"Uma tarefa, várias saídas","en":"One task, several outputs","es":"Una tarea, varias salidas","fr":"Une tâche, plusieurs sorties"},"bullets":[{"pt":"Texto ou resumo.","en":"Text or summary.","es":"Texto o resumen.","fr":"Texte ou résumé."},{"pt":"Arquivo ou artefato.","en":"File or artifact.","es":"Archivo o artefacto.","fr":"Fichier ou artefact."},{"pt":"Próximas ações e itens de revisão.","en":"Next actions and review items.","es":"Próximas acciones y elementos de revisión.","fr":"Actions suivantes et éléments à réviser."}]},{"title":{"pt":"A fronteira útil","en":"The useful boundary","es":"El límite útil","fr":"La frontière utile"},"body":[{"pt":"Cowork não precisa esconder o processo nem despejar toda a implementação. Ele precisa mostrar fontes, tarefa, estado e resultado de forma que outra pessoa consiga continuar.","en":"Cowork does not need to hide the process or dump the whole implementation. It needs to show sources, task, state, and result so another person can continue.","es":"Cowork no necesita ocultar el proceso ni volcar toda la implementación. Debe mostrar fuentes, tarea, estado y resultado para que otra persona pueda continuar.","fr":"Cowork n’a pas besoin de cacher le processus ni de déverser toute l’implémentation. Il doit montrer sources, tâche, état et résultat afin qu’une autre personne puisse continuer."}]},{"title":{"pt":"O trabalho precisa permanecer rastreável","en":"Work needs to remain traceable","es":"El trabajo debe seguir siendo rastreable","fr":"Le travail doit rester traçable"},"body":[{"pt":"Cowork ganha valor quando fonte, pedido, transformação e entrega permanecem conectados. Isso reduz o custo de conferir de onde veio uma afirmação e facilita continuar o trabalho depois sem reconstruir o raciocínio a partir do zero.","en":"Cowork becomes more valuable when source, request, transformation, and delivery stay connected. That lowers the cost of checking where a claim came from and makes it easier to continue later without rebuilding the reasoning from scratch.","es":"Cowork gana valor cuando fuente, pedido, transformación y entrega permanecen conectados. Eso reduce el costo de comprobar de dónde salió una afirmación y facilita continuar después sin reconstruir el razonamiento desde cero.","fr":"Cowork gagne en valeur lorsque la source, la demande, la transformation et la livraison restent reliées. Cela réduit le coût de vérification de l’origine d’une affirmation et facilite la reprise du travail sans reconstruire le raisonnement depuis zéro."}]},{"title":{"pt":"O ponto que decide Cowork precisa transformar delegação em trabalho observável","en":"The decision point in Cowork: sources, task, and output in the same flow","es":"El punto decisivo de Cowork: fuentes, tarea y salida en el mismo flujo","fr":"Le point décisif de Cowork : sources, tâche et sortie dans le même flux"},"body":[{"pt":"Uma tarefa delegada ganha confiança quando o usuário enxerga fontes, plano, progresso, decisões que exigem intervenção e o artefato final. O agente não deve desaparecer por minutos e voltar com uma caixa-preta.","en":"The useful way to read “Cowork: sources, task, and output in the same flow” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Cowork: fuentes, tarea y salida en el mismo flujo» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Cowork : sources, tâche et sortie dans le même flux » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"trabalho delegado continua observável","en":"trabalho delegado continua observável","es":"trabalho delegado continua observável","fr":"trabalho delegado continua observável"},{"pt":"paralelismo respeita dependências","en":"paralelismo respeita dependências","es":"paralelismo respeita dependências","fr":"paralelismo respeita dependências"},{"pt":"handoff registra estado e decisão pendente","en":"handoff registra estado e decisão pendente","es":"handoff registra estado e decisão pendente","fr":"handoff registra estado e decisão pendente"}]},{"title":{"pt":"Falha específica: Cowork precisa transformar delegação em trabalho observável","en":"Specific failure mode: Cowork: sources, task, and output in the same flow","es":"Fallo específico: Cowork: fuentes, tarea y salida en el mismo flujo","fr":"Mode de défaillance : Cowork : sources, tâche et sortie dans le même flux"},"body":[{"pt":"O risco é paralelizar etapas que dependem umas das outras ou permitir que subagentes escrevam no mesmo estado sem coordenação.","en":"The failure mode to watch in “Cowork: sources, task, and output in the same flow” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Cowork: fuentes, tarea y salida en el mismo flujo» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Cowork : sources, tâche et sortie dans le même flux » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Cowork precisa transformar delegação em trabalho observável","en":"Evidence that closes Cowork: sources, task, and output in the same flow","es":"Evidencia que cierra Cowork: fuentes, tarea y salida en el mismo flujo","fr":"Preuve qui valide Cowork : sources, tâche et sortie dans le même flux"},"body":[{"pt":"Um bom orquestrador separa unidades independentes, faz handoffs estruturados e mantém um líder responsável por integrar e verificar o resultado.","en":"For “Cowork: sources, task, and output in the same flow”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Cowork: fuentes, tarea y salida en el mismo flujo», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Cowork : sources, tâche et sortie dans le même flux », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"web-search-for-freshness","category":"search","asset":"cloudHand","title":{"pt":"Busca na web quando a resposta depende do agora","en":"Web search when the answer depends on now","es":"Búsqueda web cuando la respuesta depende del presente","fr":"Recherche web lorsque la réponse dépend du présent"},"lead":{"pt":"Informação atual exige uma fonte atual; o desafio é pesquisar quando necessário sem transformar todo pedido em navegação.","en":"Current information needs a current source; the challenge is searching when needed without turning every request into browsing.","es":"La información actual necesita una fuente actual; el reto es buscar cuando sea necesario sin convertir cada solicitud en navegación.","fr":"Une information actuelle exige une source actuelle ; le défi est de rechercher lorsque nécessaire sans transformer chaque demande en navigation."},"date":"2026-08-20","read":2,"blocks":[{"title":{"pt":"Frescura é parte da pergunta","en":"Freshness is part of the question","es":"La actualidad forma parte de la pregunta","fr":"La fraîcheur fait partie de la question"},"body":[{"pt":"Tabela, preço, notícia, versão de produto e disponibilidade podem mudar. Nesses casos, responder só com memória do modelo é assumir que o mundo parou.","en":"Standings, prices, news, product versions, and availability can change. In those cases, answering from model memory alone assumes the world stopped.","es":"Tablas, precios, noticias, versiones de producto y disponibilidad pueden cambiar. En esos casos, responder solo desde la memoria del modelo supone que el mundo se detuvo.","fr":"Classements, prix, actualités, versions de produit et disponibilité peuvent changer. Dans ces cas, répondre uniquement depuis la mémoire du modèle revient à supposer que le monde s’est arrêté."}]},{"title":{"pt":"Sinais de que vale pesquisar","en":"Signals that search is worth it","es":"Señales de que conviene buscar","fr":"Signes qu’une recherche vaut la peine"},"bullets":[{"pt":"O usuário pede “agora”, “hoje”, “último” ou “atual”.","en":"The user asks for “now,” “today,” “latest,” or “current.”","es":"El usuario pide “ahora”, “hoy”, “último” o “actual”.","fr":"L’utilisateur demande « maintenant », « aujourd’hui », « dernier » ou « actuel »."},{"pt":"O dado muda com frequência.","en":"The data changes frequently.","es":"El dato cambia con frecuencia.","fr":"La donnée change fréquemment."},{"pt":"Uma fonte pública verificável melhora a resposta.","en":"A verifiable public source improves the answer.","es":"Una fuente pública verificable mejora la respuesta.","fr":"Une source publique vérifiable améliore la réponse."}]},{"title":{"pt":"Pesquisar também tem limite","en":"Search also has a boundary","es":"Buscar también tiene un límite","fr":"La recherche a aussi une limite"},"body":[{"pt":"Pedidos criativos, resumos de arquivos já fornecidos e conhecimento estável não precisam sofrer uma excursão pela internet só porque o botão existe.","en":"Creative requests, summaries of already provided files, and stable knowledge do not need an internet excursion simply because the button exists.","es":"Las solicitudes creativas, resúmenes de archivos ya proporcionados y conocimiento estable no necesitan una excursión por internet solo porque existe el botón.","fr":"Les demandes créatives, résumés de fichiers déjà fournis et connaissances stables n’ont pas besoin d’une excursion sur internet simplement parce que le bouton existe."}]},{"title":{"pt":"Frescor é parte da resposta","en":"Freshness is part of the answer","es":"La actualidad es parte de la respuesta","fr":"La fraîcheur fait partie de la réponse"},"body":[{"pt":"A web agrega valor quando o fato pode ter mudado: preços, disponibilidade, documentação viva, notícias, resultados, versões e políticas. Para conhecimento estável, buscar por reflexo adiciona latência e fontes desnecessárias. A decisão correta depende da volatilidade da informação.","en":"The web adds value when a fact may have changed: prices, availability, living documentation, news, results, versions, and policies. For stable knowledge, searching by reflex adds latency and unnecessary sources. The right decision depends on information volatility.","es":"La web aporta valor cuando el dato puede haber cambiado: precios, disponibilidad, documentación viva, noticias, resultados, versiones y políticas. Para conocimiento estable, buscar por reflejo añade latencia y fuentes innecesarias. La decisión depende de la volatilidad de la información.","fr":"Le web apporte de la valeur lorsque l’information peut avoir changé : prix, disponibilité, documentation vivante, actualités, résultats, versions et politiques. Pour les connaissances stables, rechercher par réflexe ajoute de la latence et des sources inutiles. La décision dépend de la volatilité de l’information."}]},{"title":{"pt":"O que precisa estar atualizado","en":"What must be current","es":"What must be current","fr":"What must be current"},"body":[{"pt":"Em “Busca na web quando a resposta depende do agora”, a ideia só vira valor quando aparece no fluxo real. Informação atual exige uma fonte atual; o desafio é pesquisar quando necessário sem transformar todo pedido em navegação. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. Current information needs a current source; the challenge is searching when needed without turning every request into browsing. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. Current information needs a current source; the challenge is searching when needed without turning every request into browsing. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Web search when the answer depends on now”, the idea only becomes valuable when it appears in the real workflow. Current information needs a current source; the challenge is searching when needed without turning every request into browsing. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Como Busca atual precisa de fallback heterogêneo deixa de ser só interface","en":"How Web search when the answer depends on now becomes more than interface","es":"Cómo Búsqueda web cuando la respuesta depende del presente deja de ser solo interfaz","fr":"Comment Recherche web lorsque la réponse dépend du présent dépasse la simple interface"},"body":[{"pt":"Uma busca robusta não depende de um único provedor. Se CSE retorna 403 ou outro serviço está sem quota, o sistema precisa poder recorrer a outra fonte de web aberta ou a um vertical apropriado sem inventar resultado.","en":"The useful way to read “Web search when the answer depends on now” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Búsqueda web cuando la respuesta depende del presente» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Recherche web lorsque la réponse dépend du présent » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"fonte tem frescor compatível com a pergunta","en":"fonte tem frescor compatível com a pergunta","es":"fonte tem frescor compatível com a pergunta","fr":"fonte tem frescor compatível com a pergunta"},{"pt":"fallback mantém o mesmo tipo de intenção","en":"fallback mantém o mesmo tipo de intenção","es":"fallback mantém o mesmo tipo de intenção","fr":"fallback mantém o mesmo tipo de intenção"},{"pt":"ausência de fonte atual é declarada","en":"ausência de fonte atual é declarada","es":"ausência de fonte atual é declarada","fr":"ausência de fonte atual é declarada"}]},{"title":{"pt":"Falha específica: Busca atual precisa de fallback heterogêneo","en":"Specific failure mode: Web search when the answer depends on now","es":"Fallo específico: Búsqueda web cuando la respuesta depende del presente","fr":"Mode de défaillance : Recherche web lorsque la réponse dépend du présent"},"body":[{"pt":"O risco é cair de busca geral para fonte acadêmica e apresentar paper antigo como resposta a uma pergunta sobre “agora”.","en":"The failure mode to watch in “Web search when the answer depends on now” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Búsqueda web cuando la respuesta depende del presente» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Recherche web lorsque la réponse dépend du présent » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Busca atual precisa de fallback heterogêneo","en":"Evidence that closes Web search when the answer depends on now","es":"Evidencia que cierra Búsqueda web cuando la respuesta depende del presente","fr":"Preuve qui valide Recherche web lorsque la réponse dépend du présent"},"body":[{"pt":"O roteador deve preservar tipo de intenção, registrar frescor das fontes e falhar de forma explícita quando nenhuma fonte adequada responde.","en":"For “Web search when the answer depends on now”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Búsqueda web cuando la respuesta depende del presente», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Recherche web lorsque la réponse dépend du présent », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":3}},{"slug":"model-effort-and-mode","category":"models","asset":"site","title":{"pt":"Modelo, esforço e modo sem transformar o composer em painel de avião","en":"Model, effort, and mode without turning the composer into a cockpit","es":"Modelo, esfuerzo y modo sin convertir el composer en una cabina","fr":"Modèle, effort et mode sans transformer le composer en cockpit"},"lead":{"pt":"Controles avançados só ajudam quando a pessoa entende o efeito sem interromper o pedido que está escrevendo.","en":"Advanced controls only help when people understand their effect without interrupting the request they are writing.","es":"Los controles avanzados solo ayudan cuando la persona entiende su efecto sin interrumpir la solicitud que está escribiendo.","fr":"Les contrôles avancés n’aident que si la personne comprend leur effet sans interrompre la demande en cours."},"date":"2026-08-19","read":2,"blocks":[{"title":{"pt":"O composer continua sendo o centro","en":"The composer remains the center","es":"El composer sigue siendo el centro","fr":"Le composer reste le centre"},"body":[{"pt":"Escolher modelo, esforço ou capacidade não deveria competir visualmente com escrever o pedido. Os controles ficam úteis quando são compactos, previsíveis e mostram estado atual.","en":"Choosing model, effort, or capability should not visually compete with writing the request. Controls are useful when compact, predictable, and clear about current state.","es":"Elegir modelo, esfuerzo o capacidad no debería competir visualmente con escribir la solicitud. Los controles son útiles cuando son compactos, previsibles y muestran el estado actual.","fr":"Choisir modèle, effort ou capacité ne devrait pas concurrencer visuellement la rédaction de la demande. Les contrôles sont utiles lorsqu’ils sont compacts, prévisibles et explicites sur l’état actuel."}]},{"title":{"pt":"Três perguntas","en":"Three questions","es":"Tres preguntas","fr":"Trois questions"},"bullets":[{"pt":"Qual modelo está ativo?","en":"Which model is active?","es":"¿Qué modelo está activo?","fr":"Quel modèle est actif ?"},{"pt":"Quanto raciocínio a tarefa merece?","en":"How much reasoning does the task deserve?","es":"¿Cuánto razonamiento merece la tarea?","fr":"Quel niveau de raisonnement la tâche mérite-t-elle ?"},{"pt":"Há uma capacidade específica, como busca ou código, necessária agora?","en":"Is a specific capability, such as search or code, needed now?","es":"¿Se necesita ahora una capacidad específica, como búsqueda o código?","fr":"Une capacité spécifique, comme la recherche ou le code, est-elle nécessaire maintenant ?"}]},{"title":{"pt":"Defaults importam","en":"Defaults matter","es":"Los valores predeterminados importan","fr":"Les valeurs par défaut comptent"},"body":[{"pt":"A maioria dos pedidos deve funcionar sem configuração manual. Controles avançados são escape hatch, não pré-requisito para conversar.","en":"Most requests should work without manual configuration. Advanced controls are an escape hatch, not a prerequisite for conversation.","es":"La mayoría de las solicitudes deben funcionar sin configuración manual. Los controles avanzados son una salida, no un requisito previo para conversar.","fr":"La plupart des demandes doivent fonctionner sans configuration manuelle. Les contrôles avancés sont une échappatoire, pas un prérequis pour converser."}]},{"title":{"pt":"Por dentro de Composer não é cockpit","en":"Inside Model, effort, and mode without turning the composer into a cockpit","es":"Por dentro de Modelo, esfuerzo y modo sin convertir el composer en una cabina","fr":"Au cœur de Modèle, effort et mode sans transformer le composer en cockpit"},"body":[{"pt":"Modelo, esforço e modo precisam caber na decisão que o usuário realmente faz. Expor cada detalhe do runtime transforma o composer em painel de avião e aumenta erro de configuração.","en":"The useful way to read “Model, effort, and mode without turning the composer into a cockpit” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Modelo, esfuerzo y modo sin convertir el composer en una cabina» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Modèle, effort et mode sans transformer le composer en cockpit » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"latência e custo compatíveis com a complexidade","en":"latency and cost match complexity","es":"latência e custo compatíveis com a complexidade","fr":"latência e custo compatíveis com a complexidade"},{"pt":"identidade pública do modelo preservada em fallback","en":"public model identity survives fallback","es":"identidade pública do modelo preservada em fallback","fr":"identidade pública do modelo preservada em fallback"},{"pt":"esforço extra só quando compra evidência","en":"extra effort is spent only when it buys evidence","es":"esforço extra só quando compra evidência","fr":"esforço extra só quando compra evidência"}]},{"title":{"pt":"Falha específica: Composer não é cockpit","en":"Specific failure mode: Model, effort, and mode without turning the composer into a cockpit","es":"Fallo específico: Modelo, esfuerzo y modo sin convertir el composer en una cabina","fr":"Mode de défaillance : Modèle, effort et mode sans transformer le composer en cockpit"},"body":[{"pt":"O risco é esconder demais e impedir que usuários avançados controlem profundidade, ferramentas ou custo quando isso importa.","en":"The failure mode to watch in “Model, effort, and mode without turning the composer into a cockpit” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Modelo, esfuerzo y modo sin convertir el composer en una cabina» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Modèle, effort et mode sans transformer le composer en cockpit » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Composer não é cockpit","en":"Evidence that closes Model, effort, and mode without turning the composer into a cockpit","es":"Evidencia que cierra Modelo, esfuerzo y modo sin convertir el composer en una cabina","fr":"Preuve qui valide Modèle, effort et mode sans transformer le composer en cockpit"},"body":[{"pt":"A solução é progressive disclosure: default simples e adaptativo, com controles avançados próximos do modelo e explicações curtas sobre impacto real.","en":"For “Model, effort, and mode without turning the composer into a cockpit”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Modelo, esfuerzo y modo sin convertir el composer en una cabina», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Modèle, effort et mode sans transformer le composer en cockpit », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Critério de roteamento como gate","en":"routing criterion as a gate","es":"criterio de enrutamiento como gate","fr":"critère de routage comme gate"},"body":[{"pt":"Em “Modelo, esforço e modo sem transformar o composer em painel de avião”, o ponto técnico que fecha a análise é tratar modelo, esforço e custo como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Model, effort, and mode without turning the composer into a cockpit”, the technical point that closes the analysis is to treat model, effort, and cost as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Modelo, esfuerzo y modo sin convertir el composer en una cabina”, el cierre técnico es tratar modelo, esfuerzo y coste como un único contrato y exigir comportamiento verificable.","fr":"Dans « Modèle, effort et mode sans transformer le composer en cockpit », le point technique final consiste à traiter modèle, effort et coût comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"review-before-ship","category":"code","asset":"coding","title":{"pt":"Revisar antes de entregar","en":"Review before shipping","es":"Revisar antes de entregar","fr":"Réviser avant de livrer"},"lead":{"pt":"O painel de revisão existe para transformar alterações em evidência: o que mudou, onde mudou e se algo ficou quebrado.","en":"The review panel turns changes into evidence: what changed, where it changed, and whether anything broke.","es":"El panel de revisión convierte los cambios en evidencia: qué cambió, dónde cambió y si algo quedó roto.","fr":"Le panneau de révision transforme les changements en preuves : ce qui a changé, où et si quelque chose a été cassé."},"date":"2026-08-18","read":2,"blocks":[{"title":{"pt":"Mudança sem revisão é só confiança","en":"Change without review is just trust","es":"Cambio sin revisión es solo confianza","fr":"Un changement sans révision n’est que de la confiance"},"body":[{"pt":"Uma resposta pode soar segura e ainda ter removido uma função, alterado um seletor errado ou deixado diagnóstico pendente. A revisão organiza o que precisa ser conferido antes de encerrar a sessão.","en":"A response can sound confident and still remove a function, change the wrong selector, or leave a diagnostic unresolved. Review organizes what should be checked before closing the session.","es":"Una respuesta puede sonar segura y aun así eliminar una función, cambiar el selector equivocado o dejar un diagnóstico pendiente. La revisión organiza lo que debe comprobarse antes de cerrar la sesión.","fr":"Une réponse peut sembler sûre tout en supprimant une fonction, modifiant le mauvais sélecteur ou laissant un diagnostic non résolu. La révision organise ce qui doit être vérifié avant de fermer la session."}]},{"title":{"pt":"Evidências úteis","en":"Useful evidence","es":"Evidencias útiles","fr":"Preuves utiles"},"bullets":[{"pt":"Lista de arquivos alterados.","en":"List of changed files.","es":"Lista de archivos modificados.","fr":"Liste des fichiers modifiés."},{"pt":"Resumo do que foi feito.","en":"Summary of what was done.","es":"Resumen de lo realizado.","fr":"Résumé de ce qui a été fait."},{"pt":"Diagnósticos, testes e mensagens relevantes do terminal.","en":"Diagnostics, tests, and relevant terminal messages.","es":"Diagnósticos, pruebas y mensajes relevantes del terminal.","fr":"Diagnostics, tests et messages pertinents du terminal."}]},{"title":{"pt":"Encerrar com estado claro","en":"Close with a clear state","es":"Cerrar con un estado claro","fr":"Terminer avec un état clair"},"body":[{"pt":"Uma boa entrega diz o que está pronto, o que foi validado e o que ainda merece atenção. Esse resumo é tão importante quanto o diff.","en":"A good handoff says what is ready, what was validated, and what still deserves attention. That summary matters as much as the diff.","es":"Una buena entrega dice qué está listo, qué se validó y qué aún merece atención. Ese resumen importa tanto como el diff.","fr":"Une bonne livraison indique ce qui est prêt, ce qui a été validé et ce qui mérite encore de l’attention. Ce résumé compte autant que le diff."}]},{"title":{"pt":"A parte difícil de Revisor deve procurar regressão fora do diff","en":"The hard part of Review before shipping","es":"La parte difícil de Revisar antes de entregar","fr":"La partie difficile de Réviser avant de livrer"},"body":[{"pt":"Uma mudança pequena pode quebrar rota, auth, i18n, tema ou persistência longe do arquivo editado. Revisão antes de entregar precisa rastrear contratos atingidos, não apenas reler as linhas novas.","en":"The useful way to read “Review before shipping” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Revisar antes de entregar» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Réviser avant de livrer » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Revisor deve procurar regressão fora do diff","en":"Specific failure mode: Review before shipping","es":"Fallo específico: Revisar antes de entregar","fr":"Mode de défaillance : Réviser avant de livrer"},"body":[{"pt":"O risco é transformar review em lint textual e ignorar comportamento.","en":"The failure mode to watch in “Review before shipping” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Revisar antes de entregar» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Réviser avant de livrer » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Revisor deve procurar regressão fora do diff","en":"Evidence that closes Review before shipping","es":"Evidencia que cierra Revisar antes de entregar","fr":"Preuve qui valide Réviser avant de livrer"},"body":[{"pt":"O gate fecha com checks estáticos, execução quando disponível, inspeção de estados negativos e comparação com o último checkpoint que já funcionava.","en":"For “Review before shipping”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Revisar antes de entregar», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Réviser avant de livrer », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Revisar antes de entregar”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Review before shipping”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Revisar antes de entregar”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Réviser avant de livrer », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"terminal-as-evidence","category":"code","asset":"coding","title":{"pt":"Terminal como evidência, não como teatro","en":"Terminal as evidence, not theater","es":"Terminal como evidencia, no como teatro","fr":"Le terminal comme preuve, pas comme théâtre"},"lead":{"pt":"Comandos e logs têm valor quando respondem ao que precisa ser verificado, não quando apenas fazem a sessão parecer técnica.","en":"Commands and logs are valuable when they answer what needs verification, not when they merely make the session look technical.","es":"Los comandos y logs valen cuando responden a lo que debe verificarse, no cuando solo hacen que la sesión parezca técnica.","fr":"Les commandes et logs ont de la valeur lorsqu’ils répondent à ce qui doit être vérifié, pas lorsqu’ils donnent simplement un air technique à la session."},"date":"2026-08-17","read":2,"blocks":[{"title":{"pt":"Rodar com propósito","en":"Run with a purpose","es":"Ejecutar con propósito","fr":"Exécuter avec un but"},"body":[{"pt":"Antes de executar, a pergunta deveria ser clara: estamos verificando sintaxe, build, teste, arquivo gerado ou comportamento?","en":"Before running anything, the question should be clear: are we checking syntax, a build, a test, a generated file, or behavior?","es":"Antes de ejecutar algo, la pregunta debe estar clara: ¿verificamos sintaxis, build, prueba, archivo generado o comportamiento?","fr":"Avant d’exécuter quoi que ce soit, la question doit être claire : vérifie-t-on la syntaxe, un build, un test, un fichier généré ou un comportement ?"}]},{"title":{"pt":"Saída que interessa","en":"Output that matters","es":"Salida que importa","fr":"Sortie qui compte"},"bullets":[{"pt":"Código de saída e mensagem final.","en":"Exit code and final message.","es":"Código de salida y mensaje final.","fr":"Code de sortie et message final."},{"pt":"Erros com arquivo e linha quando disponíveis.","en":"Errors with file and line when available.","es":"Errores con archivo y línea cuando estén disponibles.","fr":"Erreurs avec fichier et ligne lorsqu’ils sont disponibles."},{"pt":"Um resumo legível na conversa.","en":"A readable summary in the conversation.","es":"Un resumen legible en la conversación.","fr":"Un résumé lisible dans la conversation."}]},{"title":{"pt":"Menos log, mais conclusão","en":"Less log, more conclusion","es":"Menos log, más conclusión","fr":"Moins de logs, plus de conclusion"},"body":[{"pt":"Despejar centenas de linhas não prova nada por si só. O terminal funciona melhor quando a sessão destaca o trecho que sustenta a decisão.","en":"Dumping hundreds of lines proves nothing by itself. The terminal works best when the session highlights the portion that supports the decision.","es":"Volcar cientos de líneas no demuestra nada por sí solo. El terminal funciona mejor cuando la sesión destaca la parte que sostiene la decisión.","fr":"Déverser des centaines de lignes ne prouve rien en soi. Le terminal fonctionne mieux lorsque la session met en évidence la partie qui soutient la décision."}]},{"title":{"pt":"O contrato escondido em Terminal não prova o que não executou","en":"The hidden contract in Terminal as evidence, not theater","es":"El contrato oculto de Terminal como evidencia, no como teatro","fr":"Le contrat caché de Le terminal comme preuve, pas comme théâtre"},"body":[{"pt":"Comando, build e teste são evidência somente quando foram realmente executados e o resultado foi observado. Mostrar comandos bonitos ou um transcript fabricado é pior do que declarar que a verificação não estava disponível.","en":"The useful way to read “Terminal as evidence, not theater” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Terminal como evidencia, no como teatro» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Le terminal comme preuve, pas comme théâtre » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Terminal não prova o que não executou","en":"Specific failure mode: Terminal as evidence, not theater","es":"Fallo específico: Terminal como evidencia, no como teatro","fr":"Mode de défaillance : Le terminal comme preuve, pas comme théâtre"},"body":[{"pt":"O risco é tratar “npm run build” como sinônimo de runtime correto ou usar exit code zero de um check parcial como garantia de produto.","en":"The failure mode to watch in “Terminal as evidence, not theater” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Terminal como evidencia, no como teatro» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Le terminal comme preuve, pas comme théâtre » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Terminal não prova o que não executou","en":"Evidence that closes Terminal as evidence, not theater","es":"Evidencia que cierra Terminal como evidencia, no como teatro","fr":"Preuve qui valide Le terminal comme preuve, pas comme théâtre"},"body":[{"pt":"O relatório deve nomear a classe da evidência: parser, lint, teste, build, startup, E2E, visual ou não executado.","en":"For “Terminal as evidence, not theater”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Terminal como evidencia, no como teatro», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Le terminal comme preuve, pas comme théâtre », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Terminal como evidência, não como teatro”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Terminal as evidence, not theater”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Terminal como evidencia, no como teatro”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Le terminal comme preuve, pas comme théâtre », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"web-versus-installed-code","category":"code","asset":"coding","title":{"pt":"Code Web e app instalado: a mesma tarefa, limites diferentes","en":"Code Web and installed app: same task, different boundaries","es":"Code Web y app instalada: misma tarea, límites distintos","fr":"Code Web et application installée : même tâche, limites différents"},"lead":{"pt":"O navegador é ótimo para acesso imediato; o app instalado ganha quando a tarefa depende mais do ambiente local.","en":"The browser is great for immediate access; the installed app gains when the task depends more heavily on the local environment.","es":"El navegador es excelente para acceso inmediato; la app instalada gana cuando la tarea depende más del entorno local.","fr":"Le navigateur est excellent pour un accès immédiat ; l’application installée prend l’avantage lorsque la tâche dépend davantage de l’environnement local."},"date":"2026-08-16","read":2,"blocks":[{"title":{"pt":"Web primeiro quando faz sentido","en":"Web first when it makes sense","es":"Web primero cuando tiene sentido","fr":"Le web d’abord quand cela a du sens"},"body":[{"pt":"Abrir uma sessão, revisar arquivos e continuar um trabalho sem instalar nada é uma vantagem real. Para tarefas compatíveis com o sandbox do navegador, o Code Web reduz atrito.","en":"Opening a session, reviewing files, and continuing work without installing anything is a real advantage. For tasks compatible with the browser sandbox, Code Web reduces friction.","es":"Abrir una sesión, revisar archivos y continuar un trabajo sin instalar nada es una ventaja real. Para tareas compatibles con el sandbox del navegador, Code Web reduce fricción.","fr":"Ouvrir une session, réviser des fichiers et continuer un travail sans rien installer est un vrai avantage. Pour les tâches compatibles avec le sandbox du navigateur, Code Web réduit les frictions."}]},{"title":{"pt":"Quando o instalado ajuda","en":"When installed helps","es":"Cuándo ayuda la app instalada","fr":"Quand l’application installée aide"},"bullets":[{"pt":"Acesso mais direto ao ambiente local.","en":"More direct access to the local environment.","es":"Acceso más directo al entorno local.","fr":"Accès plus direct à l’environnement local."},{"pt":"Fluxos de terminal e arquivos que dependem do sistema.","en":"Terminal and file flows that depend on the system.","es":"Flujos de terminal y archivos que dependen del sistema.","fr":"Flux de terminal et de fichiers dépendant du système."},{"pt":"Sessões de trabalho longas em uma superfície dedicada.","en":"Long work sessions in a dedicated surface.","es":"Sesiones de trabajo largas en una superficie dedicada.","fr":"Longues sessions de travail dans une surface dédiée."}]},{"title":{"pt":"A documentação precisa dizer a diferença","en":"Docs should state the difference","es":"La documentación debe explicar la diferencia","fr":"La documentation doit expliquer la différence"},"body":[{"pt":"Prometer paridade absoluta onde o navegador impõe limites só cria surpresa. A melhor orientação é mostrar a superfície adequada para cada tipo de tarefa.","en":"Promising absolute parity where the browser imposes limits only creates surprises. Better guidance shows which surface fits each kind of task.","es":"Prometer paridad absoluta donde el navegador impone límites solo crea sorpresas. La mejor guía muestra qué superficie encaja con cada tarea.","fr":"Promettre une parité absolue là où le navigateur impose des limites ne crée que des surprises. La meilleure guidance indique quelle surface convient à chaque tâche."}]},{"title":{"pt":"Onde Mesmo projeto, capacidades diferentes realmente ganha qualidade","en":"Where Code Web and installed app: same task, different boundaries actually gains quality","es":"Dónde Code Web y app instalada: misma tarea, límites distintos realmente gana calidad","fr":"Là où Code Web et application installée : même tâche, limites différents gagne vraiment en qualité"},"body":[{"pt":"Code Web e app instalado podem compartilhar modelo e workspace, mas não possuem as mesmas permissões de filesystem, processos, navegador local ou integração com sistema operacional.","en":"The useful way to read “Code Web and installed app: same task, different boundaries” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Code Web y app instalada: misma tarea, límites distintos» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Code Web et application installée : même tâche, limites différents » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Mesmo projeto, capacidades diferentes","en":"Specific failure mode: Code Web and installed app: same task, different boundaries","es":"Fallo específico: Code Web y app instalada: misma tarea, límites distintos","fr":"Mode de défaillance : Code Web et application installée : même tâche, limites différents"},"body":[{"pt":"O risco é gerar instrução que só funciona no desktop e apresentá-la no Web como se o runtime pudesse executá-la.","en":"The failure mode to watch in “Code Web and installed app: same task, different boundaries” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Code Web y app instalada: misma tarea, límites distintos» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Code Web et application installée : même tâche, limites différents » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Mesmo projeto, capacidades diferentes","en":"Evidence that closes Code Web and installed app: same task, different boundaries","es":"Evidencia que cierra Code Web y app instalada: misma tarea, límites distintos","fr":"Preuve qui valide Code Web et application installée : même tâche, limites différents"},"body":[{"pt":"O agente precisa conhecer o execution target, escolher ferramentas compatíveis e oferecer handoff explícito quando a tarefa exige capacidade local.","en":"For “Code Web and installed app: same task, different boundaries”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Code Web y app instalada: misma tarea, límites distintos», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Code Web et application installée : même tâche, limites différents », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Code Web e app instalado: a mesma tarefa, limites diferentes”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Code Web and installed app: same task, different boundaries”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Code Web y app instalada: misma tarea, límites distintos”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Code Web et application installée : même tâche, limites différents », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"language-before-first-render","category":"site","asset":"site","title":{"pt":"Idioma certo antes do primeiro render","en":"The right language before the first render","es":"El idioma correcto antes del primer render","fr":"La bonne langue avant le premier rendu"},"lead":{"pt":"Detectar depois que a página aparece causa flashes e mistura de idiomas; conteúdo público precisa decidir o idioma cedo.","en":"Detecting after the page appears causes flashes and mixed languages; public content needs to choose a language early.","es":"Detectar después de que aparece la página causa parpadeos y mezcla de idiomas; el contenido público debe elegir idioma temprano.","fr":"Détecter après l’affichage de la page provoque des flashs et des mélanges de langues ; le contenu public doit choisir la langue tôt."},"date":"2026-08-15","read":2,"blocks":[{"title":{"pt":"Preferência explícita vem primeiro","en":"Explicit preference comes first","es":"La preferencia explícita viene primero","fr":"La préférence explicite vient d’abord"},"body":[{"pt":"Se a pessoa escolheu um idioma nas configurações, essa escolha deve vencer o idioma do navegador. Sem escolha manual, navigator.languages oferece um bom ponto de partida.","en":"If a person chose a language in settings, that choice should override the browser language. Without a manual choice, navigator.languages is a good starting point.","es":"Si la persona eligió un idioma en configuración, esa elección debe prevalecer sobre el idioma del navegador. Sin elección manual, navigator.languages es un buen punto de partida.","fr":"Si une personne a choisi une langue dans les réglages, ce choix doit primer sur la langue du navigateur. Sans choix manuel, navigator.languages est un bon point de départ."}]},{"title":{"pt":"Sem depender de login","en":"Without depending on login","es":"Sin depender del login","fr":"Sans dépendre de la connexion"},"body":[{"pt":"Blog e documentação abrem sem conta, então suas traduções também precisam existir localmente. O primeiro render não pode depender de uma sessão autenticada para traduzir texto.","en":"Blog and documentation open without an account, so their translations also need to exist locally. First render cannot depend on an authenticated session to translate text.","es":"El blog y la documentación se abren sin cuenta, así que sus traducciones también deben existir localmente. El primer render no puede depender de una sesión autenticada para traducir texto.","fr":"Le blog et la documentation s’ouvrent sans compte ; leurs traductions doivent donc exister localement. Le premier rendu ne peut pas dépendre d’une session authentifiée pour traduire le texte."}]},{"title":{"pt":"Resultado esperado","en":"Expected result","es":"Resultado esperado","fr":"Résultat attendu"},"bullets":[{"pt":"PT, EN, ES ou FR completos desde a primeira pintura.","en":"Complete PT, EN, ES, or FR from the first paint.","es":"PT, EN, ES o FR completos desde la primera pintura.","fr":"PT, EN, ES ou FR complets dès le premier affichage."},{"pt":"Troca manual persistida para a próxima visita.","en":"Manual change persisted for the next visit.","es":"Cambio manual persistido para la siguiente visita.","fr":"Changement manuel conservé pour la prochaine visite."},{"pt":"Sem pedaços antigos no idioma anterior.","en":"No stale fragments in the previous language.","es":"Sin fragmentos antiguos en el idioma anterior.","fr":"Aucun fragment obsolète dans l’ancienne langue."}]},{"title":{"pt":"Uma superfície pública precisa funcionar sem contexto oculto","en":"A public surface must work without hidden context","es":"Una superficie pública debe funcionar sin contexto oculto","fr":"Une surface publique doit fonctionner sans contexte caché"},"body":[{"pt":"Blog e documentação devem abrir por URL direta, permanecer legíveis sem sessão e expor estrutura suficiente para navegadores, buscadores e agentes. A experiência autenticada pode continuar privada; o conteúdo público não deveria depender dela para existir.","en":"Blog and documentation should open from direct URLs, remain readable without a session, and expose enough structure for browsers, search engines, and agents. The authenticated experience can remain private; public content should not depend on it to exist.","es":"Blog y documentación deben abrir por URL directa, seguir legibles sin sesión y exponer suficiente estructura para navegadores, buscadores y agentes. La experiencia autenticada puede seguir privada; el contenido público no debería depender de ella para existir.","fr":"Le blog et la documentation doivent s’ouvrir par URL directe, rester lisibles sans session et exposer suffisamment de structure aux navigateurs, moteurs et agents. L’expérience authentifiée peut rester privée ; le contenu public ne devrait pas dépendre d’elle pour exister."}]},{"title":{"pt":"O mecanismo central de Idioma precisa existir antes da primeira pintura","en":"The core mechanism of The right language before the first render","es":"El mecanismo central de El idioma correcto antes del primer render","fr":"Le mécanisme central de La bonne langue avant le premier rendu"},"body":[{"pt":"Se a detecção de idioma ocorre depois do render, o usuário vê flicker e componentes podem persistir texto na língua errada. O idioma é parte do estado inicial da aplicação.","en":"The useful way to read “The right language before the first render” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «El idioma correcto antes del primer render» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « La bonne langue avant le premier rendu » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"rota funciona em file:// e hospedagem","en":"rota funciona em file:// e hospedagem","es":"rota funciona em file:// e hospedagem","fr":"rota funciona em file:// e hospedagem"},{"pt":"primeiro render não depende de auth quando é público","en":"primeiro render não depende de auth quando é público","es":"primeiro render não depende de auth quando é público","fr":"primeiro render não depende de auth quando é público"},{"pt":"mobile e desktop preservam a mesma intenção","en":"mobile e desktop preservam a mesma intenção","es":"mobile e desktop preservam a mesma intenção","fr":"mobile e desktop preservam a mesma intenção"}]},{"title":{"pt":"Falha específica: Idioma precisa existir antes da primeira pintura","en":"Specific failure mode: The right language before the first render","es":"Fallo específico: El idioma correcto antes del primer render","fr":"Mode de défaillance : La bonne langue avant le premier rendu"},"body":[{"pt":"O risco cresce com strings geradas por patches tardios que não entram no mesmo catálogo de tradução.","en":"The failure mode to watch in “The right language before the first render” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «El idioma correcto antes del primer render» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « La bonne langue avant le premier rendu » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Idioma precisa existir antes da primeira pintura","en":"Evidence that closes The right language before the first render","es":"Evidencia que cierra El idioma correcto antes del primer render","fr":"Preuve qui valide La bonne langue avant le premier rendu"},"body":[{"pt":"O produto deve resolver locale antes de montar a superfície, usar uma função única de tradução e auditar qualquer objeto multilíngue para PT, EN, ES e FR.","en":"For “The right language before the first render”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «El idioma correcto antes del primer render», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « La bonne langue avant le premier rendu », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"supreme-panel-clarity","category":"admin","asset":"site","title":{"pt":"Painel Supremo: poder administrativo precisa de hierarquia","en":"Supreme panel: administrative power needs hierarchy","es":"Panel Supremo: el poder administrativo necesita jerarquía","fr":"Panneau Suprême : le pouvoir administratif a besoin de hiérarchie"},"lead":{"pt":"Controles de conta, avisos e restrições ficam mais seguros quando a interface separa ações rápidas de operações sensíveis.","en":"Account controls, notices, and restrictions are safer when the interface separates quick actions from sensitive operations.","es":"Los controles de cuenta, avisos y restricciones son más seguros cuando la interfaz separa acciones rápidas de operaciones sensibles.","fr":"Les contrôles de compte, avis et restrictions sont plus sûrs lorsque l’interface sépare les actions rapides des opérations sensibles."},"date":"2026-08-14","read":2,"blocks":[{"title":{"pt":"Admin não é uma lista de botões","en":"Admin is not a list of buttons","es":"Admin no es una lista de botones","fr":"L’admin n’est pas une liste de boutons"},"body":[{"pt":"Quando tudo tem o mesmo peso visual, uma ação destrutiva parece tão casual quanto atualizar a página. Um painel administrativo precisa deixar intenção, alvo e consequência legíveis antes do clique.","en":"When everything has the same visual weight, a destructive action looks as casual as refreshing the page. An administrative panel should make intent, target, and consequence clear before the click.","es":"Cuando todo tiene el mismo peso visual, una acción destructiva parece tan casual como actualizar la página. Un panel administrativo debe dejar claros intención, objetivo y consecuencia antes del clic.","fr":"Lorsque tout a le même poids visuel, une action destructive semble aussi banale qu’un rafraîchissement. Un panneau administratif doit rendre intention, cible et conséquence claires avant le clic."}]},{"title":{"pt":"Separação útil","en":"Useful separation","es":"Separación útil","fr":"Séparation utile"},"bullets":[{"pt":"Estado e diagnóstico.","en":"State and diagnostics.","es":"Estado y diagnóstico.","fr":"État et diagnostics."},{"pt":"Avisos e comunicação.","en":"Notices and communication.","es":"Avisos y comunicación.","fr":"Avis et communication."},{"pt":"Restrições, duração e recursos.","en":"Restrictions, duration, and appeals.","es":"Restricciones, duración y recursos.","fr":"Restrictions, durée et recours."}]},{"title":{"pt":"A autorização não mora no CSS","en":"Authorization does not live in CSS","es":"La autorización no vive en el CSS","fr":"L’autorisation ne vit pas dans le CSS"},"body":[{"pt":"Esconder uma aba para usuários comuns melhora a experiência, mas a autoridade final continua no backend. A interface pode orientar; a função segura decide.","en":"Hiding a tab from regular users improves experience, but final authority remains on the backend. The interface can guide; the secure function decides.","es":"Ocultar una pestaña a usuarios normales mejora la experiencia, pero la autoridad final sigue en el backend. La interfaz guía; la función segura decide.","fr":"Masquer un onglet aux utilisateurs ordinaires améliore l’expérience, mais l’autorité finale reste côté backend. L’interface guide ; la fonction sécurisée décide."}]},{"title":{"pt":"Poder administrativo exige mais contexto","en":"Administrative power requires more context","es":"El poder administrativo exige más contexto","fr":"Le pouvoir administratif exige plus de contexte"},"body":[{"pt":"Ações de alto impacto precisam mostrar alvo, consequência e estado atual antes da confirmação. Quanto maior o alcance de uma operação, menos aceitável é depender de um rótulo ambíguo ou de um botão visualmente idêntico a uma ação comum.","en":"High-impact actions need to show the target, consequence, and current state before confirmation. The broader the operation, the less acceptable it is to rely on an ambiguous label or a button that looks like an ordinary action.","es":"Las acciones de alto impacto deben mostrar objetivo, consecuencia y estado actual antes de confirmar. Cuanto mayor sea el alcance, menos aceptable es depender de una etiqueta ambigua o de un botón que parece una acción común.","fr":"Les actions à fort impact doivent afficher la cible, la conséquence et l’état actuel avant confirmation. Plus l’opération est large, moins il est acceptable de dépendre d’un libellé ambigu ou d’un bouton ressemblant à une action ordinaire."}]},{"title":{"pt":"A engenharia por trás de Poder administrativo exige causalidade visível","en":"The engineering behind Supreme panel: administrative power needs hierarchy","es":"La ingeniería detrás de Panel Supremo: el poder administrativo necesita jerarquía","fr":"L’ingénierie derrière Panneau Suprême : le pouvoir administratif a besoin de hiérarchie"},"body":[{"pt":"Painel Supremo lida com ações que podem banir, restaurar, alterar feature flags ou mexer em contas. Hierarquia visual precisa refletir risco e separar leitura, simulação e mutação.","en":"The useful way to read “Supreme panel: administrative power needs hierarchy” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Panel Supremo: el poder administrativo necesita jerarquía» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Panneau Suprême : le pouvoir administratif a besoin de hiérarchie » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"ação destrutiva exige alvo e efeito claros","en":"ação destrutiva exige alvo e efeito claros","es":"ação destrutiva exige alvo e efeito claros","fr":"ação destrutiva exige alvo e efeito claros"},{"pt":"preview não altera estado","en":"preview não altera estado","es":"preview não altera estado","fr":"preview não altera estado"},{"pt":"auditoria distingue leitura de mutação","en":"auditoria distingue leitura de mutação","es":"auditoria distingue leitura de mutação","fr":"auditoria distingue leitura de mutação"}]},{"title":{"pt":"Falha específica: Poder administrativo exige causalidade visível","en":"Specific failure mode: Supreme panel: administrative power needs hierarchy","es":"Fallo específico: Panel Supremo: el poder administrativo necesita jerarquía","fr":"Mode de défaillance : Panneau Suprême : le pouvoir administratif a besoin de hiérarchie"},"body":[{"pt":"O perigo é colocar ações destrutivas no mesmo peso de filtros ou previews, aumentando clique acidental e dificultando auditoria.","en":"The failure mode to watch in “Supreme panel: administrative power needs hierarchy” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Panel Supremo: el poder administrativo necesita jerarquía» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Panneau Suprême : le pouvoir administratif a besoin de hiérarchie » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Poder administrativo exige causalidade visível","en":"Evidence that closes Supreme panel: administrative power needs hierarchy","es":"Evidencia que cierra Panel Supremo: el poder administrativo necesita jerarquía","fr":"Preuve qui valide Panneau Suprême : le pouvoir administratif a besoin de hiérarchie"},"body":[{"pt":"Cada mutação deve mostrar alvo, efeito, duração, justificativa quando aplicável e retorno do backend; previews não podem alterar estado real.","en":"For “Supreme panel: administrative power needs hierarchy”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Panel Supremo: el poder administrativo necesita jerarquía», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Panneau Suprême : le pouvoir administratif a besoin de hiérarchie », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"standalone-monolith-maintenance","category":"engineering","asset":"site","title":{"pt":"Como limpar um HTML standalone sem arrancar a lógica junto","en":"How to clean a standalone HTML without ripping out the logic","es":"Cómo limpiar un HTML standalone sin arrancar la lógica","fr":"Comment nettoyer un HTML standalone sans arracher la logique"},"lead":{"pt":"Em um arquivo monolítico, ordem de CSS e scripts pode ser comportamento; limpeza segura começa por entender dependências.","en":"In a monolithic file, CSS and script order can be behavior; safe cleanup starts with understanding dependencies.","es":"En un archivo monolítico, el orden de CSS y scripts puede ser comportamiento; una limpieza segura empieza por entender dependencias.","fr":"Dans un fichier monolithique, l’ordre du CSS et des scripts peut être un comportement ; un nettoyage sûr commence par comprendre les dépendances."},"date":"2026-08-13","read":2,"blocks":[{"title":{"pt":"“O último ganha” também é lógica","en":"“Last one wins” can be logic too","es":"“El último gana” también puede ser lógica","fr":"« Le dernier gagne » peut aussi être de la logique"},"body":[{"pt":"Muitos patches acumulados deixam regras repetidas, mas apagar tudo que parece duplicado pode mudar a cascata que uma tela dependia para funcionar. Primeiro é preciso identificar qual camada realmente é autoritativa.","en":"Many accumulated patches create repeated rules, but deleting everything that looks duplicated can change the cascade a screen relied on. First identify which layer is actually authoritative.","es":"Muchos parches acumulados crean reglas repetidas, pero borrar todo lo que parece duplicado puede cambiar la cascada de la que dependía una pantalla. Primero hay que identificar qué capa es autoritativa.","fr":"De nombreux patchs accumulés créent des règles répétées, mais supprimer tout ce qui semble dupliqué peut modifier la cascade dont dépend un écran. Il faut d’abord identifier la couche réellement autoritaire."}]},{"title":{"pt":"Uma limpeza segura","en":"A safe cleanup","es":"Una limpieza segura","fr":"Un nettoyage sûr"},"bullets":[{"pt":"Inventariar funções, IDs, estilos e rotas antes.","en":"Inventory functions, IDs, styles, and routes first.","es":"Inventariar funciones, IDs, estilos y rutas primero.","fr":"Inventorier d’abord fonctions, IDs, styles et routes."},{"pt":"Mover responsabilidade sem alterar ordem de execução.","en":"Move responsibility without changing execution order.","es":"Mover responsabilidades sin cambiar el orden de ejecución.","fr":"Déplacer les responsabilités sans modifier l’ordre d’exécution."},{"pt":"Validar JavaScript e comparar contagens depois.","en":"Validate JavaScript and compare counts afterward.","es":"Validar JavaScript y comparar conteos después.","fr":"Valider le JavaScript et comparer les comptes ensuite."}]},{"title":{"pt":"Comentários que ajudam alguém novo","en":"Comments that help a newcomer","es":"Comentarios que ayudan a alguien nuevo","fr":"Commentaires qui aident un nouveau venu"},"body":[{"pt":"Um mapa do fonte e marcadores de responsabilidade valem mais do que comentários de versão espalhados. A equipe precisa saber onde mudar auth, chat, Code, Refletir e admin sem adivinhar.","en":"A source map and responsibility markers are more valuable than scattered version comments. The team needs to know where to change auth, chat, Code, Reflect, and admin without guessing.","es":"Un mapa del código y marcadores de responsabilidad valen más que comentarios de versión dispersos. El equipo debe saber dónde cambiar auth, chat, Code, Reflect y admin sin adivinar.","fr":"Une carte du source et des marqueurs de responsabilité valent plus que des commentaires de version éparpillés. L’équipe doit savoir où modifier auth, chat, Code, Reflect et admin sans deviner."}]},{"title":{"pt":"O ponto que decide Em HTML monolítico, posição de patch é contrato","en":"The decision point in How to clean a standalone HTML without ripping out the logic","es":"El punto decisivo de Cómo limpiar un HTML standalone sin arrancar la lógica","fr":"Le point décisif de Comment nettoyer un HTML standalone sans arracher la logique"},"body":[{"pt":"Um único arquivo pode conter strings que parecem tags de fechamento. Fazer replace no primeiro </body> encontrado pode inserir CSS e JS dentro de template strings e destruir partes que não tinham relação com a mudança.","en":"The useful way to read “How to clean a standalone HTML without ripping out the logic” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Cómo limpiar un HTML standalone sin arrancar la lógica» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Comment nettoyer un HTML standalone sans arracher la logique » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"causa raiz vem antes do fallback","en":"causa raiz vem antes do fallback","es":"causa raiz vem antes do fallback","fr":"causa raiz vem antes do fallback"},{"pt":"mudança não quebra subsistemas fora do escopo","en":"mudança não quebra subsistemas fora do escopo","es":"mudança não quebra subsistemas fora do escopo","fr":"mudança não quebra subsistemas fora do escopo"},{"pt":"logs e códigos permitem reproduzir a falha","en":"logs e códigos permitem reproduzir a falha","es":"logs e códigos permitem reproduzir a falha","fr":"logs e códigos permitem reproduzir a falha"}]},{"title":{"pt":"Falha específica: Em HTML monolítico, posição de patch é contrato","en":"Specific failure mode: How to clean a standalone HTML without ripping out the logic","es":"Fallo específico: Cómo limpiar un HTML standalone sin arrancar la lógica","fr":"Mode de défaillance : Comment nettoyer un HTML standalone sans arracher la logique"},"body":[{"pt":"O risco é particularmente cruel porque o parser pode continuar carregando parte da página e fazer o bug parecer visual.","en":"The failure mode to watch in “How to clean a standalone HTML without ripping out the logic” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Cómo limpiar un HTML standalone sin arrancar la lógica» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Comment nettoyer un HTML standalone sans arracher la logique » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Em HTML monolítico, posição de patch é contrato","en":"Evidence that closes How to clean a standalone HTML without ripping out the logic","es":"Evidencia que cierra Cómo limpiar un HTML standalone sin arrancar la lógica","fr":"Preuve qui valide Comment nettoyer un HTML standalone sans arracher la logique"},"body":[{"pt":"A manutenção segura usa marcadores únicos, `rfind` para o fechamento real, valida todos os scripts executáveis e compara subsistemas não relacionados quando a alteração deveria ser isolada.","en":"For “How to clean a standalone HTML without ripping out the logic”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Cómo limpiar un HTML standalone sin arrancar la lógica», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Comment nettoyer un HTML standalone sans arracher la logique », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Falha que esse desenho evita como gate","en":"failure this design prevents as a gate","es":"fallo que este diseño evita como gate","fr":"panne évitée par cette conception comme gate"},"body":[{"pt":"Em “Como limpar um HTML standalone sem arrancar a lógica junto”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “How to clean a standalone HTML without ripping out the logic”, the technical point that closes the analysis is to treat ownership, recovery, and observability as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Cómo limpiar un HTML standalone sin arrancar la lógica”, el cierre técnico es tratar ownership, recuperación y observabilidad como un único contrato y exigir comportamiento verificable.","fr":"Dans « Comment nettoyer un HTML standalone sans arracher la logique », le point technique final consiste à traiter ownership, reprise et observabilité comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"artifacts-as-handoff","category":"artifacts","asset":"docs","title":{"pt":"Artefatos como entrega, não como anexo perdido","en":"Artifacts as handoff, not a lost attachment","es":"Artefactos como entrega, no como adjunto perdido","fr":"Les artefacts comme livraison, pas comme pièce jointe perdue"},"lead":{"pt":"Um artefato útil mantém nome, tipo, preview e ação próximos do contexto que o gerou.","en":"A useful artifact keeps name, type, preview, and action close to the context that generated it.","es":"Un artefacto útil mantiene nombre, tipo, preview y acción cerca del contexto que lo generó.","fr":"Un artefact utile garde nom, type, aperçu et action proches du contexte qui l’a généré."},"date":"2026-08-12","read":2,"blocks":[{"title":{"pt":"A conversa explica o porquê","en":"The conversation explains why","es":"La conversación explica el porqué","fr":"La conversation explique pourquoi"},"body":[{"pt":"O arquivo sozinho diz pouco sobre escolhas e restrições. Quando o artefato continua ligado à mensagem que o produziu, revisão e edição ganham contexto.","en":"A file alone says little about choices and constraints. When the artifact remains linked to the message that produced it, review and editing gain context.","es":"Un archivo por sí solo dice poco sobre elecciones y restricciones. Cuando el artefacto sigue ligado al mensaje que lo produjo, la revisión y edición ganan contexto.","fr":"Un fichier seul dit peu sur les choix et contraintes. Lorsque l’artefact reste lié au message qui l’a produit, la révision et l’édition gagnent du contexte."}]},{"title":{"pt":"O card precisa responder","en":"The card should answer","es":"La tarjeta debe responder","fr":"La carte doit répondre"},"bullets":[{"pt":"O que é?","en":"What is it?","es":"¿Qué es?","fr":"Qu’est-ce que c’est ?"},{"pt":"Posso abrir ou baixar?","en":"Can I open or download it?","es":"¿Puedo abrirlo o descargarlo?","fr":"Puis-je l’ouvrir ou le télécharger ?"},{"pt":"Há uma prévia útil?","en":"Is there a useful preview?","es":"¿Hay un preview útil?","fr":"Y a-t-il un aperçu utile ?"},{"pt":"De onde veio?","en":"Where did it come from?","es":"¿De dónde vino?","fr":"D’où vient-il ?"}]},{"title":{"pt":"Entrega melhor","en":"Better handoff","es":"Mejor entrega","fr":"Meilleure livraison"},"body":[{"pt":"Essa estrutura deixa o artefato funcionar como resultado verificável em vez de mais um item numa lista de downloads.","en":"That structure lets the artifact work as a verifiable result instead of another item in a download list.","es":"Esa estructura permite que el artefacto funcione como resultado verificable en lugar de otro elemento en una lista de descargas.","fr":"Cette structure permet à l’artefact de fonctionner comme résultat vérifiable plutôt que comme élément de plus dans une liste de téléchargements."}]},{"title":{"pt":"Entrega precisa sobreviver à conversa","en":"Delivery needs to outlive the conversation","es":"La entrega debe sobrevivir a la conversación","fr":"La livraison doit survivre à la conversation"},"body":[{"pt":"Um artefato útil pode ser aberto, revisado, compartilhado e retomado sem depender de encontrar a mensagem exata que o gerou. Separar a entrega da conversa transforma uma resposta em algo que continua utilizável depois.","en":"A useful artifact can be opened, reviewed, shared, and resumed without finding the exact message that created it. Separating delivery from conversation turns a response into something that remains usable afterward.","es":"Un artefacto útil puede abrirse, revisarse, compartirse y retomarse sin encontrar el mensaje exacto que lo creó. Separar la entrega de la conversación transforma una respuesta en algo que sigue siendo utilizable después.","fr":"Un artefact utile peut être ouvert, revu, partagé et repris sans retrouver le message exact qui l’a créé. Séparer la livraison de la conversation transforme une réponse en quelque chose qui reste utilisable ensuite."}]},{"title":{"pt":"Como Artefato é fronteira de entrega deixa de ser só interface","en":"How Artifacts as handoff, not a lost attachment becomes more than interface","es":"Cómo Artefactos como entrega, no como adjunto perdido deja de ser solo interfaz","fr":"Comment Les artefacts comme livraison, pas comme pièce jointe perdue dépasse la simple interface"},"body":[{"pt":"Um artefato útil tem nome, tipo, versão e relação clara com a tarefa que o produziu. Ele deve sobreviver à conversa e poder ser reaberto sem depender de lembrar qual mensagem continha o link.","en":"The useful way to read “Artifacts as handoff, not a lost attachment” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Artefactos como entrega, no como adjunto perdido» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Les artefacts comme livraison, pas comme pièce jointe perdue » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"arquivo é real e reabrível","en":"arquivo é real e reabrível","es":"arquivo é real e reabrível","fr":"arquivo é real e reabrível"},{"pt":"origem e validação ficam associadas","en":"origem e validação ficam associadas","es":"origem e validação ficam associadas","fr":"origem e validação ficam associadas"},{"pt":"handoff não depende do transcript","en":"handoff não depende do transcript","es":"handoff não depende do transcript","fr":"handoff não depende do transcript"}]},{"title":{"pt":"Falha específica: Artefato é fronteira de entrega","en":"Specific failure mode: Artifacts as handoff, not a lost attachment","es":"Fallo específico: Artefactos como entrega, no como adjunto perdido","fr":"Mode de défaillance : Les artefacts comme livraison, pas comme pièce jointe perdue"},"body":[{"pt":"O risco é criar um arquivo correto e deixá-lo perdido como efeito colateral do chat.","en":"The failure mode to watch in “Artifacts as handoff, not a lost attachment” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Artefactos como entrega, no como adjunto perdido» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Les artefacts comme livraison, pas comme pièce jointe perdue » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Artefato é fronteira de entrega","en":"Evidence that closes Artifacts as handoff, not a lost attachment","es":"Evidencia que cierra Artefactos como entrega, no como adjunto perdido","fr":"Preuve qui valide Les artefacts comme livraison, pas comme pièce jointe perdue"},"body":[{"pt":"O handoff forte inclui preview quando faz sentido, download real, origem, estado de validação e possibilidade de continuar trabalhando a partir do mesmo objeto.","en":"For “Artifacts as handoff, not a lost attachment”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Artefactos como entrega, no como adjunto perdido», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Les artefacts comme livraison, pas comme pièce jointe perdue », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"memory-visible-and-controlled","category":"memory","asset":"lockBraces","title":{"pt":"Memória visível e controlável","en":"Memory that is visible and controllable","es":"Memoria visible y controlable","fr":"Mémoire visible et contrôlable"},"lead":{"pt":"Lembrar preferências só é útil quando a pessoa consegue entender o que foi guardado e remover o que não serve mais.","en":"Remembering preferences is only useful when people can understand what was stored and remove what is no longer useful.","es":"Recordar preferencias solo es útil cuando la persona puede entender qué se guardó y eliminar lo que ya no sirve.","fr":"Mémoriser des préférences n’est utile que si la personne peut comprendre ce qui a été conservé et supprimer ce qui ne sert plus."},"date":"2026-08-11","read":2,"blocks":[{"title":{"pt":"Memória não deveria ser surpresa","en":"Memory should not be a surprise","es":"La memoria no debería ser una sorpresa","fr":"La mémoire ne devrait pas être une surprise"},"body":[{"pt":"Preferências duráveis podem reduzir repetição, mas só fazem sentido se o usuário souber que elas existem. A interface de Memórias serve para inspecionar e ajustar esse contexto.","en":"Durable preferences can reduce repetition, but only make sense if the user knows they exist. The Memories interface exists to inspect and adjust that context.","es":"Las preferencias duraderas pueden reducir repetición, pero solo tienen sentido si el usuario sabe que existen. La interfaz de Memorias sirve para inspeccionar y ajustar ese contexto.","fr":"Les préférences durables peuvent réduire la répétition, mais n’ont de sens que si l’utilisateur sait qu’elles existent. L’interface Mémoire sert à inspecter et ajuster ce contexte."}]},{"title":{"pt":"O que vale lembrar","en":"What is worth remembering","es":"Qué vale la pena recordar","fr":"Ce qui mérite d’être mémorisé"},"bullets":[{"pt":"Preferências de formato que se repetem.","en":"Formatting preferences that recur.","es":"Preferencias de formato recurrentes.","fr":"Préférences de format récurrentes."},{"pt":"Contexto estável de projetos quando apropriado.","en":"Stable project context when appropriate.","es":"Contexto estable de proyectos cuando corresponda.","fr":"Contexte de projet stable lorsque pertinent."},{"pt":"Restrições que mudam respostas futuras de forma consistente.","en":"Constraints that consistently change future answers.","es":"Restricciones que cambian de forma consistente respuestas futuras.","fr":"Contraintes qui modifient de manière cohérente les réponses futures."}]},{"title":{"pt":"Controle inclui esquecer","en":"Control includes forgetting","es":"El control incluye olvidar","fr":"Le contrôle inclut l’oubli"},"body":[{"pt":"Uma memória antiga ou errada precisa poder ser removida. Persistência sem remoção não é personalização; é acúmulo.","en":"An old or incorrect memory must be removable. Persistence without removal is not personalization; it is accumulation.","es":"Una memoria antigua o incorrecta debe poder eliminarse. Persistencia sin eliminación no es personalización; es acumulación.","fr":"Une mémoire ancienne ou incorrecte doit pouvoir être supprimée. La persistance sans suppression n’est pas de la personnalisation ; c’est de l’accumulation."}]},{"title":{"pt":"Memória útil também precisa de limites","en":"Useful memory also needs boundaries","es":"La memoria útil también necesita límites","fr":"Une mémoire utile a aussi besoin de limites"},"body":[{"pt":"Memória melhora continuidade quando o usuário consegue entender o que foi lembrado e corrigir o que não deveria continuar influenciando respostas. Persistência invisível pode economizar cliques, mas cobra o preço em previsibilidade.","en":"Memory improves continuity when users can understand what was remembered and correct what should no longer influence responses. Invisible persistence may save clicks, but it costs predictability.","es":"La memoria mejora la continuidad cuando el usuario puede entender qué se recordó y corregir lo que ya no debería influir en las respuestas. La persistencia invisible puede ahorrar clics, pero cuesta previsibilidad.","fr":"La mémoire améliore la continuité lorsque l’utilisateur peut comprendre ce qui a été retenu et corriger ce qui ne devrait plus influencer les réponses. Une persistance invisible peut économiser des clics, mais elle coûte en prévisibilité."}]},{"title":{"pt":"O que merece permanecer","en":"What deserves to persist","es":"What deserves to persist","fr":"What deserves to persist"},"body":[{"pt":"Em “Memória visível e controlável”, a ideia só vira valor quando aparece no fluxo real. Lembrar preferências só é útil quando a pessoa consegue entender o que foi guardado e remover o que não serve mais. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Memory that is visible and controllable”, the idea only becomes valuable when it appears in the real workflow. Remembering preferences is only useful when people can understand what was stored and remove what is no longer useful. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Memory that is visible and controllable”, the idea only becomes valuable when it appears in the real workflow. Remembering preferences is only useful when people can understand what was stored and remove what is no longer useful. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Memory that is visible and controllable”, the idea only becomes valuable when it appears in the real workflow. Remembering preferences is only useful when people can understand what was stored and remove what is no longer useful. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Por dentro de Memória precisa de provenance e controle","en":"Inside Memory that is visible and controllable","es":"Por dentro de Memoria visible y controlable","fr":"Au cœur de Mémoire visible et contrôlable"},"body":[{"pt":"Guardar tudo cria um modelo de usuário barulhento e potencialmente invasivo. Memória útil promove apenas informações duráveis e relevantes, com categoria, origem e possibilidade de remover ou corrigir.","en":"The useful way to read “Memory that is visible and controllable” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Memoria visible y controlable» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Mémoire visible et contrôlable » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"promoção exige informação durável","en":"promoção exige informação durável","es":"promoção exige informação durável","fr":"promoção exige informação durável"},{"pt":"origem e confiança permanecem rastreáveis","en":"origem e confiança permanecem rastreáveis","es":"origem e confiança permanecem rastreáveis","fr":"origem e confiança permanecem rastreáveis"},{"pt":"usuário pode remover ou corrigir","en":"usuário pode remover ou corrigir","es":"usuário pode remover ou corrigir","fr":"usuário pode remover ou corrigir"}]},{"title":{"pt":"Falha específica: Memória precisa de provenance e controle","en":"Specific failure mode: Memory that is visible and controllable","es":"Fallo específico: Memoria visible y controlable","fr":"Mode de défaillance : Mémoire visible et contrôlable"},"body":[{"pt":"O risco é transformar inferência em fato pessoal ou reutilizar contexto de um projeto em outro.","en":"The failure mode to watch in “Memory that is visible and controllable” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Memoria visible y controlable» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Mémoire visible et contrôlable » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Memória precisa de provenance e controle","en":"Evidence that closes Memory that is visible and controllable","es":"Evidencia que cierra Memoria visible y controlable","fr":"Preuve qui valide Mémoire visible et contrôlable"},"body":[{"pt":"O sistema deve separar memória global de contexto de projeto, registrar confiança e usar a memória silenciosamente apenas quando ela realmente muda a resposta.","en":"For “Memory that is visible and controllable”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Memoria visible y controlable», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Mémoire visible et contrôlable », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"plugins-as-capabilities","category":"plugins","asset":"cloudHand","title":{"pt":"Plugins como capacidades reconhecíveis","en":"Plugins as recognizable capabilities","es":"Plugins como capacidades reconocibles","fr":"Plugins comme capacités reconnaissables"},"lead":{"pt":"Catálogo, instalação e estado ficam mais úteis quando a interface explica o que cada plugin acrescenta ao trabalho.","en":"Catalog, installation, and state become more useful when the interface explains what each plugin adds to the work.","es":"Catálogo, instalación y estado son más útiles cuando la interfaz explica qué aporta cada plugin al trabajo.","fr":"Catalogue, installation et état deviennent plus utiles lorsque l’interface explique ce que chaque plugin ajoute au travail."},"date":"2026-08-10","read":2,"blocks":[{"title":{"pt":"Descoberta antes de instalação","en":"Discovery before installation","es":"Descubrimiento antes de instalación","fr":"Découverte avant installation"},"body":[{"pt":"Um catálogo de plugins precisa ser navegável por categoria e intenção. A pessoa deveria entender em uma frase por que aquilo existe antes de decidir instalar.","en":"A plugin catalog should be navigable by category and intent. People should understand in one sentence why something exists before deciding to install it.","es":"Un catálogo de plugins debe navegarse por categoría e intención. La persona debería entender en una frase por qué existe antes de decidir instalarlo.","fr":"Un catalogue de plugins doit être navigable par catégorie et intention. Une personne devrait comprendre en une phrase pourquoi un plugin existe avant de l’installer."}]},{"title":{"pt":"Estados claros","en":"Clear states","es":"Estados claros","fr":"États clairs"},"bullets":[{"pt":"Disponível.","en":"Available.","es":"Disponible.","fr":"Disponible."},{"pt":"Instalado.","en":"Installed.","es":"Instalado.","fr":"Installé."},{"pt":"Configurado ou aguardando configuração, quando aplicável.","en":"Configured or awaiting configuration, when applicable.","es":"Configurado o pendiente de configuración, cuando corresponda.","fr":"Configuré ou en attente de configuration, le cas échéant."}]},{"title":{"pt":"Capacidade não é ruído","en":"Capability is not noise","es":"La capacidad no es ruido","fr":"La capacité n’est pas du bruit"},"body":[{"pt":"Plugins devem ampliar o que o Giorgio consegue fazer sem transformar cada prompt em uma tela de configuração. Descoberta pode ser rica; uso precisa continuar simples.","en":"Plugins should extend what Giorgio can do without turning every prompt into a configuration screen. Discovery can be rich; use should remain simple.","es":"Los plugins deben ampliar lo que Giorgio puede hacer sin convertir cada prompt en una pantalla de configuración. El descubrimiento puede ser rico; el uso debe seguir siendo simple.","fr":"Les plugins doivent étendre ce que Giorgio peut faire sans transformer chaque prompt en écran de configuration. La découverte peut être riche ; l’usage doit rester simple."}]},{"title":{"pt":"Capacidades precisam ser legíveis","en":"Capabilities need to be legible","es":"Las capacidades deben ser legibles","fr":"Les capacités doivent être lisibles"},"body":[{"pt":"Plugins funcionam melhor quando o usuário entende rapidamente o que cada integração pode ler, produzir ou alterar. Uma lista enorme de nomes sem contexto parece poderosa, mas transfere para o usuário o trabalho de descobrir a ferramenta certa.","en":"Plugins work best when users can quickly understand what each integration can read, produce, or modify. A huge list of names without context looks powerful but pushes the work of finding the right tool back onto the user.","es":"Los plugins funcionan mejor cuando el usuario entiende rápidamente qué puede leer, producir o modificar cada integración. Una enorme lista de nombres sin contexto parece poderosa, pero devuelve al usuario el trabajo de encontrar la herramienta correcta.","fr":"Les plugins fonctionnent mieux lorsque l’utilisateur comprend rapidement ce que chaque intégration peut lire, produire ou modifier. Une immense liste de noms sans contexte semble puissante, mais renvoie à l’utilisateur le travail de trouver le bon outil."}]},{"title":{"pt":"Capacidade sem opacidade","en":"Capability without opacity","es":"Capability without opacity","fr":"Capability without opacity"},"body":[{"pt":"Em “Plugins como capacidades reconhecíveis”, a ideia só vira valor quando aparece no fluxo real. Catálogo, instalação e estado ficam mais úteis quando a interface explica o que cada plugin acrescenta ao trabalho. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Plugins as recognizable capabilities”, the idea only becomes valuable when it appears in the real workflow. Catalog, installation, and state become more useful when the interface explains what each plugin adds to the work. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Plugins as recognizable capabilities”, the idea only becomes valuable when it appears in the real workflow. Catalog, installation, and state become more useful when the interface explains what each plugin adds to the work. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Plugins as recognizable capabilities”, the idea only becomes valuable when it appears in the real workflow. Catalog, installation, and state become more useful when the interface explains what each plugin adds to the work. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"A parte difícil de Plugin deve parecer capacidade, não catálogo","en":"The hard part of Plugins as recognizable capabilities","es":"La parte difícil de Plugins como capacidades reconocibles","fr":"La partie difficile de Plugins comme capacités reconnaissables"},"body":[{"pt":"Uma lista enorme de plugins não ajuda se o usuário não entende quando cada um entra no fluxo. O produto precisa mapear capacidade, permissão, entrada e saída, e acionar ferramentas quando a tarefa pede.","en":"The useful way to read “Plugins as recognizable capabilities” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Plugins como capacidades reconocibles» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Plugins comme capacités reconnaissables » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"capacidade tem ferramenta real por trás","en":"capacidade tem ferramenta real por trás","es":"capacidade tem ferramenta real por trás","fr":"capacidade tem ferramenta real por trás"},{"pt":"permissão é resolvida antes da ação","en":"permissão é resolvida antes da ação","es":"permissão é resolvida antes da ação","fr":"permissão é resolvida antes da ação"},{"pt":"resultado da ferramenta é observável","en":"resultado da ferramenta é observável","es":"resultado da ferramenta é observável","fr":"resultado da ferramenta é observável"}]},{"title":{"pt":"Falha específica: Plugin deve parecer capacidade, não catálogo","en":"Specific failure mode: Plugins as recognizable capabilities","es":"Fallo específico: Plugins como capacidades reconocibles","fr":"Mode de défaillance : Plugins comme capacités reconnaissables"},"body":[{"pt":"O risco é exibir dezenas de integrações “instaladas” sem ação real por trás ou deixar o modelo afirmar que usou uma ferramenta que nunca foi chamada.","en":"The failure mode to watch in “Plugins as recognizable capabilities” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Plugins como capacidades reconocibles» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Plugins comme capacités reconnaissables » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Plugin deve parecer capacidade, não catálogo","en":"Evidence that closes Plugins as recognizable capabilities","es":"Evidencia que cierra Plugins como capacidades reconocibles","fr":"Preuve qui valide Plugins comme capacités reconnaissables"},"body":[{"pt":"O contrato bom exige ferramenta invocável, resultado observável e fallback claro quando a integração não está disponível.","en":"For “Plugins as recognizable capabilities”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Plugins como capacidades reconocibles», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Plugins comme capacités reconnaissables », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"attachments-as-evidence","category":"files","asset":"site","title":{"pt":"Anexos como evidência prioritária","en":"Attachments as first-class evidence","es":"Adjuntos como evidencia prioritaria","fr":"Pièces jointes comme preuves prioritaires"},"lead":{"pt":"Quando um arquivo é fornecido, a melhor resposta começa lendo o material em vez de adivinhar pelo nome.","en":"When a file is provided, the best answer starts by reading the material instead of guessing from its name.","es":"Cuando se proporciona un archivo, la mejor respuesta empieza leyendo el material en lugar de adivinar por el nombre.","fr":"Lorsqu’un fichier est fourni, la meilleure réponse commence par lire le contenu plutôt que deviner à partir du nom."},"date":"2026-08-09","read":2,"blocks":[{"title":{"pt":"O arquivo muda a prioridade","en":"The file changes priority","es":"El archivo cambia la prioridad","fr":"Le fichier change la priorité"},"body":[{"pt":"Se o pedido depende do conteúdo anexado, esse conteúdo deve ser a base. Conhecimento geral entra apenas para explicar, comparar ou ampliar quando o usuário pede.","en":"If the request depends on attached content, that content should be the basis. General knowledge enters only to explain, compare, or expand when requested.","es":"Si la solicitud depende del contenido adjunto, ese contenido debe ser la base. El conocimiento general entra solo para explicar, comparar o ampliar cuando se solicita.","fr":"Si la demande dépend du contenu joint, ce contenu doit servir de base. Les connaissances générales n’interviennent que pour expliquer, comparer ou élargir lorsque demandé."}]},{"title":{"pt":"Fluxo saudável","en":"A healthy flow","es":"Un flujo sano","fr":"Un flux sain"},"bullets":[{"pt":"Identificar o tipo do arquivo.","en":"Identify the file type.","es":"Identificar el tipo de archivo.","fr":"Identifier le type de fichier."},{"pt":"Extrair ou ler o conteúdo disponível.","en":"Extract or read available content.","es":"Extraer o leer el contenido disponible.","fr":"Extraire ou lire le contenu disponible."},{"pt":"Responder distinguindo o que veio do arquivo do que foi inferido.","en":"Answer while distinguishing file-derived material from inference.","es":"Responder distinguiendo lo que viene del archivo de lo inferido.","fr":"Répondre en distinguant ce qui vient du fichier de ce qui est inféré."}]},{"title":{"pt":"Miniatura não é leitura","en":"A thumbnail is not reading","es":"Una miniatura no es lectura","fr":"Une miniature n’est pas une lecture"},"body":[{"pt":"Mostrar um card bonito não significa que o conteúdo foi compreendido. O pipeline de anexos precisa alimentar de verdade a solicitação enviada ao modelo.","en":"Showing a pretty card does not mean the content was understood. The attachment pipeline must actually feed the material into the request sent to the model.","es":"Mostrar una tarjeta bonita no significa que el contenido se entendió. El pipeline de adjuntos debe alimentar de verdad el material en la solicitud enviada al modelo.","fr":"Afficher une jolie carte ne signifie pas que le contenu a été compris. Le pipeline de pièces jointes doit réellement fournir le contenu à la requête envoyée au modèle."}]},{"title":{"pt":"O arquivo é a fonte primária","en":"The file is the primary source","es":"El archivo es la fuente primaria","fr":"Le fichier est la source primaire"},"body":[{"pt":"Quando a tarefa depende de um documento, log, planilha ou código anexado, o conteúdo real deve vencer qualquer suposição baseada no nome do arquivo. Ler primeiro também evita respostas que parecem específicas, mas foram construídas apenas a partir do título ou de um trecho incompleto.","en":"When a task depends on an attached document, log, spreadsheet, or code file, the real content should outrank any assumption based on the filename. Reading first also avoids answers that sound specific but were built only from a title or an incomplete excerpt.","es":"Cuando una tarea depende de un documento, log, hoja de cálculo o archivo de código adjunto, el contenido real debe superar cualquier suposición basada en el nombre. Leer primero también evita respuestas que parecen específicas pero se construyeron solo a partir del título o de un fragmento incompleto.","fr":"Lorsqu’une tâche dépend d’un document, journal, tableur ou fichier de code joint, le contenu réel doit primer sur toute hypothèse fondée sur le nom du fichier. Lire d’abord évite aussi les réponses qui semblent précises mais reposent seulement sur un titre ou un extrait incomplet."}]},{"title":{"pt":"Evidência antes de inferência","en":"Evidence before inference","es":"Evidence before inference","fr":"Evidence before inference"},"body":[{"pt":"Em “Anexos como evidência prioritária”, a ideia só vira valor quando aparece no fluxo real. Quando um arquivo é fornecido, a melhor resposta começa lendo o material em vez de adivinhar pelo nome. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Attachments as first-class evidence”, the idea only becomes valuable when it appears in the real workflow. When a file is provided, the best answer starts by reading the material instead of guessing from its name. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Attachments as first-class evidence”, the idea only becomes valuable when it appears in the real workflow. When a file is provided, the best answer starts by reading the material instead of guessing from its name. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Attachments as first-class evidence”, the idea only becomes valuable when it appears in the real workflow. When a file is provided, the best answer starts by reading the material instead of guessing from its name. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"O contrato escondido em Anexo deve vencer contexto genérico","en":"The hidden contract in Attachments as first-class evidence","es":"El contrato oculto de Adjuntos como evidencia prioritaria","fr":"Le contrat caché de Pièces jointes comme preuves prioritaires"},"body":[{"pt":"Se o usuário envia um arquivo e pergunta sobre ele, esse conteúdo precisa ser a base da resposta. Conhecimento geral pode expandir ou comparar, mas não substituir silenciosamente o material enviado.","en":"The useful way to read “Attachments as first-class evidence” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Adjuntos como evidencia prioritaria» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Pièces jointes comme preuves prioritaires » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"o arquivo correto é lido antes da conclusão","en":"o arquivo correto é lido antes da conclusão","es":"o arquivo correto é lido antes da conclusão","fr":"o arquivo correto é lido antes da conclusão"},{"pt":"proveniência continua ligada à afirmação","en":"proveniência continua ligada à afirmação","es":"proveniência continua ligada à afirmação","fr":"proveniência continua ligada à afirmação"},{"pt":"leitura cresce apenas quando a tarefa exige","en":"leitura cresce apenas quando a tarefa exige","es":"leitura cresce apenas quando a tarefa exige","fr":"leitura cresce apenas quando a tarefa exige"}]},{"title":{"pt":"Falha específica: Anexo deve vencer contexto genérico","en":"Specific failure mode: Attachments as first-class evidence","es":"Fallo específico: Adjuntos como evidencia prioritaria","fr":"Mode de défaillance : Pièces jointes comme preuves prioritaires"},"body":[{"pt":"O risco é usar um snippet parcial e responder sobre seções que nunca foram lidas.","en":"The failure mode to watch in “Attachments as first-class evidence” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Adjuntos como evidencia prioritaria» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Pièces jointes comme preuves prioritaires » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Anexo deve vencer contexto genérico","en":"Evidence that closes Attachments as first-class evidence","es":"Evidencia que cierra Adjuntos como evidencia prioritaria","fr":"Preuve qui valide Pièces jointes comme preuves prioritaires"},"body":[{"pt":"O agente deve localizar a parte relevante, expandir leitura quando necessário e distinguir claramente o que vem do arquivo do que vem de pesquisa externa ou inferência.","en":"For “Attachments as first-class evidence”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Adjuntos como evidencia prioritaria», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Pièces jointes comme preuves prioritaires », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"image-input-as-context","category":"vision","asset":"site","title":{"pt":"Imagem como contexto, não só como decoração no prompt","en":"Images as context, not just decoration in the prompt","es":"Imagen como contexto, no solo decoración en el prompt","fr":"L’image comme contexte, pas seulement décoration dans le prompt"},"lead":{"pt":"Uma entrada visual útil precisa chegar ao modelo junto com a pergunta e manter relação clara com a mensagem.","en":"A useful visual input needs to reach the model together with the question and maintain a clear relationship with the message.","es":"Una entrada visual útil debe llegar al modelo junto con la pregunta y mantener una relación clara con el mensaje.","fr":"Une entrée visuelle utile doit parvenir au modèle avec la question et conserver une relation claire avec le message."},"date":"2026-08-08","read":2,"blocks":[{"title":{"pt":"Ver antes de responder","en":"See before answering","es":"Ver antes de responder","fr":"Voir avant de répondre"},"body":[{"pt":"O usuário pode apontar para detalhe de uma captura, comparar imagens ou pedir leitura de um gráfico. Nesses casos, a imagem faz parte da evidência principal da pergunta.","en":"A user may point to a detail in a screenshot, compare images, or ask for a chart reading. In those cases, the image is part of the primary evidence of the question.","es":"El usuario puede señalar un detalle de una captura, comparar imágenes o pedir lectura de un gráfico. En esos casos, la imagen forma parte de la evidencia principal.","fr":"L’utilisateur peut pointer un détail d’une capture, comparer des images ou demander la lecture d’un graphique. Dans ces cas, l’image fait partie des preuves principales de la question."}]},{"title":{"pt":"A interface precisa manter a ligação","en":"The interface should preserve the link","es":"La interfaz debe mantener el vínculo","fr":"L’interface doit préserver le lien"},"bullets":[{"pt":"Preview do anexo perto da mensagem.","en":"Attachment preview near the message.","es":"Preview del adjunto cerca del mensaje.","fr":"Aperçu de la pièce jointe près du message."},{"pt":"Estado claro de carregamento ou falha.","en":"Clear loading or failure state.","es":"Estado claro de carga o fallo.","fr":"État clair de chargement ou d’échec."},{"pt":"Possibilidade de remover antes de enviar.","en":"Ability to remove it before sending.","es":"Posibilidad de eliminarla antes de enviar.","fr":"Possibilité de la retirer avant l’envoi."}]},{"title":{"pt":"Resposta ancorada","en":"Grounded response","es":"Respuesta anclada","fr":"Réponse ancrée"},"body":[{"pt":"Quando a pergunta depende da imagem, a resposta deve refletir o que realmente está visível e sinalizar limites quando algo não pode ser lido com segurança.","en":"When the question depends on the image, the answer should reflect what is actually visible and signal limits when something cannot be read reliably.","es":"Cuando la pregunta depende de la imagen, la respuesta debe reflejar lo que realmente se ve y señalar límites cuando algo no puede leerse con seguridad.","fr":"Lorsque la question dépend de l’image, la réponse doit refléter ce qui est réellement visible et signaler les limites lorsqu’un élément ne peut pas être lu de manière fiable."}]},{"title":{"pt":"Imagem precisa entrar como evidência","en":"An image should enter as evidence","es":"La imagen debe entrar como evidencia","fr":"L’image doit entrer comme preuve"},"body":[{"pt":"Quando uma captura, diagrama ou foto é relevante para a tarefa, a análise precisa partir do que está visível nela e não apenas do texto ao redor. O ganho real aparece quando a imagem muda o diagnóstico, a explicação ou a decisão.","en":"When a screenshot, diagram, or photo matters to the task, analysis should start from what is visible in it rather than only the surrounding text. The real gain appears when the image changes the diagnosis, explanation, or decision.","es":"Cuando una captura, diagrama o foto es relevante para la tarea, el análisis debe partir de lo visible y no solo del texto alrededor. La ganancia real aparece cuando la imagen cambia el diagnóstico, la explicación o la decisión.","fr":"Lorsqu’une capture, un diagramme ou une photo compte pour la tâche, l’analyse doit partir de ce qui est visible et pas seulement du texte autour. Le véritable gain apparaît lorsque l’image change le diagnostic, l’explication ou la décision."}]},{"title":{"pt":"O que a imagem realmente prova","en":"What the image actually proves","es":"What the image actually proves","fr":"What the image actually proves"},"body":[{"pt":"Em “Imagem como contexto, não só como decoração no prompt”, a ideia só vira valor quando aparece no fluxo real. Uma entrada visual útil precisa chegar ao modelo junto com a pergunta e manter relação clara com a mensagem. O teste final é simples: a pessoa entende o estado atual, sabe qual é o próximo passo e consegue confirmar se o resultado corresponde ao que pediu.","en":"In “Images as context, not just decoration in the prompt”, the idea only becomes valuable when it appears in the real workflow. A useful visual input needs to reach the model together with the question and maintain a clear relationship with the message. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","es":"In “Images as context, not just decoration in the prompt”, the idea only becomes valuable when it appears in the real workflow. A useful visual input needs to reach the model together with the question and maintain a clear relationship with the message. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request.","fr":"In “Images as context, not just decoration in the prompt”, the idea only becomes valuable when it appears in the real workflow. A useful visual input needs to reach the model together with the question and maintain a clear relationship with the message. The final test is simple: the person understands the current state, knows the next step, and can confirm whether the result matches the request."}],"bullets":[{"pt":"teste o caminho feliz e pelo menos um estado de falha","en":"test the happy path and at least one failure state","es":"test the happy path and at least one failure state","fr":"test the happy path and at least one failure state"},{"pt":"mantenha feedback visível durante espera, fallback ou revisão","en":"keep feedback visible during waiting, fallback, or review","es":"keep feedback visible during waiting, fallback, or review","fr":"keep feedback visible during waiting, fallback, or review"},{"pt":"encerre com evidência observável, não apenas com uma afirmação de sucesso","en":"finish with observable evidence, not merely a claim of success","es":"finish with observable evidence, not merely a claim of success","fr":"finish with observable evidence, not merely a claim of success"}]},{"title":{"pt":"Onde Imagem carrega layout, estado e evidência realmente ganha qualidade","en":"Where Images as context, not just decoration in the prompt actually gains quality","es":"Dónde Imagen como contexto, no solo decoración en el prompt realmente gana calidad","fr":"Là où L’image comme contexte, pas seulement décoration dans le prompt gagne vraiment en qualité"},"body":[{"pt":"Uma screenshot não é só “uma imagem”: ela revela hierarquia, recorte, densidade, labels, estado de erro, relação entre painéis e muitas vezes a causa de uma regressão visual.","en":"The useful way to read “Images as context, not just decoration in the prompt” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Imagen como contexto, no solo decoración en el prompt» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « L’image comme contexte, pas seulement décoration dans le prompt » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"observação visual vira requisito verificável","en":"observação visual vira requisito verificável","es":"observação visual vira requisito verificável","fr":"observação visual vira requisito verificável"},{"pt":"inferência não ultrapassa o que a imagem mostra","en":"inferência não ultrapassa o que a imagem mostra","es":"inferência não ultrapassa o que a imagem mostra","fr":"inferência não ultrapassa o que a imagem mostra"},{"pt":"crop e escala são avaliados por breakpoint","en":"crop e escala são avaliados por breakpoint","es":"crop e escala são avaliados por breakpoint","fr":"crop e escala são avaliados por breakpoint"}]},{"title":{"pt":"Falha específica: Imagem carrega layout, estado e evidência","en":"Specific failure mode: Images as context, not just decoration in the prompt","es":"Fallo específico: Imagen como contexto, no solo decoración en el prompt","fr":"Mode de défaillance : L’image comme contexte, pas seulement décoration dans le prompt"},"body":[{"pt":"O risco é descrever pixels sem conectar a observação ao comportamento pedido, ou inferir informação invisível na captura.","en":"The failure mode to watch in “Images as context, not just decoration in the prompt” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Imagen como contexto, no solo decoración en el prompt» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « L’image comme contexte, pas seulement décoration dans le prompt » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Imagem carrega layout, estado e evidência","en":"Evidence that closes Images as context, not just decoration in the prompt","es":"Evidencia que cierra Imagen como contexto, no solo decoración en el prompt","fr":"Preuve qui valide L’image comme contexte, pas seulement décoration dans le prompt"},"body":[{"pt":"O uso correto transforma observações visuais em requisitos verificáveis e, em tarefas de UI, alimenta o loop de implementação e comparação.","en":"For “Images as context, not just decoration in the prompt”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Imagen como contexto, no solo decoración en el prompt», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « L’image comme contexte, pas seulement décoration dans le prompt », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"settings-with-progressive-disclosure","category":"settings","asset":"site","title":{"pt":"Configurações sem virar depósito de recurso","en":"Settings without becoming a feature warehouse","es":"Configuración sin convertirse en almacén de funciones","fr":"Des réglages sans devenir un entrepôt de fonctions"},"lead":{"pt":"Agrupar conta, privacidade, capacidades, memórias e personalização por intenção reduz a sensação de painel infinito.","en":"Grouping account, privacy, capabilities, memories, and personalization by intent reduces the feeling of an endless panel.","es":"Agrupar cuenta, privacidad, capacidades, memorias y personalización por intención reduce la sensación de panel infinito.","fr":"Regrouper compte, confidentialité, capacités, mémoires et personnalisation par intention réduit l’impression de panneau sans fin."},"date":"2026-08-07","read":1,"blocks":[{"title":{"pt":"Uma configuração deve responder “por quê”","en":"A setting should answer “why”","es":"Una configuración debe responder “por qué”","fr":"Un réglage doit répondre « pourquoi »"},"body":[{"pt":"A pessoa entra em Configurações para resolver algo: mudar aparência, administrar dados, controlar memória, revisar capacidades ou ajustar a conta. A arquitetura deve seguir essas intenções.","en":"People enter Settings to solve something: change appearance, manage data, control memory, review capabilities, or adjust the account. Architecture should follow those intents.","es":"La persona entra en Configuración para resolver algo: cambiar apariencia, administrar datos, controlar memoria, revisar capacidades o ajustar la cuenta. La arquitectura debe seguir esas intenciones.","fr":"On ouvre les Réglages pour résoudre quelque chose : changer l’apparence, gérer les données, contrôler la mémoire, examiner les capacités ou ajuster le compte. L’architecture doit suivre ces intentions."}]},{"title":{"pt":"Progressive disclosure","en":"Progressive disclosure","es":"Divulgación progresiva","fr":"Divulgation progressive"},"body":[{"pt":"Opções avançadas podem existir sem ocupar a primeira tela. Mostrar primeiro o que é comum e aprofundar quando necessário mantém o painel legível.","en":"Advanced options can exist without taking over the first screen. Showing common controls first and going deeper when needed keeps the panel readable.","es":"Las opciones avanzadas pueden existir sin ocupar la primera pantalla. Mostrar primero lo común y profundizar cuando sea necesario mantiene el panel legible.","fr":"Les options avancées peuvent exister sans occuper le premier écran. Montrer d’abord les réglages courants puis approfondir si nécessaire garde le panneau lisible."}]},{"title":{"pt":"Consistência","en":"Consistency","es":"Consistencia","fr":"Cohérence"},"bullets":[{"pt":"Mesma linguagem de cards e divisórias.","en":"Same card and divider language.","es":"Mismo lenguaje de tarjetas y divisores.","fr":"Même langage de cartes et séparateurs."},{"pt":"Descrições curtas para efeitos menos óbvios.","en":"Short descriptions for less obvious effects.","es":"Descripciones cortas para efectos menos obvios.","fr":"Descriptions courtes pour les effets moins évidents."},{"pt":"Ações destrutivas separadas visualmente.","en":"Destructive actions visually separated.","es":"Acciones destructivas separadas visualmente.","fr":"Actions destructives visuellement séparées."}]},{"title":{"pt":"Configuração boa aparece na hora certa","en":"Good settings appear at the right time","es":"Una buena configuración aparece en el momento correcto","fr":"Un bon réglage apparaît au bon moment"},"body":[{"pt":"Controles frequentes precisam ser fáceis de achar; opções raras podem ficar atrás de níveis mais profundos. Essa hierarquia evita transformar a tela de configurações em um inventário técnico onde tudo parece igualmente importante.","en":"Frequent controls should be easy to find; rare options can live deeper. That hierarchy keeps settings from becoming a technical inventory where everything looks equally important.","es":"Los controles frecuentes deben ser fáciles de encontrar; las opciones raras pueden quedar en niveles más profundos. Esa jerarquía evita convertir ajustes en un inventario técnico donde todo parece igualmente importante.","fr":"Les contrôles fréquents doivent être faciles à trouver ; les options rares peuvent rester plus profondes. Cette hiérarchie évite de transformer les réglages en inventaire technique où tout semble aussi important."}]},{"title":{"pt":"O mecanismo central de Configuração avançada precisa aparecer no momento certo","en":"The core mechanism of Settings without becoming a feature warehouse","es":"El mecanismo central de Configuración sin convertirse en almacén de funciones","fr":"Le mécanisme central de Des réglages sans devenir un entrepôt de fonctions"},"body":[{"pt":"Configurações acumulam opções de produto, modelo, privacidade e aparência. Sem hierarquia, o usuário precisa entender a arquitetura interna só para mudar uma preferência simples.","en":"The useful way to read “Settings without becoming a feature warehouse” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Configuración sin convertirse en almacén de funciones» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Des réglages sans devenir un entrepôt de fonctions » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"default simples primeiro","en":"default simples primeiro","es":"default simples primeiro","fr":"default simples primeiro"},{"pt":"opções avançadas aparecem sob demanda","en":"opções avançadas aparecem sob demanda","es":"opções avançadas aparecem sob demanda","fr":"opções avançadas aparecem sob demanda"},{"pt":"cada toggle persiste e altera comportamento","en":"cada toggle persiste e altera comportamento","es":"cada toggle persiste e altera comportamento","fr":"cada toggle persiste e altera comportamento"}]},{"title":{"pt":"Falha específica: Configuração avançada precisa aparecer no momento certo","en":"Specific failure mode: Settings without becoming a feature warehouse","es":"Fallo específico: Configuración sin convertirse en almacén de funciones","fr":"Mode de défaillance : Des réglages sans devenir un entrepôt de fonctions"},"body":[{"pt":"O risco é esconder opções importantes em submenus profundos ou deixar preferências que não alteram comportamento real.","en":"The failure mode to watch in “Settings without becoming a feature warehouse” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Configuración sin convertirse en almacén de funciones» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Des réglages sans devenir un entrepôt de fonctions » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Configuração avançada precisa aparecer no momento certo","en":"Evidence that closes Settings without becoming a feature warehouse","es":"Evidencia que cierra Configuración sin convertirse en almacén de funciones","fr":"Preuve qui valide Des réglages sans devenir un entrepôt de fonctions"},"body":[{"pt":"Progressive disclosure mantém defaults claros, agrupa por intenção e garante que cada controle tenha efeito persistente e reversível.","en":"For “Settings without becoming a feature warehouse”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Configuración sin convertirse en almacén de funciones», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Des réglages sans devenir un entrepôt de fonctions », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]}],"readingMinutes":{"pt":1,"en":2,"es":2,"fr":2}},{"slug":"responsive-code-workspace","category":"code","asset":"coding","title":{"pt":"Code no celular sem fingir que 390px são 1440px","en":"Code on mobile without pretending 390px is 1440px","es":"Code en móvil sin fingir que 390px son 1440px","fr":"Code sur mobile sans prétendre que 390px valent 1440px"},"lead":{"pt":"Uma coluna por vez é mais útil do que esmagar sidebar, editor, terminal e conversa lado a lado.","en":"One column at a time is more useful than crushing sidebar, editor, terminal, and conversation side by side.","es":"Una columna a la vez es más útil que aplastar sidebar, editor, terminal y conversación lado a lado.","fr":"Une colonne à la fois est plus utile que d’écraser sidebar, éditeur, terminal et conversation côte à côte."},"date":"2026-08-06","read":2,"blocks":[{"title":{"pt":"A prioridade muda","en":"Priority changes","es":"La prioridad cambia","fr":"La priorité change"},"body":[{"pt":"No desktop, múltiplos painéis podem coexistir. No celular, a mesma informação precisa virar navegação entre superfícies: sessão, arquivos, editor, terminal e preview.","en":"On desktop, multiple panels can coexist. On mobile, the same information needs to become navigation between surfaces: session, files, editor, terminal, and preview.","es":"En escritorio pueden coexistir varios paneles. En móvil, la misma información debe convertirse en navegación entre superficies: sesión, archivos, editor, terminal y preview.","fr":"Sur desktop, plusieurs panneaux peuvent coexister. Sur mobile, la même information doit devenir une navigation entre surfaces : session, fichiers, éditeur, terminal et aperçu."}]},{"title":{"pt":"Controles essenciais","en":"Essential controls","es":"Controles esenciales","fr":"Contrôles essentiels"},"bullets":[{"pt":"Botão de menu e retorno sempre alcançáveis.","en":"Menu and back actions always reachable.","es":"Botón de menú y regreso siempre accesibles.","fr":"Menu et retour toujours accessibles."},{"pt":"Composer fixado sem cobrir o conteúdo.","en":"Composer anchored without covering content.","es":"Composer fijo sin cubrir el contenido.","fr":"Composer fixé sans couvrir le contenu."},{"pt":"Drawers em tela cheia para arquivos e editor.","en":"Full-screen drawers for files and editor.","es":"Drawers de pantalla completa para archivos y editor.","fr":"Drawers plein écran pour fichiers et éditeur."}]},{"title":{"pt":"Responsivo não é miniatura","en":"Responsive is not miniature","es":"Responsivo no es miniatura","fr":"Réactif ne signifie pas miniature"},"body":[{"pt":"Reduzir tudo proporcionalmente deixa texto, hitboxes e controles inúteis. O layout mobile precisa reorganizar responsabilidades, não apenas encolher pixels.","en":"Scaling everything proportionally makes text, hitboxes, and controls useless. The mobile layout should reorganize responsibilities, not merely shrink pixels.","es":"Reducir todo proporcionalmente vuelve inútiles texto, áreas táctiles y controles. El layout móvil debe reorganizar responsabilidades, no solo encoger píxeles.","fr":"Réduire tout proportionnellement rend texte, zones tactiles et contrôles inutiles. Le layout mobile doit réorganiser les responsabilités, pas seulement réduire les pixels."}]},{"title":{"pt":"A engenharia por trás de Mobile exige outra composição, não miniaturização","en":"The engineering behind Code on mobile without pretending 390px is 1440px","es":"La ingeniería detrás de Code en móvil sin fingir que 390px son 1440px","fr":"L’ingénierie derrière Code sur mobile sans prétendre que 390px valent 1440px"},"body":[{"pt":"Um workspace de código com sidebar, árvore, editor, terminal e preview não cabe em 390px apenas reduzindo tudo. A interface precisa decidir qual superfície ocupa o foco e como o usuário troca entre elas.","en":"The useful way to read “Code on mobile without pretending 390px is 1440px” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Code en móvil sin fingir que 390px son 1440px» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Code sur mobile sans prétendre que 390px valent 1440px » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Mobile exige outra composição, não miniaturização","en":"Specific failure mode: Code on mobile without pretending 390px is 1440px","es":"Fallo específico: Code en móvil sin fingir que 390px son 1440px","fr":"Mode de défaillance : Code sur mobile sans prétendre que 390px valent 1440px"},"body":[{"pt":"O risco é manter painéis simultâneos, targets pequenos e viewport fixo enquanto teclado e safe area mudam a geometria.","en":"The failure mode to watch in “Code on mobile without pretending 390px is 1440px” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Code en móvil sin fingir que 390px son 1440px» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Code sur mobile sans prétendre que 390px valent 1440px » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Mobile exige outra composição, não miniaturização","en":"Evidence that closes Code on mobile without pretending 390px is 1440px","es":"Evidencia que cierra Code en móvil sin fingir que 390px son 1440px","fr":"Preuve qui valide Code sur mobile sans prétendre que 390px valent 1440px"},"body":[{"pt":"O desenho robusto usa navegação por superfícies, preserva estado ao trocar de painel e testa edição, terminal e preview com teclado aberto.","en":"For “Code on mobile without pretending 390px is 1440px”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Code en móvil sin fingir que 390px son 1440px», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Code sur mobile sans prétendre que 390px valent 1440px », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Code no celular sem fingir que 390px são 1440px”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Code on mobile without pretending 390px is 1440px”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Code en móvil sin fingir que 390px son 1440px”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Code sur mobile sans prétendre que 390px valent 1440px », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"diagnostics-people-can-act-on","category":"code","asset":"coding","title":{"pt":"Diagnósticos que alguém consegue usar","en":"Diagnostics people can act on","es":"Diagnósticos que alguien puede usar","fr":"Diagnostics sur lesquels on peut agir"},"lead":{"pt":"Erro bom informa contexto, localização e próximo passo em vez de apenas dizer que “não foi possível”.","en":"A good error provides context, location, and a next step instead of merely saying it could not be done.","es":"Un buen error aporta contexto, ubicación y siguiente paso en lugar de limitarse a decir que no fue posible.","fr":"Une bonne erreur donne contexte, emplacement et étape suivante au lieu de simplement dire que cela n’a pas été possible."},"date":"2026-08-05","read":2,"blocks":[{"title":{"pt":"O erro é parte do produto","en":"The error is part of the product","es":"El error forma parte del producto","fr":"L’erreur fait partie du produit"},"body":[{"pt":"Falhas de rede, modelo, arquivo e execução acontecem. O que diferencia uma experiência utilizável é se a mensagem ajuda a pessoa a decidir o que fazer depois.","en":"Network, model, file, and execution failures happen. What distinguishes a usable experience is whether the message helps a person decide what to do next.","es":"Los fallos de red, modelo, archivo y ejecución ocurren. Lo que distingue una experiencia utilizable es si el mensaje ayuda a decidir qué hacer después.","fr":"Les échecs réseau, modèle, fichier et exécution arrivent. Ce qui distingue une expérience utilisable est la capacité du message à aider la personne à décider quoi faire ensuite."}]},{"title":{"pt":"Um diagnóstico útil contém","en":"A useful diagnostic contains","es":"Un diagnóstico útil contiene","fr":"Un diagnostic utile contient"},"bullets":[{"pt":"Qual etapa falhou.","en":"Which step failed.","es":"Qué paso falló.","fr":"Quelle étape a échoué."},{"pt":"Se há arquivo, comando ou recurso associado.","en":"Whether a file, command, or resource is associated.","es":"Si hay un archivo, comando o recurso asociado.","fr":"S’il existe un fichier, une commande ou une ressource associée."},{"pt":"Se tentar novamente faz sentido ou se outra ação é necessária.","en":"Whether retrying makes sense or another action is needed.","es":"Si tiene sentido reintentar o si se necesita otra acción.","fr":"S’il est pertinent de réessayer ou si une autre action est nécessaire."}]},{"title":{"pt":"Mensagem genérica é último recurso","en":"Generic message is a last resort","es":"El mensaje genérico es último recurso","fr":"Le message générique est un dernier recours"},"body":[{"pt":"“Tente novamente” serve quando realmente não há informação melhor. Se o runtime sabe o que falhou, esconder isso só torna suporte e depuração mais difíceis.","en":"“Try again” is useful when there truly is no better information. If the runtime knows what failed, hiding it only makes support and debugging harder.","es":"“Inténtalo de nuevo” sirve cuando realmente no hay mejor información. Si el runtime sabe qué falló, ocultarlo solo dificulta soporte y depuración.","fr":"« Réessayez » est utile lorsqu’il n’existe vraiment pas de meilleure information. Si le runtime sait ce qui a échoué, le cacher ne fait que compliquer support et débogage."}]},{"title":{"pt":"O ponto que decide Erro útil contém próxima ação","en":"The decision point in Diagnostics people can act on","es":"El punto decisivo de Diagnósticos que alguien puede usar","fr":"Le point décisif de Diagnostics sur lesquels on peut agir"},"body":[{"pt":"Um diagnóstico acionável informa o que falhou, onde, em qual classe, se é recuperável e qual evidência sustenta essa classificação. “Não foi possível concluir” serve como último fallback, não como interface principal.","en":"The useful way to read “Diagnostics people can act on” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Diagnósticos que alguien puede usar» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Diagnostics sur lesquels on peut agir » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Erro útil contém próxima ação","en":"Specific failure mode: Diagnostics people can act on","es":"Fallo específico: Diagnósticos que alguien puede usar","fr":"Mode de défaillance : Diagnostics sur lesquels on peut agir"},"body":[{"pt":"O risco é despejar stack trace ou mensagem do provedor sem tradução para o estado do produto.","en":"The failure mode to watch in “Diagnostics people can act on” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Diagnósticos que alguien puede usar» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Diagnostics sur lesquels on peut agir » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Erro útil contém próxima ação","en":"Evidence that closes Diagnostics people can act on","es":"Evidencia que cierra Diagnósticos que alguien puede usar","fr":"Preuve qui valide Diagnostics sur lesquels on peut agir"},"body":[{"pt":"O sistema deve mapear códigos técnicos para ações seguras e preservar detalhes suficientes para debug quando o usuário abre a camada avançada.","en":"For “Diagnostics people can act on”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Diagnósticos que alguien puede usar», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Diagnostics sur lesquels on peut agir », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Diagnósticos que alguém consegue usar”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Diagnostics people can act on”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Diagnósticos que alguien puede usar”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Diagnostics sur lesquels on peut agir », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"code-specialties-without-clutter","category":"code","asset":"coding","title":{"pt":"Especialidades de Code sem lotar a interface","en":"Code specialties without cluttering the interface","es":"Especialidades de Code sin saturar la interfaz","fr":"Spécialités Code sans encombrer l’interface"},"lead":{"pt":"Especialidade deve orientar o contexto e as prioridades da tarefa sem virar uma segunda linguagem de configuração.","en":"A specialty should guide task context and priorities without becoming a second configuration language.","es":"Una especialidad debe orientar contexto y prioridades de la tarea sin convertirse en un segundo lenguaje de configuración.","fr":"Une spécialité doit guider le contexte et les priorités de la tâche sans devenir un second langage de configuration."},"date":"2026-08-04","read":2,"blocks":[{"title":{"pt":"Um atalho de intenção","en":"An intent shortcut","es":"Un atajo de intención","fr":"Un raccourci d’intention"},"body":[{"pt":"Quando a tarefa é claramente frontend, backend, revisão ou documentação, uma especialidade pode ajustar defaults e dar pistas ao agente sem exigir um prompt maior.","en":"When a task is clearly frontend, backend, review, or documentation, a specialty can adjust defaults and give the agent hints without requiring a larger prompt.","es":"Cuando una tarea es claramente frontend, backend, revisión o documentación, una especialidad puede ajustar valores predeterminados y dar pistas al agente sin exigir un prompt más largo.","fr":"Lorsqu’une tâche est clairement frontend, backend, révision ou documentation, une spécialité peut ajuster les valeurs par défaut et donner des indices à l’agent sans exiger un prompt plus long."}]},{"title":{"pt":"O chip precisa ser leve","en":"The chip should stay light","es":"El chip debe ser ligero","fr":"Le chip doit rester léger"},"bullets":[{"pt":"Mostrar a escolha atual.","en":"Show the current choice.","es":"Mostrar la elección actual.","fr":"Afficher le choix actuel."},{"pt":"Permitir trocar ou remover rapidamente.","en":"Allow quick switching or removal.","es":"Permitir cambiarla o eliminarla rápidamente.","fr":"Permettre de changer ou retirer rapidement."},{"pt":"Não competir com modelo, esforço e envio.","en":"Not compete with model, effort, and send.","es":"No competir con modelo, esfuerzo y envío.","fr":"Ne pas concurrencer modèle, effort et envoi."}]},{"title":{"pt":"O prompt ainda manda","en":"The prompt still leads","es":"El prompt sigue mandando","fr":"Le prompt reste prioritaire"},"body":[{"pt":"Especialidade é contexto auxiliar. O pedido explícito da pessoa continua definindo o resultado esperado e as restrições reais.","en":"A specialty is auxiliary context. The person’s explicit request still defines the expected result and real constraints.","es":"La especialidad es contexto auxiliar. La solicitud explícita de la persona sigue definiendo el resultado esperado y las restricciones reales.","fr":"La spécialité est un contexte auxiliaire. La demande explicite de la personne continue de définir le résultat attendu et les contraintes réelles."}]},{"title":{"pt":"Como Especialidade deve entrar como contexto sob demanda deixa de ser só interface","en":"How Code specialties without cluttering the interface becomes more than interface","es":"Cómo Especialidades de Code sin saturar la interfaz deja de ser solo interfaz","fr":"Comment Spécialités Code sans encombrer l’interface dépasse la simple interface"},"body":[{"pt":"Frontend, backend, dados, 3D, documentos e mobile exigem critérios diferentes. A interface não precisa mostrar quinze toggles; o runtime pode detectar domínio e anexar a skill apropriada ao prompt de engenharia.","en":"The useful way to read “Code specialties without cluttering the interface” is as a system contract rather than a feature note. The implementation has to preserve the intended behavior across the normal path, degraded states, repetition, and handoff to adjacent surfaces.","es":"La forma útil de leer «Especialidades de Code sin saturar la interfaz» es como un contrato de sistema y no como una nota de función. La implementación debe conservar el comportamiento esperado en el flujo normal, estados degradados, repetición y traspaso a superficies adyacentes.","fr":"La bonne manière de lire « Spécialités Code sans encombrer l’interface » est comme un contrat de système et non comme une simple note de fonctionnalité. L’implémentation doit préserver le comportement attendu dans le parcours normal, les états dégradés, la répétition et les transitions vers les surfaces voisines."}],"bullets":[{"pt":"contratos entre arquivos e runtimes continuam alinhados","en":"contratos entre arquivos e runtimes continuam alinhados","es":"contratos entre arquivos e runtimes continuam alinhados","fr":"contratos entre arquivos e runtimes continuam alinhados"},{"pt":"cada estado de erro tem recuperação previsível","en":"cada estado de erro tem recuperação previsível","es":"cada estado de erro tem recuperação previsível","fr":"cada estado de erro tem recuperação previsível"},{"pt":"verificação distingue parser, runtime e visual","en":"verificação distingue parser, runtime e visual","es":"verificação distingue parser, runtime e visual","fr":"verificação distingue parser, runtime e visual"}]},{"title":{"pt":"Falha específica: Especialidade deve entrar como contexto sob demanda","en":"Specific failure mode: Code specialties without cluttering the interface","es":"Fallo específico: Especialidades de Code sin saturar la interfaz","fr":"Mode de défaillance : Spécialités Code sans encombrer l’interface"},"body":[{"pt":"O risco é ativar todas as skills ao mesmo tempo e aumentar contexto, conflito de regras e latência.","en":"The failure mode to watch in “Code specialties without cluttering the interface” is a locally plausible change that violates a neighboring contract. A result can look complete and still be wrong if routing, persistence, permission, runtime evidence, or responsive behavior no longer agrees with the rest of the product.","es":"El fallo que conviene vigilar en «Especialidades de Code sin saturar la interfaz» es un cambio localmente plausible que rompe un contrato vecino. Un resultado puede parecer completo y seguir siendo incorrecto si rutas, persistencia, permisos, evidencia de runtime o comportamiento responsive dejan de coincidir.","fr":"Le risque à surveiller dans « Spécialités Code sans encombrer l’interface » est une modification localement plausible qui rompt un contrat voisin. Un résultat peut sembler complet tout en restant faux si routage, persistance, autorisations, preuves runtime ou comportement responsive ne concordent plus."}]},{"title":{"pt":"Evidência que fecha Especialidade deve entrar como contexto sob demanda","en":"Evidence that closes Code specialties without cluttering the interface","es":"Evidencia que cierra Especialidades de Code sin saturar la interfaz","fr":"Preuve qui valide Spécialités Code sans encombrer l’interface"},"body":[{"pt":"Uma boa seleção usa sinais do pedido e da base, mantém poucas skills ativas e deixa a evidência do projeto superar heurística quando há conflito.","en":"For “Code specialties without cluttering the interface”, completion should be tied to observable evidence. The strongest candidate is the one that satisfies the requested behavior, keeps adjacent contracts intact, and survives the checks that are actually available instead of claiming execution that never happened.","es":"Para «Especialidades de Code sin saturar la interfaz», la finalización debe vincularse a evidencia observable. El mejor candidato cumple el comportamiento pedido, conserva contratos adyacentes y supera las comprobaciones realmente disponibles sin afirmar ejecuciones que nunca ocurrieron.","fr":"Pour « Spécialités Code sans encombrer l’interface », la fin du travail doit être liée à des preuves observables. Le meilleur candidat satisfait le comportement demandé, préserve les contrats voisins et passe les vérifications réellement disponibles sans inventer d’exécution."}]},{"title":{"pt":"Contrato de saída como gate","en":"output contract as a gate","es":"contrato de salida como gate","fr":"contrat de sortie comme gate"},"body":[{"pt":"Em “Especialidades de Code sem lotar a interface”, o ponto técnico que fecha a análise é tratar código executável, regressão e evidência como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.","en":"In “Code specialties without cluttering the interface”, the technical point that closes the analysis is to treat executable code, regression, and evidence as one contract. The implementation stops being convincing when one of those dimensions exists only in prose rather than verifiable product behavior.","es":"En “Especialidades de Code sin saturar la interfaz”, el cierre técnico es tratar código ejecutable, regresión y evidencia como un único contrato y exigir comportamiento verificable.","fr":"Dans « Spécialités Code sans encombrer l’interface », le point technique final consiste à traiter code exécutable, régression et preuve comme un seul contrat et à exiger un comportement vérifiable."}],"bullets":[{"pt":"definir o estado esperado antes da ação","en":"define expected state before the action","es":"definir el estado esperado antes de la acción","fr":"définir l’état attendu avant l’action"},{"pt":"observar o efeito real e registrar a evidência","en":"observe the real effect and record evidence","es":"observar el efecto real y registrar evidencia","fr":"observer l’effet réel et enregistrer la preuve"},{"pt":"se o gate falhar, reparar a causa antes de ampliar o escopo","en":"if the gate fails, repair the cause before expanding scope","es":"si el gate falla, reparar la causa antes de ampliar el alcance","fr":"si le gate échoue, réparer la cause avant d’élargir le périmètre"}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}},{"slug":"melos-2-development-begins","category":"models","asset":"modelGraph","date":"2026-09-02","read":2,"title":{"pt":"Começamos o desenvolvimento do Melos 2","en":"Development of Melos 2 has started","es":"Comenzamos el desarrollo de Melos 2","fr":"Le développement de Melos 2 commence"},"lead":{"pt":"A próxima geração da rota rápida do Giorgio começa com uma meta clara: menos latência e custo sem transformar velocidade em superficialidade.","en":"The next generation of Giorgio’s fast route starts with a clear goal: lower latency and cost without turning speed into shallowness.","es":"La próxima generación de la ruta rápida de Giorgio comienza con una meta clara: menor latencia y coste sin convertir la velocidad en superficialidad.","fr":"La prochaine génération de la voie rapide de Giorgio démarre avec un objectif clair : réduire latence et coût sans rendre les réponses superficielles."},"blocks":[{"title":{"pt":"Por que um Melos 2","en":"Why a Melos 2","es":"Por qué un Melos 2","fr":"Pourquoi un Melos 2"},"body":[{"pt":"Thesis 2 está sendo construído para tarefas em que contexto, verificação, ferramentas e execução prolongada justificam mais compute. Isso deixa um espaço importante para um modelo complementar: rápido o suficiente para permanecer no fluxo, mas disciplinado o bastante para não transformar toda tarefa curta em um chute.","en":"Thesis 2 is being built for work where context, verification, tools, and long execution justify more compute. That leaves room for a complementary model: fast enough to stay in flow, but disciplined enough not to turn every short task into a guess.","es":"Thesis 2 se construye para tareas donde contexto, verificación, herramientas y ejecución prolongada justifican más cómputo. Queda espacio para un modelo complementario: suficientemente rápido para mantener el flujo y suficientemente disciplinado para no convertir cada tarea corta en una apuesta.","fr":"Thesis 2 est conçu pour les tâches où contexte, vérification, outils et exécution longue justifient davantage de calcul. Il reste donc une place pour un modèle complémentaire : assez rapide pour préserver le flux, mais assez discipliné pour ne pas transformer chaque petite tâche en pari."}]},{"title":{"pt":"Objetivos de arquitetura","en":"Architecture goals","es":"Objetivos de arquitectura","fr":"Objectifs d’architecture"},"bullets":[{"pt":"roteamento de ferramentas nativo e barato, com descoberta sob demanda em vez de carregar dezenas de schemas","en":"cheap native tool routing with on-demand discovery instead of loading dozens of schemas","es":"enrutamiento de herramientas nativo y barato, con descubrimiento bajo demanda en vez de cargar decenas de esquemas","fr":"routage d’outils natif et économique, avec découverte à la demande plutôt que des dizaines de schémas"},{"pt":"contexto compacto orientado à tarefa, preservando instrução, evidência recente e estado útil","en":"compact task-oriented context that preserves instruction, recent evidence, and useful state","es":"contexto compacto orientado a la tarea, preservando instrucción, evidencia reciente y estado útil","fr":"contexte compact orienté tâche, conservant instruction, preuves récentes et état utile"},{"pt":"verificação seletiva: checks determinísticos primeiro; juiz de modelo só quando houver incerteza residual","en":"selective verification: deterministic checks first; model judge only for residual uncertainty","es":"verificación selectiva: comprobaciones deterministas primero; juez de modelo solo ante incertidumbre residual","fr":"vérification sélective : contrôles déterministes d’abord ; juge modèle seulement pour l’incertitude résiduelle"},{"pt":"handoff limpo para Thesis 2 quando a tarefa deixa de ser rápida e passa a exigir profundidade","en":"clean handoff to Thesis 2 when a fast task turns into deep work","es":"traspaso limpio a Thesis 2 cuando una tarea rápida pasa a exigir profundidad","fr":"passage propre vers Thesis 2 lorsqu’une tâche rapide devient un travail profond"}]},{"title":{"pt":"O que não está sendo anunciado","en":"What is not being announced","es":"Lo que no estamos anunciando","fr":"Ce qui n’est pas annoncé"},"body":[{"pt":"Melos 2 ainda está em desenvolvimento. Este artigo descreve direção e critérios, não um modelo já finalizado nem benchmarks que ainda não existem. O trabalho começa agora com avaliação de latência, qualidade curta, uso de ferramentas, coding leve e custo por tarefa concluída.","en":"Melos 2 is still in development. This article describes direction and criteria, not a finished model or benchmarks that do not exist yet. Work starts now with latency, short-form quality, tool use, light coding, and cost-per-completed-task evaluation.","es":"Melos 2 sigue en desarrollo. Este artículo describe dirección y criterios, no un modelo terminado ni benchmarks que aún no existen. El trabajo comienza con latencia, calidad corta, uso de herramientas, coding ligero y coste por tarea completada.","fr":"Melos 2 est encore en développement. Cet article décrit une direction et des critères, pas un modèle finalisé ni des benchmarks inexistants. Le travail commence par la latence, la qualité courte, l’usage d’outils, le coding léger et le coût par tâche terminée."}]},{"title":{"pt":"Como vamos medir progresso","en":"How progress will be measured","es":"Cómo mediremos el progreso","fr":"Comment nous mesurerons le progrès"},"bullets":[{"pt":"tempo até a primeira resposta útil, não apenas tokens por segundo","en":"time to first useful answer, not only tokens per second","es":"tiempo hasta la primera respuesta útil, no solo tokens por segundo","fr":"temps jusqu’à la première réponse utile, pas seulement les tokens par seconde"},{"pt":"taxa de tarefas resolvidas sem escalada desnecessária","en":"rate of tasks solved without unnecessary escalation","es":"tasa de tareas resueltas sin escalado innecesario","fr":"taux de tâches résolues sans escalade inutile"},{"pt":"qualidade de tool use e recuperação quando uma ferramenta falha","en":"tool-use quality and recovery when a tool fails","es":"calidad del uso de herramientas y recuperación cuando una herramienta falla","fr":"qualité de l’usage d’outils et récupération lorsqu’un outil échoue"},{"pt":"custo total por resultado aceito, incluindo reparos e verificações","en":"total cost per accepted result, including repairs and verification","es":"coste total por resultado aceptado, incluidos reparaciones y verificaciones","fr":"coût total par résultat accepté, réparations et vérifications incluses"}]},{"title":{"pt":"Relação com Thesis 2","en":"Relationship with Thesis 2","es":"Relación con Thesis 2","fr":"Relation avec Thesis 2"},"body":[{"pt":"A intenção não é criar dois modelos disputando o mesmo lugar. Melos 2 deve resolver com eficiência o que já está dentro de sua fronteira confiável; Thesis 2 assume quando o trabalho exige pesquisa iterativa, arquitetura, verificação independente, execução longa ou refinamento visual e técnico mais caro.","en":"The goal is not to build two models competing for the same slot. Melos 2 should efficiently solve what is inside its reliable frontier; Thesis 2 takes over when work needs iterative research, architecture, independent verification, long execution, or more expensive visual and technical refinement.","es":"La idea no es crear dos modelos compitiendo por el mismo lugar. Melos 2 debe resolver con eficiencia lo que está dentro de su frontera fiable; Thesis 2 toma el relevo cuando el trabajo exige investigación iterativa, arquitectura, verificación independiente, ejecución larga o refinamiento visual y técnico más costoso.","fr":"L’objectif n’est pas de créer deux modèles en concurrence pour le même rôle. Melos 2 doit résoudre efficacement ce qui se trouve dans sa frontière fiable ; Thesis 2 prend le relais quand le travail exige recherche itérative, architecture, vérification indépendante, exécution longue ou raffinement visuel et technique plus coûteux."}]},{"title":{"pt":"Fast path precisa saber quando sair do caminho","en":"A fast path must know when to step aside","es":"La ruta rápida debe saber cuándo apartarse","fr":"La voie rapide doit savoir quand céder la place"},"body":[{"pt":"Melos 2 não precisa vencer Thesis 2 em profundidade. Precisa reconhecer cedo quando uma tarefa deixou de ser barata: migração, auth, arquitetura, research mutável ou código com alto risco devem promover para uma rota mais profunda antes de gerar confiança falsa.","en":"Melos 2 does not need to beat Thesis 2 on depth. It needs to recognize early when a task stops being cheap: migrations, auth, architecture, mutable research, or high-risk code should promote to a deeper route before producing false confidence.","es":"Melos 2 debe detectar cuándo una tarea deja de ser barata y promoverla antes de generar confianza falsa.","fr":"Melos 2 doit détecter quand une tâche cesse d’être bon marché et la promouvoir avant de produire une fausse confiance."}]},{"title":{"pt":"Métrica central: trabalho útil por segundo","en":"Core metric: useful work per second","es":"Métrica central: trabajo útil por segundo","fr":"Métrique centrale : travail utile par seconde"},"body":[{"pt":"Latência só vale se a resposta evita retrabalho. O objetivo do Melos 2 é maximizar trabalho útil por segundo: contexto menor, tool routing barato, output objetivo e verificação curta quando existe risco real.","en":"Latency only matters if the answer avoids rework. Melos 2 aims to maximize useful work per second through smaller context, cheap tool routing, focused output, and short verification when real risk exists.","es":"La latencia solo importa si evita retrabajo; Melos 2 optimiza trabajo útil por segundo.","fr":"La latence n’a de valeur que si elle évite le retravail ; Melos 2 optimise le travail utile par seconde."}]}],"readingMinutes":{"pt":2,"en":2,"es":2,"fr":2}}],"general":[{"slug":"overview","group":"start","asset":"docs","title":{"pt":"Visão geral","en":"Overview","es":"Visión general","fr":"Vue d’ensemble"},"lead":{"pt":"O Giorgio reúne conversa, pesquisa, arquivos, projetos, artefatos e workspaces especializados em uma interface única.","en":"Giorgio brings conversation, research, files, projects, artifacts, and specialized workspaces into one interface.","es":"Giorgio reúne conversación, investigación, archivos, proyectos, artefactos y espacios especializados en una sola interfaz.","fr":"Giorgio réunit conversation, recherche, fichiers, projets, artefacts et espaces spécialisés dans une seule interface."},"sections":[{"title":{"pt":"Como pensar no produto","en":"How to think about the product","es":"Cómo pensar el producto","fr":"Comment penser le produit"},"body":[{"pt":"O chat é a entrada mais simples. A partir dele, arquivos, busca e artefatos entram quando a tarefa exige mais contexto ou uma entrega concreta.","en":"Chat is the simplest entry point. From there, files, search, and artifacts come in when a task needs more context or a concrete deliverable.","es":"El chat es el punto de entrada más simple. A partir de ahí, archivos, búsqueda y artefactos entran cuando la tarea necesita más contexto o una entrega concreta.","fr":"Le chat est le point d’entrée le plus simple. Ensuite, fichiers, recherche et artefacts interviennent lorsqu’une tâche exige plus de contexte ou un livrable concret."}]},{"title":{"pt":"Superfícies principais","en":"Main surfaces","es":"Superficies principales","fr":"Surfaces principales"},"bullets":[{"pt":"Chat para perguntas, criação e análise.","en":"Chat for questions, creation, and analysis.","es":"Chat para preguntas, creación y análisis.","fr":"Chat pour questions, création et analyse."},{"pt":"Projetos para contexto persistente.","en":"Projects for persistent context.","es":"Proyectos para contexto persistente.","fr":"Projets pour contexte persistant."},{"pt":"Artefatos para arquivos e resultados verificáveis.","en":"Artifacts for files and verifiable results.","es":"Artefactos para archivos y resultados verificables.","fr":"Artefacts pour fichiers et résultats vérifiables."},{"pt":"Design e Cowork para fluxos especializados.","en":"Design and Cowork for specialized workflows.","es":"Design y Cowork para flujos especializados.","fr":"Design et Cowork pour flux spécialisés."}]},{"title":{"pt":"Como as superfícies se encaixam","en":"How the surfaces fit together","es":"How the surfaces fit together","fr":"How the surfaces fit together"},"body":[{"pt":"A visão geral funciona melhor quando você entende o produto como quatro superfícies ligadas: Chat para conversa, Projetos para contexto persistente, Docs para referência e Code para execução técnica.","en":"The overview works best when you treat the product as four connected surfaces: Chat for conversation, Projects for persistent context, Docs for reference, and Code for technical execution.","es":"The overview works best when you treat the product as four connected surfaces: Chat for conversation, Projects for persistent context, Docs for reference, and Code for technical execution.","fr":"The overview works best when you treat the product as four connected surfaces: Chat for conversation, Projects for persistent context, Docs for reference, and Code for technical execution."}],"bullets":[{"pt":"Use a página inicial para decidir onde começar; evite mover uma tarefa para Code ou Cowork apenas por hábito.","en":"Use the home surface to decide where to begin; do not move work into Code or Cowork by habit.","es":"Use the home surface to decide where to begin; do not move work into Code or Cowork by habit.","fr":"Use the home surface to decide where to begin; do not move work into Code or Cowork by habit."}]},{"title":{"pt":"Como isso entra no fluxo","en":"How this fits the workflow","es":"Cómo entra esto en el flujo","fr":"Comment cela s’insère dans le flux"},"body":[{"pt":"Use Visão geral como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O Giorgio reúne conversa, pesquisa, arquivos, projetos, artefatos e workspaces especializados em uma interface única. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Overview as an operational reference, not as an isolated screen. The page itself is about this: Giorgio brings conversation, research, files, projects, artifacts, and specialized workspaces into one interface. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Visión general como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Giorgio reúne conversación, investigación, archivos, proyectos, artefactos y espacios especializados en una sola interfaz. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Vue d’ensemble comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Giorgio réunit conversation, recherche, fichiers, projets, artefacts et espaces spécialisés dans une seule interface. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Visão geral o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Overview where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Visión general el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Vue d’ensemble où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Cenário real","en":"Real-world scenario","es":"Escenario real","fr":"Scénario réel"},"body":[{"pt":"Comece por “Como pensar no produto”, confirme o estado visível e avance para “Superfícies principais” apenas quando a etapa anterior estiver estável. Em Visão geral, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “How to think about the product”, confirm the visible state, and move to “Main surfaces” only when the previous step is stable. In Overview, skipping context usually creates more rework than speed.","es":"Empieza por “Cómo pensar el producto”, confirma el estado visible y avanza a “Superficies principales” solo cuando la etapa anterior esté estable. En Visión general, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Comment penser le produit », confirmez l’état visible puis passez à « Surfaces principales » seulement lorsque l’étape précédente est stable. Dans Vue d’ensemble, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Onde costuma quebrar","en":"Where it usually breaks","es":"Dónde suele fallar","fr":"Là où cela casse souvent"},"body":[{"pt":"Imagine uma tarefa real em que Visão geral deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Overview stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Visión general deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Vue d’ensemble cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Visão geral realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Overview truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Visión general realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Vue d’ensemble exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Critério de conclusão","en":"Definition of done","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Visão geral o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Overview where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Visión general el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Vue d’ensemble où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Visão geral como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O Giorgio reúne conversa, pesquisa, arquivos, projetos, artefatos e workspaces especializados em uma interface única. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Overview as an operational reference, not as an isolated screen. The page itself is about this: Giorgio brings conversation, research, files, projects, artifacts, and specialized workspaces into one interface. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Visión general como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Giorgio reúne conversación, investigación, archivos, proyectos, artefactos y espacios especializados en una sola interfaz. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Vue d’ensemble comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Giorgio réunit conversation, recherche, fichiers, projets, artefacts et espaces spécialisés dans une seule interface. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Mapa operacional: Visão geral","en":"Operational map: Overview","es":"Mapa operativo: Visión general","fr":"Carte opérationnelle: Vue d’ensemble"},"body":[{"pt":"Nesta página, a referência completa cobre mapa das superfícies públicas, privadas e do fluxo principal. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Overview as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Visión general como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Vue d’ensemble comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Visão geral","en":"Edge cases for Overview","es":"Casos límite de Visión general","fr":"Cas limites de Vue d’ensemble"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Overview flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Visión general sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Vue d’ensemble reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Público","en":"Public","es":"Público","fr":"Public"},{"pt":"Sem conta: Blog e Docs","en":"No account: Blog and Docs","es":"Sin cuenta: Blog y Docs","fr":"Sans compte : Blog et Docs"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"access-login","group":"start","asset":"site","title":{"pt":"Acesso e login","en":"Access and login","es":"Acceso e inicio de sesión","fr":"Accès et connexion"},"lead":{"pt":"A tela de acesso separa conteúdo público de ações que dependem da sua conta.","en":"The access screen separates public content from actions that depend on your account.","es":"La pantalla de acceso separa el contenido público de las acciones que dependen de tu cuenta.","fr":"L’écran d’accès sépare le contenu public des actions qui dépendent de votre compte."},"sections":[{"title":{"pt":"Antes de entrar","en":"Before signing in","es":"Antes de entrar","fr":"Avant de se connecter"},"body":[{"pt":"Blog, Giorgio Docs e Giorgio Code Docs podem ser abertos diretamente pela tela de login. Essas páginas não precisam de sessão autenticada.","en":"Blog, Giorgio Docs, and Giorgio Code Docs can be opened directly from the login screen. These pages do not require an authenticated session.","es":"Blog, Giorgio Docs y Giorgio Code Docs pueden abrirse directamente desde la pantalla de inicio. Estas páginas no requieren una sesión autenticada.","fr":"Blog, Giorgio Docs et Giorgio Code Docs peuvent être ouverts directement depuis l’écran de connexion. Ces pages ne nécessitent pas de session authentifiée."}]},{"title":{"pt":"Depois de entrar","en":"After signing in","es":"Después de entrar","fr":"Après connexion"},"bullets":[{"pt":"Conversas e histórico ficam disponíveis.","en":"Conversations and history become available.","es":"Las conversaciones y el historial quedan disponibles.","fr":"Les conversations et l’historique deviennent disponibles."},{"pt":"Projetos, memórias e configurações passam a usar o estado da conta.","en":"Projects, memories, and settings begin using account state.","es":"Proyectos, memorias y configuración pasan a usar el estado de la cuenta.","fr":"Projets, mémoires et réglages utilisent alors l’état du compte."},{"pt":"Ações administrativas continuam protegidas pelo backend.","en":"Administrative actions remain protected by the backend.","es":"Las acciones administrativas siguen protegidas por el backend.","fr":"Les actions administratives restent protégées par le backend."}]},{"title":{"pt":"Sessão, recuperação e continuidade","en":"Session, recovery, and continuity","es":"Session, recovery, and continuity","fr":"Session, recovery, and continuity"},"body":[{"pt":"Login não é só uma porta de entrada. A sessão precisa sobreviver a refresh, expiração de token e troca de rota sem perder a conversa em andamento.","en":"Login is more than an entry point. The session should survive refreshes, token expiry, and route changes without losing ongoing work.","es":"Login is more than an entry point. The session should survive refreshes, token expiry, and route changes without losing ongoing work.","fr":"Login is more than an entry point. The session should survive refreshes, token expiry, and route changes without losing ongoing work."}],"bullets":[{"pt":"Se o acesso falhar, diferencie credencial inválida, sessão expirada e indisponibilidade do serviço antes de refazer o login.","en":"When access fails, distinguish invalid credentials, expired sessions, and service unavailability before signing in again.","es":"When access fails, distinguish invalid credentials, expired sessions, and service unavailability before signing in again.","fr":"When access fails, distinguish invalid credentials, expired sessions, and service unavailability before signing in again."}]},{"title":{"pt":"Antes de começar","en":"Before you start","es":"Antes de empezar","fr":"Avant de commencer"},"body":[{"pt":"Imagine uma tarefa real em que Acesso e login deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Access and login stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Acceso e inicio de sesión deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Accès et connexion cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Sequência recomendada","en":"Recommended sequence","es":"Secuencia recomendada","fr":"Séquence recommandée"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Acesso e login o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Access and login where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Acceso e inicio de sesión el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Accès et connexion où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Acesso e login como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A tela de acesso separa conteúdo público de ações que dependem da sua conta. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Access and login as an operational reference, not as an isolated screen. The page itself is about this: The access screen separates public content from actions that depend on your account. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Acceso e inicio de sesión como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La pantalla de acceso separa el contenido público de las acciones que dependen de tu cuenta. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Accès et connexion comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : L’écran d’accès sépare le contenu public des actions qui dépendent de votre compte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Decisões que mudam o resultado","en":"Decisions that change the outcome","es":"Decisiones que cambian el resultado","fr":"Décisions qui changent le résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Acesso e login, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Access and login, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Acceso e inicio de sesión, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Accès et connexion, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Antes de entrar”, confirme o estado visível e avance para “Depois de entrar” apenas quando a etapa anterior estiver estável. Em Acesso e login, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Before signing in”, confirm the visible state, and move to “After signing in” only when the previous step is stable. In Access and login, skipping context usually creates more rework than speed.","es":"Empieza por “Antes de entrar”, confirma el estado visible y avanza a “Después de entrar” solo cuando la etapa anterior esté estable. En Acceso e inicio de sesión, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Avant de se connecter », confirmez l’état visible puis passez à « Après connexion » seulement lorsque l’étape précédente est stable. Dans Accès et connexion, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Como validar","en":"How to validate","es":"Cómo validar","fr":"Comment valider"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Acesso e login realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Access and login truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Acceso e inicio de sesión realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Accès et connexion exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Acesso e login","en":"Production reference: Access and login","es":"Referencia de producción: Acceso e inicio de sesión","fr":"Référence de production: Accès et connexion"},"body":[{"pt":"Nesta página, a referência completa cobre sessão, refresh, callbacks, recuperação e preservação do trabalho local. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Access and login as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Acceso e inicio de sesión como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Accès et connexion comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Acesso e login","en":"Edge cases for Access and login","es":"Casos límite de Acceso e inicio de sesión","fr":"Cas limites de Accès et connexion"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Access and login flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Acceso e inicio de sesión sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Accès et connexion reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"navigation","group":"start","asset":"site","title":{"pt":"Navegação","en":"Navigation","es":"Navegación","fr":"Navigation"},"lead":{"pt":"A sidebar organiza trabalho recente e as principais superfícies sem duplicar funções.","en":"The sidebar organizes recent work and main surfaces without duplicating functions.","es":"La barra lateral organiza trabajo reciente y superficies principales sin duplicar funciones.","fr":"La barre latérale organise le travail récent et les surfaces principales sans dupliquer les fonctions."},"sections":[{"title":{"pt":"Comece pelo destino","en":"Start from the destination","es":"Empieza por el destino","fr":"Commencez par la destination"},"bullets":[{"pt":"Novo bate-papo inicia uma conversa limpa.","en":"New chat starts a clean conversation.","es":"Nuevo chat inicia una conversación limpia.","fr":"Nouveau chat démarre une conversation propre."},{"pt":"Projetos abre contextos persistentes.","en":"Projects opens persistent contexts.","es":"Proyectos abre contextos persistentes.","fr":"Projets ouvre des contextes persistants."},{"pt":"Artefatos reúne resultados gerados.","en":"Artifacts collects generated results.","es":"Artefactos reúne resultados generados.","fr":"Artefacts regroupe les résultats générés."},{"pt":"Code Web e Design abrem workspaces especializados.","en":"Code Web and Design open specialized workspaces.","es":"Code Web y Design abren espacios especializados.","fr":"Code Web et Design ouvrent des espaces spécialisés."}]},{"title":{"pt":"Recolher sem perder acesso","en":"Collapse without losing access","es":"Contraer sin perder acceso","fr":"Réduire sans perdre l’accès"},"body":[{"pt":"No desktop, a sidebar pode ser recolhida e reaberta pelo controle de painel. No mobile, ela funciona como drawer para não competir com o conteúdo.","en":"On desktop, the sidebar can collapse and reopen from the panel control. On mobile, it behaves as a drawer so it does not compete with content.","es":"En escritorio, la barra lateral puede contraerse y reabrirse desde el control del panel. En móvil, funciona como drawer para no competir con el contenido.","fr":"Sur desktop, la barre latérale peut être réduite puis rouverte via le contrôle de panneau. Sur mobile, elle fonctionne comme drawer pour ne pas concurrencer le contenu."}]},{"title":{"pt":"Rotas que preservam contexto","en":"Routes that preserve context","es":"Routes that preserve context","fr":"Routes that preserve context"},"body":[{"pt":"A navegação foi pensada para manter a tarefa viva enquanto você alterna entre conversa, projeto, artefato e documentação.","en":"Navigation is designed to keep the task alive while you move between conversation, project, artifact, and documentation.","es":"Navigation is designed to keep the task alive while you move between conversation, project, artifact, and documentation.","fr":"Navigation is designed to keep the task alive while you move between conversation, project, artifact, and documentation."}],"bullets":[{"pt":"Em telas menores, priorize a tarefa atual; em desktop, use a navegação lateral para manter histórico e ferramentas acessíveis.","en":"On smaller screens, prioritize the current task; on desktop, use the side navigation to keep history and tools reachable.","es":"On smaller screens, prioritize the current task; on desktop, use the side navigation to keep history and tools reachable.","fr":"On smaller screens, prioritize the current task; on desktop, use the side navigation to keep history and tools reachable."}]},{"title":{"pt":"Leitura operacional","en":"Operational reading","es":"Lectura operativa","fr":"Lecture opérationnelle"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Navegação, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Navigation, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Navegación, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Navigation, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Comece pelo destino”, confirme o estado visível e avance para “Recolher sem perder acesso” apenas quando a etapa anterior estiver estável. Em Navegação, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Start from the destination”, confirm the visible state, and move to “Collapse without losing access” only when the previous step is stable. In Navigation, skipping context usually creates more rework than speed.","es":"Empieza por “Empieza por el destino”, confirma el estado visible y avanza a “Contraer sin perder acceso” solo cuando la etapa anterior esté estable. En Navegación, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Commencez par la destination », confirmez l’état visible puis passez à « Réduire sans perdre l’accès » seulement lorsque l’étape précédente est stable. Dans Navigation, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Do primeiro clique à entrega","en":"From first click to delivery","es":"Del primer clic a la entrega","fr":"Du premier clic à la livraison"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Navegação realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Navigation truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Navegación realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Navigation exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Navegação deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Navigation stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Navegación deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Navigation cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Limites e exceções","en":"Limits and exceptions","es":"Límites y excepciones","fr":"Limites et exceptions"},"body":[{"pt":"Use Navegação como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A sidebar organiza trabalho recente e as principais superfícies sem duplicar funções. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Navigation as an operational reference, not as an isolated screen. The page itself is about this: The sidebar organizes recent work and main surfaces without duplicating functions. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Navegación como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La barra lateral organiza trabajo reciente y superficies principales sin duplicar funciones. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Navigation comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La barre latérale organise le travail récent et les surfaces principales sans dupliquer les fonctions. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Checklist de uso","en":"Usage checklist","es":"Lista de uso","fr":"Liste de contrôle"},"body":[{"pt":"Comece por “Comece pelo destino”, confirme o estado visível e avance para “Recolher sem perder acesso” apenas quando a etapa anterior estiver estável. Em Navegação, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Start from the destination”, confirm the visible state, and move to “Collapse without losing access” only when the previous step is stable. In Navigation, skipping context usually creates more rework than speed.","es":"Empieza por “Empieza por el destino”, confirma el estado visible y avanza a “Contraer sin perder acceso” solo cuando la etapa anterior esté estable. En Navegación, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Commencez par la destination », confirmez l’état visible puis passez à « Réduire sans perdre l’accès » seulement lorsque l’étape précédente est stable. Dans Navigation, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Navegação, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Navigation, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Navegación, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Navigation, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Contrato desta superfície: Navegação","en":"Surface contract: Navigation","es":"Contrato de la superficie: Navegación","fr":"Contrat de la surface: Navigation"},"body":[{"pt":"Nesta página, a referência completa cobre rotas, deep links, histórico, páginas públicas e retorno ao app. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Navigation as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Navegación como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Navigation comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Navegação","en":"Edge cases for Navigation","es":"Casos límite de Navegación","fr":"Cas limites de Navigation"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Navigation flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Navegación sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Navigation reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"chat","group":"chat","asset":"docs","title":{"pt":"Chat","en":"Chat","es":"Chat","fr":"Chat"},"lead":{"pt":"O chat é a superfície padrão para perguntar, criar, revisar e transformar contexto em trabalho.","en":"Chat is the default surface for asking, creating, reviewing, and turning context into work.","es":"El chat es la superficie predeterminada para preguntar, crear, revisar y convertir contexto en trabajo.","fr":"Le chat est la surface par défaut pour demander, créer, réviser et transformer le contexte en travail."},"sections":[{"title":{"pt":"Composer","en":"Composer","es":"Composer","fr":"Composer"},"body":[{"pt":"A caixa de texto aceita o pedido principal e oferece anexos, microfone, seleção de modelo e capacidades de forma compacta.","en":"The composer accepts the main request and offers attachments, microphone, model selection, and capabilities in a compact form.","es":"El composer recibe la solicitud principal y ofrece adjuntos, micrófono, selección de modelo y capacidades de forma compacta.","fr":"Le composer reçoit la demande principale et propose pièces jointes, microphone, sélection de modèle et capacités de manière compacte."}]},{"title":{"pt":"Durante a geração","en":"During generation","es":"Durante la generación","fr":"Pendant la génération"},"bullets":[{"pt":"O estado da tarefa aparece junto da resposta.","en":"Task state appears with the response.","es":"El estado de la tarea aparece junto a la respuesta.","fr":"L’état de la tâche apparaît avec la réponse."},{"pt":"Você pode continuar enviando contexto quando a interface permite fila.","en":"You can continue adding context when the interface allows queued prompts.","es":"Puedes seguir añadiendo contexto cuando la interfaz permite prompts en cola.","fr":"Vous pouvez continuer à ajouter du contexte lorsque l’interface autorise les demandes en file."},{"pt":"Ações de copiar, ouvir ou tentar novamente ficam junto da mensagem.","en":"Copy, listen, or retry actions stay next to the message.","es":"Las acciones de copiar, escuchar o reintentar quedan junto al mensaje.","fr":"Les actions copier, écouter ou réessayer restent près du message."}]},{"title":{"pt":"Composer, streaming e continuidade","en":"Composer, streaming, and continuity","es":"Composer, streaming, and continuity","fr":"Composer, streaming, and continuity"},"body":[{"pt":"O Chat deve aceitar um pedido simples sem configuração extra, mas também permitir anexos, mensagens enviadas durante geração e continuação de contexto.","en":"Chat should accept a simple request without extra setup while still supporting attachments, messages sent during generation, and context continuation.","es":"Chat should accept a simple request without extra setup while still supporting attachments, messages sent during generation, and context continuation.","fr":"Chat should accept a simple request without extra setup while still supporting attachments, messages sent during generation, and context continuation."}],"bullets":[{"pt":"Uma resposta longa não deve bloquear o próximo comando. O fluxo ideal mantém o composer disponível e o estado da geração legível.","en":"A long response should not block the next instruction. The ideal flow keeps the composer available and generation state readable.","es":"A long response should not block the next instruction. The ideal flow keeps the composer available and generation state readable.","fr":"A long response should not block the next instruction. The ideal flow keeps the composer available and generation state readable."}]},{"title":{"pt":"O que merece atenção","en":"What deserves attention","es":"Qué merece atención","fr":"Ce qui mérite l’attention"},"body":[{"pt":"Use Chat como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O chat é a superfície padrão para perguntar, criar, revisar e transformar contexto em trabalho. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Chat as an operational reference, not as an isolated screen. The page itself is about this: Chat is the default surface for asking, creating, reviewing, and turning context into work. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Chat como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El chat es la superficie predeterminada para preguntar, crear, revisar y convertir contexto en trabajo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Chat comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le chat est la surface par défaut pour demander, créer, réviser et transformer le contexte en travail. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Chat o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Chat where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Chat el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Chat où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Um fluxo que funciona","en":"A workflow that works","es":"Un flujo que funciona","fr":"Un flux qui fonctionne"},"body":[{"pt":"Comece por “Composer”, confirme o estado visível e avance para “Durante a geração” apenas quando a etapa anterior estiver estável. Em Chat, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Composer”, confirm the visible state, and move to “During generation” only when the previous step is stable. In Chat, skipping context usually creates more rework than speed.","es":"Empieza por “Composer”, confirma el estado visible y avanza a “Durante la generación” solo cuando la etapa anterior esté estable. En Chat, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Composer », confirmez l’état visible puis passez à « Pendant la génération » seulement lorsque l’étape précédente est stable. Dans Chat, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Quando mudar de estratégia","en":"When to change strategy","es":"Cuándo cambiar de estrategia","fr":"Quand changer de stratégie"},"body":[{"pt":"Imagine uma tarefa real em que Chat deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Chat stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Chat deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Chat cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Chat realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Chat truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Chat realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Chat exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Sinais de que terminou","en":"Signals that you are done","es":"Señales de finalización","fr":"Signes que le travail est terminé"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Chat o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Chat where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Chat el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Chat où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Chat como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O chat é a superfície padrão para perguntar, criar, revisar e transformar contexto em trabalho. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Chat as an operational reference, not as an isolated screen. The page itself is about this: Chat is the default surface for asking, creating, reviewing, and turning context into work. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Chat como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El chat es la superficie predeterminada para preguntar, crear, revisar y convertir contexto en trabajo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Chat comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le chat est la surface par défaut pour demander, créer, réviser et transformer le contexte en travail. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Chat","en":"Engineering reading: Chat","es":"Lectura de ingeniería: Chat","fr":"Lecture d’ingénierie: Chat"},"body":[{"pt":"Nesta página, a referência completa cobre composer, geração, anexos, modelos, estados de erro e continuidade. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Chat as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Chat como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Chat comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Chat","en":"Edge cases for Chat","es":"Casos límite de Chat","fr":"Cas limites de Chat"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Chat flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Chat sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Chat reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"temporary-chat","group":"chat","asset":"docs","title":{"pt":"Chat temporário","en":"Temporary chat","es":"Chat temporal","fr":"Chat temporaire"},"lead":{"pt":"Use uma conversa temporária quando o trabalho não precisa entrar no histórico normal.","en":"Use a temporary conversation when the work does not need to enter normal history.","es":"Usa una conversación temporal cuando el trabajo no necesita entrar en el historial normal.","fr":"Utilisez une conversation temporaire lorsque le travail n’a pas besoin d’entrer dans l’historique normal."},"sections":[{"title":{"pt":"Indicado para","en":"Good for","es":"Indicado para","fr":"Indiqué pour"},"bullets":[{"pt":"Perguntas rápidas e testes.","en":"Quick questions and tests.","es":"Preguntas rápidas y pruebas.","fr":"Questions rapides et tests."},{"pt":"Tarefas isoladas sem relação com projetos.","en":"Isolated tasks unrelated to projects.","es":"Tareas aisladas sin relación con proyectos.","fr":"Tâches isolées sans rapport avec des projets."},{"pt":"Conversas que você não precisa retomar depois.","en":"Conversations you do not need to resume later.","es":"Conversaciones que no necesitas retomar después.","fr":"Conversations que vous n’avez pas besoin de reprendre plus tard."}]},{"title":{"pt":"Escolha uma conversa normal quando","en":"Choose a normal conversation when","es":"Elige una conversación normal cuando","fr":"Choisissez une conversation normale lorsque"},"body":[{"pt":"O trabalho depende de continuidade, comparação de versões ou contexto que você pretende reutilizar.","en":"The work depends on continuity, version comparison, or context you plan to reuse.","es":"El trabajo depende de continuidad, comparación de versiones o contexto que piensas reutilizar.","fr":"Le travail dépend de continuité, de comparaison de versions ou d’un contexte que vous comptez réutiliser."}]},{"title":{"pt":"Quando não deixar rastro","en":"When not to leave a trail","es":"When not to leave a trail","fr":"When not to leave a trail"},"body":[{"pt":"Chat temporário é útil para tarefas pontuais que não precisam alimentar histórico ou memória persistente.","en":"Temporary chat is useful for one-off work that should not feed persistent history or memory.","es":"Temporary chat is useful for one-off work that should not feed persistent history or memory.","fr":"Temporary chat is useful for one-off work that should not feed persistent history or memory."}],"bullets":[{"pt":"Use-o para rascunhos sensíveis ao contexto do momento, testes rápidos e conversas que você não pretende retomar depois.","en":"Use it for moment-specific drafts, quick tests, and conversations you do not intend to resume later.","es":"Use it for moment-specific drafts, quick tests, and conversations you do not intend to resume later.","fr":"Use it for moment-specific drafts, quick tests, and conversations you do not intend to resume later."}]},{"title":{"pt":"Mapa da experiência","en":"Experience map","es":"Mapa de la experiencia","fr":"Carte de l’expérience"},"body":[{"pt":"Imagine uma tarefa real em que Chat temporário deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Temporary chat stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Chat temporal deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Chat temporaire cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Aplicação prática","en":"Practical application","es":"Aplicación práctica","fr":"Application pratique"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Chat temporário o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Temporary chat where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Chat temporal el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Chat temporaire où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Chat temporário como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Use uma conversa temporária quando o trabalho não precisa entrar no histórico normal. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Temporary chat as an operational reference, not as an isolated screen. The page itself is about this: Use a temporary conversation when the work does not need to enter normal history. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Chat temporal como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Usa una conversación temporal cuando el trabajo no necesita entrar en el historial normal. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Chat temporaire comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Utilisez une conversation temporaire lorsque le travail n’a pas besoin d’entrer dans l’historique normal. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Erros fáceis de evitar","en":"Easy mistakes to avoid","es":"Errores fáciles de evitar","fr":"Erreurs faciles à éviter"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Chat temporário, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Temporary chat, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Chat temporal, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Chat temporaire, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Indicado para”, confirme o estado visível e avance para “Escolha uma conversa normal quando” apenas quando a etapa anterior estiver estável. Em Chat temporário, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Good for”, confirm the visible state, and move to “Choose a normal conversation when” only when the previous step is stable. In Temporary chat, skipping context usually creates more rework than speed.","es":"Empieza por “Indicado para”, confirma el estado visible y avanza a “Elige una conversación normal cuando” solo cuando la etapa anterior esté estable. En Chat temporal, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Indiqué pour », confirmez l’état visible puis passez à « Choisissez une conversation normale lorsque » seulement lorsque l’étape précédente est stable. Dans Chat temporaire, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Revisão final","en":"Final review","es":"Revisión final","fr":"Révision finale"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Chat temporário realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Temporary chat truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Chat temporal realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Chat temporaire exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Checklist de integração: Chat temporário","en":"Integration checklist: Temporary chat","es":"Checklist de integración: Chat temporal","fr":"Checklist d’intégration: Chat temporaire"},"body":[{"pt":"Nesta página, a referência completa cobre retenção, memória, artefatos escolhidos e descarte previsível. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Temporary chat as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Chat temporal como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Chat temporaire comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Chat temporário","en":"Edge cases for Temporary chat","es":"Casos límite de Chat temporal","fr":"Cas limites de Chat temporaire"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Temporary chat flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Chat temporal sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Chat temporaire reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"web-search","group":"chat","asset":"site","title":{"pt":"Busca na web","en":"Web search","es":"Búsqueda web","fr":"Recherche web"},"lead":{"pt":"Ative busca quando a resposta depende de informação pública atual ou verificável.","en":"Use search when the answer depends on current or verifiable public information.","es":"Activa la búsqueda cuando la respuesta depende de información pública actual o verificable.","fr":"Activez la recherche lorsque la réponse dépend d’informations publiques actuelles ou vérifiables."},"sections":[{"title":{"pt":"Quando ajuda","en":"When it helps","es":"Cuándo ayuda","fr":"Quand elle aide"},"bullets":[{"pt":"Notícias, preços, versões e disponibilidade.","en":"News, prices, versions, and availability.","es":"Noticias, precios, versiones y disponibilidad.","fr":"Actualités, prix, versions et disponibilité."},{"pt":"Informações que mudam com frequência.","en":"Information that changes frequently.","es":"Información que cambia con frecuencia.","fr":"Informations qui changent fréquemment."},{"pt":"Pedidos que exigem uma fonte pública verificável.","en":"Requests that require a verifiable public source.","es":"Solicitudes que requieren una fuente pública verificable.","fr":"Demandes nécessitant une source publique vérifiable."}]},{"title":{"pt":"Quando não é necessária","en":"When it is not needed","es":"Cuándo no es necesaria","fr":"Quand elle n’est pas nécessaire"},"body":[{"pt":"Resumo de arquivos já enviados, escrita criativa e conhecimento estável geralmente não precisam abrir a web.","en":"Summaries of files already provided, creative writing, and stable knowledge generally do not need the web.","es":"Resúmenes de archivos ya enviados, escritura creativa y conocimiento estable generalmente no necesitan abrir la web.","fr":"Les résumés de fichiers déjà fournis, l’écriture créative et les connaissances stables n’ont généralement pas besoin du web."}]},{"title":{"pt":"Frescura da informação e evidência","en":"Freshness and evidence","es":"Freshness and evidence","fr":"Freshness and evidence"},"body":[{"pt":"A busca deve entrar quando a resposta depende do agora: preço, versão, notícia, disponibilidade, placar, lei vigente ou qualquer dado que possa ter mudado.","en":"Search should enter when the answer depends on the present: price, version, news, availability, scores, current law, or any fact that may have changed.","es":"Search should enter when the answer depends on the present: price, version, news, availability, scores, current law, or any fact that may have changed.","fr":"Search should enter when the answer depends on the present: price, version, news, availability, scores, current law, or any fact that may have changed."}],"bullets":[{"pt":"Quando a busca é usada, a resposta deve separar o que veio da web do que foi inferido pelo modelo.","en":"When search is used, the answer should separate web-derived facts from model inference.","es":"When search is used, the answer should separate web-derived facts from model inference.","fr":"When search is used, the answer should separate web-derived facts from model inference."}]},{"title":{"pt":"Ponto de partida","en":"Starting point","es":"Punto de partida","fr":"Point de départ"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Busca na web, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Web search, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Búsqueda web, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Recherche web, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Quando ajuda”, confirme o estado visível e avance para “Quando não é necessária” apenas quando a etapa anterior estiver estável. Em Busca na web, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When it helps”, confirm the visible state, and move to “When it is not needed” only when the previous step is stable. In Web search, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo ayuda”, confirma el estado visible y avanza a “Cuándo no es necesaria” solo cuando la etapa anterior esté estable. En Búsqueda web, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand elle aide », confirmez l’état visible puis passez à « Quand elle n’est pas nécessaire » seulement lorsque l’étape précédente est stable. Dans Recherche web, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Trabalho em camadas","en":"Layered work","es":"Trabajo por capas","fr":"Travail par couches"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Busca na web realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Web search truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Búsqueda web realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Recherche web exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Busca na web deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Web search stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Búsqueda web deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Recherche web cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Diagnóstico rápido","en":"Fast diagnosis","es":"Diagnóstico rápido","fr":"Diagnostic rapide"},"body":[{"pt":"Use Busca na web como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Ative busca quando a resposta depende de informação pública atual ou verificável. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Web search as an operational reference, not as an isolated screen. The page itself is about this: Use search when the answer depends on current or verifiable public information. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Búsqueda web como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Activa la búsqueda cuando la respuesta depende de información pública actual o verificable. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Recherche web comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Activez la recherche lorsque la réponse dépend d’informations publiques actuelles ou vérifiables. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Próximo passo","en":"Next step","es":"Siguiente paso","fr":"Étape suivante"},"body":[{"pt":"Comece por “Quando ajuda”, confirme o estado visível e avance para “Quando não é necessária” apenas quando a etapa anterior estiver estável. Em Busca na web, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When it helps”, confirm the visible state, and move to “When it is not needed” only when the previous step is stable. In Web search, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo ayuda”, confirma el estado visible y avanza a “Cuándo no es necesaria” solo cuando la etapa anterior esté estable. En Búsqueda web, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand elle aide », confirmez l’état visible puis passez à « Quand elle n’est pas nécessaire » seulement lorsque l’étape précédente est stable. Dans Recherche web, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Busca na web, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Web search, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Búsqueda web, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Recherche web, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Matriz de comportamento: Busca na web","en":"Behavior matrix: Web search","es":"Matriz de comportamiento: Búsqueda web","fr":"Matrice de comportement: Recherche web"},"body":[{"pt":"Nesta página, a referência completa cobre detecção de frescor, provedores, fallback, fontes e citações. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Web search as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Búsqueda web como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Recherche web comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Busca na web","en":"Edge cases for Web search","es":"Casos límite de Búsqueda web","fr":"Cas limites de Recherche web"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Web search flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Búsqueda web sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Recherche web reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"attachments","group":"content","asset":"docs","title":{"pt":"Arquivos e anexos","en":"Files and attachments","es":"Archivos y adjuntos","fr":"Fichiers et pièces jointes"},"lead":{"pt":"Anexos entram como evidência para a tarefa e permanecem ligados à mensagem que os enviou.","en":"Attachments enter as evidence for the task and stay linked to the message that sent them.","es":"Los adjuntos entran como evidencia para la tarea y permanecen ligados al mensaje que los envió.","fr":"Les pièces jointes servent de preuves pour la tâche et restent liées au message qui les a envoyées."},"sections":[{"title":{"pt":"Antes de enviar","en":"Before sending","es":"Antes de enviar","fr":"Avant l’envoi"},"bullets":[{"pt":"Confira nome e tipo do arquivo.","en":"Check the file name and type.","es":"Comprueba el nombre y tipo del archivo.","fr":"Vérifiez le nom et le type du fichier."},{"pt":"Remova anexos que não pertencem ao pedido.","en":"Remove attachments unrelated to the request.","es":"Elimina adjuntos que no pertenecen a la solicitud.","fr":"Retirez les pièces jointes sans rapport avec la demande."},{"pt":"Explique no texto o que deve ser feito com o material.","en":"Explain in text what should be done with the material.","es":"Explica en el texto qué debe hacerse con el material.","fr":"Expliquez dans le texte ce qui doit être fait avec le contenu."}]},{"title":{"pt":"Depois","en":"Afterward","es":"Después","fr":"Ensuite"},"body":[{"pt":"Arquivos gerados podem aparecer como artefatos com preview, nome e ação de abertura ou download.","en":"Generated files can appear as artifacts with a preview, name, and open or download action.","es":"Los archivos generados pueden aparecer como artefactos con preview, nombre y acción de abrir o descargar.","fr":"Les fichiers générés peuvent apparaître comme artefacts avec aperçu, nom et action d’ouverture ou de téléchargement."}]},{"title":{"pt":"Arquivo como fonte primária","en":"Files as primary evidence","es":"Files as primary evidence","fr":"Files as primary evidence"},"body":[{"pt":"Quando um arquivo é anexado, o conteúdo dele deve ter prioridade sobre suposições genéricas. A tarefa começa pela leitura do material real.","en":"When a file is attached, its contents should take priority over generic assumptions. The task starts from the actual material.","es":"When a file is attached, its contents should take priority over generic assumptions. The task starts from the actual material.","fr":"When a file is attached, its contents should take priority over generic assumptions. The task starts from the actual material."}],"bullets":[{"pt":"Se algo não estiver no arquivo, isso deve ser dito explicitamente em vez de preencher a lacuna com uma hipótese silenciosa.","en":"If something is not in the file, say so explicitly instead of silently filling the gap with a guess.","es":"If something is not in the file, say so explicitly instead of silently filling the gap with a guess.","fr":"If something is not in the file, say so explicitly instead of silently filling the gap with a guess."}]},{"title":{"pt":"Como pensar esta área","en":"How to think about this area","es":"Cómo pensar esta área","fr":"Comment penser cette zone"},"body":[{"pt":"Use Arquivos e anexos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Anexos entram como evidência para a tarefa e permanecem ligados à mensagem que os enviou. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Files and attachments as an operational reference, not as an isolated screen. The page itself is about this: Attachments enter as evidence for the task and stay linked to the message that sent them. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Archivos y adjuntos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los adjuntos entran como evidencia para la tarea y permanecen ligados al mensaje que los envió. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Fichiers et pièces jointes comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les pièces jointes servent de preuves pour la tâche et restent liées au message qui les a envoyées. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Arquivos e anexos o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Files and attachments where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Archivos y adjuntos el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Fichiers et pièces jointes où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Exemplo de uso","en":"Usage example","es":"Ejemplo de uso","fr":"Exemple d’utilisation"},"body":[{"pt":"Comece por “Antes de enviar”, confirme o estado visível e avance para “Depois” apenas quando a etapa anterior estiver estável. Em Arquivos e anexos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Before sending”, confirm the visible state, and move to “Afterward” only when the previous step is stable. In Files and attachments, skipping context usually creates more rework than speed.","es":"Empieza por “Antes de enviar”, confirma el estado visible y avanza a “Después” solo cuando la etapa anterior esté estable. En Archivos y adjuntos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Avant l’envoi », confirmez l’état visible puis passez à « Ensuite » seulement lorsque l’étape précédente est stable. Dans Fichiers et pièces jointes, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Quando não usar","en":"When not to use it","es":"Cuándo no usarlo","fr":"Quand ne pas l’utiliser"},"body":[{"pt":"Imagine uma tarefa real em que Arquivos e anexos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Files and attachments stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Archivos y adjuntos deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Fichiers et pièces jointes cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Arquivos e anexos realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Files and attachments truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Archivos y adjuntos realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Fichiers et pièces jointes exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Verificação independente","en":"Independent verification","es":"Verificación independiente","fr":"Vérification indépendante"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Arquivos e anexos o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Files and attachments where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Archivos y adjuntos el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Fichiers et pièces jointes où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Arquivos e anexos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Anexos entram como evidência para a tarefa e permanecem ligados à mensagem que os enviou. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Files and attachments as an operational reference, not as an isolated screen. The page itself is about this: Attachments enter as evidence for the task and stay linked to the message that sent them. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Archivos y adjuntos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los adjuntos entran como evidencia para la tarea y permanecen ligados al mensaje que los envió. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Fichiers et pièces jointes comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les pièces jointes servent de preuves pour la tâche et restent liées au message qui les a envoyées. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Guia de verificação: Arquivos e anexos","en":"Verification guide: Files and attachments","es":"Guía de verificación: Archivos y adjuntos","fr":"Guide de vérification: Fichiers et pièces jointes"},"body":[{"pt":"Nesta página, a referência completa cobre seleção, drag-and-drop, miniaturas, limites e envio ao pipeline. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Files and attachments as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Archivos y adjuntos como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Fichiers et pièces jointes comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Arquivos e anexos","en":"Edge cases for Files and attachments","es":"Casos límite de Archivos y adjuntos","fr":"Cas limites de Fichiers et pièces jointes"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Files and attachments flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Archivos y adjuntos sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Fichiers et pièces jointes reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"image-input","group":"content","asset":"site","title":{"pt":"Entrada de imagens","en":"Image input","es":"Entrada de imágenes","fr":"Entrée d’images"},"lead":{"pt":"Imagens podem acompanhar a mensagem para análise visual, comparação ou referência de design.","en":"Images can accompany a message for visual analysis, comparison, or design reference.","es":"Las imágenes pueden acompañar el mensaje para análisis visual, comparación o referencia de diseño.","fr":"Les images peuvent accompagner le message pour analyse visuelle, comparaison ou référence de design."},"sections":[{"title":{"pt":"Dê uma pergunta à imagem","en":"Give the image a question","es":"Dale una pregunta a la imagen","fr":"Donnez une question à l’image"},"body":[{"pt":"Dizer o que você quer observar melhora a resposta: um detalhe, proporção, texto visível, erro de UI ou diferença entre duas capturas.","en":"Saying what you want examined improves the answer: a detail, proportion, visible text, UI issue, or difference between two captures.","es":"Decir qué quieres observar mejora la respuesta: un detalle, proporción, texto visible, error de UI o diferencia entre dos capturas.","fr":"Dire ce que vous souhaitez examiner améliore la réponse : détail, proportion, texte visible, problème UI ou différence entre deux captures."}]},{"title":{"pt":"Limites visuais","en":"Visual limits","es":"Límites visuales","fr":"Limites visuelles"},"body":[{"pt":"Se algo não estiver legível ou estiver fora da imagem, a resposta deve tratar isso como limite em vez de inventar o conteúdo ausente.","en":"If something is unreadable or outside the image, the answer should treat that as a limit instead of inventing missing content.","es":"Si algo no es legible o está fuera de la imagen, la respuesta debe tratarlo como límite en lugar de inventar contenido ausente.","fr":"Si quelque chose est illisible ou hors de l’image, la réponse doit traiter cela comme une limite plutôt que d’inventer le contenu manquant."}]},{"title":{"pt":"Imagem como contexto, não decoração","en":"Images as context, not decoration","es":"Images as context, not decoration","fr":"Images as context, not decoration"},"body":[{"pt":"Imagens entram como evidência visual: interface, gráfico, fotografia, documento ou erro de tela. O objetivo é extrair contexto útil para a tarefa.","en":"Images enter as visual evidence: interface, chart, photo, document, or error screen. The goal is to extract useful task context.","es":"Images enter as visual evidence: interface, chart, photo, document, or error screen. The goal is to extract useful task context.","fr":"Images enter as visual evidence: interface, chart, photo, document, or error screen. The goal is to extract useful task context."}],"bullets":[{"pt":"Ao analisar UI, descreva primeiro o que é observável e só depois proponha causa ou correção.","en":"When analyzing UI, describe what is observable first and only then propose a cause or fix.","es":"When analyzing UI, describe what is observable first and only then propose a cause or fix.","fr":"When analyzing UI, describe what is observable first and only then propose a cause or fix."}]},{"title":{"pt":"Objetivo e contexto","en":"Goal and context","es":"Objetivo y contexto","fr":"Objectif et contexte"},"body":[{"pt":"Imagine uma tarefa real em que Entrada de imagens deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Image input stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Entrada de imágenes deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Entrée d’images cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Ordem das ações","en":"Order of actions","es":"Orden de acciones","fr":"Ordre des actions"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Entrada de imagens o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Image input where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Entrada de imágenes el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Entrée d’images où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Entrada de imagens como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Imagens podem acompanhar a mensagem para análise visual, comparação ou referência de design. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Image input as an operational reference, not as an isolated screen. The page itself is about this: Images can accompany a message for visual analysis, comparison, or design reference. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Entrada de imágenes como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las imágenes pueden acompañar el mensaje para análisis visual, comparación o referencia de diseño. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Entrée d’images comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les images peuvent accompagner le message pour analyse visuelle, comparaison ou référence de design. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Casos de borda","en":"Edge cases","es":"Casos límite","fr":"Cas limites"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Entrada de imagens, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Image input, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Entrada de imágenes, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Entrée d’images, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Dê uma pergunta à imagem”, confirme o estado visível e avance para “Limites visuais” apenas quando a etapa anterior estiver estável. Em Entrada de imagens, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Give the image a question”, confirm the visible state, and move to “Visual limits” only when the previous step is stable. In Image input, skipping context usually creates more rework than speed.","es":"Empieza por “Dale una pregunta a la imagen”, confirma el estado visible y avanza a “Límites visuales” solo cuando la etapa anterior esté estable. En Entrada de imágenes, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Donnez une question à l’image », confirmez l’état visible puis passez à « Limites visuelles » seulement lorsque l’étape précédente est stable. Dans Entrée d’images, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Entrega sem surpresa","en":"Delivery without surprises","es":"Entrega sin sorpresas","fr":"Livraison sans surprise"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Entrada de imagens realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Image input truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Entrada de imágenes realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Entrée d’images exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Detalhes que evitam regressão: Entrada de imagens","en":"Details that prevent regressions: Image input","es":"Detalles que evitan regresiones: Entrada de imágenes","fr":"Détails anti-régression: Entrée d’images"},"body":[{"pt":"Nesta página, a referência completa cobre preview, leitura visual, contexto multimodal e limites de inferência. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Image input as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Entrada de imágenes como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Entrée d’images comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Entrada de imagens","en":"Edge cases for Image input","es":"Casos límite de Entrada de imágenes","fr":"Cas limites de Entrée d’images"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Image input flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Entrada de imágenes sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Entrée d’images reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"projects","group":"projects","asset":"docs","title":{"pt":"Projetos","en":"Projects","es":"Proyectos","fr":"Projets"},"lead":{"pt":"Projetos agrupam contexto persistente, fontes e conversas relacionadas ao mesmo trabalho.","en":"Projects group persistent context, sources, and conversations related to the same work.","es":"Los proyectos agrupan contexto persistente, fuentes y conversaciones relacionadas con el mismo trabajo.","fr":"Les projets regroupent contexte persistant, sources et conversations liées au même travail."},"sections":[{"title":{"pt":"Quando criar um projeto","en":"When to create a project","es":"Cuándo crear un proyecto","fr":"Quand créer un projet"},"bullets":[{"pt":"Quando várias conversas compartilham o mesmo objetivo.","en":"When several conversations share the same goal.","es":"Cuando varias conversaciones comparten el mismo objetivo.","fr":"Lorsque plusieurs conversations partagent le même objectif."},{"pt":"Quando você possui fontes recorrentes.","en":"When you have recurring sources.","es":"Cuando tienes fuentes recurrentes.","fr":"Lorsque vous avez des sources récurrentes."},{"pt":"Quando instruções específicas devem acompanhar o trabalho.","en":"When specific instructions should follow the work.","es":"Cuando instrucciones específicas deben acompañar el trabajo.","fr":"Lorsque des instructions spécifiques doivent accompagner le travail."}]},{"title":{"pt":"Organização","en":"Organization","es":"Organización","fr":"Organisation"},"body":[{"pt":"Use nomes que descrevam o objetivo e mantenha dentro do projeto apenas materiais relacionados. Isso facilita busca, retomada e revisão.","en":"Use names that describe the goal and keep only related materials inside the project. This makes search, resumption, and review easier.","es":"Usa nombres que describan el objetivo y mantén dentro del proyecto solo materiales relacionados. Esto facilita búsqueda, reanudación y revisión.","fr":"Utilisez des noms décrivant l’objectif et gardez dans le projet uniquement les éléments liés. Cela facilite recherche, reprise et révision."}]},{"title":{"pt":"Contexto persistente de verdade","en":"Truly persistent context","es":"Truly persistent context","fr":"Truly persistent context"},"body":[{"pt":"Projetos são o lugar para manter instruções, arquivos e conversas que pertencem ao mesmo objetivo. Eles valem quando o trabalho atravessa mais de uma sessão.","en":"Projects are where instructions, files, and conversations that belong to the same goal stay together. They matter when work spans more than one session.","es":"Projects are where instructions, files, and conversations that belong to the same goal stay together. They matter when work spans more than one session.","fr":"Projects are where instructions, files, and conversations that belong to the same goal stay together. They matter when work spans more than one session."}],"bullets":[{"pt":"Evite transformar projeto em simples pasta. O ganho vem de manter decisões e referências relevantes disponíveis para o próximo passo.","en":"Do not reduce a project to a folder. The value comes from keeping relevant decisions and references available for the next step.","es":"Do not reduce a project to a folder. The value comes from keeping relevant decisions and references available for the next step.","fr":"Do not reduce a project to a folder. The value comes from keeping relevant decisions and references available for the next step."}]},{"title":{"pt":"Da intenção ao resultado","en":"From intent to result","es":"De la intención al resultado","fr":"De l’intention au résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Projetos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Projects, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Proyectos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Projets, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Quando criar um projeto”, confirme o estado visível e avance para “Organização” apenas quando a etapa anterior estiver estável. Em Projetos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When to create a project”, confirm the visible state, and move to “Organization” only when the previous step is stable. In Projects, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo crear un proyecto”, confirma el estado visible y avanza a “Organización” solo cuando la etapa anterior esté estable. En Proyectos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand créer un projet », confirmez l’état visible puis passez à « Organisation » seulement lorsque l’étape précédente est stable. Dans Projets, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Durante a execução","en":"During execution","es":"Durante la ejecución","fr":"Pendant l’exécution"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Projetos realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Projects truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Proyectos realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Projets exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Projetos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Projects stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Proyectos deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Projets cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Se algo sair do esperado","en":"If something goes off track","es":"Si algo se desvía","fr":"Si quelque chose dévie"},"body":[{"pt":"Use Projetos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Projetos agrupam contexto persistente, fontes e conversas relacionadas ao mesmo trabalho. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Projects as an operational reference, not as an isolated screen. The page itself is about this: Projects group persistent context, sources, and conversations related to the same work. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Proyectos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los proyectos agrupan contexto persistente, fuentes y conversaciones relacionadas con el mismo trabajo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Projets comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les projets regroupent contexte persistant, sources et conversations liées au même travail. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Fechamento do trabalho","en":"Closing the work","es":"Cierre del trabajo","fr":"Clôture du travail"},"body":[{"pt":"Comece por “Quando criar um projeto”, confirme o estado visível e avance para “Organização” apenas quando a etapa anterior estiver estável. Em Projetos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When to create a project”, confirm the visible state, and move to “Organization” only when the previous step is stable. In Projects, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo crear un proyecto”, confirma el estado visible y avanza a “Organización” solo cuando la etapa anterior esté estable. En Proyectos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand créer un projet », confirmez l’état visible puis passez à « Organisation » seulement lorsque l’étape précédente est stable. Dans Projets, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Projetos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Projects, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Proyectos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Projets, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Mapa operacional: Projetos","en":"Operational map: Projects","es":"Mapa operativo: Proyectos","fr":"Carte opérationnelle: Projets"},"body":[{"pt":"Nesta página, a referência completa cobre instruções, fontes, memórias de projeto e retomada de contexto. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Projects as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Proyectos como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Projets comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Projetos","en":"Edge cases for Projects","es":"Casos límite de Proyectos","fr":"Cas limites de Projets"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Projects flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Proyectos sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Projets reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"project-instructions","group":"projects","asset":"docs","title":{"pt":"Instruções do projeto","en":"Project instructions","es":"Instrucciones del proyecto","fr":"Instructions du projet"},"lead":{"pt":"Instruções do projeto definem regras duráveis para as conversas daquele contexto.","en":"Project instructions define durable rules for conversations in that context.","es":"Las instrucciones del proyecto definen reglas duraderas para las conversaciones de ese contexto.","fr":"Les instructions du projet définissent des règles durables pour les conversations de ce contexte."},"sections":[{"title":{"pt":"Boas instruções","en":"Good instructions","es":"Buenas instrucciones","fr":"Bonnes instructions"},"bullets":[{"pt":"Explicam o resultado esperado e as restrições que se repetem.","en":"Explain the expected result and recurring constraints.","es":"Explican el resultado esperado y las restricciones recurrentes.","fr":"Expliquent le résultat attendu et les contraintes récurrentes."},{"pt":"Não repetem detalhes que só pertencem a uma tarefa.","en":"Do not repeat details that belong to only one task.","es":"No repiten detalles que pertenecen solo a una tarea.","fr":"Ne répètent pas les détails propres à une seule tâche."},{"pt":"São revisadas quando o projeto muda.","en":"Are reviewed when the project changes.","es":"Se revisan cuando cambia el proyecto.","fr":"Sont révisées lorsque le projet change."}]},{"title":{"pt":"Conflitos","en":"Conflicts","es":"Conflictos","fr":"Conflits"},"body":[{"pt":"O pedido atual pode trazer uma necessidade específica. Quando houver conflito, explicite qual instrução deve prevalecer em vez de depender de ambiguidade.","en":"The current request may bring a specific need. When there is a conflict, state which instruction should prevail instead of relying on ambiguity.","es":"La solicitud actual puede traer una necesidad específica. Cuando haya conflicto, indica qué instrucción debe prevalecer en lugar de depender de ambigüedad.","fr":"La demande actuelle peut apporter un besoin spécifique. En cas de conflit, indiquez quelle instruction doit primer plutôt que de dépendre de l’ambiguïté."}]},{"title":{"pt":"Hierarquia de instruções","en":"Instruction hierarchy","es":"Instruction hierarchy","fr":"Instruction hierarchy"},"body":[{"pt":"Instruções do projeto definem regras duráveis do trabalho, enquanto o prompt atual define o pedido específico daquela rodada.","en":"Project instructions define durable work rules, while the current prompt defines the specific request for that turn.","es":"Project instructions define durable work rules, while the current prompt defines the specific request for that turn.","fr":"Project instructions define durable work rules, while the current prompt defines the specific request for that turn."}],"bullets":[{"pt":"Escreva instruções estáveis e verificáveis. Evite colocar nelas detalhes que mudam a cada tarefa.","en":"Write stable, verifiable instructions. Avoid putting details there that change with every task.","es":"Write stable, verifiable instructions. Avoid putting details there that change with every task.","fr":"Write stable, verifiable instructions. Avoid putting details there that change with every task."}]},{"title":{"pt":"O papel desta página","en":"The role of this page","es":"El papel de esta página","fr":"Le rôle de cette page"},"body":[{"pt":"Use Instruções do projeto como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Instruções do projeto definem regras duráveis para as conversas daquele contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Project instructions as an operational reference, not as an isolated screen. The page itself is about this: Project instructions define durable rules for conversations in that context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Instrucciones del proyecto como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las instrucciones del proyecto definen reglas duraderas para las conversaciones de ese contexto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Instructions du projet comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les instructions du projet définissent des règles durables pour les conversations de ce contexte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Instruções do projeto o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Project instructions where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Instrucciones del proyecto el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Instructions du projet où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Uso no dia a dia","en":"Day-to-day use","es":"Uso cotidiano","fr":"Usage quotidien"},"body":[{"pt":"Comece por “Boas instruções”, confirme o estado visível e avance para “Conflitos” apenas quando a etapa anterior estiver estável. Em Instruções do projeto, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Good instructions”, confirm the visible state, and move to “Conflicts” only when the previous step is stable. In Project instructions, skipping context usually creates more rework than speed.","es":"Empieza por “Buenas instrucciones”, confirma el estado visible y avanza a “Conflictos” solo cuando la etapa anterior esté estable. En Instrucciones del proyecto, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Bonnes instructions », confirmez l’état visible puis passez à « Conflits » seulement lorsque l’étape précédente est stable. Dans Instructions du projet, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Armadilhas comuns","en":"Common traps","es":"Trampas comunes","fr":"Pièges courants"},"body":[{"pt":"Imagine uma tarefa real em que Instruções do projeto deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Project instructions stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Instrucciones del proyecto deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Instructions du projet cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Instruções do projeto realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Project instructions truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Instrucciones del proyecto realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Instructions du projet exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Conferência antes de seguir","en":"Check before moving on","es":"Comprobación antes de seguir","fr":"Vérification avant de continuer"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Instruções do projeto o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Project instructions where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Instrucciones del proyecto el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Instructions du projet où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Instruções do projeto como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Instruções do projeto definem regras duráveis para as conversas daquele contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Project instructions as an operational reference, not as an isolated screen. The page itself is about this: Project instructions define durable rules for conversations in that context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Instrucciones del proyecto como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las instrucciones del proyecto definen reglas duraderas para las conversaciones de ese contexto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Instructions du projet comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les instructions du projet définissent des règles durables pour les conversations de ce contexte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Instruções do projeto","en":"Production reference: Project instructions","es":"Referencia de producción: Instrucciones del proyecto","fr":"Référence de production: Instructions du projet"},"body":[{"pt":"Nesta página, a referência completa cobre precedência, escopo, versionamento e efeito nas respostas. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Project instructions as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Instrucciones del proyecto como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Instructions du projet comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Instruções do projeto","en":"Edge cases for Project instructions","es":"Casos límite de Instrucciones del proyecto","fr":"Cas limites de Instructions du projet"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Project instructions flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Instrucciones del proyecto sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Instructions du projet reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"artifacts","group":"content","asset":"docs","title":{"pt":"Artefatos","en":"Artifacts","es":"Artefactos","fr":"Artefacts"},"lead":{"pt":"Artefatos são resultados gerados que merecem ser abertos, revisados ou baixados como objetos próprios.","en":"Artifacts are generated results that deserve to be opened, reviewed, or downloaded as their own objects.","es":"Los artefactos son resultados generados que merecen abrirse, revisarse o descargarse como objetos propios.","fr":"Les artefacts sont des résultats générés qui méritent d’être ouverts, révisés ou téléchargés comme objets propres."},"sections":[{"title":{"pt":"O que um card mostra","en":"What a card shows","es":"Qué muestra una tarjeta","fr":"Ce qu’une carte montre"},"bullets":[{"pt":"Nome e tipo do resultado.","en":"Name and result type.","es":"Nombre y tipo del resultado.","fr":"Nom et type du résultat."},{"pt":"Preview quando ele realmente ajuda.","en":"Preview when it actually helps.","es":"Preview cuando realmente ayuda.","fr":"Aperçu lorsqu’il aide réellement."},{"pt":"Ações de abrir, baixar ou continuar trabalhando.","en":"Open, download, or continue-working actions.","es":"Acciones para abrir, descargar o seguir trabajando.","fr":"Actions pour ouvrir, télécharger ou continuer le travail."}]},{"title":{"pt":"Relação com a conversa","en":"Relationship to the conversation","es":"Relación con la conversación","fr":"Relation avec la conversation"},"body":[{"pt":"O artefato continua ligado ao pedido que o produziu, preservando o contexto de por que aquele arquivo existe.","en":"The artifact stays linked to the request that produced it, preserving context for why that file exists.","es":"El artefacto permanece ligado a la solicitud que lo produjo, preservando el contexto de por qué existe ese archivo.","fr":"L’artefact reste lié à la demande qui l’a produit, préservant le contexte expliquant pourquoi ce fichier existe."}]},{"title":{"pt":"Artefato como handoff","en":"Artifacts as handoff","es":"Artifacts as handoff","fr":"Artifacts as handoff"},"body":[{"pt":"Um artefato bom é algo que outra pessoa consegue abrir, revisar e usar sem reconstruir o raciocínio que o gerou.","en":"A good artifact is something another person can open, review, and use without reconstructing the reasoning that produced it.","es":"A good artifact is something another person can open, review, and use without reconstructing the reasoning that produced it.","fr":"A good artifact is something another person can open, review, and use without reconstructing the reasoning that produced it."}],"bullets":[{"pt":"Prefira entregas com estrutura, nome claro e estado final verificável em vez de apenas colar conteúdo no chat.","en":"Prefer deliverables with structure, clear names, and a verifiable final state instead of only pasting content into chat.","es":"Prefer deliverables with structure, clear names, and a verifiable final state instead of only pasting content into chat.","fr":"Prefer deliverables with structure, clear names, and a verifiable final state instead of only pasting content into chat."}]},{"title":{"pt":"Primeira decisão","en":"First decision","es":"Primera decisión","fr":"Première décision"},"body":[{"pt":"Imagine uma tarefa real em que Artefatos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Artifacts stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Artefactos deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Artefacts cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Como manter o contexto","en":"Keeping context intact","es":"Cómo mantener el contexto","fr":"Préserver le contexte"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Artefatos o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Artifacts where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Artefactos el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Artefacts où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Artefatos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Artefatos são resultados gerados que merecem ser abertos, revisados ou baixados como objetos próprios. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Artifacts as an operational reference, not as an isolated screen. The page itself is about this: Artifacts are generated results that deserve to be opened, reviewed, or downloaded as their own objects. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Artefactos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los artefactos son resultados generados que merecen abrirse, revisarse o descargarse como objetos propios. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Artefacts comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les artefacts sont des résultats générés qui méritent d’être ouverts, révisés ou téléchargés comme objets propres. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Falhas recuperáveis","en":"Recoverable failures","es":"Fallos recuperables","fr":"Échecs récupérables"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Artefatos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Artifacts, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Artefactos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Artefacts, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “O que um card mostra”, confirme o estado visível e avance para “Relação com a conversa” apenas quando a etapa anterior estiver estável. Em Artefatos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What a card shows”, confirm the visible state, and move to “Relationship to the conversation” only when the previous step is stable. In Artifacts, skipping context usually creates more rework than speed.","es":"Empieza por “Qué muestra una tarjeta”, confirma el estado visible y avanza a “Relación con la conversación” solo cuando la etapa anterior esté estable. En Artefactos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Ce qu’une carte montre », confirmez l’état visible puis passez à « Relation avec la conversation » seulement lorsque l’étape précédente est stable. Dans Artefacts, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Resultado esperado","en":"Expected outcome","es":"Resultado esperado","fr":"Résultat attendu"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Artefatos realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Artifacts truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Artefactos realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Artefacts exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Contrato desta superfície: Artefatos","en":"Surface contract: Artifacts","es":"Contrato de la superficie: Artefactos","fr":"Contrat de la surface: Artefacts"},"body":[{"pt":"Nesta página, a referência completa cobre criação, preview, validação, download e reabertura. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Artifacts as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Artefactos como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Artefacts comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Artefatos","en":"Edge cases for Artifacts","es":"Casos límite de Artefactos","fr":"Cas limites de Artefacts"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Artifacts flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Artefactos sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Artefacts reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"design","group":"workspaces","asset":"site","title":{"pt":"Giorgio Design","en":"Giorgio Design","es":"Giorgio Design","fr":"Giorgio Design"},"lead":{"pt":"Design transforma um brief em uma proposta visual que pode ser revisada em diferentes tamanhos e exportada.","en":"Design turns a brief into a visual proposal that can be reviewed at different sizes and exported.","es":"Design convierte un brief en una propuesta visual que puede revisarse en distintos tamaños y exportarse.","fr":"Design transforme un brief en proposition visuelle pouvant être révisée à différentes tailles et exportée."},"sections":[{"title":{"pt":"Brief primeiro","en":"Brief first","es":"Brief primero","fr":"Le brief d’abord"},"body":[{"pt":"Descreva objetivo, público, conteúdo obrigatório e restrições. Esses elementos orientam a geração melhor do que uma lista vaga de adjetivos.","en":"Describe goal, audience, required content, and constraints. These elements guide generation better than a vague list of adjectives.","es":"Describe objetivo, público, contenido obligatorio y restricciones. Estos elementos guían la generación mejor que una lista vaga de adjetivos.","fr":"Décrivez objectif, public, contenu obligatoire et contraintes. Ces éléments guident mieux la génération qu’une liste vague d’adjectifs."}]},{"title":{"pt":"Revisão visual","en":"Visual review","es":"Revisión visual","fr":"Révision visuelle"},"bullets":[{"pt":"Alterne entre desktop, tablet e mobile.","en":"Switch between desktop, tablet, and mobile.","es":"Alterna entre escritorio, tableta y móvil.","fr":"Alternez entre desktop, tablette et mobile."},{"pt":"Ajuste tema e densidade quando necessário.","en":"Adjust theme and density when needed.","es":"Ajusta tema y densidad cuando sea necesario.","fr":"Ajustez thème et densité si nécessaire."},{"pt":"Exporte apenas depois de revisar o preview.","en":"Export only after reviewing the preview.","es":"Exporta solo después de revisar el preview.","fr":"N’exportez qu’après avoir révisé l’aperçu."}]},{"title":{"pt":"Do briefing ao QA","en":"From brief to QA","es":"From brief to QA","fr":"From brief to QA"},"body":[{"pt":"Design transforma um briefing em direção visual, preview e revisão. A qualidade vem de combinar intenção estética com acessibilidade, responsividade e QA de frontend.","en":"Design turns a brief into visual direction, preview, and review. Quality comes from combining visual intent with accessibility, responsiveness, and frontend QA.","es":"Design turns a brief into visual direction, preview, and review. Quality comes from combining visual intent with accessibility, responsiveness, and frontend QA.","fr":"Design turns a brief into visual direction, preview, and review. Quality comes from combining visual intent with accessibility, responsiveness, and frontend QA."}],"bullets":[{"pt":"Use referências para calibrar ritmo, escala e hierarquia, mas mantenha identidade própria do Giorgio.","en":"Use references to calibrate rhythm, scale, and hierarchy while keeping Giorgio’s own identity.","es":"Use references to calibrate rhythm, scale, and hierarchy while keeping Giorgio’s own identity.","fr":"Use references to calibrate rhythm, scale, and hierarchy while keeping Giorgio’s own identity."}]},{"title":{"pt":"Visão prática","en":"Practical view","es":"Vista práctica","fr":"Vue pratique"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Giorgio Design, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Giorgio Design, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Giorgio Design, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Giorgio Design, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Brief primeiro”, confirme o estado visível e avance para “Revisão visual” apenas quando a etapa anterior estiver estável. Em Giorgio Design, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Brief first”, confirm the visible state, and move to “Visual review” only when the previous step is stable. In Giorgio Design, skipping context usually creates more rework than speed.","es":"Empieza por “Brief primero”, confirma el estado visible y avanza a “Revisión visual” solo cuando la etapa anterior esté estable. En Giorgio Design, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Le brief d’abord », confirmez l’état visible puis passez à « Révision visuelle » seulement lorsque l’étape précédente est stable. Dans Giorgio Design, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Fluxo mínimo","en":"Minimum viable flow","es":"Flujo mínimo","fr":"Flux minimal"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Giorgio Design realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Giorgio Design truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Giorgio Design realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Giorgio Design exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Giorgio Design deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Giorgio Design stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Giorgio Design deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Giorgio Design cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Escalando com segurança","en":"Scaling safely","es":"Escalar con seguridad","fr":"Monter en charge en sécurité"},"body":[{"pt":"Use Giorgio Design como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Design transforma um brief em uma proposta visual que pode ser revisada em diferentes tamanhos e exportada. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Giorgio Design as an operational reference, not as an isolated screen. The page itself is about this: Design turns a brief into a visual proposal that can be reviewed at different sizes and exported. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Giorgio Design como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Design convierte un brief en una propuesta visual que puede revisarse en distintos tamaños y exportarse. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Giorgio Design comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Design transforme un brief en proposition visuelle pouvant être révisée à différentes tailles et exportée. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Como saber que funcionou","en":"How to know it worked","es":"Cómo saber que funcionó","fr":"Comment savoir que cela a fonctionné"},"body":[{"pt":"Comece por “Brief primeiro”, confirme o estado visível e avance para “Revisão visual” apenas quando a etapa anterior estiver estável. Em Giorgio Design, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Brief first”, confirm the visible state, and move to “Visual review” only when the previous step is stable. In Giorgio Design, skipping context usually creates more rework than speed.","es":"Empieza por “Brief primero”, confirma el estado visible y avanza a “Revisión visual” solo cuando la etapa anterior esté estable. En Giorgio Design, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Le brief d’abord », confirmez l’état visible puis passez à « Révision visuelle » seulement lorsque l’étape précédente est stable. Dans Giorgio Design, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Giorgio Design, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Giorgio Design, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Giorgio Design, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Giorgio Design, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Giorgio Design","en":"Engineering reading: Giorgio Design","es":"Lectura de ingeniería: Giorgio Design","fr":"Lecture d’ingénierie: Giorgio Design"},"body":[{"pt":"Nesta página, a referência completa cobre briefing, direções, preview, avaliação visual, responsividade e exportação. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Giorgio Design as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Giorgio Design como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Giorgio Design comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Giorgio Design","en":"Edge cases for Giorgio Design","es":"Casos límite de Giorgio Design","fr":"Cas limites de Giorgio Design"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Giorgio Design flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Giorgio Design sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Giorgio Design reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"cowork","group":"workspaces","asset":"docs","title":{"pt":"Giorgio Cowork","en":"Giorgio Cowork","es":"Giorgio Cowork","fr":"Giorgio Cowork"},"lead":{"pt":"Cowork organiza fontes, tarefa e saídas para trabalhos que precisam de contexto e entrega.","en":"Cowork organizes sources, task, and outputs for work that needs context and delivery.","es":"Cowork organiza fuentes, tarea y salidas para trabajos que necesitan contexto y entrega.","fr":"Cowork organise sources, tâche et sorties pour les travaux nécessitant contexte et livraison."},"sections":[{"title":{"pt":"Estrutura do workspace","en":"Workspace structure","es":"Estructura del workspace","fr":"Structure de l’espace"},"bullets":[{"pt":"Fontes e contexto de entrada.","en":"Input sources and context.","es":"Fuentes y contexto de entrada.","fr":"Sources et contexte d’entrée."},{"pt":"Descrição da tarefa atual.","en":"Description of the current task.","es":"Descripción de la tarea actual.","fr":"Description de la tâche actuelle."},{"pt":"Saídas e artefatos produzidos.","en":"Produced outputs and artifacts.","es":"Salidas y artefactos producidos.","fr":"Sorties et artefacts produits."}]},{"title":{"pt":"Use quando","en":"Use it when","es":"Úsalo cuando","fr":"Utilisez-le lorsque"},"body":[{"pt":"O trabalho se beneficia de uma visão explícita do que entrou, do que está sendo feito e do que saiu.","en":"The work benefits from an explicit view of what came in, what is being done, and what came out.","es":"El trabajo se beneficia de una vista explícita de lo que entró, lo que se está haciendo y lo que salió.","fr":"Le travail bénéficie d’une vue explicite de ce qui est entré, de ce qui est fait et de ce qui est sorti."}]},{"title":{"pt":"Delegar sem perder controle","en":"Delegate without losing control","es":"Delegate without losing control","fr":"Delegate without losing control"},"body":[{"pt":"Cowork é para tarefas em que o Giorgio pode avançar por etapas, reunir contexto e devolver um resultado revisável.","en":"Cowork is for tasks where Giorgio can advance through steps, gather context, and return a reviewable result.","es":"Cowork is for tasks where Giorgio can advance through steps, gather context, and return a reviewable result.","fr":"Cowork is for tasks where Giorgio can advance through steps, gather context, and return a reviewable result."}],"bullets":[{"pt":"Delegação boa define objetivo, limite e critério de conclusão; delegação vaga produz atividade sem garantia de utilidade.","en":"Good delegation defines the goal, boundaries, and completion criteria; vague delegation produces activity without guaranteed usefulness.","es":"Good delegation defines the goal, boundaries, and completion criteria; vague delegation produces activity without guaranteed usefulness.","fr":"Good delegation defines the goal, boundaries, and completion criteria; vague delegation produces activity without guaranteed usefulness."}]},{"title":{"pt":"Como isso entra no fluxo","en":"How this fits the workflow","es":"Cómo entra esto en el flujo","fr":"Comment cela s’insère dans le flux"},"body":[{"pt":"Use Giorgio Cowork como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Cowork organiza fontes, tarefa e saídas para trabalhos que precisam de contexto e entrega. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Giorgio Cowork as an operational reference, not as an isolated screen. The page itself is about this: Cowork organizes sources, task, and outputs for work that needs context and delivery. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Giorgio Cowork como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Cowork organiza fuentes, tarea y salidas para trabajos que necesitan contexto y entrega. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Giorgio Cowork comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Cowork organise sources, tâche et sorties pour les travaux nécessitant contexte et livraison. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Giorgio Cowork o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Giorgio Cowork where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Giorgio Cowork el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Giorgio Cowork où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Cenário real","en":"Real-world scenario","es":"Escenario real","fr":"Scénario réel"},"body":[{"pt":"Comece por “Estrutura do workspace”, confirme o estado visível e avance para “Use quando” apenas quando a etapa anterior estiver estável. Em Giorgio Cowork, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Workspace structure”, confirm the visible state, and move to “Use it when” only when the previous step is stable. In Giorgio Cowork, skipping context usually creates more rework than speed.","es":"Empieza por “Estructura del workspace”, confirma el estado visible y avanza a “Úsalo cuando” solo cuando la etapa anterior esté estable. En Giorgio Cowork, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Structure de l’espace », confirmez l’état visible puis passez à « Utilisez-le lorsque » seulement lorsque l’étape précédente est stable. Dans Giorgio Cowork, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Onde costuma quebrar","en":"Where it usually breaks","es":"Dónde suele fallar","fr":"Là où cela casse souvent"},"body":[{"pt":"Imagine uma tarefa real em que Giorgio Cowork deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Giorgio Cowork stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Giorgio Cowork deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Giorgio Cowork cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Giorgio Cowork realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Giorgio Cowork truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Giorgio Cowork realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Giorgio Cowork exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Critério de conclusão","en":"Definition of done","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Giorgio Cowork o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Giorgio Cowork where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Giorgio Cowork el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Giorgio Cowork où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Giorgio Cowork como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Cowork organiza fontes, tarefa e saídas para trabalhos que precisam de contexto e entrega. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Giorgio Cowork as an operational reference, not as an isolated screen. The page itself is about this: Cowork organizes sources, task, and outputs for work that needs context and delivery. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Giorgio Cowork como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Cowork organiza fuentes, tarea y salidas para trabajos que necesitan contexto y entrega. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Giorgio Cowork comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Cowork organise sources, tâche et sorties pour les travaux nécessitant contexte et livraison. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Checklist de integração: Giorgio Cowork","en":"Integration checklist: Giorgio Cowork","es":"Checklist de integración: Giorgio Cowork","fr":"Checklist d’intégration: Giorgio Cowork"},"body":[{"pt":"Nesta página, a referência completa cobre delegação, fontes, plano, progresso, subagentes, handoffs e entrega. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Giorgio Cowork as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Giorgio Cowork como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Giorgio Cowork comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Giorgio Cowork","en":"Edge cases for Giorgio Cowork","es":"Casos límite de Giorgio Cowork","fr":"Cas limites de Giorgio Cowork"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Giorgio Cowork flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Giorgio Cowork sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Giorgio Cowork reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"memories","group":"personalization","asset":"docs","title":{"pt":"Memórias","en":"Memories","es":"Memorias","fr":"Mémoires"},"lead":{"pt":"Memórias guardam contexto durável que pode melhorar respostas futuras e pode ser revisto nas configurações.","en":"Memories store durable context that can improve future answers and can be reviewed in settings.","es":"Las memorias guardan contexto duradero que puede mejorar respuestas futuras y puede revisarse en configuración.","fr":"Les mémoires conservent un contexte durable pouvant améliorer les réponses futures et être révisé dans les réglages."},"sections":[{"title":{"pt":"Bom candidato a memória","en":"Good memory candidate","es":"Buen candidato a memoria","fr":"Bon candidat à la mémoire"},"bullets":[{"pt":"Preferência que se repete por meses.","en":"A preference that repeats for months.","es":"Una preferencia que se repite durante meses.","fr":"Une préférence qui se répète pendant des mois."},{"pt":"Regra de trabalho estável.","en":"A stable working rule.","es":"Una regla de trabajo estable.","fr":"Une règle de travail stable."},{"pt":"Contexto que muda consistentemente respostas futuras.","en":"Context that consistently changes future answers.","es":"Contexto que cambia consistentemente respuestas futuras.","fr":"Contexte qui modifie de manière cohérente les réponses futures."}]},{"title":{"pt":"Revise e remova","en":"Review and remove","es":"Revisa y elimina","fr":"Révisez et supprimez"},"body":[{"pt":"Se uma memória ficou desatualizada ou deixou de ser útil, remova-a. A personalização funciona melhor quando o contexto persistente continua pequeno e correto.","en":"If a memory becomes outdated or no longer useful, remove it. Personalization works best when persistent context stays small and correct.","es":"Si una memoria queda desactualizada o deja de ser útil, elimínala. La personalización funciona mejor cuando el contexto persistente sigue pequeño y correcto.","fr":"Si une mémoire devient obsolète ou inutile, supprimez-la. La personnalisation fonctionne mieux lorsque le contexte persistant reste petit et correct."}]},{"title":{"pt":"Memória com provenance","en":"Memory with provenance","es":"Memory with provenance","fr":"Memory with provenance"},"body":[{"pt":"Memória útil precisa ser controlável e ter origem compreensível. Nem todo detalhe de uma conversa merece virar contexto durável.","en":"Useful memory should be controllable and have understandable provenance. Not every conversation detail deserves durable context.","es":"Useful memory should be controllable and have understandable provenance. Not every conversation detail deserves durable context.","fr":"Useful memory should be controllable and have understandable provenance. Not every conversation detail deserves durable context."}],"bullets":[{"pt":"Promova apenas preferências e fatos estáveis que realmente melhoram futuras tarefas; descarte hipóteses, exemplos e detalhes temporários.","en":"Promote only stable preferences and facts that genuinely improve future tasks; discard hypotheses, examples, and temporary details.","es":"Promote only stable preferences and facts that genuinely improve future tasks; discard hypotheses, examples, and temporary details.","fr":"Promote only stable preferences and facts that genuinely improve future tasks; discard hypotheses, examples, and temporary details."}]},{"title":{"pt":"Antes de começar","en":"Before you start","es":"Antes de empezar","fr":"Avant de commencer"},"body":[{"pt":"Imagine uma tarefa real em que Memórias deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Memories stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Memorias deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Mémoires cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Sequência recomendada","en":"Recommended sequence","es":"Secuencia recomendada","fr":"Séquence recommandée"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Memórias o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Memories where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Memorias el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Mémoires où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Memórias como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Memórias guardam contexto durável que pode melhorar respostas futuras e pode ser revisto nas configurações. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Memories as an operational reference, not as an isolated screen. The page itself is about this: Memories store durable context that can improve future answers and can be reviewed in settings. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Memorias como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las memorias guardan contexto duradero que puede mejorar respuestas futuras y puede revisarse en configuración. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Mémoires comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les mémoires conservent un contexte durable pouvant améliorer les réponses futures et être révisé dans les réglages. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Decisões que mudam o resultado","en":"Decisions that change the outcome","es":"Decisiones que cambian el resultado","fr":"Décisions qui changent le résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Memórias, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Memories, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Memorias, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Mémoires, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Bom candidato a memória”, confirme o estado visível e avance para “Revise e remova” apenas quando a etapa anterior estiver estável. Em Memórias, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Good memory candidate”, confirm the visible state, and move to “Review and remove” only when the previous step is stable. In Memories, skipping context usually creates more rework than speed.","es":"Empieza por “Buen candidato a memoria”, confirma el estado visible y avanza a “Revisa y elimina” solo cuando la etapa anterior esté estable. En Memorias, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Bon candidat à la mémoire », confirmez l’état visible puis passez à « Révisez et supprimez » seulement lorsque l’étape précédente est stable. Dans Mémoires, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Como validar","en":"How to validate","es":"Cómo validar","fr":"Comment valider"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Memórias realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Memories truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Memorias realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Mémoires exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Matriz de comportamento: Memórias","en":"Behavior matrix: Memories","es":"Matriz de comportamiento: Memorias","fr":"Matrice de comportement: Mémoires"},"body":[{"pt":"Nesta página, a referência completa cobre captura, promoção, relevância, origem, confiança e exclusão. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Memories as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Memorias como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Mémoires comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Memórias","en":"Edge cases for Memories","es":"Casos límite de Memorias","fr":"Cas limites de Mémoires"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Memories flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Memorias sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Mémoires reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"connectors","group":"extensions","asset":"connectors","title":{"pt":"Conectores","en":"Connectors","es":"Conectores","fr":"Connecteurs"},"lead":{"pt":"Conectores permitem ligar serviços externos ao Giorgio quando uma tarefa precisa desse contexto.","en":"Connectors let external services be linked to Giorgio when a task needs that context.","es":"Los conectores permiten enlazar servicios externos con Giorgio cuando una tarea necesita ese contexto.","fr":"Les connecteurs permettent de relier des services externes à Giorgio lorsqu’une tâche a besoin de ce contexte."},"sections":[{"title":{"pt":"Conectar um serviço","en":"Connect a service","es":"Conectar un servicio","fr":"Connecter un service"},"bullets":[{"pt":"Escolha o conector disponível.","en":"Choose the available connector.","es":"Elige el conector disponible.","fr":"Choisissez le connecteur disponible."},{"pt":"Revise a finalidade e permissões apresentadas.","en":"Review the displayed purpose and permissions.","es":"Revisa la finalidad y permisos mostrados.","fr":"Examinez l’objectif et les autorisations affichés."},{"pt":"Conclua a autorização exigida pelo serviço.","en":"Complete the authorization required by the service.","es":"Completa la autorización requerida por el servicio.","fr":"Terminez l’autorisation requise par le service."},{"pt":"Confirme o estado conectado antes de depender dele.","en":"Confirm the connected state before relying on it.","es":"Confirma el estado conectado antes de depender de él.","fr":"Confirmez l’état connecté avant d’en dépendre."}]},{"title":{"pt":"Desconectar","en":"Disconnect","es":"Desconectar","fr":"Déconnecter"},"body":[{"pt":"Quando uma integração não for mais necessária, use o controle de desconexão correspondente. A disponibilidade e o fluxo exato dependem do conector mostrado no catálogo.","en":"When an integration is no longer needed, use its disconnect control. Availability and exact flow depend on the connector shown in the catalog.","es":"Cuando una integración ya no sea necesaria, usa el control de desconexión correspondiente. La disponibilidad y el flujo exacto dependen del conector mostrado en el catálogo.","fr":"Lorsqu’une intégration n’est plus nécessaire, utilisez son contrôle de déconnexion. La disponibilité et le flux exact dépendent du connecteur affiché dans le catalogue."}]},{"title":{"pt":"Permissão antes de conveniência","en":"Permission before convenience","es":"Permission before convenience","fr":"Permission before convenience"},"body":[{"pt":"Conectores dão acesso a serviços externos e por isso devem tornar escopo e autorização explícitos antes de agir.","en":"Connectors provide access to external services and therefore should make scope and authorization explicit before acting.","es":"Connectors provide access to external services and therefore should make scope and authorization explicit before acting.","fr":"Connectors provide access to external services and therefore should make scope and authorization explicit before acting."}],"bullets":[{"pt":"O fluxo certo mostra o que será lido ou alterado e não confunde conexão disponível com permissão para executar qualquer ação.","en":"The right flow shows what will be read or changed and does not confuse an available connection with permission to perform any action.","es":"The right flow shows what will be read or changed and does not confuse an available connection with permission to perform any action.","fr":"The right flow shows what will be read or changed and does not confuse an available connection with permission to perform any action."}]},{"title":{"pt":"Leitura operacional","en":"Operational reading","es":"Lectura operativa","fr":"Lecture opérationnelle"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Conectores, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Connectors, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Conectores, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Connecteurs, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Conectar um serviço”, confirme o estado visível e avance para “Desconectar” apenas quando a etapa anterior estiver estável. Em Conectores, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Connect a service”, confirm the visible state, and move to “Disconnect” only when the previous step is stable. In Connectors, skipping context usually creates more rework than speed.","es":"Empieza por “Conectar un servicio”, confirma el estado visible y avanza a “Desconectar” solo cuando la etapa anterior esté estable. En Conectores, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Connecter un service », confirmez l’état visible puis passez à « Déconnecter » seulement lorsque l’étape précédente est stable. Dans Connecteurs, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Do primeiro clique à entrega","en":"From first click to delivery","es":"Del primer clic a la entrega","fr":"Du premier clic à la livraison"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Conectores realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Connectors truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Conectores realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Connecteurs exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Conectores deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Connectors stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Conectores deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Connecteurs cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Limites e exceções","en":"Limits and exceptions","es":"Límites y excepciones","fr":"Limites et exceptions"},"body":[{"pt":"Use Conectores como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Conectores permitem ligar serviços externos ao Giorgio quando uma tarefa precisa desse contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Connectors as an operational reference, not as an isolated screen. The page itself is about this: Connectors let external services be linked to Giorgio when a task needs that context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Conectores como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los conectores permiten enlazar servicios externos con Giorgio cuando una tarea necesita ese contexto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Connecteurs comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les connecteurs permettent de relier des services externes à Giorgio lorsqu’une tâche a besoin de ce contexte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Checklist de uso","en":"Usage checklist","es":"Lista de uso","fr":"Liste de contrôle"},"body":[{"pt":"Comece por “Conectar um serviço”, confirme o estado visível e avance para “Desconectar” apenas quando a etapa anterior estiver estável. Em Conectores, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Connect a service”, confirm the visible state, and move to “Disconnect” only when the previous step is stable. In Connectors, skipping context usually creates more rework than speed.","es":"Empieza por “Conectar un servicio”, confirma el estado visible y avanza a “Desconectar” solo cuando la etapa anterior esté estable. En Conectores, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Connecter un service », confirmez l’état visible puis passez à « Déconnecter » seulement lorsque l’étape précédente est stable. Dans Connecteurs, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Conectores, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Connectors, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Conectores, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Connecteurs, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Guia de verificação: Conectores","en":"Verification guide: Connectors","es":"Guía de verificación: Conectores","fr":"Guide de vérification: Connecteurs"},"body":[{"pt":"Nesta página, a referência completa cobre OAuth, escopos, leitura, escrita e fronteiras de autorização. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Connectors as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Conectores como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Connecteurs comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Conectores","en":"Edge cases for Connectors","es":"Casos límite de Conectores","fr":"Cas limites de Connecteurs"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Connectors flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Conectores sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Connecteurs reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"plugins","group":"extensions","asset":"connectors","title":{"pt":"Plugins","en":"Plugins","es":"Plugins","fr":"Plugins"},"lead":{"pt":"O catálogo de plugins reúne capacidades adicionais e mostra o que está disponível ou instalado.","en":"The plugin catalog groups additional capabilities and shows what is available or installed.","es":"El catálogo de plugins reúne capacidades adicionales y muestra lo disponible o instalado.","fr":"Le catalogue de plugins regroupe des capacités supplémentaires et indique ce qui est disponible ou installé."},"sections":[{"title":{"pt":"Descobrir","en":"Discover","es":"Descubrir","fr":"Découvrir"},"body":[{"pt":"Navegue pelas categorias e leia a descrição de cada item antes de instalar. O objetivo é entender que problema aquela extensão ajuda a resolver.","en":"Browse categories and read each item’s description before installing. The goal is to understand what problem that extension helps solve.","es":"Navega por categorías y lee la descripción de cada elemento antes de instalarlo. El objetivo es entender qué problema ayuda a resolver esa extensión.","fr":"Parcourez les catégories et lisez la description de chaque élément avant de l’installer. L’objectif est de comprendre quel problème cette extension aide à résoudre."}]},{"title":{"pt":"Estados","en":"States","es":"Estados","fr":"États"},"bullets":[{"pt":"Disponível para instalar.","en":"Available to install.","es":"Disponible para instalar.","fr":"Disponible à l’installation."},{"pt":"Instalado.","en":"Installed.","es":"Instalado.","fr":"Installé."},{"pt":"Aguardando configuração quando o plugin exigir uma etapa adicional.","en":"Awaiting configuration when the plugin requires an additional step.","es":"Pendiente de configuración cuando el plugin requiere un paso adicional.","fr":"En attente de configuration lorsque le plugin nécessite une étape supplémentaire."}]},{"title":{"pt":"Capacidades com limites claros","en":"Capabilities with clear boundaries","es":"Capabilities with clear boundaries","fr":"Capabilities with clear boundaries"},"body":[{"pt":"Plugins ampliam o que o Giorgio pode fazer, mas cada capacidade continua sujeita ao contrato da ferramenta conectada.","en":"Plugins expand what Giorgio can do, but each capability remains subject to the connected tool contract.","es":"Plugins expand what Giorgio can do, but each capability remains subject to the connected tool contract.","fr":"Plugins expand what Giorgio can do, but each capability remains subject to the connected tool contract."}],"bullets":[{"pt":"Use plugins quando eles realmente acrescentam uma ação ou fonte; evite encadear ferramentas só para tornar o fluxo mais complexo.","en":"Use plugins when they genuinely add an action or source; avoid chaining tools just to make the flow more complex.","es":"Use plugins when they genuinely add an action or source; avoid chaining tools just to make the flow more complex.","fr":"Use plugins when they genuinely add an action or source; avoid chaining tools just to make the flow more complex."}]},{"title":{"pt":"O que merece atenção","en":"What deserves attention","es":"Qué merece atención","fr":"Ce qui mérite l’attention"},"body":[{"pt":"Use Plugins como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O catálogo de plugins reúne capacidades adicionais e mostra o que está disponível ou instalado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Plugins as an operational reference, not as an isolated screen. The page itself is about this: The plugin catalog groups additional capabilities and shows what is available or installed. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Plugins como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El catálogo de plugins reúne capacidades adicionales y muestra lo disponible o instalado. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Plugins comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le catalogue de plugins regroupe des capacités supplémentaires et indique ce qui est disponible ou installé. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Plugins o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Plugins where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Plugins el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Plugins où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Um fluxo que funciona","en":"A workflow that works","es":"Un flujo que funciona","fr":"Un flux qui fonctionne"},"body":[{"pt":"Comece por “Descobrir”, confirme o estado visível e avance para “Estados” apenas quando a etapa anterior estiver estável. Em Plugins, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Discover”, confirm the visible state, and move to “States” only when the previous step is stable. In Plugins, skipping context usually creates more rework than speed.","es":"Empieza por “Descubrir”, confirma el estado visible y avanza a “Estados” solo cuando la etapa anterior esté estable. En Plugins, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Découvrir », confirmez l’état visible puis passez à « États » seulement lorsque l’étape précédente est stable. Dans Plugins, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Quando mudar de estratégia","en":"When to change strategy","es":"Cuándo cambiar de estrategia","fr":"Quand changer de stratégie"},"body":[{"pt":"Imagine uma tarefa real em que Plugins deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Plugins stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Plugins deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Plugins cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Plugins realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Plugins truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Plugins realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Plugins exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Sinais de que terminou","en":"Signals that you are done","es":"Señales de finalización","fr":"Signes que le travail est terminé"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Plugins o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Plugins where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Plugins el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Plugins où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Plugins como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O catálogo de plugins reúne capacidades adicionais e mostra o que está disponível ou instalado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Plugins as an operational reference, not as an isolated screen. The page itself is about this: The plugin catalog groups additional capabilities and shows what is available or installed. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Plugins como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El catálogo de plugins reúne capacidades adicionales y muestra lo disponible o instalado. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Plugins comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le catalogue de plugins regroupe des capacités supplémentaires et indique ce qui est disponible ou installé. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Detalhes que evitam regressão: Plugins","en":"Details that prevent regressions: Plugins","es":"Detalles que evitan regresiones: Plugins","fr":"Détails anti-régression: Plugins"},"body":[{"pt":"Nesta página, a referência completa cobre descoberta, capacidade, permissão, execução real e resultado observável. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Plugins as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Plugins como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Plugins comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Plugins","en":"Edge cases for Plugins","es":"Casos límite de Plugins","fr":"Cas limites de Plugins"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Plugins flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Plugins sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Plugins reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"privacy","group":"account","asset":"docs","title":{"pt":"Privacidade","en":"Privacy","es":"Privacidad","fr":"Confidentialité"},"lead":{"pt":"As configurações de privacidade reúnem controles e informações sobre dados, sessões e uso da conta.","en":"Privacy settings group controls and information about data, sessions, and account use.","es":"La configuración de privacidad reúne controles e información sobre datos, sesiones y uso de la cuenta.","fr":"Les réglages de confidentialité regroupent contrôles et informations sur les données, sessions et usage du compte."},"sections":[{"title":{"pt":"Revise antes de mudar","en":"Review before changing","es":"Revisa antes de cambiar","fr":"Révisez avant de modifier"},"body":[{"pt":"Leia a descrição de cada controle para entender o efeito na conta. Ações de exclusão ou remoção de dados devem ser tratadas como operações sensíveis.","en":"Read each control’s description to understand its effect on the account. Deletion or data-removal actions should be treated as sensitive operations.","es":"Lee la descripción de cada control para entender su efecto en la cuenta. Las acciones de eliminación de datos deben tratarse como operaciones sensibles.","fr":"Lisez la description de chaque contrôle pour comprendre son effet sur le compte. Les actions de suppression de données doivent être traitées comme des opérations sensibles."}]},{"title":{"pt":"Conteúdo público e privado","en":"Public and private content","es":"Contenido público y privado","fr":"Contenu public et privé"},"body":[{"pt":"Blog e documentação são públicos. Conversas, projetos, memórias e outras superfícies pessoais continuam associados à sessão autenticada.","en":"Blog and documentation are public. Conversations, projects, memories, and other personal surfaces remain associated with the authenticated session.","es":"El blog y la documentación son públicos. Conversaciones, proyectos, memorias y otras superficies personales siguen asociadas a la sesión autenticada.","fr":"Le blog et la documentation sont publics. Conversations, projets, mémoires et autres surfaces personnelles restent associés à la session authentifiée."}]},{"title":{"pt":"Fronteiras de dados","en":"Data boundaries","es":"Data boundaries","fr":"Data boundaries"},"body":[{"pt":"Privacidade depende de saber onde o dado entra, onde é armazenado e quando é compartilhado com uma ferramenta ou serviço conectado.","en":"Privacy depends on knowing where data enters, where it is stored, and when it is shared with a connected tool or service.","es":"Privacy depends on knowing where data enters, where it is stored, and when it is shared with a connected tool or service.","fr":"Privacy depends on knowing where data enters, where it is stored, and when it is shared with a connected tool or service."}],"bullets":[{"pt":"Escolha chat temporário, projeto, memória ou conector com base no ciclo de vida desejado para a informação.","en":"Choose temporary chat, project, memory, or connector based on the intended lifecycle of the information.","es":"Choose temporary chat, project, memory, or connector based on the intended lifecycle of the information.","fr":"Choose temporary chat, project, memory, or connector based on the intended lifecycle of the information."}]},{"title":{"pt":"Mapa da experiência","en":"Experience map","es":"Mapa de la experiencia","fr":"Carte de l’expérience"},"body":[{"pt":"Imagine uma tarefa real em que Privacidade deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Privacy stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Privacidad deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Confidentialité cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Aplicação prática","en":"Practical application","es":"Aplicación práctica","fr":"Application pratique"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Privacidade o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Privacy where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Privacidad el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Confidentialité où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Privacidade como uma referência de operação, não como uma tela isolada. A própria proposta da página é: As configurações de privacidade reúnem controles e informações sobre dados, sessões e uso da conta. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Privacy as an operational reference, not as an isolated screen. The page itself is about this: Privacy settings group controls and information about data, sessions, and account use. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Privacidad como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La configuración de privacidad reúne controles e información sobre datos, sesiones y uso de la cuenta. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Confidentialité comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les réglages de confidentialité regroupent contrôles et informations sur les données, sessions et usage du compte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Erros fáceis de evitar","en":"Easy mistakes to avoid","es":"Errores fáciles de evitar","fr":"Erreurs faciles à éviter"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Privacidade, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Privacy, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Privacidad, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Confidentialité, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Revise antes de mudar”, confirme o estado visível e avance para “Conteúdo público e privado” apenas quando a etapa anterior estiver estável. Em Privacidade, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Review before changing”, confirm the visible state, and move to “Public and private content” only when the previous step is stable. In Privacy, skipping context usually creates more rework than speed.","es":"Empieza por “Revisa antes de cambiar”, confirma el estado visible y avanza a “Contenido público y privado” solo cuando la etapa anterior esté estable. En Privacidad, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Révisez avant de modifier », confirmez l’état visible puis passez à « Contenu public et privé » seulement lorsque l’étape précédente est stable. Dans Confidentialité, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Revisão final","en":"Final review","es":"Revisión final","fr":"Révision finale"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Privacidade realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Privacy truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Privacidad realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Confidentialité exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Mapa operacional: Privacidade","en":"Operational map: Privacy","es":"Mapa operativo: Privacidad","fr":"Carte opérationnelle: Confidentialité"},"body":[{"pt":"Nesta página, a referência completa cobre retenção, dados conectados, telemetria, temporário e controle do usuário. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Privacy as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Privacidad como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Confidentialité comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Privacidade","en":"Edge cases for Privacy","es":"Casos límite de Privacidad","fr":"Cas limites de Confidentialité"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Privacy flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Privacidad sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Confidentialité reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"language","group":"personalization","asset":"site","title":{"pt":"Idioma","en":"Language","es":"Idioma","fr":"Langue"},"lead":{"pt":"A interface pode seguir o idioma detectado ou uma preferência manual salva no navegador.","en":"The interface can follow the detected language or a manual preference saved in the browser.","es":"La interfaz puede seguir el idioma detectado o una preferencia manual guardada en el navegador.","fr":"L’interface peut suivre la langue détectée ou une préférence manuelle enregistrée dans le navigateur."},"sections":[{"title":{"pt":"Detecção automática","en":"Automatic detection","es":"Detección automática","fr":"Détection automatique"},"body":[{"pt":"Sem escolha manual, o Giorgio usa a preferência de idioma do navegador para selecionar português, inglês, espanhol ou francês quando reconhecidos.","en":"Without a manual choice, Giorgio uses the browser language preference to select Portuguese, English, Spanish, or French when recognized.","es":"Sin elección manual, Giorgio usa la preferencia de idioma del navegador para seleccionar portugués, inglés, español o francés cuando se reconocen.","fr":"Sans choix manuel, Giorgio utilise la préférence linguistique du navigateur pour sélectionner portugais, anglais, espagnol ou français lorsqu’ils sont reconnus."}]},{"title":{"pt":"Escolha manual","en":"Manual choice","es":"Elección manual","fr":"Choix manuel"},"body":[{"pt":"Ao trocar o idioma nas páginas públicas, a preferência é salva e o conteúdo inteiro é renderizado novamente no idioma escolhido.","en":"When you change language on public pages, the preference is saved and the entire content is rendered again in the chosen language.","es":"Al cambiar el idioma en las páginas públicas, la preferencia se guarda y todo el contenido se vuelve a renderizar en el idioma elegido.","fr":"Lorsque vous changez la langue sur les pages publiques, la préférence est enregistrée et tout le contenu est rendu de nouveau dans la langue choisie."}]},{"title":{"pt":"Detecção e escolha manual","en":"Detection and manual choice","es":"Detection and manual choice","fr":"Detection and manual choice"},"body":[{"pt":"O idioma pode ser detectado automaticamente, mas a escolha manual precisa sempre vencer quando o usuário a define.","en":"Language may be detected automatically, but a manual choice should always win once the user sets it.","es":"Language may be detected automatically, but a manual choice should always win once the user sets it.","fr":"Language may be detected automatically, but a manual choice should always win once the user sets it."}],"bullets":[{"pt":"Conteúdo público, mensagens de sistema e documentação devem seguir a mesma preferência para evitar telas parcialmente traduzidas.","en":"Public content, system messages, and documentation should follow the same preference to avoid partially translated screens.","es":"Public content, system messages, and documentation should follow the same preference to avoid partially translated screens.","fr":"Public content, system messages, and documentation should follow the same preference to avoid partially translated screens."}]},{"title":{"pt":"Ponto de partida","en":"Starting point","es":"Punto de partida","fr":"Point de départ"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Idioma, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Language, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Idioma, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Langue, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Detecção automática”, confirme o estado visível e avance para “Escolha manual” apenas quando a etapa anterior estiver estável. Em Idioma, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Automatic detection”, confirm the visible state, and move to “Manual choice” only when the previous step is stable. In Language, skipping context usually creates more rework than speed.","es":"Empieza por “Detección automática”, confirma el estado visible y avanza a “Elección manual” solo cuando la etapa anterior esté estable. En Idioma, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Détection automatique », confirmez l’état visible puis passez à « Choix manuel » seulement lorsque l’étape précédente est stable. Dans Langue, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Trabalho em camadas","en":"Layered work","es":"Trabajo por capas","fr":"Travail par couches"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Idioma realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Language truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Idioma realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Langue exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Idioma deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Language stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Idioma deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Langue cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Diagnóstico rápido","en":"Fast diagnosis","es":"Diagnóstico rápido","fr":"Diagnostic rapide"},"body":[{"pt":"Use Idioma como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A interface pode seguir o idioma detectado ou uma preferência manual salva no navegador. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Language as an operational reference, not as an isolated screen. The page itself is about this: The interface can follow the detected language or a manual preference saved in the browser. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Idioma como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La interfaz puede seguir el idioma detectado o una preferencia manual guardada en el navegador. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Langue comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : L’interface peut suivre la langue détectée ou une préférence manuelle enregistrée dans le navigateur. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Próximo passo","en":"Next step","es":"Siguiente paso","fr":"Étape suivante"},"body":[{"pt":"Comece por “Detecção automática”, confirme o estado visível e avance para “Escolha manual” apenas quando a etapa anterior estiver estável. Em Idioma, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Automatic detection”, confirm the visible state, and move to “Manual choice” only when the previous step is stable. In Language, skipping context usually creates more rework than speed.","es":"Empieza por “Detección automática”, confirma el estado visible y avanza a “Elección manual” solo cuando la etapa anterior esté estable. En Idioma, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Détection automatique », confirmez l’état visible puis passez à « Choix manuel » seulement lorsque l’étape précédente est stable. Dans Langue, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Idioma, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Language, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Idioma, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Langue, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Idioma","en":"Production reference: Language","es":"Referencia de producción: Idioma","fr":"Référence de production: Langue"},"body":[{"pt":"Nesta página, a referência completa cobre detecção inicial, persistência, catálogo PT/EN/ES/FR e conteúdo dinâmico. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Language as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Idioma como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Langue comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Idioma","en":"Edge cases for Language","es":"Casos límite de Idioma","fr":"Cas limites de Langue"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Language flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Idioma sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Langue reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"mobile","group":"experience","asset":"site","title":{"pt":"Uso no celular","en":"Mobile use","es":"Uso en móvil","fr":"Utilisation mobile"},"lead":{"pt":"O layout mobile reorganiza navegação, composer e painéis para telas estreitas e para o teclado virtual.","en":"The mobile layout reorganizes navigation, composer, and panels for narrow screens and the virtual keyboard.","es":"El layout móvil reorganiza navegación, composer y paneles para pantallas estrechas y teclado virtual.","fr":"Le layout mobile réorganise navigation, composer et panneaux pour les écrans étroits et le clavier virtuel."},"sections":[{"title":{"pt":"Sidebar como drawer","en":"Sidebar as a drawer","es":"Sidebar como drawer","fr":"Barre latérale comme drawer"},"body":[{"pt":"Em vez de ocupar largura fixa, a navegação principal abre sobre o conteúdo e fecha após a escolha.","en":"Instead of occupying fixed width, main navigation opens over content and closes after selection.","es":"En lugar de ocupar ancho fijo, la navegación principal se abre sobre el contenido y se cierra tras la elección.","fr":"Au lieu d’occuper une largeur fixe, la navigation principale s’ouvre sur le contenu et se ferme après le choix."}]},{"title":{"pt":"Teclado virtual","en":"Virtual keyboard","es":"Teclado virtual","fr":"Clavier virtuel"},"body":[{"pt":"O app usa a viewport visual quando disponível para evitar que campos e ações principais fiquem escondidos atrás do teclado.","en":"The app uses the visual viewport when available to keep fields and primary actions from being hidden behind the keyboard.","es":"La app usa el viewport visual cuando está disponible para evitar que campos y acciones principales queden ocultos detrás del teclado.","fr":"L’application utilise le viewport visuel lorsqu’il est disponible afin d’éviter que champs et actions principales soient masqués par le clavier."}]},{"title":{"pt":"Prioridade para a tarefa atual","en":"Prioritize the current task","es":"Prioritize the current task","fr":"Prioritize the current task"},"body":[{"pt":"No celular, espaço é o recurso mais escasso. Composer, leitura e ações essenciais precisam vir antes de painéis secundários.","en":"On mobile, space is the scarcest resource. Composer, reading, and essential actions should come before secondary panels.","es":"On mobile, space is the scarcest resource. Composer, reading, and essential actions should come before secondary panels.","fr":"On mobile, space is the scarcest resource. Composer, reading, and essential actions should come before secondary panels."}],"bullets":[{"pt":"Evite controles que dependam de hover e garanta que imagens, previews e documentos caibam sem recorte acidental.","en":"Avoid controls that depend on hover and ensure images, previews, and documents fit without accidental cropping.","es":"Avoid controls that depend on hover and ensure images, previews, and documents fit without accidental cropping.","fr":"Avoid controls that depend on hover and ensure images, previews, and documents fit without accidental cropping."}]},{"title":{"pt":"Como pensar esta área","en":"How to think about this area","es":"Cómo pensar esta área","fr":"Comment penser cette zone"},"body":[{"pt":"Use Uso no celular como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O layout mobile reorganiza navegação, composer e painéis para telas estreitas e para o teclado virtual. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Mobile use as an operational reference, not as an isolated screen. The page itself is about this: The mobile layout reorganizes navigation, composer, and panels for narrow screens and the virtual keyboard. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Uso en móvil como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El layout móvil reorganiza navegación, composer y paneles para pantallas estrechas y teclado virtual. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Utilisation mobile comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le layout mobile réorganise navigation, composer et panneaux pour les écrans étroits et le clavier virtuel. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Uso no celular o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Mobile use where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Uso en móvil el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Utilisation mobile où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Exemplo de uso","en":"Usage example","es":"Ejemplo de uso","fr":"Exemple d’utilisation"},"body":[{"pt":"Comece por “Sidebar como drawer”, confirme o estado visível e avance para “Teclado virtual” apenas quando a etapa anterior estiver estável. Em Uso no celular, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Sidebar as a drawer”, confirm the visible state, and move to “Virtual keyboard” only when the previous step is stable. In Mobile use, skipping context usually creates more rework than speed.","es":"Empieza por “Sidebar como drawer”, confirma el estado visible y avanza a “Teclado virtual” solo cuando la etapa anterior esté estable. En Uso en móvil, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Barre latérale comme drawer », confirmez l’état visible puis passez à « Clavier virtuel » seulement lorsque l’étape précédente est stable. Dans Utilisation mobile, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Quando não usar","en":"When not to use it","es":"Cuándo no usarlo","fr":"Quand ne pas l’utiliser"},"body":[{"pt":"Imagine uma tarefa real em que Uso no celular deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Mobile use stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Uso en móvil deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Utilisation mobile cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Uso no celular realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Mobile use truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Uso en móvil realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Utilisation mobile exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Verificação independente","en":"Independent verification","es":"Verificación independiente","fr":"Vérification indépendante"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Uso no celular o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Mobile use where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Uso en móvil el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Utilisation mobile où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Uso no celular como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O layout mobile reorganiza navegação, composer e painéis para telas estreitas e para o teclado virtual. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Mobile use as an operational reference, not as an isolated screen. The page itself is about this: The mobile layout reorganizes navigation, composer, and panels for narrow screens and the virtual keyboard. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Uso en móvil como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El layout móvil reorganiza navegación, composer y paneles para pantallas estrechas y teclado virtual. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Utilisation mobile comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le layout mobile réorganise navigation, composer et panneaux pour les écrans étroits et le clavier virtuel. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Contrato desta superfície: Uso no celular","en":"Surface contract: Mobile use","es":"Contrato de la superficie: Uso en móvil","fr":"Contrat de la surface: Utilisation mobile"},"body":[{"pt":"Nesta página, a referência completa cobre viewport, teclado, safe-area, touch, overlays e composição compacta. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Mobile use as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Uso en móvil como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Utilisation mobile comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Uso no celular","en":"Edge cases for Mobile use","es":"Casos límite de Uso en móvil","fr":"Cas limites de Utilisation mobile"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Mobile use flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Uso en móvil sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Utilisation mobile reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"reflect","group":"experience","asset":"site","title":{"pt":"Refletir","en":"Reflect","es":"Reflexionar","fr":"Réfléchir"},"lead":{"pt":"Refletir resume padrões do histórico salvo com gráficos de ritmo, dias, horários e assuntos.","en":"Reflect summarizes patterns from saved history with charts for rhythm, days, hours, and topics.","es":"Reflexionar resume patrones del historial guardado con gráficos de ritmo, días, horarios y temas.","fr":"Réfléchir résume les tendances de l’historique enregistré avec des graphiques de rythme, jours, heures et sujets."},"sections":[{"title":{"pt":"O que aparece","en":"What appears","es":"Qué aparece","fr":"Ce qui apparaît"},"bullets":[{"pt":"Atividade do mês.","en":"Monthly activity.","es":"Actividad del mes.","fr":"Activité du mois."},{"pt":"Distribuição por dias da semana.","en":"Distribution by weekday.","es":"Distribución por días de la semana.","fr":"Répartition par jour de la semaine."},{"pt":"Horários de uso.","en":"Usage hours.","es":"Horarios de uso.","fr":"Heures d’utilisation."},{"pt":"Categorias frequentes.","en":"Frequent categories.","es":"Categorías frecuentes.","fr":"Catégories fréquentes."}]},{"title":{"pt":"Fonte dos dados","en":"Data source","es":"Fuente de los datos","fr":"Source des données"},"body":[{"pt":"O painel usa o histórico salvo disponível para a conta. Conversas temporárias não fazem parte desse resumo.","en":"The panel uses saved history available to the account. Temporary conversations are not part of this summary.","es":"El panel usa el historial guardado disponible para la cuenta. Las conversaciones temporales no forman parte de este resumen.","fr":"Le panneau utilise l’historique enregistré disponible pour le compte. Les conversations temporaires ne font pas partie de ce résumé."}]},{"title":{"pt":"Atividade que responde perguntas","en":"Activity that answers questions","es":"Activity that answers questions","fr":"Activity that answers questions"},"body":[{"pt":"Refletir só é útil quando o gráfico responde perguntas sobre ritmo, horário, foco e volume em vez de existir como decoração.","en":"Reflect is useful only when charts answer questions about rhythm, timing, focus, and volume instead of existing as decoration.","es":"Reflect is useful only when charts answer questions about rhythm, timing, focus, and volume instead of existing as decoration.","fr":"Reflect is useful only when charts answer questions about rhythm, timing, focus, and volume instead of existing as decoration."}],"bullets":[{"pt":"Use as métricas para detectar padrões de uso, não para transformar quantidade de prompts em uma falsa medida de produtividade.","en":"Use metrics to spot usage patterns, not to turn prompt counts into a false measure of productivity.","es":"Use metrics to spot usage patterns, not to turn prompt counts into a false measure of productivity.","fr":"Use metrics to spot usage patterns, not to turn prompt counts into a false measure of productivity."}]},{"title":{"pt":"Objetivo e contexto","en":"Goal and context","es":"Objetivo y contexto","fr":"Objectif et contexte"},"body":[{"pt":"Imagine uma tarefa real em que Refletir deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Reflect stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Reflexionar deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Réfléchir cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Ordem das ações","en":"Order of actions","es":"Orden de acciones","fr":"Ordre des actions"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Refletir o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Reflect where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Reflexionar el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Réfléchir où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Refletir como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Refletir resume padrões do histórico salvo com gráficos de ritmo, dias, horários e assuntos. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Reflect as an operational reference, not as an isolated screen. The page itself is about this: Reflect summarizes patterns from saved history with charts for rhythm, days, hours, and topics. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Reflexionar como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Reflexionar resume patrones del historial guardado con gráficos de ritmo, días, horarios y temas. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Réfléchir comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Réfléchir résume les tendances de l’historique enregistré avec des graphiques de rythme, jours, heures et sujets. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Casos de borda","en":"Edge cases","es":"Casos límite","fr":"Cas limites"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Refletir, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Reflect, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Reflexionar, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Réfléchir, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “O que aparece”, confirme o estado visível e avance para “Fonte dos dados” apenas quando a etapa anterior estiver estável. Em Refletir, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What appears”, confirm the visible state, and move to “Data source” only when the previous step is stable. In Reflect, skipping context usually creates more rework than speed.","es":"Empieza por “Qué aparece”, confirma el estado visible y avanza a “Fuente de los datos” solo cuando la etapa anterior esté estable. En Reflexionar, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Ce qui apparaît », confirmez l’état visible puis passez à « Source des données » seulement lorsque l’étape précédente est stable. Dans Réfléchir, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Entrega sem surpresa","en":"Delivery without surprises","es":"Entrega sin sorpresas","fr":"Livraison sans surprise"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Refletir realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Reflect truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Reflexionar realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Réfléchir exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Refletir","en":"Engineering reading: Reflect","es":"Lectura de ingeniería: Reflexionar","fr":"Lecture d’ingénierie: Réfléchir"},"body":[{"pt":"Nesta página, a referência completa cobre eventos, métricas, período, interpretação e limites de inferência. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Reflect as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Reflexionar como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Réfléchir comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Refletir","en":"Edge cases for Reflect","es":"Casos límite de Reflexionar","fr":"Cas limites de Réfléchir"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Reflect flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Reflexionar sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Réfléchir reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"settings","group":"account","asset":"docs","title":{"pt":"Configurações","en":"Settings","es":"Configuración","fr":"Réglages"},"lead":{"pt":"Configurações reúne conta, privacidade, capacidades, memórias, personalização e outras preferências do app.","en":"Settings brings together account, privacy, capabilities, memories, personalization, and other app preferences.","es":"Configuración reúne cuenta, privacidad, capacidades, memorias, personalización y otras preferencias de la app.","fr":"Réglages regroupe compte, confidentialité, capacités, mémoires, personnalisation et autres préférences de l’application."},"sections":[{"title":{"pt":"Use a busca","en":"Use search","es":"Usa la búsqueda","fr":"Utilisez la recherche"},"body":[{"pt":"Quando disponível, a busca do painel reduz o tempo para encontrar uma opção em listas maiores.","en":"When available, panel search reduces the time needed to find an option in larger lists.","es":"Cuando está disponible, la búsqueda del panel reduce el tiempo para encontrar una opción en listas largas.","fr":"Lorsqu’elle est disponible, la recherche du panneau réduit le temps nécessaire pour trouver une option dans de longues listes."}]},{"title":{"pt":"Ações sensíveis","en":"Sensitive actions","es":"Acciones sensibles","fr":"Actions sensibles"},"body":[{"pt":"Alterações de conta, privacidade e exclusão merecem leitura da descrição e confirmação antes de serem executadas.","en":"Account, privacy, and deletion changes deserve reading the description and confirming before execution.","es":"Los cambios de cuenta, privacidad y eliminación merecen leer la descripción y confirmar antes de ejecutarse.","fr":"Les modifications de compte, confidentialité et suppression méritent lecture de la description et confirmation avant exécution."}]},{"title":{"pt":"Preferências persistentes","en":"Persistent preferences","es":"Persistent preferences","fr":"Persistent preferences"},"body":[{"pt":"Configurações devem alterar comportamento real e persistir de forma previsível entre sessões.","en":"Settings should change real behavior and persist predictably between sessions.","es":"Settings should change real behavior and persist predictably between sessions.","fr":"Settings should change real behavior and persist predictably between sessions."}],"bullets":[{"pt":"Se uma opção só existe como aparência de controle, ela não deveria estar na página até ter efeito concreto.","en":"If an option exists only as the appearance of a control, it should not be on the page until it has a concrete effect.","es":"If an option exists only as the appearance of a control, it should not be on the page until it has a concrete effect.","fr":"If an option exists only as the appearance of a control, it should not be on the page until it has a concrete effect."}]},{"title":{"pt":"Da intenção ao resultado","en":"From intent to result","es":"De la intención al resultado","fr":"De l’intention au résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Configurações, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Settings, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Configuración, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Réglages, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Use a busca”, confirme o estado visível e avance para “Ações sensíveis” apenas quando a etapa anterior estiver estável. Em Configurações, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Use search”, confirm the visible state, and move to “Sensitive actions” only when the previous step is stable. In Settings, skipping context usually creates more rework than speed.","es":"Empieza por “Usa la búsqueda”, confirma el estado visible y avanza a “Acciones sensibles” solo cuando la etapa anterior esté estable. En Configuración, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Utilisez la recherche », confirmez l’état visible puis passez à « Actions sensibles » seulement lorsque l’étape précédente est stable. Dans Réglages, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Durante a execução","en":"During execution","es":"Durante la ejecución","fr":"Pendant l’exécution"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Configurações realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Settings truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Configuración realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Réglages exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Configurações deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Settings stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Configuración deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Réglages cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Se algo sair do esperado","en":"If something goes off track","es":"Si algo se desvía","fr":"Si quelque chose dévie"},"body":[{"pt":"Use Configurações como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Configurações reúne conta, privacidade, capacidades, memórias, personalização e outras preferências do app. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Settings as an operational reference, not as an isolated screen. The page itself is about this: Settings brings together account, privacy, capabilities, memories, personalization, and other app preferences. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Configuración como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Configuración reúne cuenta, privacidad, capacidades, memorias, personalización y otras preferencias de la app. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Réglages comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Réglages regroupe compte, confidentialité, capacités, mémoires, personnalisation et autres préférences de l’application. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Fechamento do trabalho","en":"Closing the work","es":"Cierre del trabajo","fr":"Clôture du travail"},"body":[{"pt":"Comece por “Use a busca”, confirme o estado visível e avance para “Ações sensíveis” apenas quando a etapa anterior estiver estável. Em Configurações, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Use search”, confirm the visible state, and move to “Sensitive actions” only when the previous step is stable. In Settings, skipping context usually creates more rework than speed.","es":"Empieza por “Usa la búsqueda”, confirma el estado visible y avanza a “Acciones sensibles” solo cuando la etapa anterior esté estable. En Configuración, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Utilisez la recherche », confirmez l’état visible puis passez à « Actions sensibles » seulement lorsque l’étape précédente est stable. Dans Réglages, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Configurações, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Settings, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Configuración, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Réglages, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Checklist de integração: Configurações","en":"Integration checklist: Settings","es":"Checklist de integración: Configuración","fr":"Checklist d’intégration: Réglages"},"body":[{"pt":"Nesta página, a referência completa cobre defaults, progressive disclosure, persistência e efeito real dos controles. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Settings as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Configuración como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Réglages comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Configurações","en":"Edge cases for Settings","es":"Casos límite de Configuración","fr":"Cas limites de Réglages"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Settings flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Configuración sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Réglages reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"capabilities","group":"account","asset":"docs","title":{"pt":"Planos","en":"Plans","es":"Planes","fr":"Offres"},"lead":{"pt":"Compare Free e Optima com benefícios reais, limites, preço e o tipo de uso para o qual cada plano foi desenhado.","en":"Compare Free and Optima with real benefits, limits, pricing, and the kind of use each plan is designed for.","es":"Compara Free y Optima con beneficios reales, límites, precio y el tipo de uso para el que fue diseñado cada plan.","fr":"Comparez Free et Optima avec les avantages réels, les limites, le prix et le type d’usage prévu pour chaque offre."},"sections":[{"title":{"pt":"Free: o que já vem incluído","en":"Free: what is already included","es":"Free: what is already included","fr":"Free: what is already included"},"body":[{"pt":"O Free é um plano funcional, não uma demonstração vazia. Ele cobre Chat, Projetos, memória, busca na web, conectores, artefatos, criação de arquivos, plugins e Giorgio Code para uso cotidiano.","en":"Free is a functional plan, not an empty demo. It covers Chat, Projects, memory, web search, connectors, artifacts, file creation, plugins, and Giorgio Code for everyday use.","es":"Free is a functional plan, not an empty demo. It covers Chat, Projects, memory, web search, connectors, artifacts, file creation, plugins, and Giorgio Code for everyday use.","fr":"Free is a functional plan, not an empty demo. It covers Chat, Projects, memory, web search, connectors, artifacts, file creation, plugins, and Giorgio Code for everyday use."}],"bullets":[{"pt":"500 mil tokens por janela móvel de 5 horas.","en":"500k tokens per rolling 5-hour window.","es":"500k tokens per rolling 5-hour window.","fr":"500k tokens per rolling 5-hour window."},{"pt":"Bom para estudo, escrita, pesquisa, projetos pontuais e uso casual/intermediário de Code.","en":"Good for study, writing, research, one-off projects, and casual/intermediate Code use.","es":"Good for study, writing, research, one-off projects, and casual/intermediate Code use.","fr":"Good for study, writing, research, one-off projects, and casual/intermediate Code use."},{"pt":"Sem custo mensal.","en":"No monthly charge.","es":"No monthly charge.","fr":"No monthly charge."}]},{"title":{"pt":"Optima: onde o ganho aparece","en":"Optima: where the gain shows up","es":"Optima: where the gain shows up","fr":"Optima: where the gain shows up"},"body":[{"pt":"Optima é para quem transforma o Giorgio em ferramenta de trabalho recorrente e começa a sentir o atrito da janela do Free. O foco é dar mais folga operacional, prioridade e continuidade para sessões intensas.","en":"Optima is for people who turn Giorgio into a recurring work tool and start feeling the friction of the Free window. The focus is more operational headroom, priority, and continuity for intensive sessions.","es":"Optima is for people who turn Giorgio into a recurring work tool and start feeling the friction of the Free window. The focus is more operational headroom, priority, and continuity for intensive sessions.","fr":"Optima is for people who turn Giorgio into a recurring work tool and start feeling the friction of the Free window. The focus is more operational headroom, priority, and continuity for intensive sessions."}],"bullets":[{"pt":"Mais adequado para uso profissional e sessões longas.","en":"Better suited for professional use and long sessions.","es":"Better suited for professional use and long sessions.","fr":"Better suited for professional use and long sessions."},{"pt":"Mais confortável para Giorgio Code, revisão iterativa e trabalho delegado.","en":"More comfortable for Giorgio Code, iterative review, and delegated work.","es":"More comfortable for Giorgio Code, iterative review, and delegated work.","fr":"More comfortable for Giorgio Code, iterative review, and delegated work."},{"pt":"Menos interrupção quando o volume de uso é alto.","en":"Less interruption when usage volume is high.","es":"Less interruption when usage volume is high.","fr":"Less interruption when usage volume is high."}]},{"title":{"pt":"Preço","en":"Price","es":"Price","fr":"Price"},"body":[{"pt":"Na interface atual, o Optima aparece por R$ 23,99/mês em contexto brasileiro e US$ 4.99/mês em contexto internacional. O valor final pode variar por região, moeda, impostos e método de pagamento.","en":"In the current interface, Optima is shown at R$ 23.99/month in Brazilian context and US$ 4.99/month internationally. Final pricing may vary by region, currency, taxes, and payment method.","es":"In the current interface, Optima is shown at R$ 23.99/month in Brazilian context and US$ 4.99/month internationally. Final pricing may vary by region, currency, taxes, and payment method.","fr":"In the current interface, Optima is shown at R$ 23.99/month in Brazilian context and US$ 4.99/month internationally. Final pricing may vary by region, currency, taxes, and payment method."}]},{"title":{"pt":"Quando vale ficar no Free","en":"When staying on Free makes sense","es":"When staying on Free makes sense","fr":"When staying on Free makes sense"},"body":[{"pt":"Fique no Free se o uso é leve, intermitente ou se você raramente atinge a janela móvel. Para muita gente, ele já cobre o fluxo inteiro sem custo.","en":"Stay on Free if usage is light, intermittent, or if you rarely hit the rolling window. For many people, it already covers the full workflow at no cost.","es":"Stay on Free if usage is light, intermittent, or if you rarely hit the rolling window. For many people, it already covers the full workflow at no cost.","fr":"Stay on Free if usage is light, intermittent, or if you rarely hit the rolling window. For many people, it already covers the full workflow at no cost."}]},{"title":{"pt":"Quando vale subir para Optima","en":"When Optima makes sense","es":"When Optima makes sense","fr":"When Optima makes sense"},"body":[{"pt":"Optima passa a fazer sentido quando o custo de interromper uma sessão, esperar a janela resetar ou dividir trabalho pesado já supera o valor mensal do plano.","en":"Optima starts making sense when the cost of interrupting a session, waiting for the window to reset, or splitting heavy work already exceeds the monthly plan price.","es":"Optima starts making sense when the cost of interrupting a session, waiting for the window to reset, or splitting heavy work already exceeds the monthly plan price.","fr":"Optima starts making sense when the cost of interrupting a session, waiting for the window to reset, or splitting heavy work already exceeds the monthly plan price."}],"bullets":[{"pt":"Você atinge o limite do Free com frequência.","en":"You hit the Free limit frequently.","es":"You hit the Free limit frequently.","fr":"You hit the Free limit frequently."},{"pt":"Você usa Giorgio todos os dias em trabalho real.","en":"You use Giorgio every day for real work.","es":"You use Giorgio every day for real work.","fr":"You use Giorgio every day for real work."},{"pt":"Você quer previsibilidade para fluxos longos de Code ou Cowork.","en":"You want predictable long Code or Cowork workflows.","es":"You want predictable long Code or Cowork workflows.","fr":"You want predictable long Code or Cowork workflows."}]},{"title":{"pt":"O papel desta página","en":"The role of this page","es":"El papel de esta página","fr":"Le rôle de cette page"},"body":[{"pt":"Use Planos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Compare Free e Optima com benefícios reais, limites, preço e o tipo de uso para o qual cada plano foi desenhado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Plans as an operational reference, not as an isolated screen. The page itself is about this: Compare Free and Optima with real benefits, limits, pricing, and the kind of use each plan is designed for. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Planes como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Compara Free y Optima con beneficios reales, límites, precio y el tipo de uso para el que fue diseñado cada plan. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Offres comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Comparez Free et Optima avec les avantages réels, les limites, le prix et le type d’usage prévu pour chaque offre. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Planos o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Plans where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Planes el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Offres où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Uso no dia a dia","en":"Day-to-day use","es":"Uso cotidiano","fr":"Usage quotidien"},"body":[{"pt":"Comece por “Free: o que já vem incluído”, confirme o estado visível e avance para “Optima: onde o ganho aparece” apenas quando a etapa anterior estiver estável. Em Planos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Free: what is already included”, confirm the visible state, and move to “Optima: where the gain shows up” only when the previous step is stable. In Plans, skipping context usually creates more rework than speed.","es":"Empieza por “Free: what is already included”, confirma el estado visible y avanza a “Optima: where the gain shows up” solo cuando la etapa anterior esté estable. En Planes, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Free: what is already included », confirmez l’état visible puis passez à « Optima: where the gain shows up » seulement lorsque l’étape précédente est stable. Dans Offres, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Matriz de comportamento: Planos","en":"Behavior matrix: Plans","es":"Matriz de comportamiento: Planes","fr":"Matrice de comportement: Offres"},"body":[{"pt":"Nesta página, a referência completa cobre Free, Optima, limites, preços, Thesis 2.1, Office, Code e prioridade. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Plans as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Planes como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Offres comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Planos","en":"Edge cases for Plans","es":"Casos límite de Planes","fr":"Cas limites de Offres"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Plans flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Planes sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Offres reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Free · R$ 0 / US$ 0","en":"Free · R$ 0 / US$ 0","es":"Free · R$ 0 / US$ 0","fr":"Free · R$ 0 / US$ 0"},{"pt":"Optima · R$ 23,99 / US$ 4.99 por mês*","en":"Optima · R$ 23.99 / US$ 4.99 per month*","es":"Optima · R$ 23.99 / US$ 4.99 per month*","fr":"Optima · R$ 23.99 / US$ 4.99 per month*"},{"pt":"*Preço regional pode variar por país, moeda, impostos e método de pagamento.","en":"*Regional pricing may vary by country, currency, taxes, and payment method.","es":"*Regional pricing may vary by country, currency, taxes, and payment method.","fr":"*Regional pricing may vary by country, currency, taxes, and payment method."}]},{"slug":"account","group":"account","asset":"docs","title":{"pt":"Conta","en":"Account","es":"Cuenta","fr":"Compte"},"lead":{"pt":"A página de conta reúne identificação, sessão, segurança e ações ligadas ao perfil autenticado.","en":"The account page groups identity, session, security, and actions tied to the authenticated profile.","es":"La página de cuenta reúne identificación, sesión, seguridad y acciones ligadas al perfil autenticado.","fr":"La page Compte regroupe identité, session, sécurité et actions liées au profil authentifié."},"sections":[{"title":{"pt":"Sessões e dispositivos","en":"Sessions and devices","es":"Sesiones y dispositivos","fr":"Sessions et appareils"},"body":[{"pt":"Quando o app mostra sessões ativas, use essa área para reconhecer onde a conta está conectada e encerrar acessos que não devem permanecer ativos.","en":"When the app shows active sessions, use that area to recognize where the account is signed in and end access that should no longer remain active.","es":"Cuando la app muestra sesiones activas, usa esa área para reconocer dónde está conectada la cuenta y cerrar accesos que no deben seguir activos.","fr":"Lorsque l’application affiche les sessions actives, utilisez cette zone pour reconnaître où le compte est connecté et fermer les accès qui ne doivent plus rester actifs."}]},{"title":{"pt":"Dados de conta","en":"Account data","es":"Datos de cuenta","fr":"Données du compte"},"body":[{"pt":"Alterações permanentes devem ser feitas com atenção aos avisos exibidos pelo próprio painel.","en":"Permanent changes should be made with attention to the warnings shown by the panel itself.","es":"Los cambios permanentes deben realizarse prestando atención a los avisos del propio panel.","fr":"Les modifications permanentes doivent être effectuées en tenant compte des avertissements affichés par le panneau lui-même."}]},{"title":{"pt":"Conta, identidade e recuperação","en":"Account, identity, and recovery","es":"Account, identity, and recovery","fr":"Account, identity, and recovery"},"body":[{"pt":"A área de conta reúne identidade, segurança de acesso e recuperação. Mudanças críticas precisam de feedback claro e estado confirmável.","en":"The account area brings together identity, access security, and recovery. Critical changes need clear feedback and confirmable state.","es":"The account area brings together identity, access security, and recovery. Critical changes need clear feedback and confirmable state.","fr":"The account area brings together identity, access security, and recovery. Critical changes need clear feedback and confirmable state."}],"bullets":[{"pt":"Ao trocar e-mail, senha ou método de acesso, preserve a sessão quando seguro e explique quando uma nova autenticação é necessária.","en":"When changing email, password, or sign-in method, preserve the session when safe and explain when fresh authentication is required.","es":"When changing email, password, or sign-in method, preserve the session when safe and explain when fresh authentication is required.","fr":"When changing email, password, or sign-in method, preserve the session when safe and explain when fresh authentication is required."}]},{"title":{"pt":"Primeira decisão","en":"First decision","es":"Primera decisión","fr":"Première décision"},"body":[{"pt":"Imagine uma tarefa real em que Conta deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Account stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Cuenta deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Compte cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Como manter o contexto","en":"Keeping context intact","es":"Cómo mantener el contexto","fr":"Préserver le contexte"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Conta o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Account where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Cuenta el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Compte où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Conta como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A página de conta reúne identificação, sessão, segurança e ações ligadas ao perfil autenticado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Account as an operational reference, not as an isolated screen. The page itself is about this: The account page groups identity, session, security, and actions tied to the authenticated profile. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Cuenta como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La página de cuenta reúne identificación, sesión, seguridad y acciones ligadas al perfil autenticado. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Compte comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La page Compte regroupe identité, session, sécurité et actions liées au profil authentifié. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Falhas recuperáveis","en":"Recoverable failures","es":"Fallos recuperables","fr":"Échecs récupérables"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Conta, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Account, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Cuenta, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Compte, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Sessões e dispositivos”, confirme o estado visível e avance para “Dados de conta” apenas quando a etapa anterior estiver estável. Em Conta, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Sessions and devices”, confirm the visible state, and move to “Account data” only when the previous step is stable. In Account, skipping context usually creates more rework than speed.","es":"Empieza por “Sesiones y dispositivos”, confirma el estado visible y avanza a “Datos de cuenta” solo cuando la etapa anterior esté estable. En Cuenta, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Sessions et appareils », confirmez l’état visible puis passez à « Données du compte » seulement lorsque l’étape précédente est stable. Dans Compte, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Resultado esperado","en":"Expected outcome","es":"Resultado esperado","fr":"Résultat attendu"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Conta realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Account truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Cuenta realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Compte exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Guia de verificação: Conta","en":"Verification guide: Account","es":"Guía de verificación: Cuenta","fr":"Guide de vérification: Compte"},"body":[{"pt":"Nesta página, a referência completa cobre perfil, sessão, plano, exclusão, segurança e estado da conta. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Account as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Cuenta como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Compte comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Conta","en":"Edge cases for Account","es":"Casos límite de Cuenta","fr":"Cas limites de Compte"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Account flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Cuenta sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Compte reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"troubleshooting","group":"help","asset":"docs","title":{"pt":"Solução de problemas","en":"Troubleshooting","es":"Solución de problemas","fr":"Dépannage"},"lead":{"pt":"Comece pela etapa que falhou e pelo estado visível antes de apagar dados, reinstalar ou mudar configurações.","en":"Start with the failed step and visible state before deleting data, reinstalling, or changing settings.","es":"Empieza por el paso que falló y el estado visible antes de borrar datos, reinstalar o cambiar configuración.","fr":"Commencez par l’étape qui a échoué et l’état visible avant de supprimer des données, réinstaller ou modifier les réglages."},"sections":[{"title":{"pt":"Login não conclui","en":"Login does not complete","es":"El login no termina","fr":"La connexion ne se termine pas"},"bullets":[{"pt":"Confira conexão e se o navegador permite armazenamento necessário.","en":"Check connectivity and whether the browser allows required storage.","es":"Comprueba la conexión y si el navegador permite el almacenamiento necesario.","fr":"Vérifiez la connexion et si le navigateur autorise le stockage nécessaire."},{"pt":"Tente uma sessão normal do navegador antes de limpar todos os dados.","en":"Try a normal browser session before clearing all data.","es":"Prueba una sesión normal del navegador antes de borrar todos los datos.","fr":"Essayez une session normale du navigateur avant d’effacer toutes les données."}]},{"title":{"pt":"Uma página fica vazia","en":"A page is blank","es":"Una página queda vacía","fr":"Une page reste vide"},"bullets":[{"pt":"Recarregue e observe se aparece um aviso específico.","en":"Reload and look for a specific notice.","es":"Recarga y observa si aparece un aviso específico.","fr":"Rechargez et vérifiez si un avertissement spécifique apparaît."},{"pt":"Se houver console disponível, um erro de sintaxe ou rede ajuda a localizar a etapa.","en":"If a console is available, a syntax or network error helps locate the step.","es":"Si hay consola disponible, un error de sintaxis o red ayuda a localizar el paso.","fr":"Si une console est disponible, une erreur de syntaxe ou réseau aide à localiser l’étape."}]},{"title":{"pt":"Ao reportar","en":"When reporting","es":"Al reportar","fr":"Lors du signalement"},"body":[{"pt":"Inclua a rota, ação feita, mensagem exibida e captura quando possível. Isso é muito mais útil do que apenas “não funciona”.","en":"Include the route, action taken, displayed message, and a screenshot when possible. That is far more useful than only “it does not work.”","es":"Incluye la ruta, acción realizada, mensaje mostrado y una captura cuando sea posible. Eso es mucho más útil que solo “no funciona”.","fr":"Incluez la route, l’action effectuée, le message affiché et une capture si possible. C’est bien plus utile que simplement « ça ne marche pas »."}]},{"title":{"pt":"Diagnóstico antes de tentativa aleatória","en":"Diagnose before random retries","es":"Diagnose before random retries","fr":"Diagnose before random retries"},"body":[{"pt":"Solução de problemas começa separando falha de rede, autenticação, limite, modelo, ferramenta e interface. Cada classe pede uma resposta diferente.","en":"Troubleshooting starts by separating network, authentication, limit, model, tool, and interface failures. Each class needs a different response.","es":"Troubleshooting starts by separating network, authentication, limit, model, tool, and interface failures. Each class needs a different response.","fr":"Troubleshooting starts by separating network, authentication, limit, model, tool, and interface failures. Each class needs a different response."}],"bullets":[{"pt":"Registre código, status, etapa e contexto. Isso transforma “não funcionou” em uma falha reproduzível.","en":"Record the code, status, step, and context. That turns “it did not work” into a reproducible failure.","es":"Record the code, status, step, and context. That turns “it did not work” into a reproducible failure.","fr":"Record the code, status, step, and context. That turns “it did not work” into a reproducible failure."}]},{"title":{"pt":"Visão prática","en":"Practical view","es":"Vista práctica","fr":"Vue pratique"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Solução de problemas, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Troubleshooting, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Solución de problemas, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Dépannage, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Login não conclui”, confirme o estado visível e avance para “Uma página fica vazia” apenas quando a etapa anterior estiver estável. Em Solução de problemas, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Login does not complete”, confirm the visible state, and move to “A page is blank” only when the previous step is stable. In Troubleshooting, skipping context usually creates more rework than speed.","es":"Empieza por “El login no termina”, confirma el estado visible y avanza a “Una página queda vacía” solo cuando la etapa anterior esté estable. En Solución de problemas, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « La connexion ne se termine pas », confirmez l’état visible puis passez à « Une page reste vide » seulement lorsque l’étape précédente est stable. Dans Dépannage, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.","en":"In the main app, preserve continuity across conversation, project, file, and action so the user does not have to rebuild context on every screen.","es":"En la aplicación principal, conserva la continuidad entre conversación, proyecto, archivo y acción para que el usuario no tenga que reconstruir el contexto en cada pantalla.","fr":"Dans l’application principale, préservez la continuité entre conversation, projet, fichier et action afin que l’utilisateur n’ait pas à reconstruire le contexte à chaque écran."}]},{"title":{"pt":"Fluxo mínimo","en":"Minimum viable flow","es":"Flujo mínimo","fr":"Flux minimal"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Solução de problemas realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Troubleshooting truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Solución de problemas realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Dépannage exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Solução de problemas deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Troubleshooting stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Solución de problemas deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Dépannage cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Escalando com segurança","en":"Scaling safely","es":"Escalar con seguridad","fr":"Monter en charge en sécurité"},"body":[{"pt":"Use Solução de problemas como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Comece pela etapa que falhou e pelo estado visível antes de apagar dados, reinstalar ou mudar configurações. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Troubleshooting as an operational reference, not as an isolated screen. The page itself is about this: Start with the failed step and visible state before deleting data, reinstalling, or changing settings. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Solución de problemas como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Empieza por el paso que falló y el estado visible antes de borrar datos, reinstalar o cambiar configuración. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Dépannage comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Commencez par l’étape qui a échoué et l’état visible avant de supprimer des données, réinstaller ou modifier les réglages. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Detalhes que evitam regressão: Solução de problemas","en":"Details that prevent regressions: Troubleshooting","es":"Detalles que evitan regresiones: Solución de problemas","fr":"Détails anti-régression: Dépannage"},"body":[{"pt":"Nesta página, a referência completa cobre classificação de falha, evidência, recuperação e escalonamento. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Troubleshooting as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Solución de problemas como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Dépannage comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Solução de problemas","en":"Edge cases for Troubleshooting","es":"Casos límite de Solución de problemas","fr":"Cas limites de Dépannage"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Troubleshooting flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Solución de problemas sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Dépannage reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência de produto","en":"Product reference","es":"Product reference","fr":"Product reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"office-overview","group":"workspaces","asset":"browserDoc","title":{"pt":"Giorgio Office","en":"Giorgio Office","es":"Giorgio Office","fr":"Giorgio Office"},"lead":{"pt":"A suíte de produtividade do Giorgio: planilhas, documentos, apresentações, comunicação, notas, formulários, reuniões e planejamento sob um contexto compartilhado.","en":"Giorgio’s productivity suite: spreadsheets, documents, presentations, communication, notes, forms, meetings, and planning under shared context.","es":"La suite de productividad de Giorgio: hojas, documentos, presentaciones, comunicación, notas, formularios, reuniones y planificación bajo un contexto compartido.","fr":"La suite de productivité de Giorgio : tableurs, documents, présentations, communication, notes, formulaires, réunions et planification dans un contexte partagé."},"facts":[{"pt":"8 superfícies integradas","en":"8 integrated surfaces","es":"8 superficies integradas","fr":"8 surfaces intégrées"},{"pt":"Persistência local + sync autenticado","en":"Local persistence + authenticated sync","es":"Persistencia local + sync autenticado","fr":"Persistance locale + sync authentifié"},{"pt":"Agente Giorgio entre apps","en":"Giorgio agent across apps","es":"Agente Giorgio entre apps","fr":"Agent Giorgio entre applications"}],"sections":[{"title":{"pt":"Arquitetura da suíte","en":"Suite architecture","es":"Arquitectura de la suite","fr":"Architecture de la suite"},"body":[{"pt":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena e Acta compartilham identidade, persistência e um contrato de handoff. Cada app mantém sua gramática de produtividade familiar, mas o contexto pode atravessar planilha, documento, slide, agenda e tarefa sem exigir exportações intermediárias.","en":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena, and Acta share identity, persistence, and a handoff contract. Each app keeps a familiar productivity grammar while context can cross spreadsheet, document, slide, calendar, and task without intermediate exports.","es":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena y Acta comparten identidad, persistencia y contrato de handoff. Cada app conserva una gramática familiar mientras el contexto atraviesa hoja, documento, slide, calendario y tarea.","fr":"Ordo, Scriptum, Lumen, Nodus, Tabula, Forma, Convena et Acta partagent identité, persistance et contrat de handoff. Chaque app conserve une grammaire familière tandis que le contexte traverse tableur, document, slide, calendrier et tâche."}]},{"title":{"pt":"Aplicativos e responsabilidades","en":"Apps and responsibilities","es":"Apps y responsabilidades","fr":"Applications et responsabilités"},"body":[{"pt":"O desenho evita um “super app” indistinto. Cada superfície possui domínio claro: Ordo calcula e estrutura dados; Scriptum compõe documentos; Lumen constrói narrativa visual; Nodus coordena e-mail/calendário/tarefas; Tabula organiza conhecimento; Forma coleta respostas; Convena coordena conversas e reuniões; Acta acompanha execução.","en":"The design avoids an indistinct super-app. Each surface has clear ownership: Ordo calculates and structures data; Scriptum composes documents; Lumen builds visual narratives; Nodus coordinates mail/calendar/tasks; Tabula organizes knowledge; Forma collects responses; Convena coordinates conversations and meetings; Acta tracks execution.","es":"El diseño evita un super-app indistinto. Cada superficie posee un dominio claro: Ordo calcula y estructura; Scriptum compone; Lumen construye narrativa; Nodus coordina correo/calendario/tareas; Tabula organiza conocimiento; Forma recopila respuestas; Convena coordina reuniones; Acta sigue la ejecución.","fr":"Le design évite un super-app indistinct. Chaque surface possède un domaine clair : Ordo calcule et structure ; Scriptum compose ; Lumen construit la narration ; Nodus coordonne mail/calendrier/tâches ; Tabula organise la connaissance ; Forma recueille les réponses ; Convena coordonne les réunions ; Acta suit l’exécution."}],"bullets":[{"pt":"propriedade de estado explícita por app","en":"explicit state ownership per app","es":"propiedad de estado explícita por app","fr":"propriété d’état explicite par app"},{"pt":"handoff pelo agente em vez de copiar e colar manualmente","en":"agent handoff instead of manual copy/paste","es":"handoff por agente en lugar de copiar y pegar","fr":"handoff par agent au lieu du copier-coller"},{"pt":"persistência independente com sincronização opt-in","en":"independent persistence with opt-in sync","es":"persistencia independiente con sync opcional","fr":"persistance indépendante avec sync optionnelle"}]},{"title":{"pt":"Compatibilidade de arquivos","en":"File compatibility","es":"Compatibilidad de archivos","fr":"Compatibilité des fichiers"},"body":[{"pt":"A estratégia de arquivo separa formato de trabalho interno de formatos de intercâmbio. CSV entra e sai do Ordo; documentos e apresentações podem ser exportados para formatos estruturados; quando a conversão perfeita de um formato proprietário não existe no browser, a interface deve dizer isso em vez de fabricar compatibilidade.","en":"The file strategy separates internal working format from interchange formats. CSV enters and leaves Ordo; documents and presentations can export structured formats; when perfect conversion of a proprietary format is not available in the browser, the UI should say so instead of fabricating compatibility.","es":"La estrategia separa el formato interno de los formatos de intercambio. CSV entra y sale de Ordo; documentos y presentaciones exportan formatos estructurados; cuando no existe conversión perfecta de un formato propietario, la interfaz debe indicarlo.","fr":"La stratégie sépare le format de travail interne des formats d’échange. CSV entre et sort d’Ordo ; documents et présentations exportent des formats structurés ; lorsqu’une conversion parfaite d’un format propriétaire n’existe pas, l’interface doit le signaler."}]},{"title":{"pt":"Agente entre superfícies","en":"Cross-surface agent","es":"Agente entre superficies","fr":"Agent inter-surfaces"},"body":[{"pt":"O assistente não é uma caixa de texto decorativa. O contrato correto é: ler o estado da superfície ativa, identificar recursos realmente disponíveis, produzir uma proposta ou alteração observável e manter o usuário no controle para ações externas.","en":"The assistant is not a decorative text box. The correct contract is: read active-surface state, identify capabilities that actually exist, produce an observable proposal or change, and keep the user in control for external actions.","es":"El asistente no es una caja de texto decorativa. El contrato correcto: leer el estado activo, identificar capacidades reales, producir un cambio observable y mantener al usuario en control de acciones externas.","fr":"L’assistant n’est pas une zone de texte décorative. Le bon contrat : lire l’état actif, identifier les capacités réelles, produire un changement observable et garder l’utilisateur maître des actions externes."}]},{"title":{"pt":"Critério de conclusão","en":"Completion criteria","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"Um fluxo Office está concluído quando o conteúdo persiste, pode ser reaberto, exportado quando prometido e não perde contexto ao alternar de app. “Pareceu funcionar” não substitui persistência, reentrada e feedback de erro.","en":"An Office flow is complete when content persists, can be reopened, exports when promised, and does not lose context while switching apps. “It seemed to work” does not replace persistence, re-entry, and error feedback.","es":"Un flujo Office termina cuando el contenido persiste, puede reabrirse, exporta cuando se promete y no pierde contexto al cambiar de app.","fr":"Un flux Office est terminé lorsque le contenu persiste, peut être rouvert, s’exporte lorsqu’il est promis et ne perd pas son contexte lors du changement d’app."}]}]},{"slug":"office-sync","group":"workspaces","asset":"memoryBraces","title":{"pt":"Sincronização no Giorgio Office","en":"Sync in Giorgio Office","es":"Sincronización en Giorgio Office","fr":"Synchronisation dans Giorgio Office"},"lead":{"pt":"Como estado local, sessão autenticada e sincronização na nuvem coexistem sem transformar edição em uma corrida de sobrescritas.","en":"How local state, authenticated sessions, and cloud sync coexist without turning editing into an overwrite race.","es":"Cómo conviven estado local, sesión autenticada y sync en nube sin convertir la edición en una carrera de sobrescrituras.","fr":"Comment état local, session authentifiée et sync cloud coexistent sans transformer l’édition en course à l’écrasement."},"facts":[{"pt":"Sync é opt-in","en":"Sync is opt-in","es":"Sync es opcional","fr":"Sync est optionnelle"},{"pt":"RLS por usuário","en":"Per-user RLS","es":"RLS por usuario","fr":"RLS par utilisateur"},{"pt":"Debounce antes de persistir","en":"Debounced persistence","es":"Persistencia con debounce","fr":"Persistance avec debounce"}],"sections":[{"title":{"pt":"Estado local primeiro","en":"Local-first state","es":"Estado local primero","fr":"État local d’abord"},"body":[{"pt":"A edição permanece responsiva porque o documento é salvo localmente antes de depender da rede. A nuvem é uma camada de continuidade, não o único lugar onde o estado existe.","en":"Editing stays responsive because the document is saved locally before depending on the network. Cloud is a continuity layer, not the only place where state exists.","es":"La edición sigue respondiendo porque el documento se guarda localmente antes de depender de la red.","fr":"L’édition reste réactive car le document est sauvegardé localement avant de dépendre du réseau."}]},{"title":{"pt":"Identidade e RLS","en":"Identity and RLS","es":"Identidad y RLS","fr":"Identité et RLS"},"body":[{"pt":"Cada registro de documento pertence ao user_id autenticado. As políticas de Row Level Security impedem leitura e escrita cruzada entre contas, mesmo que um cliente tente alterar identificadores manualmente.","en":"Each document record belongs to the authenticated user_id. Row Level Security policies prevent cross-account reads and writes even if a client manually changes identifiers.","es":"Cada documento pertenece al user_id autenticado. Las políticas RLS impiden lectura y escritura cruzada.","fr":"Chaque document appartient au user_id authentifié. Les politiques RLS empêchent les lectures et écritures croisées."}]},{"title":{"pt":"Conflito e relógio","en":"Conflict and clock","es":"Conflicto y reloj","fr":"Conflit et horloge"},"body":[{"pt":"A versão atual usa updated_at como evidência de atualização, mas não deve fingir colaboração CRDT que não existe. Para edição multi-dispositivo simultânea, a evolução correta é adicionar versionamento/etag ou um protocolo de merge explícito.","en":"The current version uses updated_at as update evidence but must not pretend CRDT collaboration exists. For simultaneous multi-device editing, the correct evolution is versioning/etag or an explicit merge protocol.","es":"La versión actual usa updated_at como evidencia, pero no debe fingir colaboración CRDT inexistente.","fr":"La version actuelle utilise updated_at comme preuve de mise à jour mais ne doit pas prétendre disposer d’un CRDT inexistant."}]},{"title":{"pt":"Falhas recuperáveis","en":"Recoverable failures","es":"Fallos recuperables","fr":"Pannes récupérables"},"body":[{"pt":"Sem sessão, o Office continua local. Com rede lenta, o estado de sincronização informa o atraso. Uma falha de nuvem não pode apagar o estado local nem bloquear exportação.","en":"Without a session, Office stays local. On a slow network, sync status communicates delay. A cloud failure must not erase local state or block export.","es":"Sin sesión, Office sigue local. Una falla de nube no debe borrar el estado local ni bloquear la exportación.","fr":"Sans session, Office reste local. Une panne cloud ne doit pas effacer l’état local ni bloquer l’export."}]}]},{"slug":"native-installers","group":"experience","asset":"browserCursor","title":{"pt":"Instaladores nativos para Desktop, Code e Ordo","en":"Native installers for Desktop, Code, and Ordo","es":"Instaladores nativos para Desktop, Code y Ordo","fr":"Installateurs natifs pour Desktop, Code et Ordo"},"lead":{"pt":"O que os setups em Go realmente fazem, como o executável é instalado e qual é o limite entre cabeçalho MZ/PE e assinatura digital Authenticode.","en":"What the Go setups actually do, how the executable is installed, and the boundary between an MZ/PE header and Authenticode digital signing.","es":"Qué hacen realmente los setups en Go, cómo se instala el ejecutable y la diferencia entre cabecera MZ/PE y firma Authenticode.","fr":"Ce que font réellement les setups Go, comment l’exécutable est installé et la différence entre en-tête MZ/PE et signature Authenticode."},"facts":[{"pt":"PE32+ x86-64","en":"PE32+ x86-64","es":"PE32+ x86-64","fr":"PE32+ x86-64"},{"pt":"Cabeçalho MZ verificado","en":"MZ header verified","es":"Cabecera MZ verificada","fr":"En-tête MZ vérifié"},{"pt":"Sem runtime Chromium empacotado","en":"No bundled Chromium runtime","es":"Sin runtime Chromium empaquetado","fr":"Sans runtime Chromium embarqué"}],"sections":[{"title":{"pt":"Formato do executável","en":"Executable format","es":"Formato del ejecutable","fr":"Format de l’exécutable"},"body":[{"pt":"Os instaladores são compilados em Go para Windows amd64 com subsistema GUI. O arquivo resultante é PE32+ e começa com a assinatura histórica MZ exigida pelo formato PE. Isso não equivale a uma assinatura criptográfica Authenticode.","en":"The installers are compiled in Go for Windows amd64 with the GUI subsystem. The resulting file is PE32+ and starts with the historical MZ signature required by PE. This is not the same as an Authenticode cryptographic signature.","es":"Los instaladores se compilan en Go para Windows amd64 con subsistema GUI. El archivo es PE32+ y comienza con MZ. No equivale a firma criptográfica Authenticode.","fr":"Les installateurs sont compilés en Go pour Windows amd64 avec sous-système GUI. Le fichier est PE32+ et commence par MZ. Cela n’équivaut pas à une signature Authenticode."}]},{"title":{"pt":"Instalação","en":"Installation","es":"Instalación","fr":"Installation"},"body":[{"pt":"O setup grava o launcher em LocalAppData, cria atalhos no Menu Iniciar e opcionalmente na área de trabalho, registra uma entrada mínima de desinstalação e oferece abrir o produto ao concluir.","en":"Setup writes the launcher into LocalAppData, creates Start Menu and optional desktop shortcuts, registers a minimal uninstall entry, and can open the product when finished.","es":"El setup guarda el launcher en LocalAppData, crea accesos directos, registra desinstalación y puede abrir el producto al finalizar.","fr":"Le setup écrit le launcher dans LocalAppData, crée des raccourcis, enregistre la désinstallation et peut ouvrir le produit à la fin."}]},{"title":{"pt":"Sem WebView empacotado","en":"No bundled WebView","es":"Sin WebView empaquetado","fr":"Sans WebView embarquée"},"body":[{"pt":"O launcher procura Edge ou Chrome instalados e usa o modo app do navegador. Isso mantém o binário pequeno e evita empacotar outro Chromium. Se nenhum estiver disponível, cai para o navegador padrão do sistema.","en":"The launcher looks for installed Edge or Chrome and uses browser app mode. This keeps the binary small and avoids bundling another Chromium. If neither exists, it falls back to the system default browser.","es":"El launcher busca Edge o Chrome instalados y usa modo app, evitando empaquetar Chromium.","fr":"Le launcher cherche Edge ou Chrome installés et utilise le mode app, évitant d’embarquer Chromium."}]},{"title":{"pt":"Assinatura digital","en":"Digital signing","es":"Firma digital","fr":"Signature numérique"},"body":[{"pt":"Para remover avisos de reputação do Windows em distribuição ampla é necessário um certificado de assinatura de código e Authenticode. O cabeçalho MZ sozinho apenas identifica o formato executável; ele não comprova publisher nem reputação.","en":"For broad distribution without Windows reputation warnings, a code-signing certificate and Authenticode are required. The MZ header only identifies the executable format; it does not prove publisher identity or reputation.","es":"Para distribución amplia sin avisos de reputación se necesita certificado de firma de código y Authenticode.","fr":"Pour une distribution large sans avertissements de réputation, un certificat de signature de code et Authenticode sont nécessaires."}]}]},{"slug":"thesis2-overview","group":"intelligence","asset":"modelGraph","title":{"pt":"Thesis 2.1: visão geral","en":"Thesis 2.1: overview","es":"Thesis 2.1: visión general","fr":"Thesis 2.1 : vue d’ensemble"},"lead":{"pt":"O 2.1 combina GPT-OSS 120B, roteamento math-first, test-time compute adaptativo, preflight no Melos 2 e verificação cruzada sem trocar a identidade pública do modelo.","en":"2.1 combines GPT-OSS 120B, math-first routing, adaptive test-time compute, Melos 2 preflight, and cross-model verification without changing the model’s public identity.","es":"2.1 combina GPT-OSS 120B, routing math-first, cómputo adaptativo, preflight con Melos 2 y verificación cruzada sin cambiar la identidad pública.","fr":"2.1 combine GPT-OSS 120B, routage math-first, calcul adaptatif, preflight Melos 2 et vérification croisée sans changer l’identité publique du modèle."},"facts":[{"pt":"Release 2.1 · API estável thesis-2","en":"Release 2.1 · stable API thesis-2","es":"Release 2.1 · API estable thesis-2","fr":"Release 2.1 · API stable thesis-2"},{"pt":"GPT-OSS 120B primary · GPT-OSS 20B verifier","en":"GPT-OSS 120B primary · GPT-OSS 20B verifier","es":"GPT-OSS 120B principal · GPT-OSS 20B verificador","fr":"GPT-OSS 120B principal · GPT-OSS 20B vérificateur"},{"pt":"Math-first · adaptive reasoning · contract guard","en":"Math-first · adaptive reasoning · contract guard","es":"Math-first · reasoning adaptativo · contract guard","fr":"Math-first · raisonnement adaptatif · contract guard"}],"sections":[{"title":{"pt":"Math-first routing","en":"Math-first routing","es":"Routing math-first","fr":"Routage math-first"},"body":[{"pt":"Provas e matemática avançada têm precedência sobre classificadores genéricos de formato. Restrições de apresentação continuam obrigatórias, mas são verificadas como contrato depois da solução.","en":"Proofs and advanced mathematics take precedence over generic format classifiers. Presentation constraints remain mandatory but are checked as a contract after the solution.","es":"Las demostraciones y la matemática avanzada tienen prioridad sobre clasificadores genéricos de formato.","fr":"Les preuves et mathématiques avancées ont priorité sur les classifieurs génériques de format."}]},{"title":{"pt":"Compute adaptativo por dificuldade","en":"Adaptive compute by difficulty","es":"Cómputo adaptativo por dificultad","fr":"Calcul adaptatif selon la difficulté"},"body":[{"pt":"Tarefas simples continuam curtas. Problemas com prova, operator theory, alta densidade de restrições ou sinais de problema aberto recebem esforço maior e orçamento compatível. O objetivo é comprar raciocínio onde ele altera a taxa de erro.","en":"Simple tasks remain short. Problems involving proofs, operator theory, dense constraints, or open-problem signals receive higher effort and a compatible budget. Compute is spent where it can change error rates.","es":"Las tareas simples siguen siendo cortas; las pruebas y problemas de alto riesgo reciben más esfuerzo.","fr":"Les tâches simples restent courtes ; les preuves et problèmes à haut risque reçoivent davantage d’effort."}]},{"title":{"pt":"Melos 2 como crítico rápido","en":"Melos 2 as a fast critic","es":"Melos 2 como crítico rápido","fr":"Melos 2 comme critique rapide"},"body":[{"pt":"Em casos difíceis, o 20B pode produzir um preflight adversarial com obrigações, invariantes e riscos antes da chamada principal de 120B. Esse passo é consultivo e não substitui o solver.","en":"On difficult cases, the 20B model can produce an adversarial preflight with obligations, invariants, and risks before the main 120B call. This step is advisory and does not replace the solver.","es":"En casos difíciles, el 20B produce un preflight adversarial antes de la llamada principal del 120B.","fr":"Dans les cas difficiles, le 20B produit un preflight adversarial avant l’appel principal du 120B."}]},{"title":{"pt":"Cross-model verification","en":"Cross-model verification","es":"Verificación cruzada","fr":"Vérification croisée"},"body":[{"pt":"Quando a tarefa justifica auditoria, o 20B verifica a conclusão de forma independente. O sistema não trata qualquer discordância como correção: defeitos precisam ser concretos e materiais antes de substituir a resposta do 120B.","en":"When a task justifies auditing, the 20B independently checks the conclusion. The system does not treat every disagreement as a correction: defects must be concrete and material before replacing the 120B answer.","es":"Cuando la tarea lo justifica, el 20B audita la conclusión de forma independiente y solo corrige defectos materiales.","fr":"Lorsque la tâche le justifie, le 20B audite la conclusion indépendamment et ne corrige que les défauts matériels."}]},{"title":{"pt":"Open Problem Guard","en":"Open Problem Guard","es":"Open Problem Guard","fr":"Open Problem Guard"},"body":[{"pt":"Em Riemann, P vs NP, Collatz e outros problemas abertos, o runtime impede que pontes conjecturais sejam silenciosamente promovidas a prova. O sistema pode explorar hipóteses, mas deve expor a obstrução quando uma equivalência, limite ou construção não foi demonstrada.","en":"For Riemann, P vs NP, Collatz, and other open problems, the runtime prevents conjectural bridges from silently becoming proofs. Exploration remains allowed, but missing equivalences, limits, or constructions must be exposed.","es":"En problemas abiertos, el runtime impide convertir puentes conjeturales en demostraciones sin justificar.","fr":"Dans les problèmes ouverts, le runtime empêche de transformer silencieusement des passerelles conjecturales en preuves."}]}]},{"slug":"thesis2-internet","group":"intelligence","asset":"webBraces","title":{"pt":"Internet real no Thesis 2.1","en":"Real internet in Thesis 2.1","es":"Internet real en Thesis 2.1","fr":"Internet réel dans Thesis 2.1"},"lead":{"pt":"Busca pública iterativa, fontes rastreáveis e uma fronteira clara entre evidência da web e instruções.","en":"Iterative public-web search, traceable sources, and a hard boundary between web evidence and instructions.","es":"Búsqueda web pública iterativa, fuentes trazables y una frontera clara entre evidencia web e instrucciones.","fr":"Recherche web publique itérative, sources traçables et frontière nette entre preuves du web et instructions."},"facts":[{"pt":"Busca aberta + grounding quando disponível","en":"Open web + grounding when available","es":"Web abierta + grounding cuando está disponible","fr":"Web ouverte + grounding si disponible"},{"pt":"Até 2 rodadas adicionais em Max","en":"Up to 2 additional rounds at Max","es":"Hasta 2 rondas adicionales en Max","fr":"Jusqu’à 2 tours supplémentaires en Max"},{"pt":"Texto recuperado é dado não confiável","en":"Retrieved text is untrusted data","es":"El texto recuperado es dato no confiable","fr":"Le texte récupéré est une donnée non fiable"}],"sections":[{"title":{"pt":"Pré-busca e busca dirigida pelo modelo","en":"Prefetch and model-driven search","es":"Prebúsqueda y búsqueda dirigida por el modelo","fr":"Pré-recherche et recherche pilotée par le modèle"},"body":[{"pt":"Quando o pedido já exige informação atual, documentação ou fontes, o gateway faz uma busca inicial. Se o Thesis 2.1 ainda detectar uma lacuna material, ele pode pedir consultas adicionais e receber os resultados em uma nova passagem. Isso transforma pesquisa em loop de evidência, não em um único snippet anexado ao prompt.","en":"When the request already requires current information, documentation, or sources, the gateway performs an initial search. If Thesis 2.1 still detects a material gap, it can request additional queries and receive the results in a new pass. Research becomes an evidence loop rather than one snippet attached to the prompt.","es":"Cuando el pedido exige información actual, documentación o fuentes, el gateway hace una búsqueda inicial. Si Thesis 2.1 aún detecta una laguna material, puede pedir consultas adicionales y recibir resultados en otra pasada.","fr":"Lorsque la demande exige des informations actuelles, de la documentation ou des sources, le gateway effectue une recherche initiale. Si Thesis 2.1 détecte encore une lacune importante, il peut demander des requêtes supplémentaires et recevoir les résultats lors d’un nouveau passage."}]},{"title":{"pt":"Fontes antes de síntese","en":"Sources before synthesis","es":"Fuentes antes de síntesis","fr":"Sources avant synthèse"},"bullets":[{"pt":"consultas são deduplicadas e limitadas","en":"queries are deduplicated and bounded","es":"las consultas se deduplican y limitan","fr":"les requêtes sont dédupliquées et limitées"},{"pt":"URLs são preservadas para provenance","en":"URLs are preserved for provenance","es":"las URL se conservan para la procedencia","fr":"les URL sont conservées pour la provenance"},{"pt":"claims mutáveis devem preferir fonte primária e recente","en":"mutable claims should prefer recent primary sources","es":"las afirmaciones mutables deben preferir fuentes primarias y recientes","fr":"les affirmations mutables doivent privilégier des sources primaires et récentes"}]},{"title":{"pt":"Defesa contra prompt injection","en":"Prompt-injection boundary","es":"Defensa contra prompt injection","fr":"Frontière contre l’injection de prompt"},"body":[{"pt":"O conteúdo recuperado entra explicitamente como UNTRUSTED DATA. Instruções encontradas numa página não mudam política, permissões, ferramenta ou objetivo. O texto serve para sustentar fatos; não ganha autoridade operacional só porque veio de uma URL.","en":"Retrieved content is explicitly injected as UNTRUSTED DATA. Instructions found on a page do not change policy, permissions, tools, or objective. The text may support facts; it does not gain operational authority merely because it came from a URL.","es":"El contenido recuperado entra explícitamente como UNTRUSTED DATA. Las instrucciones encontradas en una página no cambian políticas, permisos, herramientas ni objetivo.","fr":"Le contenu récupéré est explicitement injecté comme UNTRUSTED DATA. Les instructions trouvées sur une page ne modifient ni politique, ni permissions, ni outils, ni objectif."}]},{"title":{"pt":"Quando a busca não deve rodar","en":"When search should not run","es":"Cuándo no debe ejecutarse la búsqueda","fr":"Quand la recherche ne doit pas s’exécuter"},"body":[{"pt":"Conhecimento estável, transformação do texto fornecido e tarefas locais bem especificadas não precisam pagar latência de rede. A busca é ferramenta, não ritual.","en":"Stable knowledge, transformation of supplied text, and well-specified local tasks do not need network latency. Search is a tool, not a ritual.","es":"El conocimiento estable, la transformación de texto proporcionado y tareas locales bien especificadas no necesitan pagar latencia de red.","fr":"Les connaissances stables, la transformation du texte fourni et les tâches locales bien spécifiées n’ont pas besoin de la latence réseau."}]}]},{"slug":"thesis2-native-actions","group":"intelligence","asset":"codeBubble","title":{"pt":"Ações locais confirmadas","en":"Confirmed local actions","es":"Acciones locales confirmadas","fr":"Actions locales confirmées"},"lead":{"pt":"Como Thesis 2.1 pode pedir instalação de dependências e escrita de arquivos no Giorgio Desktop sem ganhar um shell irrestrito.","en":"How Thesis 2.1 can request dependency installation and file writes in Giorgio Desktop without receiving an unrestricted shell.","es":"Cómo Thesis 2.1 puede solicitar instalación de dependencias y escritura de archivos en Giorgio Desktop sin obtener un shell irrestricto.","fr":"Comment Thesis 2.1 peut demander l’installation de dépendances et l’écriture de fichiers dans Giorgio Desktop sans disposer d’un shell illimité."},"facts":[{"pt":"Somente Giorgio Desktop","en":"Giorgio Desktop only","es":"Solo Giorgio Desktop","fr":"Giorgio Desktop uniquement"},{"pt":"Confirmação explícita antes da mutação","en":"Explicit confirmation before mutation","es":"Confirmación explícita antes de la mutación","fr":"Confirmation explicite avant mutation"},{"pt":"Managers allowlisted + paths relativos","en":"Allowlisted managers + relative paths","es":"Managers permitidos + rutas relativas","fr":"Gestionnaires autorisés + chemins relatifs"}],"sections":[{"title":{"pt":"Propor, não executar silenciosamente","en":"Propose, never execute silently","es":"Proponer, no ejecutar silenciosamente","fr":"Proposer, ne jamais exécuter silencieusement"},"body":[{"pt":"O modelo emite uma ação tipada. A interface valida o tipo, mostra exatamente o que será instalado ou escrito e pede confirmação. Só depois o Desktop Bridge chama terminal ou filesystem. No navegador comum a ação não executa.","en":"The model emits a typed action. The interface validates its type, shows exactly what will be installed or written, and asks for confirmation. Only then does the Desktop Bridge call terminal or filesystem. In a normal browser the action does not execute.","es":"El modelo emite una acción tipada. La interfaz valida el tipo, muestra exactamente qué se instalará o escribirá y pide confirmación. Solo entonces Desktop Bridge llama terminal o filesystem.","fr":"Le modèle émet une action typée. L’interface valide le type, montre exactement ce qui sera installé ou écrit et demande confirmation. Ce n’est qu’ensuite que Desktop Bridge appelle le terminal ou le système de fichiers."}]},{"title":{"pt":"Instalação de pacotes","en":"Package installation","es":"Instalación de paquetes","fr":"Installation de paquets"},"bullets":[{"pt":"npm, pnpm e yarn","en":"npm, pnpm, and yarn","es":"npm, pnpm y yarn","fr":"npm, pnpm et yarn"},{"pt":"python -m pip","en":"python -m pip","es":"python -m pip","fr":"python -m pip"},{"pt":"go get e cargo add","en":"go get and cargo add","es":"go get y cargo add","fr":"go get et cargo add"},{"pt":"dotnet add package","en":"dotnet add package","es":"dotnet add package","fr":"dotnet add package"}]},{"title":{"pt":"Escrita de arquivos","en":"File writes","es":"Escritura de archivos","fr":"Écriture de fichiers"},"body":[{"pt":"A escrita fica confinada ao workspace ativo. Caminhos absolutos, .. e payloads excessivos são rejeitados pelo protocolo antes de chegar ao runtime local.","en":"Writes are confined to the active workspace. Absolute paths, .., and excessive payloads are rejected by the protocol before reaching the local runtime.","es":"La escritura queda confinada al workspace activo. Rutas absolutas, .. y payloads excesivos son rechazados por el protocolo.","fr":"Les écritures restent confinées au workspace actif. Les chemins absolus, .. et les payloads excessifs sont rejetés par le protocole."}]},{"title":{"pt":"Evidência de execução","en":"Execution evidence","es":"Evidencia de ejecución","fr":"Preuve d’exécution"},"body":[{"pt":"O retorno do terminal, o status da operação e o filesystem são evidência. Uma frase gerada pelo modelo não é. Se a ação falhar, Giorgio deve mostrar a falha e manter a resposta separada do estado real da máquina.","en":"Terminal output, operation status, and filesystem state are evidence. A sentence generated by the model is not. If an action fails, Giorgio must show the failure and keep the answer separate from the machine’s real state.","es":"La salida del terminal, el estado de la operación y el filesystem son evidencia. Una frase generada por el modelo no lo es.","fr":"La sortie du terminal, l’état de l’opération et le système de fichiers constituent des preuves. Une phrase générée par le modèle n’en est pas une."}]}]},{"slug":"plugin-runtime","group":"extensions","asset":"webBraces","title":{"pt":"Runtime de plugins","en":"Plugin runtime","es":"Runtime de plugins","fr":"Runtime des plugins"},"lead":{"pt":"Plugins agora declaram método, entregável, verificação e política de evidência em vez de serem apenas nomes num catálogo.","en":"Plugins now declare method, deliverable, verification, and evidence policy instead of being names in a catalog.","es":"Los plugins ahora declaran método, entregable, verificación y política de evidencia en vez de ser solo nombres en un catálogo.","fr":"Les plugins déclarent désormais méthode, livrable, vérification et politique de preuve au lieu d’être de simples noms dans un catalogue."},"facts":[{"pt":"Manifesto sob demanda","en":"On-demand manifest","es":"Manifiesto bajo demanda","fr":"Manifeste à la demande"},{"pt":"18 famílias operacionais","en":"18 operational families","es":"18 familias operativas","fr":"18 familles opérationnelles"},{"pt":"Busca atual quando o domínio exige","en":"Live retrieval when the domain requires it","es":"Búsqueda actual cuando el dominio lo exige","fr":"Recherche actuelle lorsque le domaine l’exige"}],"sections":[{"title":{"pt":"Manifesto operacional","en":"Operational manifest","es":"Manifiesto operativo","fr":"Manifeste opérationnel"},"body":[{"pt":"Cada família central descreve papel, métodos, entregáveis esperados, gates de verificação e quando buscar evidência atual. Isso dá ao plugin um contrato executável e facilita auditoria quando um resultado sai do foco.","en":"Each core family describes role, methods, expected deliverables, verification gates, and when fresh evidence is required. This gives the plugin an executable contract and makes off-scope results easier to audit.","es":"Cada familia central describe rol, métodos, entregables esperados, gates de verificación y cuándo buscar evidencia actual.","fr":"Chaque famille centrale décrit rôle, méthodes, livrables attendus, gates de vérification et quand rechercher des preuves actuelles."}]},{"title":{"pt":"Descoberta progressiva","en":"Progressive discovery","es":"Descubrimiento progresivo","fr":"Découverte progressive"},"body":[{"pt":"O objetivo não é jogar centenas de definições no prompt. Giorgio mapeia o plugin escolhido para a menor família operacional relevante e carrega o manifesto necessário para aquela tarefa. Menos schemas inúteis significa mais contexto para o trabalho.","en":"The goal is not to dump hundreds of definitions into the prompt. Giorgio maps the selected plugin to the smallest relevant operational family and loads the manifest needed for that task. Fewer useless schemas means more context for the work.","es":"El objetivo no es cargar cientos de definiciones en el prompt. Giorgio mapea el plugin elegido a la familia operativa mínima relevante y carga el manifiesto necesario.","fr":"Le but n’est pas de charger des centaines de définitions dans le prompt. Giorgio associe le plugin choisi à la plus petite famille opérationnelle pertinente et charge le manifeste nécessaire."}]},{"title":{"pt":"Famílias que exigem fontes atuais","en":"Families that require live evidence","es":"Familias que requieren evidencia actual","fr":"Familles exigeant des preuves actuelles"},"bullets":[{"pt":"Legal, ciência, biomedicina, finanças e enterprise search pesquisam por padrão quando o contexto pede fatos externos.","en":"Legal, science, biomedical research, finance, and enterprise search retrieve by default when external facts matter.","es":"Legal, ciencia, biomedicina, finanzas y enterprise search investigan por defecto cuando importan hechos externos.","fr":"Juridique, science, biomédical, finance et enterprise search recherchent par défaut lorsque des faits externes comptent."},{"pt":"Engineering, design e suporte pesquisam quando versão, API, status ou documentação pode ter mudado.","en":"Engineering, design, and support retrieve when versions, APIs, status, or documentation may have changed.","es":"Engineering, design y soporte investigan cuando versión, API, estado o documentación pueden haber cambiado.","fr":"Engineering, design et support recherchent lorsque version, API, statut ou documentation ont pu changer."}]},{"title":{"pt":"Verificação específica por domínio","en":"Domain-specific verification","es":"Verificación específica por dominio","fr":"Vérification spécifique au domaine"},"body":[{"pt":"Um plugin de dados precisa reconciliar grain, unidades e totais; um plugin legal precisa preservar jurisdição, data e autoridade; um plugin de design precisa testar responsive, foco e estados; um plugin de engenharia precisa distinguir parse, build, runtime e E2E. “Uma resposta boa” não é um único critério universal.","en":"A data plugin must reconcile grain, units, and totals; a legal plugin must preserve jurisdiction, date, and authority; a design plugin must test responsive behavior, focus, and states; an engineering plugin must distinguish parse, build, runtime, and E2E. “A good answer” is not one universal criterion.","es":"Un plugin de datos debe reconciliar granularidad, unidades y totales; uno legal debe preservar jurisdicción, fecha y autoridad; uno de design debe probar responsive, foco y estados; uno de engineering debe distinguir parse, build, runtime y E2E.","fr":"Un plugin data doit réconcilier granularité, unités et totaux ; un plugin juridique doit préserver juridiction, date et autorité ; un plugin design doit tester responsive, focus et états ; un plugin engineering doit distinguer parse, build, runtime et E2E."}]}]}],"code":[{"slug":"overview","group":"start","asset":"coding","title":{"pt":"Visão geral","en":"Overview","es":"Visión general","fr":"Vue d’ensemble"},"lead":{"pt":"Giorgio Code reúne sessões, arquivos, editor, terminal, preview e revisão em um workspace focado em desenvolvimento.","en":"Giorgio Code brings sessions, files, editor, terminal, preview, and review into a development-focused workspace.","es":"Giorgio Code reúne sesiones, archivos, editor, terminal, preview y revisión en un workspace centrado en desarrollo.","fr":"Giorgio Code réunit sessions, fichiers, éditeur, terminal, aperçu et révision dans un espace centré sur le développement."},"sections":[{"title":{"pt":"O fluxo principal","en":"The main flow","es":"El flujo principal","fr":"Le flux principal"},"bullets":[{"pt":"Crie ou abra uma sessão.","en":"Create or open a session.","es":"Crea o abre una sesión.","fr":"Créez ou ouvrez une session."},{"pt":"Traga arquivos e instruções relevantes.","en":"Bring in relevant files and instructions.","es":"Añade archivos e instrucciones relevantes.","fr":"Ajoutez les fichiers et instructions pertinents."},{"pt":"Implemente e execute o que puder ser verificado.","en":"Implement and run what can be verified.","es":"Implementa y ejecuta lo que pueda verificarse.","fr":"Implémentez et exécutez ce qui peut être vérifié."},{"pt":"Revise arquivos, preview e diagnósticos antes de encerrar.","en":"Review files, preview, and diagnostics before closing.","es":"Revisa archivos, preview y diagnósticos antes de cerrar.","fr":"Révisez fichiers, aperçu et diagnostics avant de terminer."}]},{"title":{"pt":"Web e instalado","en":"Web and installed","es":"Web e instalado","fr":"Web et installé"},"body":[{"pt":"O Code Web oferece acesso imediato no navegador. O app instalado pode ser melhor para tarefas que dependem mais diretamente do ambiente local.","en":"Code Web offers immediate browser access. The installed app may be better for tasks that depend more directly on the local environment.","es":"Code Web ofrece acceso inmediato en el navegador. La app instalada puede ser mejor para tareas que dependen más directamente del entorno local.","fr":"Code Web offre un accès immédiat dans le navigateur. L’application installée peut être préférable pour les tâches dépendant davantage de l’environnement local."}]},{"title":{"pt":"O ciclo completo do Code","en":"The complete Code loop","es":"The complete Code loop","fr":"The complete Code loop"},"body":[{"pt":"Uma sessão de Code combina arquivos, editor, terminal, preview e revisão. O objetivo é produzir evidência de que a mudança funciona, não apenas texto que parece plausível.","en":"A Code session combines files, editor, terminal, preview, and review. The goal is evidence that the change works, not merely text that looks plausible.","es":"A Code session combines files, editor, terminal, preview, and review. The goal is evidence that the change works, not merely text that looks plausible.","fr":"A Code session combines files, editor, terminal, preview, and review. The goal is evidence that the change works, not merely text that looks plausible."}],"bullets":[{"pt":"Feche a tarefa só depois de verificar o estado final no ambiente adequado.","en":"Close the task only after verifying the final state in the appropriate environment.","es":"Close the task only after verifying the final state in the appropriate environment.","fr":"Close the task only after verifying the final state in the appropriate environment."}]},{"title":{"pt":"O que merece atenção","en":"What deserves attention","es":"Qué merece atención","fr":"Ce qui mérite l’attention"},"body":[{"pt":"Use Visão geral como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Giorgio Code reúne sessões, arquivos, editor, terminal, preview e revisão em um workspace focado em desenvolvimento. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Overview as an operational reference, not as an isolated screen. The page itself is about this: Giorgio Code brings sessions, files, editor, terminal, preview, and review into a development-focused workspace. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Visión general como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Giorgio Code reúne sesiones, archivos, editor, terminal, preview y revisión en un workspace centrado en desarrollo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Vue d’ensemble comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Giorgio Code réunit sessions, fichiers, éditeur, terminal, aperçu et révision dans un espace centré sur le développement. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Visão geral o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Overview where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Visión general el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Vue d’ensemble où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Um fluxo que funciona","en":"A workflow that works","es":"Un flujo que funciona","fr":"Un flux qui fonctionne"},"body":[{"pt":"Comece por “O fluxo principal”, confirme o estado visível e avance para “Web e instalado” apenas quando a etapa anterior estiver estável. Em Visão geral, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “The main flow”, confirm the visible state, and move to “Web and installed” only when the previous step is stable. In Overview, skipping context usually creates more rework than speed.","es":"Empieza por “El flujo principal”, confirma el estado visible y avanza a “Web e instalado” solo cuando la etapa anterior esté estable. En Visión general, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Le flux principal », confirmez l’état visible puis passez à « Web et installé » seulement lorsque l’étape précédente est stable. Dans Vue d’ensemble, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Quando mudar de estratégia","en":"When to change strategy","es":"Cuándo cambiar de estrategia","fr":"Quand changer de stratégie"},"body":[{"pt":"Imagine uma tarefa real em que Visão geral deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Overview stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Visión general deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Vue d’ensemble cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Visão geral realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Overview truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Visión general realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Vue d’ensemble exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Sinais de que terminou","en":"Signals that you are done","es":"Señales de finalización","fr":"Signes que le travail est terminé"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Visão geral o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Overview where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Visión general el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Vue d’ensemble où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Visão geral como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Giorgio Code reúne sessões, arquivos, editor, terminal, preview e revisão em um workspace focado em desenvolvimento. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Overview as an operational reference, not as an isolated screen. The page itself is about this: Giorgio Code brings sessions, files, editor, terminal, preview, and review into a development-focused workspace. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Visión general como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Giorgio Code reúne sesiones, archivos, editor, terminal, preview y revisión en un workspace centrado en desarrollo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Vue d’ensemble comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Giorgio Code réunit sessions, fichiers, éditeur, terminal, aperçu et révision dans un espace centré sur le développement. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Mapa operacional: Visão geral","en":"Operational map: Overview","es":"Mapa operativo: Visión general","fr":"Carte opérationnelle: Vue d’ensemble"},"body":[{"pt":"Nesta página, a referência completa cobre arquitetura do workspace, ciclo understand→implement→verify e contratos de entrega. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Overview as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Visión general como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Vue d’ensemble comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Visão geral","en":"Edge cases for Overview","es":"Casos límite de Visión general","fr":"Cas limites de Vue d’ensemble"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Overview flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Visión general sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Vue d’ensemble reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"code-web","group":"start","asset":"coding","title":{"pt":"Code Web","en":"Code Web","es":"Code Web","fr":"Code Web"},"lead":{"pt":"A versão web prioriza sessões persistentes e acesso rápido sem exigir instalação.","en":"The web version prioritizes persistent sessions and quick access without requiring installation.","es":"La versión web prioriza sesiones persistentes y acceso rápido sin instalación.","fr":"La version web privilégie les sessions persistantes et l’accès rapide sans installation."},"sections":[{"title":{"pt":"Estrutura da tela","en":"Screen structure","es":"Estructura de la pantalla","fr":"Structure de l’écran"},"bullets":[{"pt":"Sidebar com sessões e ações principais.","en":"Sidebar with sessions and primary actions.","es":"Sidebar con sesiones y acciones principales.","fr":"Barre latérale avec sessions et actions principales."},{"pt":"Área central para conversa e execução.","en":"Central area for conversation and execution.","es":"Área central para conversación y ejecución.","fr":"Zone centrale pour conversation et exécution."},{"pt":"Arquivos, editor e terminal aparecem quando necessários.","en":"Files, editor, and terminal appear when needed.","es":"Archivos, editor y terminal aparecen cuando son necesarios.","fr":"Fichiers, éditeur et terminal apparaissent lorsque nécessaire."}]},{"title":{"pt":"Limites do navegador","en":"Browser boundaries","es":"Límites del navegador","fr":"Limites du navigateur"},"body":[{"pt":"Algumas operações dependem do sandbox disponível e não têm o mesmo acesso que um app instalado ao sistema local. A interface deve sinalizar quando essa diferença importa.","en":"Some operations depend on the available sandbox and do not have the same access to the local system as an installed app. The interface should signal when that difference matters.","es":"Algunas operaciones dependen del sandbox disponible y no tienen el mismo acceso al sistema local que una app instalada. La interfaz debe señalar cuando esa diferencia importa.","fr":"Certaines opérations dépendent du sandbox disponible et n’ont pas le même accès au système local qu’une application installée. L’interface doit signaler lorsque cette différence compte."}]},{"title":{"pt":"O que muda no navegador","en":"What changes in the browser","es":"What changes in the browser","fr":"What changes in the browser"},"body":[{"pt":"Code Web facilita acesso rápido ao workspace, mas continua limitado pelo ambiente do navegador e pelas permissões disponíveis.","en":"Code Web gives quick access to the workspace but remains limited by browser environment and available permissions.","es":"Code Web gives quick access to the workspace but remains limited by browser environment and available permissions.","fr":"Code Web gives quick access to the workspace but remains limited by browser environment and available permissions."}],"bullets":[{"pt":"Quando a tarefa exige processo local, binário nativo ou acesso amplo ao sistema, use a experiência instalada.","en":"When a task needs local processes, native binaries, or broad system access, use the installed experience.","es":"When a task needs local processes, native binaries, or broad system access, use the installed experience.","fr":"When a task needs local processes, native binaries, or broad system access, use the installed experience."}]},{"title":{"pt":"Mapa da experiência","en":"Experience map","es":"Mapa de la experiencia","fr":"Carte de l’expérience"},"body":[{"pt":"Imagine uma tarefa real em que Code Web deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code Web stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Code Web deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Code Web cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Aplicação prática","en":"Practical application","es":"Aplicación práctica","fr":"Application pratique"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Code Web o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code Web where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Code Web el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Code Web où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Code Web como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A versão web prioriza sessões persistentes e acesso rápido sem exigir instalação. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code Web as an operational reference, not as an isolated screen. The page itself is about this: The web version prioritizes persistent sessions and quick access without requiring installation. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Code Web como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La versión web prioriza sesiones persistentes y acceso rápido sin instalación. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Code Web comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La version web privilégie les sessions persistantes et l’accès rapide sans installation. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Erros fáceis de evitar","en":"Easy mistakes to avoid","es":"Errores fáciles de evitar","fr":"Erreurs faciles à éviter"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Code Web, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Code Web, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Code Web, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Code Web, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Estrutura da tela”, confirme o estado visível e avance para “Limites do navegador” apenas quando a etapa anterior estiver estável. Em Code Web, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Screen structure”, confirm the visible state, and move to “Browser boundaries” only when the previous step is stable. In Code Web, skipping context usually creates more rework than speed.","es":"Empieza por “Estructura de la pantalla”, confirma el estado visible y avanza a “Límites del navegador” solo cuando la etapa anterior esté estable. En Code Web, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Structure de l’écran », confirmez l’état visible puis passez à « Limites du navigateur » seulement lorsque l’étape précédente est stable. Dans Code Web, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Revisão final","en":"Final review","es":"Revisión final","fr":"Révision finale"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Code Web realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code Web truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Code Web realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Code Web exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Code Web","en":"Production reference: Code Web","es":"Referencia de producción: Code Web","fr":"Référence de production: Code Web"},"body":[{"pt":"Nesta página, a referência completa cobre runtime web, limites de filesystem/processo, preview e handoff para desktop. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code Web as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Code Web como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Code Web comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Code Web","en":"Edge cases for Code Web","es":"Casos límite de Code Web","fr":"Cas limites de Code Web"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code Web flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Code Web sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Code Web reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"sessions","group":"sessions","asset":"coding","title":{"pt":"Sessões","en":"Sessions","es":"Sesiones","fr":"Sessions"},"lead":{"pt":"Cada sessão preserva a tarefa, histórico e contexto de desenvolvimento relacionados.","en":"Each session preserves the related task, history, and development context.","es":"Cada sesión conserva la tarea, historial y contexto de desarrollo relacionados.","fr":"Chaque session conserve la tâche, l’historique et le contexte de développement associés."},"sections":[{"title":{"pt":"Uma sessão por objetivo","en":"One session per objective","es":"Una sesión por objetivo","fr":"Une session par objectif"},"body":[{"pt":"Separar objetivos independentes reduz mistura de contexto. Correções e revisões do mesmo trabalho normalmente pertencem à mesma sessão.","en":"Separating independent objectives reduces context mixing. Fixes and reviews of the same work normally belong in the same session.","es":"Separar objetivos independientes reduce mezcla de contexto. Correcciones y revisiones del mismo trabajo normalmente pertenecen a la misma sesión.","fr":"Séparer les objectifs indépendants réduit le mélange de contexte. Les corrections et révisions du même travail appartiennent généralement à la même session."}]},{"title":{"pt":"Nomeie para reencontrar","en":"Name it to find it again","es":"Nómbrala para encontrarla","fr":"Nommez-la pour la retrouver"},"body":[{"pt":"Um nome curto baseado na tarefa é mais útil do que depender da primeira frase da conversa.","en":"A short task-based name is more useful than relying on the first sentence of the conversation.","es":"Un nombre corto basado en la tarea es más útil que depender de la primera frase de la conversación.","fr":"Un nom court basé sur la tâche est plus utile que de dépendre de la première phrase de la conversation."}]},{"title":{"pt":"Sessão como unidade de trabalho","en":"Sessions as a unit of work","es":"Sessions as a unit of work","fr":"Sessions as a unit of work"},"body":[{"pt":"A sessão guarda contexto técnico, decisões e estado do workspace para que o trabalho não precise recomeçar a cada prompt.","en":"A session keeps technical context, decisions, and workspace state so work does not restart with every prompt.","es":"A session keeps technical context, decisions, and workspace state so work does not restart with every prompt.","fr":"A session keeps technical context, decisions, and workspace state so work does not restart with every prompt."}],"bullets":[{"pt":"Use uma sessão por objetivo coerente; abrir uma nova sessão a cada detalhe fragmenta contexto e revisão.","en":"Use one session per coherent goal; starting a new session for every detail fragments context and review.","es":"Use one session per coherent goal; starting a new session for every detail fragments context and review.","fr":"Use one session per coherent goal; starting a new session for every detail fragments context and review."}]},{"title":{"pt":"Ponto de partida","en":"Starting point","es":"Punto de partida","fr":"Point de départ"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Sessões, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Sessions, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Sesiones, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Sessions, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Uma sessão por objetivo”, confirme o estado visível e avance para “Nomeie para reencontrar” apenas quando a etapa anterior estiver estável. Em Sessões, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “One session per objective”, confirm the visible state, and move to “Name it to find it again” only when the previous step is stable. In Sessions, skipping context usually creates more rework than speed.","es":"Empieza por “Una sesión por objetivo”, confirma el estado visible y avanza a “Nómbrala para encontrarla” solo cuando la etapa anterior esté estable. En Sesiones, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Une session par objectif », confirmez l’état visible puis passez à « Nommez-la pour la retrouver » seulement lorsque l’étape précédente est stable. Dans Sessions, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Trabalho em camadas","en":"Layered work","es":"Trabajo por capas","fr":"Travail par couches"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Sessões realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Sessions truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Sesiones realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Sessions exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Sessões deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Sessions stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Sesiones deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Sessions cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Diagnóstico rápido","en":"Fast diagnosis","es":"Diagnóstico rápido","fr":"Diagnostic rapide"},"body":[{"pt":"Use Sessões como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Cada sessão preserva a tarefa, histórico e contexto de desenvolvimento relacionados. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Sessions as an operational reference, not as an isolated screen. The page itself is about this: Each session preserves the related task, history, and development context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Sesiones como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Cada sesión conserva la tarea, historial y contexto de desarrollo relacionados. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Sessions comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Chaque session conserve la tâche, l’historique et le contexte de développement associés. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Próximo passo","en":"Next step","es":"Siguiente paso","fr":"Étape suivante"},"body":[{"pt":"Comece por “Uma sessão por objetivo”, confirme o estado visível e avance para “Nomeie para reencontrar” apenas quando a etapa anterior estiver estável. Em Sessões, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “One session per objective”, confirm the visible state, and move to “Name it to find it again” only when the previous step is stable. In Sessions, skipping context usually creates more rework than speed.","es":"Empieza por “Una sesión por objetivo”, confirma el estado visible y avanza a “Nómbrala para encontrarla” solo cuando la etapa anterior esté estable. En Sesiones, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Une session par objectif », confirmez l’état visible puis passez à « Nommez-la pour la retrouver » seulement lorsque l’étape précédente est stable. Dans Sessions, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Sessões, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Sessions, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Sesiones, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Sessions, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Contrato desta superfície: Sessões","en":"Surface contract: Sessions","es":"Contrato de la superficie: Sesiones","fr":"Contrat de la surface: Sessions"},"body":[{"pt":"Nesta página, a referência completa cobre estado da tarefa, checkpoints, retomada, cancelamento e conclusão. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Sessions as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Sesiones como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Sessions comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Sessões","en":"Edge cases for Sessions","es":"Casos límite de Sesiones","fr":"Cas limites de Sessions"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Sessions flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Sesiones sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Sessions reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"session-history","group":"sessions","asset":"coding","title":{"pt":"Histórico de sessões","en":"Session history","es":"Historial de sesiones","fr":"Historique des sessions"},"lead":{"pt":"A lista de sessões permite retomar trabalho anterior sem reconstruir manualmente o contexto.","en":"The session list lets you resume previous work without manually rebuilding context.","es":"La lista de sesiones permite retomar trabajo anterior sin reconstruir manualmente el contexto.","fr":"La liste des sessions permet de reprendre un travail précédent sans reconstruire manuellement le contexte."},"sections":[{"title":{"pt":"Retomar","en":"Resume","es":"Retomar","fr":"Reprendre"},"bullets":[{"pt":"Abra a sessão pela sidebar.","en":"Open the session from the sidebar.","es":"Abre la sesión desde la sidebar.","fr":"Ouvrez la session depuis la barre latérale."},{"pt":"Revise as últimas mensagens e arquivos antes de continuar.","en":"Review the latest messages and files before continuing.","es":"Revisa los últimos mensajes y archivos antes de continuar.","fr":"Révisez les derniers messages et fichiers avant de continuer."},{"pt":"Confirme se o objetivo ainda é o mesmo.","en":"Confirm the objective is still the same.","es":"Confirma que el objetivo sigue siendo el mismo.","fr":"Confirmez que l’objectif est toujours le même."}]},{"title":{"pt":"Evite sessões órfãs","en":"Avoid orphaned sessions","es":"Evita sesiones huérfanas","fr":"Évitez les sessions orphelines"},"body":[{"pt":"Quando terminar uma tarefa longa, deixe um resumo final do que foi alterado, validado e do que ainda falta.","en":"When finishing a long task, leave a final summary of what changed, what was validated, and what remains.","es":"Al terminar una tarea larga, deja un resumen final de lo modificado, validado y pendiente.","fr":"À la fin d’une longue tâche, laissez un résumé final de ce qui a changé, été validé et reste à faire."}]},{"title":{"pt":"Retomar sem reconstruir","en":"Resume without rebuilding context","es":"Resume without rebuilding context","fr":"Resume without rebuilding context"},"body":[{"pt":"Histórico de sessões serve para recuperar o caminho técnico já percorrido, incluindo decisões e arquivos associados.","en":"Session history helps recover the technical path already taken, including decisions and associated files.","es":"Session history helps recover the technical path already taken, including decisions and associated files.","fr":"Session history helps recover the technical path already taken, including decisions and associated files."}],"bullets":[{"pt":"Ao retomar, confira o estado atual do repositório antes de assumir que tudo continua igual ao último registro.","en":"When resuming, inspect the current repository state before assuming everything still matches the last record.","es":"When resuming, inspect the current repository state before assuming everything still matches the last record.","fr":"When resuming, inspect the current repository state before assuming everything still matches the last record."}]},{"title":{"pt":"Como pensar esta área","en":"How to think about this area","es":"Cómo pensar esta área","fr":"Comment penser cette zone"},"body":[{"pt":"Use Histórico de sessões como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A lista de sessões permite retomar trabalho anterior sem reconstruir manualmente o contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Session history as an operational reference, not as an isolated screen. The page itself is about this: The session list lets you resume previous work without manually rebuilding context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Historial de sesiones como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La lista de sesiones permite retomar trabajo anterior sin reconstruir manualmente el contexto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Historique des sessions comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La liste des sessions permet de reprendre un travail précédent sans reconstruire manuellement le contexte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Histórico de sessões o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Session history where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Historial de sesiones el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Historique des sessions où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Exemplo de uso","en":"Usage example","es":"Ejemplo de uso","fr":"Exemple d’utilisation"},"body":[{"pt":"Comece por “Retomar”, confirme o estado visível e avance para “Evite sessões órfãs” apenas quando a etapa anterior estiver estável. Em Histórico de sessões, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Resume”, confirm the visible state, and move to “Avoid orphaned sessions” only when the previous step is stable. In Session history, skipping context usually creates more rework than speed.","es":"Empieza por “Retomar”, confirma el estado visible y avanza a “Evita sesiones huérfanas” solo cuando la etapa anterior esté estable. En Historial de sesiones, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Reprendre », confirmez l’état visible puis passez à « Évitez les sessions orphelines » seulement lorsque l’étape précédente est stable. Dans Historique des sessions, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Quando não usar","en":"When not to use it","es":"Cuándo no usarlo","fr":"Quand ne pas l’utiliser"},"body":[{"pt":"Imagine uma tarefa real em que Histórico de sessões deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Session history stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Historial de sesiones deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Historique des sessions cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Histórico de sessões realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Session history truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Historial de sesiones realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Historique des sessions exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Verificação independente","en":"Independent verification","es":"Verificación independiente","fr":"Vérification indépendante"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Histórico de sessões o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Session history where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Historial de sesiones el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Historique des sessions où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Histórico de sessões como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A lista de sessões permite retomar trabalho anterior sem reconstruir manualmente o contexto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Session history as an operational reference, not as an isolated screen. The page itself is about this: The session list lets you resume previous work without manually rebuilding context. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Historial de sesiones como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La lista de sesiones permite retomar trabajo anterior sin reconstruir manualmente el contexto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Historique des sessions comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La liste des sessions permet de reprendre un travail précédent sans reconstruire manuellement le contexte. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Histórico de sessões","en":"Engineering reading: Session history","es":"Lectura de ingeniería: Historial de sesiones","fr":"Lecture d’ingénierie: Historique des sessions"},"body":[{"pt":"Nesta página, a referência completa cobre linha do tempo, decisões, artefatos, evidência e reentrada. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Session history as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Historial de sesiones como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Historique des sessions comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Histórico de sessões","en":"Edge cases for Session history","es":"Casos límite de Historial de sesiones","fr":"Cas limites de Historique des sessions"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Session history flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Historial de sesiones sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Historique des sessions reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"files","group":"workspace","asset":"coding","title":{"pt":"Arquivos","en":"Files","es":"Archivos","fr":"Fichiers"},"lead":{"pt":"O painel de arquivos serve para explorar a estrutura, abrir documentos e criar novos itens dentro do workspace.","en":"The files panel is used to explore structure, open documents, and create new items inside the workspace.","es":"El panel de archivos sirve para explorar la estructura, abrir documentos y crear nuevos elementos en el workspace.","fr":"Le panneau Fichiers sert à explorer la structure, ouvrir des documents et créer de nouveaux éléments dans l’espace."},"sections":[{"title":{"pt":"Abrir e navegar","en":"Open and navigate","es":"Abrir y navegar","fr":"Ouvrir et naviguer"},"body":[{"pt":"Use a árvore para localizar arquivos e abrir apenas o que importa para a tarefa atual. Manter o editor cheio de abas desnecessárias aumenta ruído.","en":"Use the tree to locate files and open only what matters to the current task. Keeping the editor full of unnecessary tabs adds noise.","es":"Usa el árbol para localizar archivos y abre solo lo que importa para la tarea actual. Mantener el editor lleno de pestañas innecesarias añade ruido.","fr":"Utilisez l’arborescence pour localiser les fichiers et n’ouvrez que ce qui compte pour la tâche actuelle. Remplir l’éditeur d’onglets inutiles ajoute du bruit."}]},{"title":{"pt":"Criar arquivos","en":"Create files","es":"Crear archivos","fr":"Créer des fichiers"},"body":[{"pt":"Quando o workspace permite criação, use nomes coerentes com a estrutura existente e depois abra o novo arquivo para revisão.","en":"When the workspace allows creation, use names consistent with the existing structure and then open the new file for review.","es":"Cuando el workspace permite crear, usa nombres coherentes con la estructura existente y después abre el nuevo archivo para revisión.","fr":"Lorsque l’espace permet la création, utilisez des noms cohérents avec la structure existante puis ouvrez le nouveau fichier pour révision."}]},{"title":{"pt":"Árvore de arquivos como evidência","en":"File tree as evidence","es":"File tree as evidence","fr":"File tree as evidence"},"body":[{"pt":"A árvore de arquivos deve refletir o workspace real. Abrir, criar, mover e excluir arquivos precisa manter editor e contexto sincronizados.","en":"The file tree should reflect the real workspace. Opening, creating, moving, and deleting files must keep editor and context synchronized.","es":"The file tree should reflect the real workspace. Opening, creating, moving, and deleting files must keep editor and context synchronized.","fr":"The file tree should reflect the real workspace. Opening, creating, moving, and deleting files must keep editor and context synchronized."}],"bullets":[{"pt":"Antes de alterar código, confirme o arquivo correto e leia o trecho relevante em vez de adivinhar a estrutura.","en":"Before changing code, confirm the right file and read the relevant section instead of guessing the structure.","es":"Before changing code, confirm the right file and read the relevant section instead of guessing the structure.","fr":"Before changing code, confirm the right file and read the relevant section instead of guessing the structure."}]},{"title":{"pt":"Objetivo e contexto","en":"Goal and context","es":"Objetivo y contexto","fr":"Objectif et contexte"},"body":[{"pt":"Imagine uma tarefa real em que Arquivos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Files stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Archivos deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Fichiers cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Ordem das ações","en":"Order of actions","es":"Orden de acciones","fr":"Ordre des actions"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Arquivos o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Files where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Archivos el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Fichiers où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Arquivos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O painel de arquivos serve para explorar a estrutura, abrir documentos e criar novos itens dentro do workspace. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Files as an operational reference, not as an isolated screen. The page itself is about this: The files panel is used to explore structure, open documents, and create new items inside the workspace. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Archivos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El panel de archivos sirve para explorar la estructura, abrir documentos y crear nuevos elementos en el workspace. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Fichiers comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le panneau Fichiers sert à explorer la structure, ouvrir des documents et créer de nouveaux éléments dans l’espace. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Casos de borda","en":"Edge cases","es":"Casos límite","fr":"Cas limites"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Arquivos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Files, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Archivos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Fichiers, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Abrir e navegar”, confirme o estado visível e avance para “Criar arquivos” apenas quando a etapa anterior estiver estável. Em Arquivos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Open and navigate”, confirm the visible state, and move to “Create files” only when the previous step is stable. In Files, skipping context usually creates more rework than speed.","es":"Empieza por “Abrir y navegar”, confirma el estado visible y avanza a “Crear archivos” solo cuando la etapa anterior esté estable. En Archivos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Ouvrir et naviguer », confirmez l’état visible puis passez à « Créer des fichiers » seulement lorsque l’étape précédente est stable. Dans Fichiers, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Entrega sem surpresa","en":"Delivery without surprises","es":"Entrega sin sorpresas","fr":"Livraison sans surprise"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Arquivos realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Files truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Archivos realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Fichiers exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Checklist de integração: Arquivos","en":"Integration checklist: Files","es":"Checklist de integración: Archivos","fr":"Checklist d’intégration: Fichiers"},"body":[{"pt":"Nesta página, a referência completa cobre árvore, leitura, escrita, caminhos seguros, diffs e estado sujo. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Files as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Archivos como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Fichiers comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Arquivos","en":"Edge cases for Files","es":"Casos límite de Archivos","fr":"Cas limites de Fichiers"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Files flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Archivos sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Fichiers reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"editor","group":"workspace","asset":"coding","title":{"pt":"Editor integrado","en":"Integrated editor","es":"Editor integrado","fr":"Éditeur intégré"},"lead":{"pt":"O editor abre arquivos da sessão, mantém abas e permite revisar ou salvar alterações sem sair do Code.","en":"The editor opens session files, keeps tabs, and lets you review or save changes without leaving Code.","es":"El editor abre archivos de la sesión, mantiene pestañas y permite revisar o guardar cambios sin salir de Code.","fr":"L’éditeur ouvre les fichiers de la session, conserve les onglets et permet de réviser ou enregistrer des changements sans quitter Code."},"sections":[{"title":{"pt":"Abas abertas","en":"Open tabs","es":"Pestañas abiertas","fr":"Onglets ouverts"},"body":[{"pt":"Cada aba representa um arquivo em revisão. Feche o que não está mais em uso para manter o foco na alteração atual.","en":"Each tab represents a file under review. Close what is no longer in use to keep focus on the current change.","es":"Cada pestaña representa un archivo en revisión. Cierra lo que ya no se usa para mantener el foco en el cambio actual.","fr":"Chaque onglet représente un fichier en révision. Fermez ce qui n’est plus utilisé pour garder le focus sur la modification actuelle."}]},{"title":{"pt":"Salvar conscientemente","en":"Save deliberately","es":"Guardar conscientemente","fr":"Enregistrer consciemment"},"body":[{"pt":"Depois de uma edição manual ou gerada, salve e use revisão ou execução quando a mudança precisar de validação adicional.","en":"After a manual or generated edit, save and use review or execution when the change needs additional validation.","es":"Después de una edición manual o generada, guarda y usa revisión o ejecución cuando el cambio necesite validación adicional.","fr":"Après une modification manuelle ou générée, enregistrez puis utilisez révision ou exécution si le changement nécessite une validation supplémentaire."}]},{"title":{"pt":"Editar sem perder intenção","en":"Edit without losing intent","es":"Edit without losing intent","fr":"Edit without losing intent"},"body":[{"pt":"O editor é onde proposta vira mudança concreta. Seleção, cursor, arquivo ativo e diff precisam continuar claros durante iterações longas.","en":"The editor is where a proposal becomes a concrete change. Selection, cursor, active file, and diff should remain clear during long iterations.","es":"The editor is where a proposal becomes a concrete change. Selection, cursor, active file, and diff should remain clear during long iterations.","fr":"The editor is where a proposal becomes a concrete change. Selection, cursor, active file, and diff should remain clear during long iterations."}],"bullets":[{"pt":"Mudanças extensas ficam mais seguras quando são divididas em passos verificáveis em vez de um rewrite opaco.","en":"Large changes are safer when split into verifiable steps instead of an opaque rewrite.","es":"Large changes are safer when split into verifiable steps instead of an opaque rewrite.","fr":"Large changes are safer when split into verifiable steps instead of an opaque rewrite."}]},{"title":{"pt":"Da intenção ao resultado","en":"From intent to result","es":"De la intención al resultado","fr":"De l’intention au résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Editor integrado, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Integrated editor, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Editor integrado, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Éditeur intégré, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Abas abertas”, confirme o estado visível e avance para “Salvar conscientemente” apenas quando a etapa anterior estiver estável. Em Editor integrado, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Open tabs”, confirm the visible state, and move to “Save deliberately” only when the previous step is stable. In Integrated editor, skipping context usually creates more rework than speed.","es":"Empieza por “Pestañas abiertas”, confirma el estado visible y avanza a “Guardar conscientemente” solo cuando la etapa anterior esté estable. En Editor integrado, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Onglets ouverts », confirmez l’état visible puis passez à « Enregistrer consciemment » seulement lorsque l’étape précédente est stable. Dans Éditeur intégré, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Durante a execução","en":"During execution","es":"Durante la ejecución","fr":"Pendant l’exécution"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Editor integrado realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Integrated editor truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Editor integrado realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Éditeur intégré exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Editor integrado deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Integrated editor stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Editor integrado deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Éditeur intégré cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Se algo sair do esperado","en":"If something goes off track","es":"Si algo se desvía","fr":"Si quelque chose dévie"},"body":[{"pt":"Use Editor integrado como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O editor abre arquivos da sessão, mantém abas e permite revisar ou salvar alterações sem sair do Code. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Integrated editor as an operational reference, not as an isolated screen. The page itself is about this: The editor opens session files, keeps tabs, and lets you review or save changes without leaving Code. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Editor integrado como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El editor abre archivos de la sesión, mantiene pestañas y permite revisar o guardar cambios sin salir de Code. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Éditeur intégré comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : L’éditeur ouvre les fichiers de la session, conserve les onglets et permet de réviser ou enregistrer des changements sans quitter Code. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Fechamento do trabalho","en":"Closing the work","es":"Cierre del trabajo","fr":"Clôture du travail"},"body":[{"pt":"Comece por “Abas abertas”, confirme o estado visível e avance para “Salvar conscientemente” apenas quando a etapa anterior estiver estável. Em Editor integrado, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Open tabs”, confirm the visible state, and move to “Save deliberately” only when the previous step is stable. In Integrated editor, skipping context usually creates more rework than speed.","es":"Empieza por “Pestañas abiertas”, confirma el estado visible y avanza a “Guardar conscientemente” solo cuando la etapa anterior esté estable. En Editor integrado, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Onglets ouverts », confirmez l’état visible puis passez à « Enregistrer consciemment » seulement lorsque l’étape précédente est stable. Dans Éditeur intégré, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Editor integrado, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Integrated editor, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Editor integrado, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Éditeur intégré, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Matriz de comportamento: Editor integrado","en":"Behavior matrix: Integrated editor","es":"Matriz de comportamiento: Editor integrado","fr":"Matrice de comportement: Éditeur intégré"},"body":[{"pt":"Nesta página, a referência completa cobre seleção, diagnóstico, edição integral, foco e sincronização com arquivo. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Integrated editor as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Editor integrado como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Éditeur intégré comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Editor integrado","en":"Edge cases for Integrated editor","es":"Casos límite de Editor integrado","fr":"Cas limites de Éditeur intégré"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Integrated editor flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Editor integrado sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Éditeur intégré reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"terminal","group":"workspace","asset":"coding","title":{"pt":"Terminal integrado","en":"Integrated terminal","es":"Terminal integrado","fr":"Terminal intégré"},"lead":{"pt":"O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente.","en":"The terminal runs commands and shows output that helps verify builds, tests, files, and environment.","es":"El terminal ejecuta comandos y muestra salidas que ayudan a verificar builds, pruebas, archivos y entorno.","fr":"Le terminal exécute des commandes et affiche des sorties qui aident à vérifier builds, tests, fichiers et environnement."},"sections":[{"title":{"pt":"Antes de executar","en":"Before running","es":"Antes de ejecutar","fr":"Avant d’exécuter"},"body":[{"pt":"Saiba qual pergunta o comando responde. Um comando destrutivo ou que altera o ambiente merece contexto claro antes da execução.","en":"Know what question the command answers. A destructive command or one that changes the environment deserves clear context before execution.","es":"Sabe qué pregunta responde el comando. Un comando destructivo o que cambia el entorno merece contexto claro antes de ejecutarse.","fr":"Sachez à quelle question répond la commande. Une commande destructive ou qui modifie l’environnement mérite un contexte clair avant exécution."}]},{"title":{"pt":"Depois","en":"Afterward","es":"Después","fr":"Ensuite"},"bullets":[{"pt":"Observe código de saída e erro relevante.","en":"Observe the exit code and relevant error.","es":"Observa el código de salida y el error relevante.","fr":"Observez le code de sortie et l’erreur pertinente."},{"pt":"Leve a conclusão importante de volta para a sessão.","en":"Bring the important conclusion back into the session.","es":"Lleva la conclusión importante de vuelta a la sesión.","fr":"Ramenez la conclusion importante dans la session."},{"pt":"Não confunda muito log com validação bem feita.","en":"Do not confuse a lot of logs with good validation.","es":"No confundas muchos logs con una buena validación.","fr":"Ne confondez pas beaucoup de logs avec une bonne validation."}]},{"title":{"pt":"Saída de terminal é prova","en":"Terminal output is evidence","es":"Terminal output is evidence","fr":"Terminal output is evidence"},"body":[{"pt":"Terminal não é decoração técnica. Build, teste, lint, migration e comando de execução fornecem evidência direta sobre o estado do projeto.","en":"The terminal is not technical decoration. Builds, tests, linting, migrations, and run commands provide direct evidence about project state.","es":"The terminal is not technical decoration. Builds, tests, linting, migrations, and run commands provide direct evidence about project state.","fr":"The terminal is not technical decoration. Builds, tests, linting, migrations, and run commands provide direct evidence about project state."}],"bullets":[{"pt":"Preserve stderr, exit code e comando executado quando a falha precisa ser diagnosticada.","en":"Preserve stderr, exit code, and executed command when a failure needs diagnosis.","es":"Preserve stderr, exit code, and executed command when a failure needs diagnosis.","fr":"Preserve stderr, exit code, and executed command when a failure needs diagnosis."}]},{"title":{"pt":"O papel desta página","en":"The role of this page","es":"El papel de esta página","fr":"Le rôle de cette page"},"body":[{"pt":"Use Terminal integrado como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Integrated terminal as an operational reference, not as an isolated screen. The page itself is about this: The terminal runs commands and shows output that helps verify builds, tests, files, and environment. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Terminal integrado como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El terminal ejecuta comandos y muestra salidas que ayudan a verificar builds, pruebas, archivos y entorno. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Terminal intégré comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le terminal exécute des commandes et affiche des sorties qui aident à vérifier builds, tests, fichiers et environnement. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Terminal integrado o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Integrated terminal where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Terminal integrado el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Terminal intégré où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Uso no dia a dia","en":"Day-to-day use","es":"Uso cotidiano","fr":"Usage quotidien"},"body":[{"pt":"Comece por “Antes de executar”, confirme o estado visível e avance para “Depois” apenas quando a etapa anterior estiver estável. Em Terminal integrado, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Before running”, confirm the visible state, and move to “Afterward” only when the previous step is stable. In Integrated terminal, skipping context usually creates more rework than speed.","es":"Empieza por “Antes de ejecutar”, confirma el estado visible y avanza a “Después” solo cuando la etapa anterior esté estable. En Terminal integrado, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Avant d’exécuter », confirmez l’état visible puis passez à « Ensuite » seulement lorsque l’étape précédente est stable. Dans Terminal intégré, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Armadilhas comuns","en":"Common traps","es":"Trampas comunes","fr":"Pièges courants"},"body":[{"pt":"Imagine uma tarefa real em que Terminal integrado deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Integrated terminal stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Terminal integrado deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Terminal intégré cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Terminal integrado realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Integrated terminal truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Terminal integrado realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Terminal intégré exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Conferência antes de seguir","en":"Check before moving on","es":"Comprobación antes de seguir","fr":"Vérification avant de continuer"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Terminal integrado o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Integrated terminal where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Terminal integrado el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Terminal intégré où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Terminal integrado como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O terminal executa comandos e mostra saídas que ajudam a verificar builds, testes, arquivos e ambiente. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Integrated terminal as an operational reference, not as an isolated screen. The page itself is about this: The terminal runs commands and shows output that helps verify builds, tests, files, and environment. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Terminal integrado como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El terminal ejecuta comandos y muestra salidas que ayudan a verificar builds, pruebas, archivos y entorno. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Terminal intégré comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le terminal exécute des commandes et affiche des sorties qui aident à vérifier builds, tests, fichiers et environnement. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Guia de verificação: Terminal integrado","en":"Verification guide: Integrated terminal","es":"Guía de verificación: Terminal integrado","fr":"Guide de vérification: Terminal intégré"},"body":[{"pt":"Nesta página, a referência completa cobre comandos, working directory, stdout/stderr, exit code e honestidade de execução. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Integrated terminal as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Terminal integrado como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Terminal intégré comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Terminal integrado","en":"Edge cases for Integrated terminal","es":"Casos límite de Terminal integrado","fr":"Cas limites de Terminal intégré"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Integrated terminal flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Terminal integrado sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Terminal intégré reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"run","group":"execution","asset":"coding","title":{"pt":"Executar código","en":"Run code","es":"Ejecutar código","fr":"Exécuter du code"},"lead":{"pt":"Quando suportado pela superfície atual, a execução transforma uma alteração em algo que pode ser observado e verificado.","en":"When supported by the current surface, execution turns a change into something observable and verifiable.","es":"Cuando la superficie actual lo permite, la ejecución convierte un cambio en algo observable y verificable.","fr":"Lorsque la surface actuelle le permet, l’exécution transforme une modification en quelque chose d’observable et vérifiable."},"sections":[{"title":{"pt":"Objetivo da execução","en":"Purpose of execution","es":"Objetivo de la ejecución","fr":"Objectif de l’exécution"},"bullets":[{"pt":"Confirmar sintaxe ou build.","en":"Confirm syntax or build.","es":"Confirmar sintaxis o build.","fr":"Confirmer syntaxe ou build."},{"pt":"Rodar teste relevante.","en":"Run a relevant test.","es":"Ejecutar una prueba relevante.","fr":"Exécuter un test pertinent."},{"pt":"Gerar um arquivo ou preview esperado.","en":"Generate an expected file or preview.","es":"Generar un archivo o preview esperado.","fr":"Générer un fichier ou aperçu attendu."}]},{"title":{"pt":"Web tem sandbox","en":"Web has a sandbox","es":"Web tiene sandbox","fr":"Le web a un sandbox"},"body":[{"pt":"No navegador, a capacidade de executar depende do ambiente disponibilizado. Se a tarefa exigir acesso que a superfície web não possui, use o app instalado ou outro ambiente apropriado.","en":"In the browser, execution capability depends on the provided environment. If a task requires access the web surface does not have, use the installed app or another appropriate environment.","es":"En el navegador, la capacidad de ejecutar depende del entorno disponible. Si una tarea requiere acceso que la superficie web no tiene, usa la app instalada u otro entorno adecuado.","fr":"Dans le navigateur, la capacité d’exécution dépend de l’environnement fourni. Si une tâche exige un accès que la surface web n’a pas, utilisez l’application installée ou un autre environnement adapté."}]},{"title":{"pt":"Executar com hipótese clara","en":"Run with a clear hypothesis","es":"Run with a clear hypothesis","fr":"Run with a clear hypothesis"},"body":[{"pt":"Antes de rodar um comando, saiba o que ele deve confirmar. Execução sem hipótese vira tentativa e erro difícil de revisar.","en":"Before running a command, know what it is supposed to confirm. Execution without a hypothesis becomes hard-to-review trial and error.","es":"Before running a command, know what it is supposed to confirm. Execution without a hypothesis becomes hard-to-review trial and error.","fr":"Before running a command, know what it is supposed to confirm. Execution without a hypothesis becomes hard-to-review trial and error."}],"bullets":[{"pt":"Depois do comando, compare resultado observado com o esperado e só então avance.","en":"After the command, compare the observed result with the expected one before moving on.","es":"After the command, compare the observed result with the expected one before moving on.","fr":"After the command, compare the observed result with the expected one before moving on."}]},{"title":{"pt":"Primeira decisão","en":"First decision","es":"Primera decisión","fr":"Première décision"},"body":[{"pt":"Imagine uma tarefa real em que Executar código deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Run code stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Ejecutar código deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Exécuter du code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Como manter o contexto","en":"Keeping context intact","es":"Cómo mantener el contexto","fr":"Préserver le contexte"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Executar código o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Run code where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Ejecutar código el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Exécuter du code où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Executar código como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Quando suportado pela superfície atual, a execução transforma uma alteração em algo que pode ser observado e verificado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Run code as an operational reference, not as an isolated screen. The page itself is about this: When supported by the current surface, execution turns a change into something observable and verifiable. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Ejecutar código como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Cuando la superficie actual lo permite, la ejecución convierte un cambio en algo observable y verificable. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Exécuter du code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Lorsque la surface actuelle le permet, l’exécution transforme une modification en quelque chose d’observable et vérifiable. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Falhas recuperáveis","en":"Recoverable failures","es":"Fallos recuperables","fr":"Échecs récupérables"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Executar código, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Run code, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Ejecutar código, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Exécuter du code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Objetivo da execução”, confirme o estado visível e avance para “Web tem sandbox” apenas quando a etapa anterior estiver estável. Em Executar código, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Purpose of execution”, confirm the visible state, and move to “Web has a sandbox” only when the previous step is stable. In Run code, skipping context usually creates more rework than speed.","es":"Empieza por “Objetivo de la ejecución”, confirma el estado visible y avanza a “Web tiene sandbox” solo cuando la etapa anterior esté estable. En Ejecutar código, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Objectif de l’exécution », confirmez l’état visible puis passez à « Le web a un sandbox » seulement lorsque l’étape précédente est stable. Dans Exécuter du code, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Resultado esperado","en":"Expected outcome","es":"Resultado esperado","fr":"Résultat attendu"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Executar código realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Run code truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Ejecutar código realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Exécuter du code exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Detalhes que evitam regressão: Executar código","en":"Details that prevent regressions: Run code","es":"Detalles que evitan regresiones: Ejecutar código","fr":"Détails anti-régression: Exécuter du code"},"body":[{"pt":"Nesta página, a referência completa cobre entrypoints, dependências, processo, timeout, cancelamento e evidência de runtime. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Run code as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Ejecutar código como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Exécuter du code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Executar código","en":"Edge cases for Run code","es":"Casos límite de Ejecutar código","fr":"Cas limites de Exécuter du code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Run code flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Ejecutar código sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Exécuter du code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"preview","group":"execution","asset":"coding","title":{"pt":"Preview","en":"Preview","es":"Preview","fr":"Aperçu"},"lead":{"pt":"Preview permite olhar o resultado gerado sem transformar a revisão em troca constante de ferramentas.","en":"Preview lets you inspect the generated result without turning review into constant tool switching.","es":"Preview permite mirar el resultado generado sin convertir la revisión en cambio constante de herramientas.","fr":"L’aperçu permet d’examiner le résultat généré sans transformer la révision en changement constant d’outils."},"sections":[{"title":{"pt":"O que revisar","en":"What to review","es":"Qué revisar","fr":"Que vérifier"},"bullets":[{"pt":"Layout e responsividade.","en":"Layout and responsiveness.","es":"Layout y responsividad.","fr":"Mise en page et réactivité."},{"pt":"Estados e ações principais.","en":"States and primary actions.","es":"Estados y acciones principales.","fr":"États et actions principales."},{"pt":"Se o resultado corresponde ao pedido.","en":"Whether the result matches the request.","es":"Si el resultado corresponde a la solicitud.","fr":"Si le résultat correspond à la demande."}]},{"title":{"pt":"Preview não é teste automático","en":"Preview is not an automated test","es":"Preview no es una prueba automática","fr":"L’aperçu n’est pas un test automatisé"},"body":[{"pt":"Ele ajuda a enxergar o resultado. Terminal, diagnósticos e revisão continuam necessários quando a tarefa exige confirmação técnica.","en":"It helps you see the result. Terminal, diagnostics, and review remain necessary when the task requires technical confirmation.","es":"Ayuda a ver el resultado. Terminal, diagnósticos y revisión siguen siendo necesarios cuando la tarea exige confirmación técnica.","fr":"Il aide à voir le résultat. Terminal, diagnostics et révision restent nécessaires lorsque la tâche exige une confirmation technique."}]},{"title":{"pt":"Preview antes da entrega","en":"Preview before delivery","es":"Preview before delivery","fr":"Preview before delivery"},"body":[{"pt":"Preview é a ponte entre código e experiência final. Ele deve mostrar HTML, UI ou artefato no estado em que o usuário realmente verá.","en":"Preview is the bridge between code and the final experience. It should show HTML, UI, or artifacts in the state the user will actually see.","es":"Preview is the bridge between code and the final experience. It should show HTML, UI, or artifacts in the state the user will actually see.","fr":"Preview is the bridge between code and the final experience. It should show HTML, UI, or artifacts in the state the user will actually see."}],"bullets":[{"pt":"Use preview para detectar layout quebrado, assets faltando e comportamento visual que testes de sintaxe não capturam.","en":"Use preview to catch broken layout, missing assets, and visual behavior that syntax tests cannot detect.","es":"Use preview to catch broken layout, missing assets, and visual behavior that syntax tests cannot detect.","fr":"Use preview to catch broken layout, missing assets, and visual behavior that syntax tests cannot detect."}]},{"title":{"pt":"Visão prática","en":"Practical view","es":"Vista práctica","fr":"Vue pratique"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Preview, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Preview, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Preview, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Aperçu, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “O que revisar”, confirme o estado visível e avance para “Preview não é teste automático” apenas quando a etapa anterior estiver estável. Em Preview, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What to review”, confirm the visible state, and move to “Preview is not an automated test” only when the previous step is stable. In Preview, skipping context usually creates more rework than speed.","es":"Empieza por “Qué revisar”, confirma el estado visible y avanza a “Preview no es una prueba automática” solo cuando la etapa anterior esté estable. En Preview, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Que vérifier », confirmez l’état visible puis passez à « L’aperçu n’est pas un test automatisé » seulement lorsque l’étape précédente est stable. Dans Aperçu, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Fluxo mínimo","en":"Minimum viable flow","es":"Flujo mínimo","fr":"Flux minimal"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Preview realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Preview truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Preview realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Aperçu exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Preview deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Preview stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Preview deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Aperçu cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Escalando com segurança","en":"Scaling safely","es":"Escalar con seguridad","fr":"Monter en charge en sécurité"},"body":[{"pt":"Use Preview como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Preview permite olhar o resultado gerado sem transformar a revisão em troca constante de ferramentas. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Preview as an operational reference, not as an isolated screen. The page itself is about this: Preview lets you inspect the generated result without turning review into constant tool switching. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Preview como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Preview permite mirar el resultado generado sin convertir la revisión en cambio constante de herramientas. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Aperçu comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : L’aperçu permet d’examiner le résultat généré sans transformer la révision en changement constant d’outils. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Como saber que funcionou","en":"How to know it worked","es":"Cómo saber que funcionó","fr":"Comment savoir que cela a fonctionné"},"body":[{"pt":"Comece por “O que revisar”, confirme o estado visível e avance para “Preview não é teste automático” apenas quando a etapa anterior estiver estável. Em Preview, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What to review”, confirm the visible state, and move to “Preview is not an automated test” only when the previous step is stable. In Preview, skipping context usually creates more rework than speed.","es":"Empieza por “Qué revisar”, confirma el estado visible y avanza a “Preview no es una prueba automática” solo cuando la etapa anterior esté estable. En Preview, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Que vérifier », confirmez l’état visible puis passez à « L’aperçu n’est pas un test automatisé » seulement lorsque l’étape précédente est stable. Dans Aperçu, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Preview, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Preview, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Preview, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Aperçu, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Mapa operacional: Preview","en":"Operational map: Preview","es":"Mapa operativo: Preview","fr":"Carte opérationnelle: Aperçu"},"body":[{"pt":"Nesta página, a referência completa cobre servidor local, navegador, screenshot, DOM, interação e breakpoints. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Preview as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Preview como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Aperçu comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Preview","en":"Edge cases for Preview","es":"Casos límite de Preview","fr":"Cas limites de Aperçu"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Preview flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Preview sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Aperçu reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"review","group":"execution","asset":"coding","title":{"pt":"Revisão","en":"Review","es":"Revisión","fr":"Révision"},"lead":{"pt":"A revisão resume alterações, arquivos e diagnósticos para apoiar a decisão de encerrar ou continuar a tarefa.","en":"Review summarizes changes, files, and diagnostics to support the decision to close or continue the task.","es":"La revisión resume cambios, archivos y diagnósticos para apoyar la decisión de cerrar o continuar la tarea.","fr":"La révision résume changements, fichiers et diagnostics pour aider à décider de terminer ou poursuivre la tâche."},"sections":[{"title":{"pt":"Leia o resumo","en":"Read the summary","es":"Lee el resumen","fr":"Lisez le résumé"},"body":[{"pt":"Comece pelo que a sessão afirma ter mudado. Depois confira arquivos e evidências que sustentam esse resumo.","en":"Start with what the session says it changed. Then inspect files and evidence that support that summary.","es":"Empieza por lo que la sesión afirma haber cambiado. Después revisa archivos y evidencias que sostienen ese resumen.","fr":"Commencez par ce que la session affirme avoir modifié. Vérifiez ensuite fichiers et preuves qui soutiennent ce résumé."}]},{"title":{"pt":"Diagnósticos","en":"Diagnostics","es":"Diagnósticos","fr":"Diagnostics"},"body":[{"pt":"Erros e avisos devem continuar visíveis até serem resolvidos ou conscientemente aceitos como limite da entrega.","en":"Errors and warnings should remain visible until resolved or consciously accepted as a delivery limitation.","es":"Errores y avisos deben seguir visibles hasta resolverse o aceptarse conscientemente como límite de la entrega.","fr":"Erreurs et avertissements doivent rester visibles jusqu’à résolution ou acceptation consciente comme limite de livraison."}]},{"title":{"pt":"Revisão independente de verdade","en":"Truly independent review","es":"Truly independent review","fr":"Truly independent review"},"body":[{"pt":"Revisão é mais útil quando não repete a mesma hipótese do agente que fez a mudança. Thesis e Melos podem atuar como leituras independentes antes de aceitar a entrega.","en":"Review is more useful when it does not simply repeat the hypothesis of the agent that made the change. Thesis and Melos can act as independent readings before acceptance.","es":"Review is more useful when it does not simply repeat the hypothesis of the agent that made the change. Thesis and Melos can act as independent readings before acceptance.","fr":"Review is more useful when it does not simply repeat the hypothesis of the agent that made the change. Thesis and Melos can act as independent readings before acceptance."}],"bullets":[{"pt":"Uma revisão deve apontar regressão observável, risco ou contrato violado; reprovar sem diagnóstico não ajuda.","en":"A review should identify an observable regression, risk, or violated contract; rejecting without diagnosis is not helpful.","es":"A review should identify an observable regression, risk, or violated contract; rejecting without diagnosis is not helpful.","fr":"A review should identify an observable regression, risk, or violated contract; rejecting without diagnosis is not helpful."}]},{"title":{"pt":"Como isso entra no fluxo","en":"How this fits the workflow","es":"Cómo entra esto en el flujo","fr":"Comment cela s’insère dans le flux"},"body":[{"pt":"Use Revisão como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A revisão resume alterações, arquivos e diagnósticos para apoiar a decisão de encerrar ou continuar a tarefa. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Review as an operational reference, not as an isolated screen. The page itself is about this: Review summarizes changes, files, and diagnostics to support the decision to close or continue the task. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Revisión como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La revisión resume cambios, archivos y diagnósticos para apoyar la decisión de cerrar o continuar la tarea. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Révision comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La révision résume changements, fichiers et diagnostics pour aider à décider de terminer ou poursuivre la tâche. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Revisão o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Review where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Revisión el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Révision où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Cenário real","en":"Real-world scenario","es":"Escenario real","fr":"Scénario réel"},"body":[{"pt":"Comece por “Leia o resumo”, confirme o estado visível e avance para “Diagnósticos” apenas quando a etapa anterior estiver estável. Em Revisão, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Read the summary”, confirm the visible state, and move to “Diagnostics” only when the previous step is stable. In Review, skipping context usually creates more rework than speed.","es":"Empieza por “Lee el resumen”, confirma el estado visible y avanza a “Diagnósticos” solo cuando la etapa anterior esté estable. En Revisión, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Lisez le résumé », confirmez l’état visible puis passez à « Diagnostics » seulement lorsque l’étape précédente est stable. Dans Révision, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Onde costuma quebrar","en":"Where it usually breaks","es":"Dónde suele fallar","fr":"Là où cela casse souvent"},"body":[{"pt":"Imagine uma tarefa real em que Revisão deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Review stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Revisión deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Révision cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Revisão realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Review truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Revisión realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Révision exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Critério de conclusão","en":"Definition of done","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Revisão o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Review where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Revisión el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Révision où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Revisão como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A revisão resume alterações, arquivos e diagnósticos para apoiar a decisão de encerrar ou continuar a tarefa. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Review as an operational reference, not as an isolated screen. The page itself is about this: Review summarizes changes, files, and diagnostics to support the decision to close or continue the task. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Revisión como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La revisión resume cambios, archivos y diagnósticos para apoyar la decisión de cerrar o continuar la tarea. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Révision comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : La révision résume changements, fichiers et diagnostics pour aider à décider de terminer ou poursuivre la tâche. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Revisão","en":"Production reference: Review","es":"Referencia de producción: Revisión","fr":"Référence de production: Révision"},"body":[{"pt":"Nesta página, a referência completa cobre arquitetura, produto, segurança, regressão, visual e poder de veto. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Review as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Revisión como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Révision comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Revisão","en":"Edge cases for Review","es":"Casos límite de Revisión","fr":"Cas limites de Révision"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Review flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Revisión sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Révision reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"artifacts","group":"execution","asset":"coding","title":{"pt":"Artefatos no Code","en":"Artifacts in Code","es":"Artefactos en Code","fr":"Artefacts dans Code"},"lead":{"pt":"Resultados gerados pelo fluxo de código podem aparecer como artefatos para abrir, revisar e exportar.","en":"Results generated by the coding flow can appear as artifacts to open, review, and export.","es":"Los resultados generados por el flujo de código pueden aparecer como artefactos para abrir, revisar y exportar.","fr":"Les résultats générés par le flux de code peuvent apparaître comme artefacts à ouvrir, réviser et exporter."},"sections":[{"title":{"pt":"Quando usar um artefato","en":"When to use an artifact","es":"Cuándo usar un artefacto","fr":"Quand utiliser un artefact"},"bullets":[{"pt":"Arquivo final que precisa ser entregue.","en":"A final file that needs delivery.","es":"Un archivo final que debe entregarse.","fr":"Un fichier final à livrer."},{"pt":"HTML ou documento que se beneficia de preview.","en":"HTML or a document that benefits from preview.","es":"HTML o documento que se beneficia de preview.","fr":"HTML ou document bénéficiant d’un aperçu."},{"pt":"Pacote gerado que precisa ser baixado.","en":"A generated package that needs download.","es":"Un paquete generado que debe descargarse.","fr":"Un paquet généré à télécharger."}]},{"title":{"pt":"Nome e contexto","en":"Name and context","es":"Nombre y contexto","fr":"Nom et contexte"},"body":[{"pt":"Use nomes claros para que o resultado continue reconhecível fora da conversa e mantenha a relação com a sessão que o produziu.","en":"Use clear names so the result stays recognizable outside the conversation and keeps its relationship to the session that produced it.","es":"Usa nombres claros para que el resultado siga reconocible fuera de la conversación y conserve su relación con la sesión que lo produjo.","fr":"Utilisez des noms clairs pour que le résultat reste reconnaissable hors de la conversation et conserve son lien avec la session qui l’a produit."}]},{"title":{"pt":"Entrega técnica reproduzível","en":"Reproducible technical delivery","es":"Reproducible technical delivery","fr":"Reproducible technical delivery"},"body":[{"pt":"Artefatos do Code devem permitir que outra pessoa inspecione o resultado: HTML, ZIP, relatório, imagem ou arquivo gerado.","en":"Code artifacts should let another person inspect the result: HTML, ZIP, report, image, or generated file.","es":"Code artifacts should let another person inspect the result: HTML, ZIP, report, image, or generated file.","fr":"Code artifacts should let another person inspect the result: HTML, ZIP, report, image, or generated file."}],"bullets":[{"pt":"Nome, formato e conteúdo precisam corresponder ao que foi prometido na conversa.","en":"Name, format, and content should match what was promised in the conversation.","es":"Name, format, and content should match what was promised in the conversation.","fr":"Name, format, and content should match what was promised in the conversation."}]},{"title":{"pt":"Antes de começar","en":"Before you start","es":"Antes de empezar","fr":"Avant de commencer"},"body":[{"pt":"Imagine uma tarefa real em que Artefatos no Code deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Artifacts in Code stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Artefactos en Code deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Artefacts dans Code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Sequência recomendada","en":"Recommended sequence","es":"Secuencia recomendada","fr":"Séquence recommandée"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Artefatos no Code o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Artifacts in Code where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Artefactos en Code el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Artefacts dans Code où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Artefatos no Code como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Resultados gerados pelo fluxo de código podem aparecer como artefatos para abrir, revisar e exportar. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Artifacts in Code as an operational reference, not as an isolated screen. The page itself is about this: Results generated by the coding flow can appear as artifacts to open, review, and export. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Artefactos en Code como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los resultados generados por el flujo de código pueden aparecer como artefactos para abrir, revisar y exportar. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Artefacts dans Code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les résultats générés par le flux de code peuvent apparaître comme artefacts à ouvrir, réviser et exporter. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Decisões que mudam o resultado","en":"Decisions that change the outcome","es":"Decisiones que cambian el resultado","fr":"Décisions qui changent le résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Artefatos no Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Artifacts in Code, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Artefactos en Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Artefacts dans Code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Quando usar um artefato”, confirme o estado visível e avance para “Nome e contexto” apenas quando a etapa anterior estiver estável. Em Artefatos no Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When to use an artifact”, confirm the visible state, and move to “Name and context” only when the previous step is stable. In Artifacts in Code, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo usar un artefacto”, confirma el estado visible y avanza a “Nombre y contexto” solo cuando la etapa anterior esté estable. En Artefactos en Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand utiliser un artefact », confirmez l’état visible puis passez à « Nom et contexte » seulement lorsque l’étape précédente est stable. Dans Artefacts dans Code, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Como validar","en":"How to validate","es":"Cómo validar","fr":"Comment valider"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Artefatos no Code realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Artifacts in Code truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Artefactos en Code realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Artefacts dans Code exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Contrato desta superfície: Artefatos no Code","en":"Surface contract: Artifacts in Code","es":"Contrato de la superficie: Artefactos en Code","fr":"Contrat de la surface: Artefacts dans Code"},"body":[{"pt":"Nesta página, a referência completa cobre arquivos gerados, protocolo de paths, preview, download e handoff. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Artifacts in Code as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Artefactos en Code como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Artefacts dans Code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Artefatos no Code","en":"Edge cases for Artifacts in Code","es":"Casos límite de Artefactos en Code","fr":"Cas limites de Artefacts dans Code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Artifacts in Code flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Artefactos en Code sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Artefacts dans Code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"models","group":"controls","asset":"theory","title":{"pt":"Modelos no Code","en":"Models in Code","es":"Modelos en Code","fr":"Modèles dans Code"},"lead":{"pt":"O seletor de modelo define qual opção disponível será usada na sessão de desenvolvimento.","en":"The model selector defines which available option will be used in the development session.","es":"El selector de modelo define qué opción disponible se usará en la sesión de desarrollo.","fr":"Le sélecteur de modèle définit quelle option disponible sera utilisée dans la session de développement."},"sections":[{"title":{"pt":"Thesis 2.1","en":"Thesis 2.1","es":"Thesis 2.1","fr":"Thesis 2.1"},"body":[{"pt":"Thesis 2.1 é o alias frontier do Giorgio para arquitetura, coding profundo e direção visual. Ele usa o mesmo identificador interno “thesis” para preservar compatibilidade de roteamento, mas a experiência de produto passa a expor a geração 2 explicitamente.","en":"Thesis 2.1 is Giorgio’s frontier alias for architecture, deep coding, and visual direction. It keeps the internal “thesis” identifier for routing compatibility while the product experience exposes generation 2 explicitly.","es":"Thesis 2.1 es el alias frontier de Giorgio para arquitectura, coding profundo y dirección visual. Mantiene el identificador interno “thesis” para conservar compatibilidad de rutas, mientras la experiencia muestra explícitamente la generación 2.","fr":"Thesis 2.1 est l’alias frontier de Giorgio pour l’architecture, le coding profond et la direction visuelle. Il conserve l’identifiant interne « thesis » pour la compatibilité de routage tout en affichant explicitement la génération 2 dans le produit."}],"bullets":[{"pt":"gerador + avaliador para tarefas visuais ambiciosas","en":"generator + evaluator for ambitious visual tasks","es":"generador + evaluador para tareas visuales ambiciosas","fr":"générateur + évaluateur pour les tâches visuelles ambitieuses"},{"pt":"checkpoint da melhor versão válida para evitar regressão","en":"best-valid checkpoint to prevent regression","es":"checkpoint de la mejor versión válida para evitar regresiones","fr":"checkpoint de la meilleure version valide pour éviter les régressions"},{"pt":"validação funcional continua obrigatória mesmo quando o foco é estética","en":"functional validation remains mandatory even when aesthetics are the focus","es":"la validación funcional sigue siendo obligatoria aunque el foco sea la estética","fr":"la validation fonctionnelle reste obligatoire même lorsque l’esthétique est prioritaire"}]},{"title":{"pt":"Domínios especializados do Thesis 2.1 v3","en":"Specialized domains in Thesis 2.1 v3","es":"Dominios especializados de Thesis 2.1 v3","fr":"Domaines spécialisés de Thesis 2.1 v3"},"body":[{"pt":"A terceira geração do gateway classifica visual, 3D, PBR, arquitetura, refinamento e risco separadamente. Isso permite aumentar o rigor em um domínio sem transformar toda tarefa em uma execução frontier cara.","en":"The third gateway generation classifies visual, 3D, PBR, architecture, refinement, and risk separately. This allows rigor to increase in one domain without turning every task into an expensive frontier run.","es":"La tercera generación clasifica visual, 3D, PBR, arquitectura, refinamiento y riesgo por separado.","fr":"La troisième génération classe visuel, 3D, PBR, architecture, raffinement et risque séparément."}],"bullets":[{"pt":"anti-AI-slop e fidelidade de referência","en":"anti-AI-slop and reference fidelity","es":"anti-AI-slop y fidelidad de referencia","fr":"anti-AI-slop et fidélité de référence"},{"pt":"PBR/3D com pipeline físico e budget de GPU","en":"PBR/3D with physical pipeline and GPU budget","es":"PBR/3D con pipeline físico y budget GPU","fr":"PBR/3D avec pipeline physique et budget GPU"},{"pt":"arquitetura, contratos e targeted repair","en":"architecture, contracts, and targeted repair","es":"arquitectura, contratos y targeted repair","fr":"architecture, contrats et targeted repair"}]},{"title":{"pt":"Escolha pelo trabalho","en":"Choose for the work","es":"Elige según el trabajo","fr":"Choisissez selon le travail"},"body":[{"pt":"Tarefas rápidas e pequenas podem não precisar do mesmo orçamento de uma revisão ampla ou refactor de vários arquivos.","en":"Small, quick tasks may not need the same budget as a broad review or multi-file refactor.","es":"Las tareas pequeñas y rápidas pueden no necesitar el mismo presupuesto que una revisión amplia o refactor de varios archivos.","fr":"Les petites tâches rapides peuvent ne pas nécessiter le même budget qu’une révision large ou un refactor multi-fichiers."}]},{"title":{"pt":"Disponibilidade pode mudar","en":"Availability can change","es":"La disponibilidad puede cambiar","fr":"La disponibilité peut changer"},"body":[{"pt":"Se um modelo estiver temporariamente indisponível, a interface deve mostrar esse estado em vez de deixar o envio falhar sem contexto.","en":"If a model is temporarily unavailable, the interface should show that state instead of letting a send fail without context.","es":"Si un modelo está temporalmente no disponible, la interfaz debe mostrar ese estado en lugar de dejar que el envío falle sin contexto.","fr":"Si un modèle est temporairement indisponible, l’interface doit afficher cet état au lieu de laisser l’envoi échouer sans contexte."}]},{"title":{"pt":"Escolher modelo pela carga","en":"Choose the model by workload","es":"Choose the model by workload","fr":"Choose the model by workload"},"body":[{"pt":"Melos favorece baixa latência; Thesis aumenta profundidade; Thesis 1.6 adiciona raciocínio adaptativo e disciplina de preflight para mudanças de maior risco.","en":"Melos favors low latency; Thesis adds depth; Thesis 1.6 adds adaptive reasoning and stricter preflight for higher-risk changes.","es":"Melos favors low latency; Thesis adds depth; Thesis 1.6 adds adaptive reasoning and stricter preflight for higher-risk changes.","fr":"Melos favors low latency; Thesis adds depth; Thesis 1.6 adds adaptive reasoning and stricter preflight for higher-risk changes."}],"bullets":[{"pt":"Escolha pelo custo do erro e pela complexidade da tarefa, não por hábito ou tamanho da resposta.","en":"Choose based on error cost and task complexity, not habit or response length.","es":"Choose based on error cost and task complexity, not habit or response length.","fr":"Choose based on error cost and task complexity, not habit or response length."}]},{"title":{"pt":"Leitura operacional","en":"Operational reading","es":"Lectura operativa","fr":"Lecture opérationnelle"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Modelos no Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Models in Code, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Modelos en Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Modèles dans Code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Escolha pelo trabalho”, confirme o estado visível e avance para “Disponibilidade pode mudar” apenas quando a etapa anterior estiver estável. Em Modelos no Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Choose for the work”, confirm the visible state, and move to “Availability can change” only when the previous step is stable. In Models in Code, skipping context usually creates more rework than speed.","es":"Empieza por “Elige según el trabajo”, confirma el estado visible y avanza a “La disponibilidad puede cambiar” solo cuando la etapa anterior esté estable. En Modelos en Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Choisissez selon le travail », confirmez l’état visible puis passez à « La disponibilité peut changer » seulement lorsque l’étape précédente est stable. Dans Modèles dans Code, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Do primeiro clique à entrega","en":"From first click to delivery","es":"Del primer clic a la entrega","fr":"Du premier clic à la livraison"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Modelos no Code realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Models in Code truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Modelos en Code realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Modèles dans Code exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Modelos no Code deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Models in Code stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Modelos en Code deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Modèles dans Code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Limites e exceções","en":"Limits and exceptions","es":"Límites y excepciones","fr":"Limites et exceptions"},"body":[{"pt":"Use Modelos no Code como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O seletor de modelo define qual opção disponível será usada na sessão de desenvolvimento. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Models in Code as an operational reference, not as an isolated screen. The page itself is about this: The model selector defines which available option will be used in the development session. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Modelos en Code como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El selector de modelo define qué opción disponible se usará en la sesión de desarrollo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Modèles dans Code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le sélecteur de modèle définit quelle option disponible sera utilisée dans la session de développement. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Checklist de uso","en":"Usage checklist","es":"Lista de uso","fr":"Liste de contrôle"},"body":[{"pt":"Comece por “Escolha pelo trabalho”, confirme o estado visível e avance para “Disponibilidade pode mudar” apenas quando a etapa anterior estiver estável. Em Modelos no Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Choose for the work”, confirm the visible state, and move to “Availability can change” only when the previous step is stable. In Models in Code, skipping context usually creates more rework than speed.","es":"Empieza por “Elige según el trabajo”, confirma el estado visible y avanza a “La disponibilidad puede cambiar” solo cuando la etapa anterior esté estable. En Modelos en Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Choisissez selon le travail », confirmez l’état visible puis passez à « La disponibilité peut changer » seulement lorsque l’étape précédente est stable. Dans Modèles dans Code, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Modelos no Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Models in Code, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Modelos en Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Modèles dans Code, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Modelos no Code","en":"Engineering reading: Models in Code","es":"Lectura de ingeniería: Modelos en Code","fr":"Lecture d’ingénierie: Modèles dans Code"},"body":[{"pt":"Nesta página, a referência completa cobre Thesis 2.1, Thesis 1.6, Melos, roteamento, identidade e fallback. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Models in Code as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Modelos en Code como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Modèles dans Code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Modelos no Code","en":"Edge cases for Models in Code","es":"Casos límite de Modelos en Code","fr":"Cas limites de Modèles dans Code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Models in Code flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Modelos en Code sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Modèles dans Code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"effort","group":"controls","asset":"theory","title":{"pt":"Esforço de raciocínio","en":"Reasoning effort","es":"Esfuerzo de razonamiento","fr":"Effort de raisonnement"},"lead":{"pt":"O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final.","en":"The effort control adjusts how much reasoning work the session may spend before the final answer.","es":"El control de esfuerzo ajusta cuánto trabajo de razonamiento puede dedicar la sesión antes de la respuesta final.","fr":"Le contrôle d’effort ajuste la quantité de raisonnement que la session peut consacrer avant la réponse finale."},"sections":[{"title":{"pt":"Aumente quando","en":"Increase it when","es":"Auméntalo cuando","fr":"Augmentez-le lorsque"},"bullets":[{"pt":"Há muitas dependências ou arquivos envolvidos.","en":"Many dependencies or files are involved.","es":"Hay muchas dependencias o archivos implicados.","fr":"De nombreuses dépendances ou fichiers sont impliqués."},{"pt":"O pedido exige planejamento e revisão em várias etapas.","en":"The request requires multi-step planning and review.","es":"La solicitud exige planificación y revisión en varias etapas.","fr":"La demande exige planification et révision en plusieurs étapes."},{"pt":"Um erro pode ter causas menos óbvias.","en":"An error may have less obvious causes.","es":"Un error puede tener causas menos obvias.","fr":"Une erreur peut avoir des causes moins évidentes."}]},{"title":{"pt":"Não aumente por hábito","en":"Do not increase it by habit","es":"No lo aumentes por costumbre","fr":"Ne l’augmentez pas par habitude"},"body":[{"pt":"Uma alteração simples fica mais eficiente com um esforço proporcional. O melhor nível é o menor que ainda oferece qualidade suficiente para a tarefa.","en":"A simple change is more efficient with proportional effort. The best level is the lowest one that still provides enough quality for the task.","es":"Un cambio simple es más eficiente con un esfuerzo proporcional. El mejor nivel es el menor que todavía ofrece calidad suficiente para la tarea.","fr":"Une modification simple est plus efficace avec un effort proportionné. Le meilleur niveau est le plus bas qui fournit encore une qualité suffisante pour la tâche."}]},{"title":{"pt":"Esforço é orçamento","en":"Effort is a budget","es":"Effort is a budget","fr":"Effort is a budget"},"body":[{"pt":"Low, Medium, High, Extra e Max controlam quanto trabalho interno é dedicado à tarefa. Mais esforço não significa automaticamente melhor resultado.","en":"Low, Medium, High, Extra, and Max control how much internal work is spent on the task. More effort does not automatically mean a better result.","es":"Low, Medium, High, Extra, and Max control how much internal work is spent on the task. More effort does not automatically mean a better result.","fr":"Low, Medium, High, Extra, and Max control how much internal work is spent on the task. More effort does not automatically mean a better result."}],"bullets":[{"pt":"Aumente o nível quando dependências, regressões ou custo de reversão deixam de ser locais.","en":"Increase effort when dependencies, regressions, or the cost of reversal stop being local.","es":"Increase effort when dependencies, regressions, or the cost of reversal stop being local.","fr":"Increase effort when dependencies, regressions, or the cost of reversal stop being local."}]},{"title":{"pt":"O que merece atenção","en":"What deserves attention","es":"Qué merece atención","fr":"Ce qui mérite l’attention"},"body":[{"pt":"Use Esforço de raciocínio como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Reasoning effort as an operational reference, not as an isolated screen. The page itself is about this: The effort control adjusts how much reasoning work the session may spend before the final answer. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Esfuerzo de razonamiento como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El control de esfuerzo ajusta cuánto trabajo de razonamiento puede dedicar la sesión antes de la respuesta final. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Effort de raisonnement comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le contrôle d’effort ajuste la quantité de raisonnement que la session peut consacrer avant la réponse finale. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Esforço de raciocínio o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Reasoning effort where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Esfuerzo de razonamiento el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Effort de raisonnement où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Um fluxo que funciona","en":"A workflow that works","es":"Un flujo que funciona","fr":"Un flux qui fonctionne"},"body":[{"pt":"Comece por “Aumente quando”, confirme o estado visível e avance para “Não aumente por hábito” apenas quando a etapa anterior estiver estável. Em Esforço de raciocínio, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Increase it when”, confirm the visible state, and move to “Do not increase it by habit” only when the previous step is stable. In Reasoning effort, skipping context usually creates more rework than speed.","es":"Empieza por “Auméntalo cuando”, confirma el estado visible y avanza a “No lo aumentes por costumbre” solo cuando la etapa anterior esté estable. En Esfuerzo de razonamiento, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Augmentez-le lorsque », confirmez l’état visible puis passez à « Ne l’augmentez pas par habitude » seulement lorsque l’étape précédente est stable. Dans Effort de raisonnement, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Quando mudar de estratégia","en":"When to change strategy","es":"Cuándo cambiar de estrategia","fr":"Quand changer de stratégie"},"body":[{"pt":"Imagine uma tarefa real em que Esforço de raciocínio deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Reasoning effort stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Esfuerzo de razonamiento deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Effort de raisonnement cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Esforço de raciocínio realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Reasoning effort truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Esfuerzo de razonamiento realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Effort de raisonnement exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Sinais de que terminou","en":"Signals that you are done","es":"Señales de finalización","fr":"Signes que le travail est terminé"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Esforço de raciocínio o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Reasoning effort where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Esfuerzo de razonamiento el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Effort de raisonnement où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Esforço de raciocínio como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O controle de esforço ajusta quanto trabalho de raciocínio a sessão pode dedicar antes da resposta final. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Reasoning effort as an operational reference, not as an isolated screen. The page itself is about this: The effort control adjusts how much reasoning work the session may spend before the final answer. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Esfuerzo de razonamiento como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El control de esfuerzo ajusta cuánto trabajo de razonamiento puede dedicar la sesión antes de la respuesta final. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Effort de raisonnement comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le contrôle d’effort ajuste la quantité de raisonnement que la session peut consacrer avant la réponse finale. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Checklist de integração: Esforço de raciocínio","en":"Integration checklist: Reasoning effort","es":"Checklist de integración: Esfuerzo de razonamiento","fr":"Checklist d’intégration: Effort de raisonnement"},"body":[{"pt":"Nesta página, a referência completa cobre Low, Medium, High, Extra, Max, adaptação e orçamento de verificação. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Reasoning effort as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Esfuerzo de razonamiento como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Effort de raisonnement comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Esforço de raciocínio","en":"Edge cases for Reasoning effort","es":"Casos límite de Esfuerzo de razonamiento","fr":"Cas limites de Effort de raisonnement"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Reasoning effort flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Esfuerzo de razonamiento sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Effort de raisonnement reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"themes","group":"appearance","asset":"coding","title":{"pt":"Temas do Code","en":"Code themes","es":"Temas de Code","fr":"Thèmes de Code"},"lead":{"pt":"Temas alteram superfícies, contraste e detalhes visuais do workspace sem mudar a lógica da sessão.","en":"Themes change surfaces, contrast, and visual details of the workspace without changing session logic.","es":"Los temas cambian superficies, contraste y detalles visuales del workspace sin cambiar la lógica de la sesión.","fr":"Les thèmes modifient surfaces, contraste et détails visuels de l’espace sans changer la logique de session."},"sections":[{"title":{"pt":"Escolha por legibilidade","en":"Choose for readability","es":"Elige por legibilidad","fr":"Choisissez pour la lisibilité"},"body":[{"pt":"O melhor tema é aquele em que código, mensagens, diffs e controles continuam fáceis de separar durante uma sessão longa.","en":"The best theme is the one where code, messages, diffs, and controls remain easy to distinguish during a long session.","es":"El mejor tema es aquel donde código, mensajes, diffs y controles siguen siendo fáciles de distinguir durante una sesión larga.","fr":"Le meilleur thème est celui où code, messages, diffs et contrôles restent faciles à distinguer pendant une longue session."}]},{"title":{"pt":"Tema não corrige hierarquia","en":"Theme does not fix hierarchy","es":"El tema no corrige jerarquía","fr":"Le thème ne corrige pas la hiérarchie"},"body":[{"pt":"Se a tela está visualmente congestionada, trocar cor não resolve sozinho. Painéis, espaçamento e ordem de informação ainda precisam estar corretos.","en":"If a screen is visually crowded, changing color alone will not fix it. Panels, spacing, and information order still need to be right.","es":"Si la pantalla está visualmente congestionada, cambiar el color no la arregla por sí solo. Paneles, espaciado y orden de información deben seguir siendo correctos.","fr":"Si l’écran est visuellement encombré, changer uniquement la couleur ne le corrigera pas. Panneaux, espacement et ordre de l’information doivent rester corrects."}]},{"title":{"pt":"Tema sem sacrificar legibilidade","en":"Theme without sacrificing legibility","es":"Theme without sacrificing legibility","fr":"Theme without sacrificing legibility"},"body":[{"pt":"Temas mudam contraste e atmosfera do Code, mas precisam preservar hierarquia, seleção, foco e estados de erro.","en":"Themes change Code contrast and atmosphere but should preserve hierarchy, selection, focus, and error states.","es":"Themes change Code contrast and atmosphere but should preserve hierarchy, selection, focus, and error states.","fr":"Themes change Code contrast and atmosphere but should preserve hierarchy, selection, focus, and error states."}],"bullets":[{"pt":"Teste tema em editor, terminal, diff e preview; não avalie só pela tela vazia.","en":"Test a theme in the editor, terminal, diff, and preview; do not judge it only on an empty screen.","es":"Test a theme in the editor, terminal, diff, and preview; do not judge it only on an empty screen.","fr":"Test a theme in the editor, terminal, diff, and preview; do not judge it only on an empty screen."}]},{"title":{"pt":"Mapa da experiência","en":"Experience map","es":"Mapa de la experiencia","fr":"Carte de l’expérience"},"body":[{"pt":"Imagine uma tarefa real em que Temas do Code deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code themes stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Temas de Code deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Thèmes de Code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Aplicação prática","en":"Practical application","es":"Aplicación práctica","fr":"Application pratique"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Temas do Code o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code themes where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Temas de Code el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Thèmes de Code où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Temas do Code como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Temas alteram superfícies, contraste e detalhes visuais do workspace sem mudar a lógica da sessão. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code themes as an operational reference, not as an isolated screen. The page itself is about this: Themes change surfaces, contrast, and visual details of the workspace without changing session logic. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Temas de Code como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los temas cambian superficies, contraste y detalles visuales del workspace sin cambiar la lógica de la sesión. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Thèmes de Code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les thèmes modifient surfaces, contraste et détails visuels de l’espace sans changer la logique de session. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Erros fáceis de evitar","en":"Easy mistakes to avoid","es":"Errores fáciles de evitar","fr":"Erreurs faciles à éviter"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Temas do Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Code themes, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Temas de Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Thèmes de Code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Escolha por legibilidade”, confirme o estado visível e avance para “Tema não corrige hierarquia” apenas quando a etapa anterior estiver estável. Em Temas do Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Choose for readability”, confirm the visible state, and move to “Theme does not fix hierarchy” only when the previous step is stable. In Code themes, skipping context usually creates more rework than speed.","es":"Empieza por “Elige por legibilidad”, confirma el estado visible y avanza a “El tema no corrige jerarquía” solo cuando la etapa anterior esté estable. En Temas de Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Choisissez pour la lisibilité », confirmez l’état visible puis passez à « Le thème ne corrige pas la hiérarchie » seulement lorsque l’étape précédente est stable. Dans Thèmes de Code, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Revisão final","en":"Final review","es":"Revisión final","fr":"Révision finale"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Temas do Code realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code themes truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Temas de Code realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Thèmes de Code exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Matriz de comportamento: Temas do Code","en":"Behavior matrix: Code themes","es":"Matriz de comportamiento: Temas de Code","fr":"Matrice de comportement: Thèmes de Code"},"body":[{"pt":"Nesta página, a referência completa cobre tokens, contraste, editor, terminal, preview e persistência. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code themes as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Temas de Code como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Thèmes de Code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Temas do Code","en":"Edge cases for Code themes","es":"Casos límite de Temas de Code","fr":"Cas limites de Thèmes de Code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code themes flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Temas de Code sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Thèmes de Code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"fonts","group":"appearance","asset":"coding","title":{"pt":"Fontes do Code","en":"Code fonts","es":"Fuentes de Code","fr":"Polices de Code"},"lead":{"pt":"A fonte do editor e a fonte da interface podem ser ajustadas para equilibrar densidade e leitura.","en":"Editor and interface fonts can be adjusted to balance density and readability.","es":"La fuente del editor y la fuente de la interfaz pueden ajustarse para equilibrar densidad y lectura.","fr":"Les polices de l’éditeur et de l’interface peuvent être ajustées pour équilibrer densité et lisibilité."},"sections":[{"title":{"pt":"Editor","en":"Editor","es":"Editor","fr":"Éditeur"},"body":[{"pt":"Código funciona melhor com uma fonte monoespaçada legível, largura consistente e distinção clara entre caracteres parecidos.","en":"Code works best with a readable monospaced font, consistent width, and clear distinction between similar characters.","es":"El código funciona mejor con una fuente monoespaciada legible, ancho consistente y distinción clara entre caracteres parecidos.","fr":"Le code fonctionne mieux avec une police monospace lisible, une largeur cohérente et une distinction claire entre caractères similaires."}]},{"title":{"pt":"Interface","en":"Interface","es":"Interfaz","fr":"Interface"},"body":[{"pt":"Menus, sessões e controles podem usar uma fonte de interface mais compacta. O importante é manter tamanhos e pesos consistentes com o restante do produto.","en":"Menus, sessions, and controls can use a more compact interface font. The important part is keeping sizes and weights consistent with the rest of the product.","es":"Menús, sesiones y controles pueden usar una fuente de interfaz más compacta. Lo importante es mantener tamaños y pesos consistentes con el resto del producto.","fr":"Menus, sessions et contrôles peuvent utiliser une police d’interface plus compacte. L’important est de garder tailles et graisses cohérentes avec le reste du produit."}]},{"title":{"pt":"Fonte como ferramenta de leitura","en":"Fonts as a reading tool","es":"Fonts as a reading tool","fr":"Fonts as a reading tool"},"body":[{"pt":"Fonte do Code afeta densidade, alinhamento e legibilidade de símbolos. A escolha precisa funcionar em linhas longas e trechos com muita pontuação.","en":"Code fonts affect density, alignment, and symbol legibility. The choice must work on long lines and punctuation-heavy sections.","es":"Code fonts affect density, alignment, and symbol legibility. The choice must work on long lines and punctuation-heavy sections.","fr":"Code fonts affect density, alignment, and symbol legibility. The choice must work on long lines and punctuation-heavy sections."}],"bullets":[{"pt":"Prefira consistência entre editor e terminal para reduzir mudança visual durante debugging.","en":"Prefer consistency between editor and terminal to reduce visual switching during debugging.","es":"Prefer consistency between editor and terminal to reduce visual switching during debugging.","fr":"Prefer consistency between editor and terminal to reduce visual switching during debugging."}]},{"title":{"pt":"Ponto de partida","en":"Starting point","es":"Punto de partida","fr":"Point de départ"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Fontes do Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Code fonts, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Fuentes de Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Polices de Code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Editor”, confirme o estado visível e avance para “Interface” apenas quando a etapa anterior estiver estável. Em Fontes do Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Editor”, confirm the visible state, and move to “Interface” only when the previous step is stable. In Code fonts, skipping context usually creates more rework than speed.","es":"Empieza por “Editor”, confirma el estado visible y avanza a “Interfaz” solo cuando la etapa anterior esté estable. En Fuentes de Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Éditeur », confirmez l’état visible puis passez à « Interface » seulement lorsque l’étape précédente est stable. Dans Polices de Code, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Trabalho em camadas","en":"Layered work","es":"Trabajo por capas","fr":"Travail par couches"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Fontes do Code realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code fonts truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Fuentes de Code realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Polices de Code exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Fontes do Code deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code fonts stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Fuentes de Code deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Polices de Code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Diagnóstico rápido","en":"Fast diagnosis","es":"Diagnóstico rápido","fr":"Diagnostic rapide"},"body":[{"pt":"Use Fontes do Code como uma referência de operação, não como uma tela isolada. A própria proposta da página é: A fonte do editor e a fonte da interface podem ser ajustadas para equilibrar densidade e leitura. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code fonts as an operational reference, not as an isolated screen. The page itself is about this: Editor and interface fonts can be adjusted to balance density and readability. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Fuentes de Code como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La fuente del editor y la fuente de la interfaz pueden ajustarse para equilibrar densidad y lectura. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Polices de Code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les polices de l’éditeur et de l’interface peuvent être ajustées pour équilibrer densité et lisibilité. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Próximo passo","en":"Next step","es":"Siguiente paso","fr":"Étape suivante"},"body":[{"pt":"Comece por “Editor”, confirme o estado visível e avance para “Interface” apenas quando a etapa anterior estiver estável. Em Fontes do Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Editor”, confirm the visible state, and move to “Interface” only when the previous step is stable. In Code fonts, skipping context usually creates more rework than speed.","es":"Empieza por “Editor”, confirma el estado visible y avanza a “Interfaz” solo cuando la etapa anterior esté estable. En Fuentes de Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Éditeur », confirmez l’état visible puis passez à « Interface » seulement lorsque l’étape précédente est stable. Dans Polices de Code, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Fontes do Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Code fonts, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Fuentes de Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Polices de Code, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Guia de verificação: Fontes do Code","en":"Verification guide: Code fonts","es":"Guía de verificación: Fuentes de Code","fr":"Guide de vérification: Polices de Code"},"body":[{"pt":"Nesta página, a referência completa cobre Geist/monospace, legibilidade, métricas, densidade e fallback. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code fonts as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Fuentes de Code como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Polices de Code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Fontes do Code","en":"Edge cases for Code fonts","es":"Casos límite de Fuentes de Code","fr":"Cas limites de Polices de Code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code fonts flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Fuentes de Code sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Polices de Code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"specialties","group":"controls","asset":"theory","title":{"pt":"Especialidades","en":"Specialties","es":"Especialidades","fr":"Spécialités"},"lead":{"pt":"Especialidades oferecem contexto auxiliar para tipos recorrentes de tarefa sem substituir o pedido explícito.","en":"Specialties provide auxiliary context for recurring task types without replacing the explicit request.","es":"Las especialidades ofrecen contexto auxiliar para tipos recurrentes de tarea sin sustituir la solicitud explícita.","fr":"Les spécialités fournissent un contexte auxiliaire pour des types de tâches récurrents sans remplacer la demande explicite."},"sections":[{"title":{"pt":"Uso","en":"Use","es":"Uso","fr":"Utilisation"},"body":[{"pt":"Selecione uma especialidade quando ela descreve bem o trabalho atual. O chip mostra a escolha e permite trocar ou remover sem abrir uma configuração grande.","en":"Select a specialty when it describes the current work well. The chip shows the choice and lets you switch or remove it without opening a large settings flow.","es":"Selecciona una especialidad cuando describe bien el trabajo actual. El chip muestra la elección y permite cambiarla o quitarla sin abrir una configuración grande.","fr":"Sélectionnez une spécialité lorsqu’elle décrit bien le travail actuel. Le chip affiche le choix et permet de le changer ou le retirer sans ouvrir un grand panneau de réglages."}]},{"title":{"pt":"Pedido explícito continua primeiro","en":"Explicit request still comes first","es":"La solicitud explícita sigue primero","fr":"La demande explicite reste prioritaire"},"body":[{"pt":"A especialidade orienta, mas as instruções da mensagem e do projeto continuam definindo objetivo e restrições.","en":"The specialty guides, but message and project instructions still define the goal and constraints.","es":"La especialidad orienta, pero las instrucciones del mensaje y del proyecto siguen definiendo objetivo y restricciones.","fr":"La spécialité guide, mais les instructions du message et du projet continuent de définir objectif et contraintes."}]},{"title":{"pt":"Especialidade sem esconder o básico","en":"Specialties without hiding the basics","es":"Specialties without hiding the basics","fr":"Specialties without hiding the basics"},"body":[{"pt":"Especialidades podem orientar o agente para frontend, backend, dados ou revisão, mas não devem dispensar leitura do projeto real.","en":"Specialties can steer the agent toward frontend, backend, data, or review, but should not replace reading the real project.","es":"Specialties can steer the agent toward frontend, backend, data, or review, but should not replace reading the real project.","fr":"Specialties can steer the agent toward frontend, backend, data, or review, but should not replace reading the real project."}],"bullets":[{"pt":"Use a especialidade para ajustar prioridade e critérios, não para assumir stack ou arquitetura que não foi observada.","en":"Use a specialty to adjust priorities and criteria, not to assume a stack or architecture that was never observed.","es":"Use a specialty to adjust priorities and criteria, not to assume a stack or architecture that was never observed.","fr":"Use a specialty to adjust priorities and criteria, not to assume a stack or architecture that was never observed."}]},{"title":{"pt":"Como pensar esta área","en":"How to think about this area","es":"Cómo pensar esta área","fr":"Comment penser cette zone"},"body":[{"pt":"Use Especialidades como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Especialidades oferecem contexto auxiliar para tipos recorrentes de tarefa sem substituir o pedido explícito. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Specialties as an operational reference, not as an isolated screen. The page itself is about this: Specialties provide auxiliary context for recurring task types without replacing the explicit request. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Especialidades como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las especialidades ofrecen contexto auxiliar para tipos recurrentes de tarea sin sustituir la solicitud explícita. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Spécialités comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les spécialités fournissent un contexte auxiliaire pour des types de tâches récurrents sans remplacer la demande explicite. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Especialidades o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Specialties where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Especialidades el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Spécialités où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Exemplo de uso","en":"Usage example","es":"Ejemplo de uso","fr":"Exemple d’utilisation"},"body":[{"pt":"Comece por “Uso”, confirme o estado visível e avance para “Pedido explícito continua primeiro” apenas quando a etapa anterior estiver estável. Em Especialidades, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Use”, confirm the visible state, and move to “Explicit request still comes first” only when the previous step is stable. In Specialties, skipping context usually creates more rework than speed.","es":"Empieza por “Uso”, confirma el estado visible y avanza a “La solicitud explícita sigue primero” solo cuando la etapa anterior esté estable. En Especialidades, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Utilisation », confirmez l’état visible puis passez à « La demande explicite reste prioritaire » seulement lorsque l’étape précédente est stable. Dans Spécialités, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Quando não usar","en":"When not to use it","es":"Cuándo no usarlo","fr":"Quand ne pas l’utiliser"},"body":[{"pt":"Imagine uma tarefa real em que Especialidades deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Specialties stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Especialidades deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Spécialités cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Especialidades realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Specialties truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Especialidades realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Spécialités exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Verificação independente","en":"Independent verification","es":"Verificación independiente","fr":"Vérification indépendante"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Especialidades o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Specialties where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Especialidades el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Spécialités où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Especialidades como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Especialidades oferecem contexto auxiliar para tipos recorrentes de tarefa sem substituir o pedido explícito. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Specialties as an operational reference, not as an isolated screen. The page itself is about this: Specialties provide auxiliary context for recurring task types without replacing the explicit request. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Especialidades como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las especialidades ofrecen contexto auxiliar para tipos recurrentes de tarea sin sustituir la solicitud explícita. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Spécialités comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les spécialités fournissent un contexte auxiliaire pour des types de tâches récurrents sans remplacer la demande explicite. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Detalhes que evitam regressão: Especialidades","en":"Details that prevent regressions: Specialties","es":"Detalles que evitan regresiones: Especialidades","fr":"Détails anti-régression: Spécialités"},"body":[{"pt":"Nesta página, a referência completa cobre seleção de skills por domínio sem inflar o contexto. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Specialties as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Especialidades como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Spécialités comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Especialidades","en":"Edge cases for Specialties","es":"Casos límite de Especialidades","fr":"Cas limites de Spécialités"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Specialties flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Especialidades sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Spécialités reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"context-contract","group":"workspace","asset":"coding","title":{"pt":"Contrato de contexto do projeto","en":"Project context contract","es":"Contrato de contexto del proyecto","fr":"Contrat de contexte du projet"},"lead":{"pt":"O Code prepara instruções, arquivos relevantes e informações do workspace para manter a implementação alinhada ao projeto.","en":"Code prepares instructions, relevant files, and workspace information to keep implementation aligned with the project.","es":"Code prepara instrucciones, archivos relevantes e información del workspace para mantener la implementación alineada con el proyecto.","fr":"Code prépare instructions, fichiers pertinents et informations de l’espace afin de garder l’implémentation alignée sur le projet."},"sections":[{"title":{"pt":"O que deve entrar","en":"What should enter","es":"Qué debe entrar","fr":"Ce qui doit entrer"},"bullets":[{"pt":"Objetivo atual da sessão.","en":"Current session objective.","es":"Objetivo actual de la sesión.","fr":"Objectif actuel de la session."},{"pt":"Instruções do projeto que realmente se aplicam.","en":"Project instructions that actually apply.","es":"Instrucciones del proyecto que realmente aplican.","fr":"Instructions du projet qui s’appliquent réellement."},{"pt":"Arquivos e estrutura necessários para a mudança.","en":"Files and structure needed for the change.","es":"Archivos y estructura necesarios para el cambio.","fr":"Fichiers et structure nécessaires à la modification."}]},{"title":{"pt":"Evite contexto decorativo","en":"Avoid decorative context","es":"Evita contexto decorativo","fr":"Évitez le contexte décoratif"},"body":[{"pt":"Adicionar documentos sem relação com a tarefa aumenta ruído e pode diluir as instruções mais importantes.","en":"Adding documents unrelated to the task increases noise and can dilute the most important instructions.","es":"Añadir documentos sin relación con la tarea aumenta ruido y puede diluir las instrucciones más importantes.","fr":"Ajouter des documents sans rapport avec la tâche augmente le bruit et peut diluer les instructions les plus importantes."}]},{"title":{"pt":"Separar evidência de hipótese","en":"Separate evidence from hypothesis","es":"Separate evidence from hypothesis","fr":"Separate evidence from hypothesis"},"body":[{"pt":"O contrato de contexto distingue observado em arquivos, hipótese inferida, mudança proposta, execução verificada e trabalho não executado.","en":"The context contract distinguishes observed-in-files, inferred hypothesis, proposed change, execution-verified, and not-executed states.","es":"The context contract distinguishes observed-in-files, inferred hypothesis, proposed change, execution-verified, and not-executed states.","fr":"The context contract distinguishes observed-in-files, inferred hypothesis, proposed change, execution-verified, and not-executed states."}],"bullets":[{"pt":"Essa separação reduz alucinação porque impede que uma suposição seja promovida silenciosamente a fato do projeto.","en":"That separation reduces hallucination by preventing a guess from silently becoming a project fact.","es":"That separation reduces hallucination by preventing a guess from silently becoming a project fact.","fr":"That separation reduces hallucination by preventing a guess from silently becoming a project fact."}]},{"title":{"pt":"Objetivo e contexto","en":"Goal and context","es":"Objetivo y contexto","fr":"Objectif et contexte"},"body":[{"pt":"Imagine uma tarefa real em que Contrato de contexto do projeto deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Project context contract stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Contrato de contexto del proyecto deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Contrat de contexte du projet cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Ordem das ações","en":"Order of actions","es":"Orden de acciones","fr":"Ordre des actions"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Contrato de contexto do projeto o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Project context contract where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Contrato de contexto del proyecto el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Contrat de contexte du projet où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Contrato de contexto do projeto como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O Code prepara instruções, arquivos relevantes e informações do workspace para manter a implementação alinhada ao projeto. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Project context contract as an operational reference, not as an isolated screen. The page itself is about this: Code prepares instructions, relevant files, and workspace information to keep implementation aligned with the project. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Contrato de contexto del proyecto como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Code prepara instrucciones, archivos relevantes e información del workspace para mantener la implementación alineada con el proyecto. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Contrat de contexte du projet comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Code prépare instructions, fichiers pertinents et informations de l’espace afin de garder l’implémentation alignée sur le projet. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Casos de borda","en":"Edge cases","es":"Casos límite","fr":"Cas limites"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Contrato de contexto do projeto, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Project context contract, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Contrato de contexto del proyecto, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Contrat de contexte du projet, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “O que deve entrar”, confirme o estado visível e avance para “Evite contexto decorativo” apenas quando a etapa anterior estiver estável. Em Contrato de contexto do projeto, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What should enter”, confirm the visible state, and move to “Avoid decorative context” only when the previous step is stable. In Project context contract, skipping context usually creates more rework than speed.","es":"Empieza por “Qué debe entrar”, confirma el estado visible y avanza a “Evita contexto decorativo” solo cuando la etapa anterior esté estable. En Contrato de contexto del proyecto, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Ce qui doit entrer », confirmez l’état visible puis passez à « Évitez le contexte décoratif » seulement lorsque l’étape précédente est stable. Dans Contrat de contexte du projet, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Entrega sem surpresa","en":"Delivery without surprises","es":"Entrega sin sorpresas","fr":"Livraison sans surprise"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Contrato de contexto do projeto realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Project context contract truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Contrato de contexto del proyecto realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Contrat de contexte du projet exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Mapa operacional: Contrato de contexto do projeto","en":"Operational map: Project context contract","es":"Mapa operativo: Contrato de contexto del proyecto","fr":"Carte opérationnelle: Contrat de contexte du projet"},"body":[{"pt":"Nesta página, a referência completa cobre observado, inferido, proposto, verificado, não executado e provenance. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Project context contract as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Contrato de contexto del proyecto como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Contrat de contexte du projet comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Contrato de contexto do projeto","en":"Edge cases for Project context contract","es":"Casos límite de Contrato de contexto del proyecto","fr":"Cas limites de Contrat de contexte du projet"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Project context contract flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Contrato de contexto del proyecto sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Contrat de contexte du projet reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"diagnostics","group":"execution","asset":"coding","title":{"pt":"Diagnósticos","en":"Diagnostics","es":"Diagnósticos","fr":"Diagnostics"},"lead":{"pt":"Diagnósticos destacam erros e avisos encontrados durante execução ou revisão.","en":"Diagnostics highlight errors and warnings found during execution or review.","es":"Los diagnósticos destacan errores y avisos encontrados durante ejecución o revisión.","fr":"Les diagnostics mettent en évidence les erreurs et avertissements trouvés pendant l’exécution ou la révision."},"sections":[{"title":{"pt":"Leia nível e origem","en":"Read level and source","es":"Lee nivel y origen","fr":"Lisez niveau et origine"},"body":[{"pt":"Quando disponível, o item mostra se é erro ou aviso e aponta o arquivo ou contexto associado. Comece pelo diagnóstico mais específico.","en":"When available, an item shows whether it is an error or warning and points to the associated file or context. Start with the most specific diagnostic.","es":"Cuando está disponible, el elemento muestra si es error o aviso y señala el archivo o contexto asociado. Empieza por el diagnóstico más específico.","fr":"Lorsqu’il est disponible, un élément indique s’il s’agit d’une erreur ou d’un avertissement et pointe vers le fichier ou contexte associé. Commencez par le diagnostic le plus précis."}]},{"title":{"pt":"Resolvido ou aceito","en":"Resolved or accepted","es":"Resuelto o aceptado","fr":"Résolu ou accepté"},"body":[{"pt":"Antes de encerrar a tarefa, resolva o que bloqueia a entrega ou registre claramente o que permanece como limitação conhecida.","en":"Before closing the task, resolve what blocks delivery or clearly record what remains as a known limitation.","es":"Antes de cerrar la tarea, resuelve lo que bloquea la entrega o registra claramente lo que queda como limitación conocida.","fr":"Avant de terminer la tâche, résolvez ce qui bloque la livraison ou consignez clairement ce qui reste comme limitation connue."}]},{"title":{"pt":"Falha classificada, resposta adequada","en":"Classified failure, appropriate response","es":"Classified failure, appropriate response","fr":"Classified failure, appropriate response"},"body":[{"pt":"TIMEOUT e RATE_LIMIT pedem retry; SYNTAX_ERROR, TYPE_ERROR e TEST_FAILURE pedem correção; BASE_DRIFT e CONTEXT_DRIFT invalidam conclusões derivadas.","en":"TIMEOUT and RATE_LIMIT call for retry; SYNTAX_ERROR, TYPE_ERROR, and TEST_FAILURE call for repair; BASE_DRIFT and CONTEXT_DRIFT invalidate derived conclusions.","es":"TIMEOUT and RATE_LIMIT call for retry; SYNTAX_ERROR, TYPE_ERROR, and TEST_FAILURE call for repair; BASE_DRIFT and CONTEXT_DRIFT invalidate derived conclusions.","fr":"TIMEOUT and RATE_LIMIT call for retry; SYNTAX_ERROR, TYPE_ERROR, and TEST_FAILURE call for repair; BASE_DRIFT and CONTEXT_DRIFT invalidate derived conclusions."}],"bullets":[{"pt":"Diagnóstico bom muda a próxima ação, em vez de apenas renomear o erro.","en":"Good diagnosis changes the next action instead of merely renaming the error.","es":"Good diagnosis changes the next action instead of merely renaming the error.","fr":"Good diagnosis changes the next action instead of merely renaming the error."}]},{"title":{"pt":"Da intenção ao resultado","en":"From intent to result","es":"De la intención al resultado","fr":"De l’intention au résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Diagnósticos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Diagnostics, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Diagnósticos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Diagnostics, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Leia nível e origem”, confirme o estado visível e avance para “Resolvido ou aceito” apenas quando a etapa anterior estiver estável. Em Diagnósticos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Read level and source”, confirm the visible state, and move to “Resolved or accepted” only when the previous step is stable. In Diagnostics, skipping context usually creates more rework than speed.","es":"Empieza por “Lee nivel y origen”, confirma el estado visible y avanza a “Resuelto o aceptado” solo cuando la etapa anterior esté estable. En Diagnósticos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Lisez niveau et origine », confirmez l’état visible puis passez à « Résolu ou accepté » seulement lorsque l’étape précédente est stable. Dans Diagnostics, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Durante a execução","en":"During execution","es":"Durante la ejecución","fr":"Pendant l’exécution"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Diagnósticos realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Diagnostics truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Diagnósticos realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Diagnostics exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Diagnósticos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Diagnostics stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Diagnósticos deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Diagnostics cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Se algo sair do esperado","en":"If something goes off track","es":"Si algo se desvía","fr":"Si quelque chose dévie"},"body":[{"pt":"Use Diagnósticos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Diagnósticos destacam erros e avisos encontrados durante execução ou revisão. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Diagnostics as an operational reference, not as an isolated screen. The page itself is about this: Diagnostics highlight errors and warnings found during execution or review. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Diagnósticos como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Los diagnósticos destacan errores y avisos encontrados durante ejecución o revisión. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Diagnostics comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les diagnostics mettent en évidence les erreurs et avertissements trouvés pendant l’exécution ou la révision. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Fechamento do trabalho","en":"Closing the work","es":"Cierre del trabajo","fr":"Clôture du travail"},"body":[{"pt":"Comece por “Leia nível e origem”, confirme o estado visível e avance para “Resolvido ou aceito” apenas quando a etapa anterior estiver estável. Em Diagnósticos, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Read level and source”, confirm the visible state, and move to “Resolved or accepted” only when the previous step is stable. In Diagnostics, skipping context usually creates more rework than speed.","es":"Empieza por “Lee nivel y origen”, confirma el estado visible y avanza a “Resuelto o aceptado” solo cuando la etapa anterior esté estable. En Diagnósticos, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Lisez niveau et origine », confirmez l’état visible puis passez à « Résolu ou accepté » seulement lorsque l’étape précédente est stable. Dans Diagnostics, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Diagnósticos, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Diagnostics, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Diagnósticos, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Diagnostics, où le contexte peut traverser plusieurs étapes."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Referência de produção: Diagnósticos","en":"Production reference: Diagnostics","es":"Referencia de producción: Diagnósticos","fr":"Référence de production: Diagnostics"},"body":[{"pt":"Nesta página, a referência completa cobre classe, severidade, retry, repair, drift e causa raiz. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Diagnostics as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Diagnósticos como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Diagnostics comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Diagnósticos","en":"Edge cases for Diagnostics","es":"Casos límite de Diagnósticos","fr":"Cas limites de Diagnostics"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Diagnostics flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Diagnósticos sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Diagnostics reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"web-limitations","group":"execution","asset":"coding","title":{"pt":"Limites do Code Web","en":"Code Web limitations","es":"Límites de Code Web","fr":"Limites de Code Web"},"lead":{"pt":"O navegador oferece conveniência, mas não possui automaticamente o mesmo acesso ao sistema que uma aplicação instalada.","en":"The browser offers convenience but does not automatically have the same system access as an installed application.","es":"El navegador ofrece comodidad, pero no tiene automáticamente el mismo acceso al sistema que una aplicación instalada.","fr":"Le navigateur offre de la commodité mais n’a pas automatiquement le même accès au système qu’une application installée."},"sections":[{"title":{"pt":"O que pode variar","en":"What can vary","es":"Qué puede variar","fr":"Ce qui peut varier"},"bullets":[{"pt":"Execução disponível no sandbox.","en":"Execution available in the sandbox.","es":"Ejecución disponible en el sandbox.","fr":"Exécution disponible dans le sandbox."},{"pt":"Acesso a arquivos locais.","en":"Access to local files.","es":"Acceso a archivos locales.","fr":"Accès aux fichiers locaux."},{"pt":"Comandos e ferramentas instaladas no sistema.","en":"Commands and tools installed on the system.","es":"Comandos y herramientas instalados en el sistema.","fr":"Commandes et outils installés sur le système."}]},{"title":{"pt":"Quando trocar de superfície","en":"When to switch surfaces","es":"Cuándo cambiar de superficie","fr":"Quand changer de surface"},"body":[{"pt":"Se a tarefa depende de um recurso local que o navegador não oferece, continue no app instalado em vez de tentar simular acesso que não existe.","en":"If the task depends on a local resource the browser does not provide, continue in the installed app instead of trying to simulate access that does not exist.","es":"Si la tarea depende de un recurso local que el navegador no ofrece, continúa en la app instalada en lugar de intentar simular acceso inexistente.","fr":"Si la tâche dépend d’une ressource locale que le navigateur ne fournit pas, continuez dans l’application installée au lieu de simuler un accès inexistant."}]},{"title":{"pt":"Limites reais do Code Web","en":"Real Code Web limits","es":"Real Code Web limits","fr":"Real Code Web limits"},"body":[{"pt":"O navegador não deve fingir acesso que não possui. Processos locais, permissões amplas e integrações do sistema podem exigir a experiência instalada.","en":"The browser should not pretend to have access it does not have. Local processes, broad permissions, and system integrations may require the installed experience.","es":"The browser should not pretend to have access it does not have. Local processes, broad permissions, and system integrations may require the installed experience.","fr":"The browser should not pretend to have access it does not have. Local processes, broad permissions, and system integrations may require the installed experience."}],"bullets":[{"pt":"Quando algo não puder ser executado no web runtime, a UI deve explicar a limitação e oferecer um caminho alternativo.","en":"When something cannot run in the web runtime, the UI should explain the limitation and offer an alternative path.","es":"When something cannot run in the web runtime, the UI should explain the limitation and offer an alternative path.","fr":"When something cannot run in the web runtime, the UI should explain the limitation and offer an alternative path."}]},{"title":{"pt":"O papel desta página","en":"The role of this page","es":"El papel de esta página","fr":"Le rôle de cette page"},"body":[{"pt":"Use Limites do Code Web como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O navegador oferece conveniência, mas não possui automaticamente o mesmo acesso ao sistema que uma aplicação instalada. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code Web limitations as an operational reference, not as an isolated screen. The page itself is about this: The browser offers convenience but does not automatically have the same system access as an installed application. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Límites de Code Web como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El navegador ofrece comodidad, pero no tiene automáticamente el mismo acceso al sistema que una aplicación instalada. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Limites de Code Web comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le navigateur offre de la commodité mais n’a pas automatiquement le même accès au système qu’une application installée. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Limites do Code Web o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code Web limitations where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Límites de Code Web el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Limites de Code Web où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Uso no dia a dia","en":"Day-to-day use","es":"Uso cotidiano","fr":"Usage quotidien"},"body":[{"pt":"Comece por “O que pode variar”, confirme o estado visível e avance para “Quando trocar de superfície” apenas quando a etapa anterior estiver estável. Em Limites do Code Web, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “What can vary”, confirm the visible state, and move to “When to switch surfaces” only when the previous step is stable. In Code Web limitations, skipping context usually creates more rework than speed.","es":"Empieza por “Qué puede variar”, confirma el estado visible y avanza a “Cuándo cambiar de superficie” solo cuando la etapa anterior esté estable. En Límites de Code Web, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Ce qui peut varier », confirmez l’état visible puis passez à « Quand changer de surface » seulement lorsque l’étape précédente est stable. Dans Limites de Code Web, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Armadilhas comuns","en":"Common traps","es":"Trampas comunes","fr":"Pièges courants"},"body":[{"pt":"Imagine uma tarefa real em que Limites do Code Web deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code Web limitations stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Límites de Code Web deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Limites de Code Web cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Limites do Code Web realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code Web limitations truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Límites de Code Web realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Limites de Code Web exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Conferência antes de seguir","en":"Check before moving on","es":"Comprobación antes de seguir","fr":"Vérification avant de continuer"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Limites do Code Web o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code Web limitations where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Límites de Code Web el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Limites de Code Web où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Limites do Code Web como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O navegador oferece conveniência, mas não possui automaticamente o mesmo acesso ao sistema que uma aplicação instalada. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code Web limitations as an operational reference, not as an isolated screen. The page itself is about this: The browser offers convenience but does not automatically have the same system access as an installed application. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Límites de Code Web como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: El navegador ofrece comodidad, pero no tiene automáticamente el mismo acceso al sistema que una aplicación instalada. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Limites de Code Web comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Le navigateur offre de la commodité mais n’a pas automatiquement le même accès au système qu’une application installée. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Contrato desta superfície: Limites do Code Web","en":"Surface contract: Code Web limitations","es":"Contrato de la superficie: Límites de Code Web","fr":"Contrat de la surface: Limites de Code Web"},"body":[{"pt":"Nesta página, a referência completa cobre browser sandbox, rede, origem, APIs locais e diferenças do app instalado. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code Web limitations as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Límites de Code Web como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Limites de Code Web comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Limites do Code Web","en":"Edge cases for Code Web limitations","es":"Casos límite de Límites de Code Web","fr":"Cas limites de Limites de Code Web"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code Web limitations flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Límites de Code Web sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Limites de Code Web reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"downloads","group":"install","asset":"coding","title":{"pt":"Downloads","en":"Downloads","es":"Descargas","fr":"Téléchargements"},"lead":{"pt":"As opções de download do Code oferecem instaladores quando disponíveis para o sistema suportado.","en":"Code download options provide installers when available for the supported system.","es":"Las opciones de descarga de Code ofrecen instaladores cuando están disponibles para el sistema compatible.","fr":"Les options de téléchargement de Code proposent des installateurs lorsqu’ils sont disponibles pour le système pris en charge."},"sections":[{"title":{"pt":"Escolha a plataforma correta","en":"Choose the correct platform","es":"Elige la plataforma correcta","fr":"Choisissez la bonne plateforme"},"body":[{"pt":"Use a opção correspondente ao seu sistema e mantenha a versão web como alternativa quando você só precisa abrir uma sessão rapidamente.","en":"Use the option that matches your system and keep the web version as an alternative when you only need to open a session quickly.","es":"Usa la opción correspondiente a tu sistema y conserva la versión web como alternativa cuando solo necesitas abrir una sesión rápidamente.","fr":"Utilisez l’option correspondant à votre système et gardez la version web comme alternative lorsque vous avez seulement besoin d’ouvrir rapidement une session."}]},{"title":{"pt":"Atualizações","en":"Updates","es":"Actualizaciones","fr":"Mises à jour"},"body":[{"pt":"Quando houver uma versão mais recente, prefira atualizar pelo fluxo apresentado no próprio produto em vez de misturar arquivos antigos e novos manualmente.","en":"When a newer version exists, prefer updating through the product flow instead of manually mixing old and new files.","es":"Cuando exista una versión más reciente, prefiere actualizar mediante el flujo del producto en lugar de mezclar manualmente archivos antiguos y nuevos.","fr":"Lorsqu’une version plus récente existe, préférez mettre à jour via le flux du produit plutôt que mélanger manuellement anciens et nouveaux fichiers."}]},{"title":{"pt":"Download como entrega final","en":"Downloads as final delivery","es":"Downloads as final delivery","fr":"Downloads as final delivery"},"body":[{"pt":"Downloads devem refletir o artefato final, não uma cópia incompleta do workspace.","en":"Downloads should reflect the final artifact, not an incomplete copy of the workspace.","es":"Downloads should reflect the final artifact, not an incomplete copy of the workspace.","fr":"Downloads should reflect the final artifact, not an incomplete copy of the workspace."}],"bullets":[{"pt":"Antes de baixar, valide nome, extensão, tamanho e conteúdo esperado do arquivo.","en":"Before downloading, validate the expected name, extension, size, and content.","es":"Before downloading, validate the expected name, extension, size, and content.","fr":"Before downloading, validate the expected name, extension, size, and content."}]},{"title":{"pt":"Primeira decisão","en":"First decision","es":"Primera decisión","fr":"Première décision"},"body":[{"pt":"Imagine uma tarefa real em que Downloads deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Downloads stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Descargas deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Téléchargements cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Como manter o contexto","en":"Keeping context intact","es":"Cómo mantener el contexto","fr":"Préserver le contexte"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Downloads o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Downloads where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Descargas el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Téléchargements où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Downloads como uma referência de operação, não como uma tela isolada. A própria proposta da página é: As opções de download do Code oferecem instaladores quando disponíveis para o sistema suportado. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Downloads as an operational reference, not as an isolated screen. The page itself is about this: Code download options provide installers when available for the supported system. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Descargas como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Las opciones de descarga de Code ofrecen instaladores cuando están disponibles para el sistema compatible. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Téléchargements comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Les options de téléchargement de Code proposent des installateurs lorsqu’ils sont disponibles pour le système pris en charge. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Falhas recuperáveis","en":"Recoverable failures","es":"Fallos recuperables","fr":"Échecs récupérables"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Downloads, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Downloads, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Descargas, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Téléchargements, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Escolha a plataforma correta”, confirme o estado visível e avance para “Atualizações” apenas quando a etapa anterior estiver estável. Em Downloads, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Choose the correct platform”, confirm the visible state, and move to “Updates” only when the previous step is stable. In Downloads, skipping context usually creates more rework than speed.","es":"Empieza por “Elige la plataforma correcta”, confirma el estado visible y avanza a “Actualizaciones” solo cuando la etapa anterior esté estable. En Descargas, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Choisissez la bonne plateforme », confirmez l’état visible puis passez à « Mises à jour » seulement lorsque l’étape précédente est stable. Dans Téléchargements, ignorer le contexte crée généralement plus de reprise que de vitesse."}]},{"title":{"pt":"Resultado esperado","en":"Expected outcome","es":"Resultado esperado","fr":"Résultat attendu"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Downloads realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Downloads truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Descargas realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Téléchargements exige réellement plus de contexte, de contrôle ou de vérification."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Leitura de engenharia: Downloads","en":"Engineering reading: Downloads","es":"Lectura de ingeniería: Descargas","fr":"Lecture d’ingénierie: Téléchargements"},"body":[{"pt":"Nesta página, a referência completa cobre artefatos binários, MIME, nome, integridade e origem. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Downloads as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Descargas como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Téléchargements comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Downloads","en":"Edge cases for Downloads","es":"Casos límite de Descargas","fr":"Cas limites de Téléchargements"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Downloads flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Descargas sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Téléchargements reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]},{"title":{"pt":"Setup nativo em Go","en":"Native Go setup","es":"Setup nativo en Go","fr":"Setup natif en Go"},"body":[{"pt":"A build 7.85 inclui executáveis de instalação Windows separados para Giorgio Desktop e Giorgio Code. Eles são PE32+ x86-64 com cabeçalho MZ, instalam launchers em LocalAppData e criam atalhos. O launcher usa Edge/Chrome em modo app quando disponível, sem empacotar outro Chromium.","en":"Build 7.85 includes separate Windows installers for Giorgio Desktop and Giorgio Code. They are PE32+ x86-64 files with MZ headers, install launchers into LocalAppData, and create shortcuts. The launcher uses Edge/Chrome app mode when available without bundling another Chromium.","es":"La build 7.85 incluye instaladores Windows separados para Giorgio Desktop y Giorgio Code, PE32+ x86-64 con cabecera MZ.","fr":"La build 7.85 inclut des installateurs Windows séparés pour Giorgio Desktop et Giorgio Code, PE32+ x86-64 avec en-tête MZ."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"desktop","group":"install","asset":"coding","title":{"pt":"App desktop","en":"Desktop app","es":"App de escritorio","fr":"Application desktop"},"lead":{"pt":"O app desktop oferece uma superfície dedicada para sessões de Code e pode trabalhar mais perto do ambiente local.","en":"The desktop app provides a dedicated surface for Code sessions and can work closer to the local environment.","es":"La app de escritorio ofrece una superficie dedicada para sesiones de Code y puede trabajar más cerca del entorno local.","fr":"L’application desktop fournit une surface dédiée aux sessions Code et peut travailler plus près de l’environnement local."},"sections":[{"title":{"pt":"Quando preferir","en":"When to prefer it","es":"Cuándo preferirla","fr":"Quand la préférer"},"bullets":[{"pt":"Sessões longas de desenvolvimento.","en":"Long development sessions.","es":"Sesiones largas de desarrollo.","fr":"Longues sessions de développement."},{"pt":"Tarefas que precisam de mais acesso local.","en":"Tasks that need more local access.","es":"Tareas que necesitan más acceso local.","fr":"Tâches nécessitant davantage d’accès local."},{"pt":"Uso frequente de editor e terminal.","en":"Frequent editor and terminal use.","es":"Uso frecuente de editor y terminal.","fr":"Utilisation fréquente de l’éditeur et du terminal."}]},{"title":{"pt":"Mesmo modelo mental","en":"Same mental model","es":"Mismo modelo mental","fr":"Même modèle mental"},"body":[{"pt":"Sessões, arquivos, editor, terminal, preview e revisão continuam sendo as peças principais; a diferença é a superfície de execução.","en":"Sessions, files, editor, terminal, preview, and review remain the main pieces; the difference is the execution surface.","es":"Sesiones, archivos, editor, terminal, preview y revisión siguen siendo las piezas principales; la diferencia es la superficie de ejecución.","fr":"Sessions, fichiers, éditeur, terminal, aperçu et révision restent les pièces principales ; la différence est la surface d’exécution."}]},{"title":{"pt":"Quando o app instalado faz diferença","en":"When the installed app matters","es":"When the installed app matters","fr":"When the installed app matters"},"body":[{"pt":"A experiência desktop existe para tarefas que precisam de filesystem, processos locais e integração mais próxima do ambiente de desenvolvimento.","en":"The desktop experience exists for tasks that need filesystem access, local processes, and closer integration with the development environment.","es":"The desktop experience exists for tasks that need filesystem access, local processes, and closer integration with the development environment.","fr":"The desktop experience exists for tasks that need filesystem access, local processes, and closer integration with the development environment."}],"bullets":[{"pt":"Use o desktop quando o navegador virar o limitador do trabalho, não apenas porque a tarefa é “de código”.","en":"Use desktop when the browser becomes the work limiter, not merely because the task is “code.”","es":"Use desktop when the browser becomes the work limiter, not merely because the task is “code.”","fr":"Use desktop when the browser becomes the work limiter, not merely because the task is “code.”"}]},{"title":{"pt":"Visão prática","en":"Practical view","es":"Vista práctica","fr":"Vue pratique"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em App desktop, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Desktop app, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en App de escritorio, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Application desktop, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Quando preferir”, confirme o estado visível e avance para “Mesmo modelo mental” apenas quando a etapa anterior estiver estável. Em App desktop, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When to prefer it”, confirm the visible state, and move to “Same mental model” only when the previous step is stable. In Desktop app, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo preferirla”, confirma el estado visible y avanza a “Mismo modelo mental” solo cuando la etapa anterior esté estable. En App de escritorio, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand la préférer », confirmez l’état visible puis passez à « Même modèle mental » seulement lorsque l’étape précédente est stable. Dans Application desktop, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Fluxo mínimo","en":"Minimum viable flow","es":"Flujo mínimo","fr":"Flux minimal"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando App desktop realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Desktop app truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando App de escritorio realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Application desktop exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que App desktop deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Desktop app stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que App de escritorio deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Application desktop cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}]},{"title":{"pt":"Escalando com segurança","en":"Scaling safely","es":"Escalar con seguridad","fr":"Monter en charge en sécurité"},"body":[{"pt":"Use App desktop como uma referência de operação, não como uma tela isolada. A própria proposta da página é: O app desktop oferece uma superfície dedicada para sessões de Code e pode trabalhar mais perto do ambiente local. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Desktop app as an operational reference, not as an isolated screen. The page itself is about this: The desktop app provides a dedicated surface for Code sessions and can work closer to the local environment. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa App de escritorio como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: La app de escritorio ofrece una superficie dedicada para sesiones de Code y puede trabajar más cerca del entorno local. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Application desktop comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : L’application desktop fournit une surface dédiée aux sessions Code et peut travailler plus près de l’environnement local. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Como saber que funcionou","en":"How to know it worked","es":"Cómo saber que funcionó","fr":"Comment savoir que cela a fonctionné"},"body":[{"pt":"Comece por “Quando preferir”, confirme o estado visível e avance para “Mesmo modelo mental” apenas quando a etapa anterior estiver estável. Em App desktop, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “When to prefer it”, confirm the visible state, and move to “Same mental model” only when the previous step is stable. In Desktop app, skipping context usually creates more rework than speed.","es":"Empieza por “Cuándo preferirla”, confirma el estado visible y avanza a “Mismo modelo mental” solo cuando la etapa anterior esté estable. En App de escritorio, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Quand la préférer », confirmez l’état visible puis passez à « Même modèle mental » seulement lorsque l’étape précédente est stable. Dans Application desktop, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em App desktop, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Desktop app, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en App de escritorio, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Application desktop, où le contexte peut traverser plusieurs étapes."}]},{"title":{"pt":"Checklist de integração: App desktop","en":"Integration checklist: Desktop app","es":"Checklist de integración: App de escritorio","fr":"Checklist d’intégration: Application desktop"},"body":[{"pt":"Nesta página, a referência completa cobre filesystem real, terminal, Computer Use, setup, atualização e segurança. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Desktop app as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata App de escritorio como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Application desktop comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de App desktop","en":"Edge cases for Desktop app","es":"Casos límite de App de escritorio","fr":"Cas limites de Application desktop"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Desktop app flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de App de escritorio sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Application desktop reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]},{"title":{"pt":"Setup nativo em Go","en":"Native Go setup","es":"Setup nativo en Go","fr":"Setup natif en Go"},"body":[{"pt":"A build 7.85 inclui executáveis de instalação Windows separados para Giorgio Desktop e Giorgio Code. Eles são PE32+ x86-64 com cabeçalho MZ, instalam launchers em LocalAppData e criam atalhos. O launcher usa Edge/Chrome em modo app quando disponível, sem empacotar outro Chromium.","en":"Build 7.85 includes separate Windows installers for Giorgio Desktop and Giorgio Code. They are PE32+ x86-64 files with MZ headers, install launchers into LocalAppData, and create shortcuts. The launcher uses Edge/Chrome app mode when available without bundling another Chromium.","es":"La build 7.85 incluye instaladores Windows separados para Giorgio Desktop y Giorgio Code, PE32+ x86-64 con cabecera MZ.","fr":"La build 7.85 inclut des installateurs Windows séparés pour Giorgio Desktop et Giorgio Code, PE32+ x86-64 avec en-tête MZ."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"mobile-code","group":"experience","asset":"coding","title":{"pt":"Code no celular","en":"Code on mobile","es":"Code en móvil","fr":"Code sur mobile"},"lead":{"pt":"No mobile, o workspace prioriza uma superfície por vez para manter leitura e controles utilizáveis.","en":"On mobile, the workspace prioritizes one surface at a time to keep reading and controls usable.","es":"En móvil, el workspace prioriza una superficie a la vez para mantener lectura y controles utilizables.","fr":"Sur mobile, l’espace privilégie une surface à la fois afin de garder lecture et contrôles utilisables."},"sections":[{"title":{"pt":"Navegação","en":"Navigation","es":"Navegación","fr":"Navigation"},"body":[{"pt":"A sidebar vira drawer e arquivos ou editor podem ocupar a tela quando abertos. Isso evita comprimir três colunas em uma largura que não comporta nenhuma delas bem.","en":"The sidebar becomes a drawer and files or editor can take over the screen when opened. This avoids compressing three columns into a width that serves none of them well.","es":"La sidebar se convierte en drawer y archivos o editor pueden ocupar la pantalla al abrirse. Esto evita comprimir tres columnas en un ancho que no sirve bien a ninguna.","fr":"La barre latérale devient un drawer et les fichiers ou l’éditeur peuvent occuper l’écran lorsqu’ils sont ouverts. Cela évite de comprimer trois colonnes dans une largeur qui ne convient à aucune."}]},{"title":{"pt":"Composer","en":"Composer","es":"Composer","fr":"Composer"},"body":[{"pt":"A caixa de entrada permanece acessível na parte inferior sem cobrir o conteúdo principal e considera a área ocupada pelo teclado virtual.","en":"The input remains accessible at the bottom without covering main content and accounts for the area occupied by the virtual keyboard.","es":"La caja de entrada permanece accesible abajo sin cubrir el contenido principal y considera el área ocupada por el teclado virtual.","fr":"La zone de saisie reste accessible en bas sans couvrir le contenu principal et tient compte de la zone occupée par le clavier virtuel."}]},{"title":{"pt":"Code no celular sem fingir desktop","en":"Code on mobile without pretending it is desktop","es":"Code on mobile without pretending it is desktop","fr":"Code on mobile without pretending it is desktop"},"body":[{"pt":"No celular, leitura, revisão e pequenas alterações funcionam melhor do que tentar replicar uma IDE inteira em poucos pixels.","en":"On mobile, reading, review, and small changes work better than trying to replicate an entire IDE in a few pixels.","es":"On mobile, reading, review, and small changes work better than trying to replicate an entire IDE in a few pixels.","fr":"On mobile, reading, review, and small changes work better than trying to replicate an entire IDE in a few pixels."}],"bullets":[{"pt":"Priorize sessão, resposta, diff e ações essenciais; esconda painéis secundários até serem necessários.","en":"Prioritize the session, response, diff, and essential actions; hide secondary panels until needed.","es":"Prioritize the session, response, diff, and essential actions; hide secondary panels until needed.","fr":"Prioritize the session, response, diff, and essential actions; hide secondary panels until needed."}]},{"title":{"pt":"Como isso entra no fluxo","en":"How this fits the workflow","es":"Cómo entra esto en el flujo","fr":"Comment cela s’insère dans le flux"},"body":[{"pt":"Use Code no celular como uma referência de operação, não como uma tela isolada. A própria proposta da página é: No mobile, o workspace prioriza uma superfície por vez para manter leitura e controles utilizáveis. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code on mobile as an operational reference, not as an isolated screen. The page itself is about this: On mobile, the workspace prioritizes one surface at a time to keep reading and controls usable. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Code en móvil como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: En móvil, el workspace prioriza una superficie a la vez para mantener lectura y controles utilizables. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Code sur mobile comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Sur mobile, l’espace privilégie une surface à la fois afin de garder lecture et contrôles utilisables. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."},{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Code no celular o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code on mobile where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Code en móvil el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Code sur mobile où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Cenário real","en":"Real-world scenario","es":"Escenario real","fr":"Scénario réel"},"body":[{"pt":"Comece por “Navegação”, confirme o estado visível e avance para “Composer” apenas quando a etapa anterior estiver estável. Em Code no celular, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Navigation”, confirm the visible state, and move to “Composer” only when the previous step is stable. In Code on mobile, skipping context usually creates more rework than speed.","es":"Empieza por “Navegación”, confirma el estado visible y avanza a “Composer” solo cuando la etapa anterior esté estable. En Code en móvil, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Navigation », confirmez l’état visible puis passez à « Composer » seulement lorsque l’étape précédente est stable. Dans Code sur mobile, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Onde costuma quebrar","en":"Where it usually breaks","es":"Dónde suele fallar","fr":"Là où cela casse souvent"},"body":[{"pt":"Imagine uma tarefa real em que Code no celular deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code on mobile stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Code en móvil deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Code sur mobile cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Code no celular realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code on mobile truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Code en móvil realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Code sur mobile exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Critério de conclusão","en":"Definition of done","es":"Criterio de finalización","fr":"Critère de fin"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Code no celular o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Code on mobile where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Code en móvil el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Code sur mobile où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Code no celular como uma referência de operação, não como uma tela isolada. A própria proposta da página é: No mobile, o workspace prioriza uma superfície por vez para manter leitura e controles utilizáveis. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code on mobile as an operational reference, not as an isolated screen. The page itself is about this: On mobile, the workspace prioritizes one surface at a time to keep reading and controls usable. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Code en móvil como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: En móvil, el workspace prioriza una superficie a la vez para mantener lectura y controles utilizables. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Code sur mobile comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Sur mobile, l’espace privilégie une surface à la fois afin de garder lecture et contrôles utilisables. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Matriz de comportamento: Code no celular","en":"Behavior matrix: Code on mobile","es":"Matriz de comportamiento: Code en móvil","fr":"Matrice de comportement: Code sur mobile"},"body":[{"pt":"Nesta página, a referência completa cobre painéis focais, teclado, touch, navegação e preservação de estado. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code on mobile as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Code en móvil como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Code sur mobile comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Code no celular","en":"Edge cases for Code on mobile","es":"Casos límite de Code en móvil","fr":"Cas limites de Code sur mobile"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code on mobile flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Code en móvil sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Code sur mobile reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"zip-export","group":"delivery","asset":"coding","title":{"pt":"Exportar ZIP","en":"Export ZIP","es":"Exportar ZIP","fr":"Exporter ZIP"},"lead":{"pt":"Quando o trabalho envolve vários arquivos, o ZIP oferece uma entrega única para baixar e abrir fora do workspace.","en":"When work involves multiple files, ZIP provides a single deliverable to download and open outside the workspace.","es":"Cuando el trabajo incluye varios archivos, ZIP ofrece una entrega única para descargar y abrir fuera del workspace.","fr":"Lorsque le travail implique plusieurs fichiers, ZIP fournit une livraison unique à télécharger et ouvrir hors de l’espace."},"sections":[{"title":{"pt":"Antes de exportar","en":"Before exporting","es":"Antes de exportar","fr":"Avant d’exporter"},"bullets":[{"pt":"Revise os arquivos incluídos.","en":"Review included files.","es":"Revisa los archivos incluidos.","fr":"Révisez les fichiers inclus."},{"pt":"Remova saídas temporárias que não pertencem à entrega.","en":"Remove temporary outputs that do not belong in the delivery.","es":"Elimina salidas temporales que no pertenecen a la entrega.","fr":"Retirez les sorties temporaires qui ne font pas partie de la livraison."},{"pt":"Use um nome de pacote reconhecível.","en":"Use a recognizable package name.","es":"Usa un nombre de paquete reconocible.","fr":"Utilisez un nom de paquet reconnaissable."}]},{"title":{"pt":"Depois de baixar","en":"After download","es":"Después de descargar","fr":"Après téléchargement"},"body":[{"pt":"Abra o pacote e confirme que a estrutura necessária está presente. O arquivo compactado é a entrega, não a validação.","en":"Open the package and confirm the required structure is present. The archive is the delivery, not the validation.","es":"Abre el paquete y confirma que la estructura necesaria está presente. El archivo comprimido es la entrega, no la validación.","fr":"Ouvrez le paquet et confirmez que la structure nécessaire est présente. L’archive est la livraison, pas la validation."}]},{"title":{"pt":"ZIP que outra pessoa consegue abrir","en":"A ZIP another person can open","es":"A ZIP another person can open","fr":"A ZIP another person can open"},"body":[{"pt":"Exportar ZIP é uma forma de handoff. A estrutura interna deve preservar caminhos, nomes e arquivos necessários para reproduzir o resultado.","en":"ZIP export is a handoff format. The internal structure should preserve paths, names, and files needed to reproduce the result.","es":"ZIP export is a handoff format. The internal structure should preserve paths, names, and files needed to reproduce the result.","fr":"ZIP export is a handoff format. The internal structure should preserve paths, names, and files needed to reproduce the result."}],"bullets":[{"pt":"Evite incluir lixo temporário, secrets ou dependências geradas que não fazem parte da entrega.","en":"Avoid including temporary junk, secrets, or generated dependencies that are not part of the delivery.","es":"Avoid including temporary junk, secrets, or generated dependencies that are not part of the delivery.","fr":"Avoid including temporary junk, secrets, or generated dependencies that are not part of the delivery."}]},{"title":{"pt":"Antes de começar","en":"Before you start","es":"Antes de empezar","fr":"Avant de commencer"},"body":[{"pt":"Imagine uma tarefa real em que Exportar ZIP deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Export ZIP stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Exportar ZIP deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Exporter ZIP cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}],"bullets":[{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"},{"pt":"revise a saída no mesmo ambiente em que ela será usada","en":"review the output in the same environment where it will be used","es":"revisa la salida en el mismo entorno donde se utilizará","fr":"relisez la sortie dans le même environnement que celui où elle sera utilisée"},{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"}]},{"title":{"pt":"Sequência recomendada","en":"Recommended sequence","es":"Secuencia recomendada","fr":"Séquence recommandée"},"body":[{"pt":"Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Exportar ZIP o estado deixou de corresponder ao que a interface prometia.","en":"If behavior diverges from expectations, separate visual failure, data failure, and execution failure. The goal is to find the exact point in Export ZIP where state stopped matching what the interface promised.","es":"Si el comportamiento se desvía de lo esperado, separa fallo visual, fallo de datos y fallo de ejecución. El objetivo es descubrir en qué punto de Exportar ZIP el estado dejó de corresponder a lo que prometía la interfaz.","fr":"Si le comportement diverge de ce qui est attendu, séparez le problème visuel, le problème de données et le problème d’exécution. L’objectif est de trouver le point précis de Exporter ZIP où l’état ne correspond plus à ce que l’interface annonçait."},{"pt":"Use Exportar ZIP como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Quando o trabalho envolve vários arquivos, o ZIP oferece uma entrega única para baixar e abrir fora do workspace. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Export ZIP as an operational reference, not as an isolated screen. The page itself is about this: When work involves multiple files, ZIP provides a single deliverable to download and open outside the workspace. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Exportar ZIP como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Cuando el trabajo incluye varios archivos, ZIP ofrece una entrega única para descargar y abrir fuera del workspace. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Exporter ZIP comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Lorsque le travail implique plusieurs fichiers, ZIP fournit une livraison unique à télécharger et ouvrir hors de l’espace. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Decisões que mudam o resultado","en":"Decisions that change the outcome","es":"Decisiones que cambian el resultado","fr":"Décisions qui changent le résultat"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Exportar ZIP, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Export ZIP, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Exportar ZIP, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Exporter ZIP, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “Antes de exportar”, confirme o estado visível e avance para “Depois de baixar” apenas quando a etapa anterior estiver estável. Em Exportar ZIP, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “Before exporting”, confirm the visible state, and move to “After download” only when the previous step is stable. In Export ZIP, skipping context usually creates more rework than speed.","es":"Empieza por “Antes de exportar”, confirma el estado visible y avanza a “Después de descargar” solo cuando la etapa anterior esté estable. En Exportar ZIP, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « Avant d’exporter », confirmez l’état visible puis passez à « Après téléchargement » seulement lorsque l’étape précédente est stable. Dans Exporter ZIP, ignorer le contexte crée généralement plus de reprise que de vitesse."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Como validar","en":"How to validate","es":"Cómo validar","fr":"Comment valider"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Exportar ZIP realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Export ZIP truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Exportar ZIP realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Exporter ZIP exige réellement plus de contexte, de contrôle ou de vérification."}]},{"title":{"pt":"Guia de verificação: Exportar ZIP","en":"Verification guide: Export ZIP","es":"Guía de verificación: Exportar ZIP","fr":"Guide de vérification: Exporter ZIP"},"body":[{"pt":"Nesta página, a referência completa cobre manifesto, caminhos, conteúdo integral, empacotamento e validação. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Export ZIP as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Exportar ZIP como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Exporter ZIP comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Exportar ZIP","en":"Edge cases for Export ZIP","es":"Casos límite de Exportar ZIP","fr":"Cas limites de Exporter ZIP"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Export ZIP flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Exportar ZIP sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Exporter ZIP reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"troubleshooting","group":"help","asset":"coding","title":{"pt":"Solução de problemas no Code","en":"Code troubleshooting","es":"Solución de problemas en Code","fr":"Dépannage dans Code"},"lead":{"pt":"Diagnostique a superfície que falhou — sessão, arquivo, editor, terminal, preview ou modelo — antes de reiniciar tudo.","en":"Diagnose the surface that failed — session, file, editor, terminal, preview, or model — before restarting everything.","es":"Diagnostica la superficie que falló — sesión, archivo, editor, terminal, preview o modelo — antes de reiniciar todo.","fr":"Diagnostiquez la surface en échec — session, fichier, éditeur, terminal, aperçu ou modèle — avant de tout redémarrer."},"sections":[{"title":{"pt":"A sessão não envia","en":"The session does not send","es":"La sesión no envía","fr":"La session n’envoie pas"},"bullets":[{"pt":"Confira o estado do modelo e avisos visíveis.","en":"Check model state and visible notices.","es":"Comprueba el estado del modelo y avisos visibles.","fr":"Vérifiez l’état du modèle et les avertissements visibles."},{"pt":"Verifique se há conexão e sessão autenticada.","en":"Verify connectivity and authenticated session.","es":"Verifica conexión y sesión autenticada.","fr":"Vérifiez la connexion et la session authentifiée."},{"pt":"Se a fila estiver vazia, não deve aparecer um contador residual.","en":"If the queue is empty, no residual counter should appear.","es":"Si la cola está vacía, no debe aparecer un contador residual.","fr":"Si la file est vide, aucun compteur résiduel ne doit apparaître."}]},{"title":{"pt":"Preview ou arquivo não abre","en":"Preview or file does not open","es":"Preview o archivo no abre","fr":"Aperçu ou fichier ne s’ouvre pas"},"body":[{"pt":"Tente reabrir pelo painel correspondente e confirme que o arquivo ainda existe no workspace. Se houver erro específico, use essa mensagem como ponto de partida.","en":"Try reopening it from the corresponding panel and confirm the file still exists in the workspace. If a specific error appears, use that message as the starting point.","es":"Intenta reabrirlo desde el panel correspondiente y confirma que el archivo sigue en el workspace. Si aparece un error específico, usa ese mensaje como punto de partida.","fr":"Essayez de le rouvrir depuis le panneau correspondant et confirmez que le fichier existe toujours dans l’espace. Si une erreur spécifique apparaît, utilisez ce message comme point de départ."}]},{"title":{"pt":"Ao reportar","en":"When reporting","es":"Al reportar","fr":"Lors du signalement"},"body":[{"pt":"Inclua a ação, sessão, arquivo relevante, mensagem exibida e captura. Isso permite distinguir erro visual de erro de runtime.","en":"Include the action, session, relevant file, displayed message, and a screenshot. That helps distinguish a visual issue from a runtime issue.","es":"Incluye la acción, sesión, archivo relevante, mensaje mostrado y captura. Eso permite distinguir un error visual de un error de runtime.","fr":"Incluez l’action, la session, le fichier pertinent, le message affiché et une capture. Cela permet de distinguer un problème visuel d’un problème runtime."}]},{"title":{"pt":"Do erro ao próximo passo","en":"From error to next step","es":"From error to next step","fr":"From error to next step"},"body":[{"pt":"Troubleshooting no Code usa a mesma regra: classifique a falha, capture evidência, forme uma hipótese e teste uma correção pequena.","en":"Code troubleshooting follows the same rule: classify the failure, capture evidence, form a hypothesis, and test a small repair.","es":"Code troubleshooting follows the same rule: classify the failure, capture evidence, form a hypothesis, and test a small repair.","fr":"Code troubleshooting follows the same rule: classify the failure, capture evidence, form a hypothesis, and test a small repair."}],"bullets":[{"pt":"Se a correção muda muita coisa de uma vez, fica difícil saber o que realmente resolveu o problema.","en":"If a fix changes too much at once, it becomes hard to know what actually solved the problem.","es":"If a fix changes too much at once, it becomes hard to know what actually solved the problem.","fr":"If a fix changes too much at once, it becomes hard to know what actually solved the problem."}]},{"title":{"pt":"Leitura operacional","en":"Operational reading","es":"Lectura operativa","fr":"Lecture opérationnelle"},"body":[{"pt":"Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Solução de problemas no Code, onde o contexto pode atravessar mais de uma etapa.","en":"Treat the flow as complete when the result can be reopened, reviewed, and understood without relying on the operator’s memory. That matters especially in Code troubleshooting, where context may span more than one step.","es":"Considera el flujo terminado cuando el resultado puede reabrirse, revisarse y entenderse sin depender de la memoria de quien ejecutó la tarea. Esto es especialmente importante en Solución de problemas en Code, donde el contexto puede atravesar varias etapas.","fr":"Considérez le flux comme terminé lorsque le résultat peut être rouvert, relu et compris sans dépendre de la mémoire de la personne qui a effectué la tâche. C’est particulièrement important dans Dépannage dans Code, où le contexte peut traverser plusieurs étapes."},{"pt":"Comece por “A sessão não envia”, confirme o estado visível e avance para “Preview ou arquivo não abre” apenas quando a etapa anterior estiver estável. Em Solução de problemas no Code, pular contexto costuma gerar mais retrabalho do que velocidade.","en":"Start with “The session does not send”, confirm the visible state, and move to “Preview or file does not open” only when the previous step is stable. In Code troubleshooting, skipping context usually creates more rework than speed.","es":"Empieza por “La sesión no envía”, confirma el estado visible y avanza a “Preview o archivo no abre” solo cuando la etapa anterior esté estable. En Solución de problemas en Code, saltarse el contexto suele generar más retrabajo que velocidad.","fr":"Commencez par « La session n’envoie pas », confirmez l’état visible puis passez à « Aperçu ou fichier ne s’ouvre pas » seulement lorsque l’étape précédente est stable. Dans Dépannage dans Code, ignorer le contexte crée généralement plus de reprise que de vitesse."},{"pt":"No Giorgio Code, isso também significa distinguir o que foi apenas proposto, o que foi escrito em arquivo e o que foi realmente executado ou verificado.","en":"In Giorgio Code, this also means distinguishing what was merely proposed, what was written to a file, and what was actually executed or verified.","es":"En Giorgio Code, esto también significa distinguir lo que solo se propuso, lo que se escribió en un archivo y lo que realmente se ejecutó o verificó.","fr":"Dans Giorgio Code, cela signifie aussi distinguer ce qui a seulement été proposé, ce qui a été écrit dans un fichier et ce qui a réellement été exécuté ou vérifié."}]},{"title":{"pt":"Do primeiro clique à entrega","en":"From first click to delivery","es":"Del primer clic a la entrega","fr":"Du premier clic à la livraison"},"body":[{"pt":"Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Solução de problemas no Code realmente exigir mais contexto, controle ou verificação.","en":"Not every case needs the most advanced configuration. Prefer the smallest path that solves the goal, and add complexity only when Code troubleshooting truly needs more context, control, or verification.","es":"No todos los casos necesitan la configuración más avanzada. Prefiere el camino mínimo que resuelve el objetivo y aumenta la complejidad solo cuando Solución de problemas en Code realmente requiera más contexto, control o verificación.","fr":"Tous les cas n’exigent pas la configuration la plus avancée. Préférez le chemin minimal qui résout l’objectif et n’ajoutez de la complexité que lorsque Dépannage dans Code exige réellement plus de contexte, de contrôle ou de vérification."},{"pt":"Imagine uma tarefa real em que Solução de problemas no Code deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.","en":"Picture a real task where Code troubleshooting stops being a menu option and starts determining delivery quality. Make a short first pass, observe system feedback, and only then increase scope, file count, or session length.","es":"Imagina una tarea real en la que Solución de problemas en Code deja de ser una opción de menú y pasa a determinar la calidad de la entrega. Haz una primera pasada corta, observa la respuesta del sistema y solo después amplía el alcance, los archivos o la duración de la sesión.","fr":"Imaginez une tâche réelle où Dépannage dans Code cesse d’être une option de menu et commence à déterminer la qualité de la livraison. Faites un premier passage court, observez le retour du système puis augmentez seulement ensuite la portée, le nombre de fichiers ou la durée de session."}],"bullets":[{"pt":"confirme o estado antes de iniciar a próxima ação","en":"confirm the current state before starting the next action","es":"confirma el estado antes de iniciar la siguiente acción","fr":"confirmez l’état avant de lancer l’action suivante"},{"pt":"mantenha arquivos, sessão e contexto ligados ao mesmo objetivo","en":"keep files, session, and context tied to the same goal","es":"mantén archivos, sesión y contexto vinculados al mismo objetivo","fr":"gardez les fichiers, la session et le contexte liés au même objectif"},{"pt":"trate mensagens de erro como dados de diagnóstico, não como detalhe visual","en":"treat error messages as diagnostic data rather than visual noise","es":"trata los mensajes de error como datos de diagnóstico y no como ruido visual","fr":"traitez les messages d’erreur comme des données de diagnostic et non comme du bruit visuel"}]},{"title":{"pt":"Limites e exceções","en":"Limits and exceptions","es":"Límites y excepciones","fr":"Limites et exceptions"},"body":[{"pt":"Use Solução de problemas no Code como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Diagnostique a superfície que falhou — sessão, arquivo, editor, terminal, preview ou modelo — antes de reiniciar tudo. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.","en":"Use Code troubleshooting as an operational reference, not as an isolated screen. The page itself is about this: Diagnose the surface that failed — session, file, editor, terminal, preview, or model — before restarting everything. The gain appears when it connects cleanly to what comes before and what must happen next.","es":"Usa Solución de problemas en Code como referencia operativa, no como una pantalla aislada. La propia propuesta de la página es: Diagnostica la superficie que falló — sesión, archivo, editor, terminal, preview o modelo — antes de reiniciar todo. El beneficio aparece cuando se conecta bien con lo que viene antes y con lo que debe ocurrir después.","fr":"Utilisez Dépannage dans Code comme référence opérationnelle, et non comme un écran isolé. La page elle-même poursuit cet objectif : Diagnostiquez la surface en échec — session, fichier, éditeur, terminal, aperçu ou modèle — avant de tout redémarrer. Le bénéfice apparaît lorsque cela s’enchaîne proprement avec ce qui précède et ce qui doit suivre."}]},{"title":{"pt":"Detalhes que evitam regressão: Solução de problemas no Code","en":"Details that prevent regressions: Code troubleshooting","es":"Detalles que evitan regresiones: Solución de problemas en Code","fr":"Détails anti-régression: Dépannage dans Code"},"body":[{"pt":"Nesta página, a referência completa cobre syntax, test, runtime, auth, dependency, contract e recovery. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.","en":"This page treats Code troubleshooting as an operational contract: inputs, state, side effects, recoverable failures, and the evidence that confirms completion are all part of the feature.","es":"Esta página trata Solución de problemas en Code como un contrato operativo: entradas, estado, efectos laterales, fallos recuperables y la evidencia que confirma la finalización forman parte de la función.","fr":"Cette page traite Dépannage dans Code comme un contrat opérationnel : entrées, état, effets de bord, échecs récupérables et preuves de fin font partie de la fonctionnalité."}],"bullets":[{"pt":"confirme o estado inicial antes de executar a ação","en":"confirm the initial state before the action","es":"confirma el estado inicial antes de la acción","fr":"confirmez l’état initial avant l’action"},{"pt":"identifique quais dados ou arquivos a superfície realmente possui","en":"identify which data or files the surface actually owns","es":"identifica qué datos o archivos posee realmente la superficie","fr":"identifiez les données ou fichiers réellement détenus par la surface"},{"pt":"trate loading, vazio, erro, retry e reentrada como comportamento principal","en":"treat loading, empty, error, retry, and re-entry as first-class behavior","es":"trata loading, vacío, error, retry y reentrada como comportamiento principal","fr":"traitez chargement, vide, erreur, retry et réentrée comme des comportements de premier ordre"},{"pt":"verifique o resultado no mesmo contrato que o usuário consegue observar","en":"verify the result in the same contract the user can observe","es":"verifica el resultado en el mismo contrato observable por el usuario","fr":"vérifiez le résultat dans le même contrat observable par l’utilisateur"}]},{"title":{"pt":"Casos de borda de Solução de problemas no Code","en":"Edge cases for Code troubleshooting","es":"Casos límite de Solución de problemas en Code","fr":"Cas limites de Dépannage dans Code"},"body":[{"pt":"A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.","en":"A robust Code troubleshooting flow remains coherent when the network stalls, the session changes, content is empty, an action is repeated, the viewport shrinks, or an external dependency stops responding.","es":"Un flujo robusto de Solución de problemas en Code sigue siendo coherente cuando la red tarda, cambia la sesión, no hay contenido, se repite una acción, se reduce el viewport o falla una dependencia externa.","fr":"Un flux robuste de Dépannage dans Code reste cohérent si le réseau ralentit, la session change, le contenu est vide, une action est répétée, le viewport rétrécit ou une dépendance externe ne répond plus."}]}],"facts":[{"pt":"Referência técnica","en":"Technical reference","es":"Technical reference","fr":"Technical reference"},{"pt":"Conteúdo expandido nesta versão","en":"Expanded in this version","es":"Contenido ampliado en esta versión","fr":"Contenu enrichi dans cette version"},{"pt":"Projetado para uso em fluxo real","en":"Designed for real workflow use","es":"Diseñado para uso en flujos reales","fr":"Conçu pour un usage réel"}]},{"slug":"thesis2-orchestration","group":"controls","asset":"modelGraph","title":{"pt":"Thesis 2.1: Sparse Frontier Orchestration","en":"Thesis 2.1: Sparse Frontier Orchestration","es":"Thesis 2.1: Sparse Frontier Orchestration","fr":"Thesis 2.1 : Sparse Frontier Orchestration"},"lead":{"pt":"Como o Thesis 2.1 distribui compute por risco, evidência e incerteza sem pagar o custo de multiagente em toda tarefa.","en":"How Thesis 2.1 allocates compute by risk, evidence, and uncertainty without paying multi-agent cost on every task.","es":"Cómo Thesis 2.1 distribuye compute por riesgo, evidencia e incertidumbre sin pagar multiagente en toda tarea.","fr":"Comment Thesis 2.1 alloue le calcul selon risque, preuve et incertitude sans payer le coût multi-agent sur chaque tâche."},"sections":[{"title":{"pt":"Trajetória direta antes de escalar","en":"Direct trajectory before escalation","es":"Trayectoria directa antes de escalar","fr":"Trajectoire directe avant escalade"},"body":[{"pt":"Low e Medium usam uma trajetória coerente e validação determinística. High, Extra e Max só promovem para o harness frontier quando arquitetura, PBR, fidelidade visual, risco operacional ou complexidade justificam o custo.","en":"Low and Medium use one coherent trajectory and deterministic validation. High, Extra, and Max promote to the frontier harness only when architecture, PBR, visual fidelity, operational risk, or complexity justify the cost.","es":"Low y Medium usan una trayectoria coherente y validación determinista. High/Extra/Max escalan solo cuando arquitectura, PBR, fidelidad visual o riesgo justifican el costo.","fr":"Low et Medium utilisent une trajectoire cohérente et une validation déterministe. High/Extra/Max n’escaladent que lorsque architecture, PBR, fidélité visuelle ou risque justifient le coût."}]},{"title":{"pt":"Gates de incerteza","en":"Uncertainty gates","es":"Gates de incertidumbre","fr":"Gates d’incertitude"},"body":[{"pt":"O roteador classifica code, visual, 3D, PBR, arquitetura, refinamento e risco. O objetivo não é adivinhar “dificuldade” por tamanho do prompt; é identificar onde uma segunda avaliação pode mudar a decisão técnica.","en":"The router classifies code, visual, 3D, PBR, architecture, refinement, and risk. The goal is not to infer difficulty from prompt length; it is to identify where a second evaluation can change the technical decision.","es":"El router clasifica código, visual, 3D, PBR, arquitectura, refinamiento y riesgo.","fr":"Le routeur classe code, visuel, 3D, PBR, architecture, raffinement et risque."}]},{"title":{"pt":"Checkpoint de melhor candidato","en":"Best-candidate checkpoint","es":"Checkpoint del mejor candidato","fr":"Checkpoint du meilleur candidat"},"body":[{"pt":"Um repair pass só substitui a resposta anterior quando fica verificado ou supera a pontuação de evidência. Isso evita que uma reescrita mais recente destrua comportamento que já estava correto.","en":"A repair pass only replaces the previous answer when it becomes verified or exceeds the evidence score. This prevents a newer rewrite from destroying behavior that was already correct.","es":"Un repair pass solo reemplaza la respuesta anterior si queda verificado o supera la puntuación de evidencia.","fr":"Un repair pass ne remplace la réponse précédente que s’il est vérifié ou améliore le score de preuve."}]},{"title":{"pt":"Economia de contexto","en":"Context economy","es":"Economía de contexto","fr":"Économie de contexte"},"body":[{"pt":"Contexto estável permanece estável; evidência nova entra no final; saídas de ferramenta são resumidas; tarefas determinísticas como parsing e contagem ficam fora do raciocínio caro.","en":"Stable context stays stable; new evidence is appended; tool output is summarized; deterministic tasks such as parsing and counting stay outside expensive reasoning.","es":"El contexto estable permanece estable; evidencia nueva se añade; parsing y conteo quedan fuera del razonamiento caro.","fr":"Le contexte stable reste stable ; les nouvelles preuves sont ajoutées ; parsing et comptage restent hors du raisonnement coûteux."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"anti-ai-slop","group":"appearance","asset":"browserCursor","title":{"pt":"Anti-AI-slop: critérios de direção visual","en":"Anti-AI-slop: visual direction criteria","es":"Anti-AI-slop: criterios de dirección visual","fr":"Anti-AI-slop : critères de direction visuelle"},"lead":{"pt":"Um contrato visual que transforma “não parecer gerado por IA” em critérios observáveis de composição, hierarquia e identidade.","en":"A visual contract that turns “do not look AI-generated” into observable criteria for composition, hierarchy, and identity.","es":"Un contrato visual que convierte “no parecer generado por IA” en criterios observables.","fr":"Un contrat visuel qui transforme « ne pas sembler généré par IA » en critères observables."},"sections":[{"title":{"pt":"Padrões penalizados","en":"Patterns that are penalized","es":"Patrones penalizados","fr":"Motifs pénalisés"},"body":[{"pt":"O evaluator reduz score de grids de cards com peso idêntico, glassmorphism gratuito, glow/gradientes sem função, excesso de pills, radius aleatório, hero vazio, dashboards falsos, controles decorativos e ilustrações usadas apenas para preencher espaço.","en":"The evaluator lowers scores for equal-weight card grids, gratuitous glassmorphism, purposeless glow/gradients, pill spam, random radii, empty heroes, fake dashboards, decorative controls, and illustrations used only as filler.","es":"El evaluator penaliza grids de cards de peso igual, glassmorphism gratuito, glow/gradientes sin función, pills excesivas, radios aleatorios, héroes vacíos y controles decorativos.","fr":"L’évaluateur pénalise les grilles de cartes au même poids, le glassmorphism gratuit, glow/gradients sans fonction, l’abus de pills, rayons aléatoires et contrôles décoratifs."}]},{"title":{"pt":"Shape grammar específica","en":"Product-specific shape grammar","es":"Shape grammar específica","fr":"Shape grammar spécifique"},"body":[{"pt":"A UI deve ter uma gramática própria: tipos de superfície, bordas, ritmo, alinhamento, densidade e estados definidos pelo produto. Reutilização é boa quando comunica parentesco; repetição automática é slop quando apaga a função de cada área.","en":"UI should have its own grammar: surface types, borders, rhythm, alignment, density, and states defined by the product. Reuse is good when it communicates kinship; automatic repetition becomes slop when it erases each area’s function.","es":"La UI debe tener gramática propia: superficies, bordes, ritmo, alineación, densidad y estados.","fr":"L’UI doit avoir sa propre grammaire : surfaces, bordures, rythme, alignement, densité et états."}]},{"title":{"pt":"Referência como contrato","en":"Reference as contract","es":"Referencia como contrato","fr":"Référence comme contrat"},"body":[{"pt":"Quando há print de referência, o Thesis 2.1 compara proporções, hierarquia, densidade, crop, tipografia, navegação e interação. Copiar apenas paleta não é fidelidade.","en":"When a reference screenshot exists, Thesis 2.1 compares proportions, hierarchy, density, crop, typography, navigation, and interaction. Copying only the palette is not fidelity.","es":"Con una captura de referencia, Thesis 2.1 compara proporciones, jerarquía, densidad, crop, tipografía, navegación e interacción.","fr":"Avec une capture de référence, Thesis 2.1 compare proportions, hiérarchie, densité, cadrage, typographie, navigation et interaction."}]},{"title":{"pt":"Estados também são design","en":"States are design too","es":"Los estados también son diseño","fr":"Les états font aussi partie du design"},"body":[{"pt":"Loading, vazio, erro, retry, hover, focus, seleção, disabled, mobile e overflow fazem parte da avaliação. Um mock estático bonito com estados quebrados não passa como UI refinada.","en":"Loading, empty, error, retry, hover, focus, selection, disabled, mobile, and overflow are part of evaluation. A pretty static mock with broken states does not pass as refined UI.","es":"Loading, vacío, error, retry, hover, focus, selección, disabled, mobile y overflow forman parte de la evaluación.","fr":"Chargement, vide, erreur, retry, hover, focus, sélection, disabled, mobile et overflow font partie de l’évaluation."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"pbr-rendering","group":"execution","asset":"modelGraph","title":{"pt":"PBR avançado e pipeline de cor","en":"Advanced PBR and color pipeline","es":"PBR avanzado y pipeline de color","fr":"PBR avancé et pipeline couleur"},"lead":{"pt":"O contrato técnico usado pelo Thesis 2.1 para materiais, iluminação e color management em cenas 3D realistas.","en":"The technical contract Thesis 2.1 uses for materials, lighting, and color management in realistic 3D scenes.","es":"El contrato técnico de Thesis 2.1 para materiales, iluminación y color management en escenas 3D realistas.","fr":"Le contrat technique de Thesis 2.1 pour matériaux, éclairage et gestion couleur dans les scènes 3D réalistes."},"sections":[{"title":{"pt":"Metallic-roughness","en":"Metallic-roughness","es":"Metallic-roughness","fr":"Metallic-roughness"},"body":[{"pt":"O baseline segue um workflow metallic-roughness coerente: base color tem significado diferente para condutores e dielétricos; metalness e roughness precisam preservar plausibilidade material; mapas normal/occlusion/emissive têm semântica distinta e não podem ser tratados como cores genéricas.","en":"The baseline follows a coherent metallic-roughness workflow: base color means different things for conductors and dielectrics; metalness and roughness must preserve material plausibility; normal/occlusion/emissive maps have distinct semantics and cannot be treated as generic color textures.","es":"El baseline sigue un workflow metallic-roughness coherente; normal/occlusion/emissive tienen semánticas distintas.","fr":"Le baseline suit un workflow metallic-roughness cohérent ; normal/occlusion/emissive ont des sémantiques distinctes."}]},{"title":{"pt":"Microfacet BRDF","en":"Microfacet BRDF","es":"Microfacet BRDF","fr":"Microfacet BRDF"},"body":[{"pt":"A revisão procura distribuição de microfacetas compatível com GGX, masking/shadowing no estilo Smith e Fresnel plausível, com conservação de energia. O objetivo não é exigir uma implementação acadêmica literal, e sim evitar materiais que só “parecem brilhantes”.","en":"Review looks for a microfacet distribution compatible with GGX, Smith-style masking/shadowing, plausible Fresnel behavior, and energy conservation. The goal is not a literal academic implementation but avoiding materials that merely “look shiny.”","es":"La revisión busca GGX, Smith, Fresnel plausible y conservación de energía.","fr":"La revue recherche GGX, Smith, Fresnel plausible et conservation de l’énergie."}]},{"title":{"pt":"Linear light e saída sRGB","en":"Linear light and sRGB output","es":"Luz lineal y salida sRGB","fr":"Lumière linéaire et sortie sRGB"},"body":[{"pt":"Iluminação e interpolação devem acontecer em espaço linear; texturas de cor precisam de interpretação sRGB correta; dados como roughness/metalness/normal permanecem lineares. A saída para display é convertida para sRGB, e tone mapping/exposure são avaliados como parte do pipeline.","en":"Lighting and interpolation should occur in linear space; color textures need correct sRGB interpretation; roughness/metalness/normal data remain linear. Display output converts to sRGB, and tone mapping/exposure are evaluated as part of the pipeline.","es":"Iluminación e interpolación en espacio lineal; texturas de color en sRGB; datos roughness/metalness/normal lineales.","fr":"Éclairage et interpolation en espace linéaire ; textures couleur en sRGB ; roughness/metalness/normal restent linéaires."}]},{"title":{"pt":"IBL e prefiltragem","en":"IBL and prefiltering","es":"IBL y prefiltrado","fr":"IBL et préfiltrage"},"body":[{"pt":"Para iluminação indireta realista, o Thesis 2.1 procura ambiente HDR/prefiltered environment, irradiance difusa e reflexão especular dependente de roughness, preferindo PMREM/IBL quando o engine oferece suporte.","en":"For realistic indirect lighting, Thesis 2.1 looks for HDR/prefiltered environments, diffuse irradiance, and roughness-dependent specular reflection, preferring PMREM/IBL when the engine supports it.","es":"Para iluminación indirecta realista, Thesis 2.1 busca entorno HDR/prefiltrado, irradiancia difusa y reflexión especular dependiente de roughness.","fr":"Pour l’éclairage indirect réaliste, Thesis 2.1 recherche environnement HDR/préfiltré, irradiance diffuse et réflexion spéculaire dépendante de roughness."}]},{"title":{"pt":"Budget de GPU","en":"GPU budget","es":"Presupuesto de GPU","fr":"Budget GPU"},"body":[{"pt":"Fidelidade não libera desperdício. A revisão considera draw calls, triângulos, memória de textura, shader variants, shadow maps, DPR, post-processing, LOD, instancing, culling, BVH e disposal.","en":"Fidelity does not excuse waste. Review considers draw calls, triangles, texture memory, shader variants, shadow maps, DPR, post-processing, LOD, instancing, culling, BVH, and disposal.","es":"La fidelidad no justifica desperdicio: draw calls, triángulos, texturas, shadow maps, DPR, LOD, instancing, culling, BVH y disposal importan.","fr":"La fidélité n’excuse pas le gaspillage : draw calls, triangles, textures, shadow maps, DPR, LOD, instancing, culling, BVH et disposal comptent."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"3d-scene-engineering","group":"execution","asset":"modelGraph","title":{"pt":"Engenharia de cenas 3D","en":"3D scene engineering","es":"Ingeniería de escenas 3D","fr":"Ingénierie de scènes 3D"},"lead":{"pt":"Geometria, câmera, input, colisão, iluminação e performance como um único sistema executável.","en":"Geometry, camera, input, collision, lighting, and performance as one executable system.","es":"Geometría, cámara, input, colisión, iluminación y rendimiento como un único sistema ejecutable.","fr":"Géométrie, caméra, input, collision, éclairage et performance comme un seul système exécutable."},"sections":[{"title":{"pt":"Macro, médio e micro","en":"Macro, mid, and micro scale","es":"Macro, medio y micro","fr":"Macro, moyen et micro"},"body":[{"pt":"Uma cena convincente precisa de leitura em três escalas. Macro define massas e silhueta; médio define construção, junções e repetição; micro é reservado para materiais, decals, normal detail e pequenas imperfeições. Pilhas de BoxGeometry não substituem autoria.","en":"A convincing scene needs three scales of readability. Macro defines masses and silhouette; mid defines construction, joints, and repetition; micro is reserved for materials, decals, normal detail, and small imperfections. Piles of BoxGeometry do not replace authorship.","es":"Una escena convincente necesita lectura en tres escalas. Macro define masas; medio define construcción; micro queda para materiales, decals y detalle.","fr":"Une scène convaincante exige trois échelles de lecture. Macro définit les masses ; moyen la construction ; micro les matériaux, decals et détails."}]},{"title":{"pt":"Câmera e navegação","en":"Camera and navigation","es":"Cámara y navegación","fr":"Caméra et navigation"},"body":[{"pt":"Near/far, FOV, damping, collision e velocidade são parâmetros de produto, não defaults invisíveis. Câmera cinematográfica usa estados de shot e easing; câmera de jogo prioriza legibilidade e previsibilidade.","en":"Near/far, FOV, damping, collision, and speed are product parameters, not invisible defaults. Cinematic cameras use shot states and easing; game cameras prioritize readability and predictability.","es":"Near/far, FOV, damping, colisión y velocidad son parámetros de producto.","fr":"Near/far, FOV, damping, collision et vitesse sont des paramètres produit."}]},{"title":{"pt":"Loop, resize e lifecycle","en":"Loop, resize, and lifecycle","es":"Loop, resize y lifecycle","fr":"Loop, resize et lifecycle"},"body":[{"pt":"Render loop, resize, DPR, eventos de input e recursos GPU precisam de lifecycle explícito. Reentrada não pode duplicar listeners nem criar dois loops; desmontar a cena deve liberar geometrias, materiais, texturas e targets.","en":"Render loop, resize, DPR, input events, and GPU resources need explicit lifecycle. Re-entry must not duplicate listeners or create two loops; unmounting should release geometries, materials, textures, and render targets.","es":"Render loop, resize, DPR, eventos y recursos GPU necesitan lifecycle explícito.","fr":"Render loop, resize, DPR, événements et ressources GPU nécessitent un lifecycle explicite."}]},{"title":{"pt":"Estruturas de aceleração","en":"Acceleration structures","es":"Estructuras de aceleración","fr":"Structures d’accélération"},"body":[{"pt":"Raycast amplo, colisão e consultas espaciais podem exigir BVH, octree, grid espacial ou broad phase. O Thesis 2.1 deve escolher pelo padrão de consulta e escala, não adicionar estruturas complexas como decoração arquitetural.","en":"Broad raycasts, collision, and spatial queries may need BVH, octree, spatial grid, or broad phase. Thesis 2.1 should choose based on query pattern and scale, not add complex structures as architectural decoration.","es":"Raycast amplio y consultas espaciales pueden requerir BVH, octree o broad phase según el patrón de consulta.","fr":"Raycast large et requêtes spatiales peuvent exiger BVH, octree ou broad phase selon le motif de requête."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"architecture-contracts","group":"workspace","asset":"memoryBraces","title":{"pt":"Contratos de arquitetura e invariantes","en":"Architecture contracts and invariants","es":"Contratos de arquitectura e invariantes","fr":"Contrats d’architecture et invariants"},"lead":{"pt":"O padrão de system design do Thesis 2.1 para serviços, banco, auth, filas, realtime e migrações.","en":"Thesis 2.1’s system-design standard for services, databases, auth, queues, realtime, and migrations.","es":"El estándar de system design de Thesis 2.1 para servicios, base de datos, auth, colas, realtime y migraciones.","fr":"Le standard de system design de Thesis 2.1 pour services, bases, auth, files, realtime et migrations."},"sections":[{"title":{"pt":"Domain ownership","en":"Domain ownership","es":"Domain ownership","fr":"Domain ownership"},"body":[{"pt":"Antes de escolher serviços, o Thesis 2.1 identifica quem é dono de cada estado, quais invariantes não podem ser violados e quais fronteiras exigem autorização. Isso reduz acoplamento “mágico” entre frontend, função edge e banco.","en":"Before choosing services, Thesis 2.1 identifies who owns each state, which invariants cannot be violated, and which boundaries require authorization. This reduces “magical” coupling across frontend, edge function, and database.","es":"Antes de elegir servicios, Thesis 2.1 identifica dueño del estado, invariantes y fronteras de autorización.","fr":"Avant de choisir les services, Thesis 2.1 identifie propriétaire de l’état, invariants et frontières d’autorisation."}]},{"title":{"pt":"Idempotência e transações","en":"Idempotency and transactions","es":"Idempotencia y transacciones","fr":"Idempotence et transactions"},"body":[{"pt":"Operações repetíveis precisam de chave/idempotency strategy; mudanças relacionadas precisam de fronteira transacional clara; retries não podem duplicar cobrança, jobs, e-mails ou side effects.","en":"Repeatable operations need an idempotency strategy; related changes need a clear transactional boundary; retries must not duplicate billing, jobs, emails, or side effects.","es":"Operaciones repetibles necesitan estrategia de idempotencia; retries no deben duplicar efectos.","fr":"Les opérations répétables exigent une stratégie d’idempotence ; les retries ne doivent pas dupliquer les effets."}]},{"title":{"pt":"Backpressure e cancelamento","en":"Backpressure and cancellation","es":"Backpressure y cancelación","fr":"Backpressure et annulation"},"body":[{"pt":"Filas e tarefas longas precisam de ownership, deadlines, cancelamento e limites de concorrência. “Retry até funcionar” não é resiliência se a origem continua sobrecarregada.","en":"Queues and long tasks need ownership, deadlines, cancellation, and concurrency limits. “Retry until it works” is not resilience if the source remains overloaded.","es":"Colas y tareas largas necesitan ownership, deadlines, cancelación y límites de concurrencia.","fr":"Queues et tâches longues exigent ownership, deadlines, annulation et limites de concurrence."}]},{"title":{"pt":"Migração e rollback","en":"Migration and rollback","es":"Migración y rollback","fr":"Migration et rollback"},"body":[{"pt":"Schema changes são avaliadas junto com compatibilidade de leitores/escritores, ordem de deploy, backfill e rollback. Uma migration que executa não prova que a aplicação antiga e a nova convivem durante rollout.","en":"Schema changes are evaluated together with reader/writer compatibility, deployment order, backfill, and rollback. A migration that runs does not prove old and new applications can coexist during rollout.","es":"Cambios de schema se evalúan con compatibilidad, orden de deploy, backfill y rollback.","fr":"Les changements de schéma sont évalués avec compatibilité, ordre de déploiement, backfill et rollback."}]},{"title":{"pt":"Observabilidade como contrato","en":"Observability as a contract","es":"Observabilidad como contrato","fr":"Observabilité comme contrat"},"body":[{"pt":"Logs, métricas e traces só ajudam quando carregam request/job IDs, classificação de erro e estado suficiente para localizar a fronteira que falhou. Mensagem genérica no cliente não substitui telemetria acionável.","en":"Logs, metrics, and traces help only when they carry request/job IDs, error classification, and enough state to locate the failing boundary. A generic client message does not replace actionable telemetry.","es":"Logs, métricas y traces ayudan cuando llevan IDs, clasificación de error y estado suficiente.","fr":"Logs, métriques et traces aident lorsqu’ils portent IDs, classification d’erreur et état suffisant."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"code-refinement","group":"execution","asset":"eraser","title":{"pt":"Refinamento de código e regressão","en":"Code refinement and regression control","es":"Refinamiento de código y regresión","fr":"Raffinement du code et contrôle des régressions"},"lead":{"pt":"Como o Thesis 2.1 melhora código existente sem transformar cada correção em reescrita total.","en":"How Thesis 2.1 improves existing code without turning every fix into a full rewrite.","es":"Cómo Thesis 2.1 mejora código existente sin convertir cada corrección en reescritura total.","fr":"Comment Thesis 2.1 améliore le code existant sans transformer chaque correction en réécriture totale."},"sections":[{"title":{"pt":"Diff mínimo, contrato completo","en":"Small diff, complete contract","es":"Diff mínimo, contrato completo","fr":"Petit diff, contrat complet"},"body":[{"pt":"A unidade de mudança é o contrato quebrado, não a quantidade de linhas. O ideal é o menor conjunto de arquivos que restaura comportamento completo, incluindo estados de erro e reentrada.","en":"The unit of change is the broken contract, not line count. The goal is the smallest set of files that restores complete behavior, including error and re-entry states.","es":"La unidad de cambio es el contrato roto, no el número de líneas.","fr":"L’unité de changement est le contrat cassé, pas le nombre de lignes."}]},{"title":{"pt":"Sweep de defeitos adjacentes","en":"Adjacent-defect sweep","es":"Sweep de defectos adyacentes","fr":"Sweep des défauts adjacents"},"body":[{"pt":"Ao encontrar listener duplicado, race de sessão ou route guard incorreto, o repair pass procura outras ocorrências da mesma classe antes de encerrar. Isso evita corrigir um sintoma e deixar clones do mesmo bug.","en":"After finding a duplicate listener, session race, or incorrect route guard, the repair pass looks for other occurrences of the same class before stopping. This avoids fixing one symptom while leaving clones.","es":"Al encontrar listener duplicado o race de sesión, el repair pass busca ocurrencias de la misma clase.","fr":"Après un listener dupliqué ou race de session, le repair pass cherche les occurrences de la même classe."}]},{"title":{"pt":"Lifecycle e recursos","en":"Lifecycle and resources","es":"Lifecycle y recursos","fr":"Lifecycle et ressources"},"body":[{"pt":"Timers, observers, event listeners, object URLs, workers, sockets e recursos GPU entram na revisão porque muitos bugs só aparecem após navegar, reabrir ou repetir a ação.","en":"Timers, observers, event listeners, object URLs, workers, sockets, and GPU resources are reviewed because many bugs appear only after navigation, re-entry, or repetition.","es":"Timers, observers, listeners, URLs, workers, sockets y GPU entran en revisión.","fr":"Timers, observers, listeners, URLs, workers, sockets et GPU entrent dans la revue."}]},{"title":{"pt":"Evidência em camadas","en":"Layered evidence","es":"Evidencia en capas","fr":"Preuve en couches"},"body":[{"pt":"Parse/syntax, typecheck, build, unit, integration, runtime, E2E e visual review são classes diferentes. Thesis 2.1 não deve promover “node --check passou” para “site funciona”.","en":"Parse/syntax, typecheck, build, unit, integration, runtime, E2E, and visual review are different classes. Thesis 2.1 must not promote “node --check passed” into “the site works.”","es":"Parse, typecheck, build, runtime, E2E y visual review son clases distintas.","fr":"Parse, typecheck, build, runtime, E2E et revue visuelle sont des classes distinctes."}]}],"facts":[{"pt":"Thesis 2.1 v3","en":"Thesis 2.1 v3","es":"Thesis 2.1 v3","fr":"Thesis 2.1 v3"},{"pt":"Critérios de release observáveis","en":"Observable release criteria","es":"Criterios de release observables","fr":"Critères de release observables"},{"pt":"Escala de compute progressiva","en":"Progressive compute scaling","es":"Escala de compute progresiva","fr":"Échelle de calcul progressive"}]},{"slug":"thesis2-context-compiler","group":"thesis2","asset":"memoryBraces","title":{"pt":"Compilador de contexto do Thesis 2.1","en":"Thesis 2.1 context compiler","es":"Compilador de contexto de Thesis 2.1","fr":"Compilateur de contexte de Thesis 2.1"},"lead":{"pt":"Seleção determinística de missão, estado recente e evidência de alto sinal sob um orçamento rígido.","en":"Deterministic selection of mission, recent state, and high-signal evidence under a hard budget.","es":"Selección determinista de misión, estado reciente y evidencia de alta señal bajo un presupuesto rígido.","fr":"Sélection déterministe de mission, état récent et preuves à fort signal sous un budget strict."},"facts":[{"pt":"Contexto não é transcript dump","en":"Context is not a transcript dump","es":"El contexto no es un volcado del transcript","fr":"Le contexte n’est pas un dump de transcript"},{"pt":"missão + recente + evidência","en":"mission + recent + evidence","es":"misión + reciente + evidencia","fr":"mission + récent + preuves"},{"pt":"resultados antigos podem ser compactados","en":"old results may be compacted","es":"los resultados antiguos pueden compactarse","fr":"les anciens résultats peuvent être compactés"}],"sections":[{"title":{"pt":"Problema que resolve","en":"Problem it solves","es":"Problema que resuelve","fr":"Problème résolu"},"body":[{"pt":"Contextos longos falham não só por limite de tokens, mas por poluição: logs antigos, tool output repetido e decisões obsoletas competem com a tarefa atual. O compilador pontua missão, recência, overlap lexical e sinais de evidência antes de montar o contexto.","en":"Long contexts fail not only because of token limits, but because of pollution: old logs, repeated tool output, and obsolete decisions compete with the current task. The compiler scores mission, recency, lexical overlap, and evidence signals before assembling context.","es":"Los contextos largos fallan no solo por límite de tokens, sino por contaminación: logs antiguos, tool output repetido y decisiones obsoletas compiten con la tarea actual.","fr":"Les longs contextes échouent non seulement à cause de la limite de tokens, mais aussi de la pollution : anciens logs, sorties d’outils répétées et décisions obsolètes concurrencent la tâche actuelle."}]},{"title":{"pt":"Compaction com recall primeiro","en":"Recall-first compaction","es":"Compactación con recall primero","fr":"Compaction privilégiant le rappel"},"body":[{"pt":"Quando um segmento precisa ser reduzido, o sistema preserva cabeça e cauda, marca a omissão e mantém artefatos duráveis fora do prompt. A meta é remover repetição sem apagar contrato, erro ainda aberto ou decisão arquitetural.","en":"When a segment must be reduced, the system preserves head and tail, marks the omission, and keeps durable artifacts outside the prompt. The goal is to remove repetition without erasing contracts, open errors, or architecture decisions.","es":"Cuando un segmento debe reducirse, el sistema conserva principio y final, marca la omisión y mantiene artefactos durables fuera del prompt.","fr":"Lorsqu’un segment doit être réduit, le système conserve début et fin, marque l’omission et garde les artefacts durables hors du prompt."}]},{"title":{"pt":"Contexto multimodal","en":"Multimodal context","es":"Contexto multimodal","fr":"Contexte multimodal"},"body":[{"pt":"Imagens recentes são preservadas separadamente do texto. Para design, screenshot e 3D, transformar toda evidência visual em uma descrição textual cedo demais pode apagar crop, proporção e relações espaciais que o verificador precisa depois.","en":"Recent images are preserved separately from text. For design, screenshots, and 3D, converting all visual evidence into text too early can erase crop, proportion, and spatial relationships needed by later verification.","es":"Las imágenes recientes se conservan separadas del texto. En design, screenshots y 3D, convertir toda evidencia visual en texto demasiado pronto puede borrar recorte, proporción y relaciones espaciales.","fr":"Les images récentes sont conservées séparément du texte. Pour design, captures et 3D, convertir trop tôt toute preuve visuelle en texte peut effacer cadrage, proportion et relations spatiales."}]},{"title":{"pt":"Falha a evitar","en":"Failure to avoid","es":"Fallo a evitar","fr":"Échec à éviter"},"body":[{"pt":"Compressão não pode virar amnésia elegante. Se um resumo começa a causar repetição de exploração, ações bloqueadas ou reversão de decisões, o checkpoint precisa ser considerado suspeito e reconstruído a partir da fonte durável.","en":"Compression must not become elegant amnesia. If a summary starts causing repeated exploration, blocked actions, or reversed decisions, the checkpoint should be treated as suspect and rebuilt from durable source material.","es":"La compresión no puede convertirse en amnesia elegante. Si un resumen empieza a causar exploración repetida, acciones bloqueadas o reversión de decisiones, el checkpoint debe reconstruirse.","fr":"La compression ne doit pas devenir une amnésie élégante. Si un résumé provoque exploration répétée, actions bloquées ou inversion de décisions, le checkpoint doit être reconstruit depuis la source durable."}]}]},{"slug":"thesis2-progressive-proof","group":"thesis2","asset":"modelGraph","title":{"pt":"Progressive Proof","en":"Progressive Proof","es":"Progressive Proof","fr":"Progressive Proof"},"lead":{"pt":"A resposta sobe de custo apenas quando o próximo gate pode comprar evidência nova.","en":"The response becomes more expensive only when the next gate can buy new evidence.","es":"La respuesta aumenta de coste solo cuando el siguiente gate puede comprar evidencia nueva.","fr":"La réponse devient plus coûteuse uniquement lorsque le gate suivant peut acheter de nouvelles preuves."},"facts":[{"pt":"determinístico antes de probabilístico","en":"deterministic before probabilistic","es":"determinista antes de probabilístico","fr":"déterministe avant probabiliste"},{"pt":"refine antes de resample","en":"refine before resample","es":"refinar antes de remuestrear","fr":"raffiner avant de rééchantillonner"},{"pt":"branch só com incerteza residual","en":"branch only with residual uncertainty","es":"rama solo con incertidumbre residual","fr":"branche seulement avec incertitude résiduelle"}],"sections":[{"title":{"pt":"Escada de evidência","en":"Evidence ladder","es":"Escalera de evidencia","fr":"Échelle de preuves"},"bullets":[{"pt":"geração primária","en":"primary generation","es":"generación primaria","fr":"génération primaire"},{"pt":"validators determinísticos","en":"deterministic validators","es":"validadores deterministas","fr":"validateurs déterministes"},{"pt":"reparo localizado","en":"targeted repair","es":"reparación localizada","fr":"réparation ciblée"},{"pt":"verificador semântico independente","en":"independent semantic verifier","es":"verificador semántico independiente","fr":"vérificateur sémantique indépendant"},{"pt":"refinamento profundo ou branch quando necessário","en":"deep refinement or branch when needed","es":"refinamiento profundo o rama cuando hace falta","fr":"raffinement profond ou branche si nécessaire"}]},{"title":{"pt":"Por que não multiagente sempre","en":"Why not multi-agent all the time","es":"Por qué no multiagente siempre","fr":"Pourquoi pas du multi-agent en permanence"},"body":[{"pt":"Mais rollouts podem aumentar cobertura, mas também multiplicam custo e ruído. Thesis 2.1 começa com uma trajetória forte e só cria uma segunda hipótese quando o melhor candidato ainda tem incerteza material ou desacordo entre verificadores.","en":"More rollouts can increase coverage, but they also multiply cost and noise. Thesis 2.1 starts with one strong trajectory and creates another hypothesis only when the best candidate still has material uncertainty or verifier disagreement.","es":"Más rollouts pueden aumentar cobertura, pero también multiplican coste y ruido. Thesis 2.1 comienza con una trayectoria fuerte y solo crea otra hipótesis si queda incertidumbre material.","fr":"Davantage de rollouts peut accroître la couverture, mais multiplie aussi coût et bruit. Thesis 2.1 commence par une trajectoire forte et ne crée une autre hypothèse que s’il reste une incertitude matérielle."}]},{"title":{"pt":"Regra monotônica de checkpoint","en":"Monotonic checkpoint rule","es":"Regla monotónica de checkpoint","fr":"Règle monotone de checkpoint"},"body":[{"pt":"Um reparo novo não ganha só por ser novo. Ele precisa reduzir penalidade material, limpar um gate ou vencer comparação independente sem introduzir regressão. Caso contrário o candidato anterior permanece.","en":"A new repair does not win merely by being newer. It must reduce material penalty, clear a gate, or win independent comparison without introducing regression. Otherwise the previous candidate remains.","es":"Una reparación nueva no gana por ser nueva. Debe reducir penalización material, limpiar un gate o ganar una comparación independiente sin introducir regresión.","fr":"Une nouvelle réparation ne gagne pas parce qu’elle est plus récente. Elle doit réduire la pénalité matérielle, franchir un gate ou gagner une comparaison indépendante sans régression."}]},{"title":{"pt":"Orçamento por tarefa","en":"Per-task budget","es":"Presupuesto por tarea","fr":"Budget par tâche"},"body":[{"pt":"Low e Medium evitam verificadores caros; High pode reparar; Extra adiciona verificação semântica; Max pode comparar microplanos independentes, refinamento e branch. O objetivo é custo por resultado aceito, não tokens gastos.","en":"Low and Medium avoid expensive verifiers; High may repair; Extra adds semantic verification; Max may compare independent microplans, refinement, and branching. The objective is cost per accepted result, not tokens spent.","es":"Low y Medium evitan verificadores caros; High puede reparar; Extra añade verificación semántica; Max puede comparar microplanes, refinamiento y ramas.","fr":"Low et Medium évitent les vérificateurs coûteux ; High peut réparer ; Extra ajoute une vérification sémantique ; Max peut comparer des microplans, raffiner et brancher."}]}]},{"slug":"thesis2-long-running","group":"thesis2","asset":"memoryBraces","title":{"pt":"Tarefas de horas e dias","en":"Tasks that run for hours or days","es":"Tareas de horas y días","fr":"Tâches de plusieurs heures ou jours"},"lead":{"pt":"Execução durável por sessões delimitadas, artefato completo, ledger de requisitos e release gate independente.","en":"Durable execution through bounded sessions, a complete artifact, a requirement ledger, and an independent release gate.","es":"Ejecución durable mediante sesiones delimitadas, artefacto completo, ledger de requisitos y release gate independiente.","fr":"Exécution durable via sessions bornées, artefact complet, ledger d’exigences et release gate indépendant."},"facts":[{"pt":"até 2048 passos duráveis","en":"up to 2048 durable steps","es":"hasta 2048 pasos durables","fr":"jusqu’à 2048 étapes durables"},{"pt":"leases + next_run_at","en":"leases + next_run_at","es":"leases + next_run_at","fr":"leases + next_run_at"},{"pt":"artefato persistido fora do prompt","en":"artifact persisted outside the prompt","es":"artefacto persistido fuera del prompt","fr":"artefact persisté hors du prompt"}],"sections":[{"title":{"pt":"Por que não manter uma função viva","en":"Why not keep one function alive","es":"Por qué no mantener una función viva","fr":"Pourquoi ne pas garder une fonction en vie"},"body":[{"pt":"Uma Edge Function contínua por 30 horas é uma arquitetura frágil. Thesis usa jobs duráveis: cada sessão toma um lease, avança um milestone, persiste artefato e estado, agenda a próxima execução e termina. Um crash perde uma sessão, não o trabalho inteiro.","en":"A single Edge Function running for 30 hours is fragile architecture. Thesis uses durable jobs: each session takes a lease, advances a milestone, persists artifact and state, schedules the next run, and exits. A crash loses one session, not the whole task.","es":"Una Edge Function viva durante 30 horas es arquitectura frágil. Thesis usa jobs durables: cada sesión toma un lease, avanza un milestone, persiste artefacto y estado, agenda la siguiente ejecución y termina.","fr":"Une Edge Function vivante pendant 30 heures est une architecture fragile. Thesis utilise des jobs durables : chaque session prend un lease, avance un jalon, persiste artefact et état, planifie la suite puis se termine."}]},{"title":{"pt":"Papéis que mudam ao longo da execução","en":"Roles change over the run","es":"Roles que cambian durante la ejecución","fr":"Rôles qui changent pendant l’exécution"},"bullets":[{"pt":"Initializer constrói o ledger material","en":"Initializer builds the material ledger","es":"Initializer construye el ledger material","fr":"Initializer construit le ledger matériel"},{"pt":"Builder implementa o requisito de maior valor","en":"Builder implements the highest-value open requirement","es":"Builder implementa el requisito abierto de mayor valor","fr":"Builder implémente l’exigence ouverte de plus grande valeur"},{"pt":"Verifier tenta falsificar o artefato","en":"Verifier tries to falsify the artifact","es":"Verifier intenta falsificar el artefacto","fr":"Verifier tente de falsifier l’artefact"},{"pt":"Integrator reconcilia contratos e regressões","en":"Integrator reconciles contracts and regressions","es":"Integrator reconcilia contratos y regresiones","fr":"Integrator réconcilie contrats et régressions"},{"pt":"Red-team replanner muda estratégia em plateau","en":"Red-team replanner changes strategy on a plateau","es":"Red-team replanner cambia estrategia en un plateau","fr":"Red-team replanner change de stratégie en plateau"}]},{"title":{"pt":"Handoff estruturado","en":"Structured handoff","es":"Handoff estructurado","fr":"Handoff structuré"},"body":[{"pt":"O checkpoint carrega requisitos, milestones, concluídos, riscos, evidência, próximo passo e confiança. O artefato completo permanece armazenado separadamente. A nova sessão recebe visão compacta do estado sem carregar cada log que levou até ali.","en":"The checkpoint carries requirements, milestones, completed work, risks, evidence, next step, and confidence. The complete artifact remains separately stored. A new session gets a compact state view without carrying every log that led there.","es":"El checkpoint transporta requisitos, milestones, completados, riesgos, evidencia, siguiente paso y confianza. El artefacto completo permanece almacenado aparte.","fr":"Le checkpoint transporte exigences, jalons, éléments terminés, risques, preuves, prochaine étape et confiance. L’artefact complet reste stocké séparément."}]},{"title":{"pt":"Release gate","en":"Release gate","es":"Release gate","fr":"Release gate"},"body":[{"pt":"A tarefa só termina quando requisitos materiais estão concluídos e o gate final independente passa. Se o gate encontra defeito, o job volta para RELEASE-REPAIR em vez de publicar uma conclusão otimista.","en":"The task only ends when material requirements are complete and the independent final gate passes. If the gate finds a defect, the job returns to RELEASE-REPAIR instead of publishing an optimistic completion.","es":"La tarea solo termina cuando los requisitos materiales están completos y el gate final independiente pasa. Si encuentra un defecto, vuelve a RELEASE-REPAIR.","fr":"La tâche ne se termine que lorsque les exigences matérielles sont complètes et que le gate final indépendant passe. S’il trouve un défaut, le job retourne en RELEASE-REPAIR."}]}]},{"slug":"thesis2-test-time-scaling","group":"thesis2","asset":"modelGraph","title":{"pt":"Test-time scaling do Thesis 2.1","en":"Thesis 2.1 test-time scaling","es":"Test-time scaling de Thesis 2.1","fr":"Test-time scaling de Thesis 2.1"},"lead":{"pt":"Como o harness reutiliza trajetórias e concentra compute em incerteza em vez de gerar mais respostas por esporte.","en":"How the harness reuses trajectories and concentrates compute on uncertainty instead of generating more answers for sport.","es":"Cómo el harness reutiliza trayectorias y concentra cómputo en incertidumbre en vez de generar más respuestas por deporte.","fr":"Comment le harness réutilise les trajectoires et concentre le calcul sur l’incertitude au lieu de générer plus de réponses pour le plaisir."},"facts":[{"pt":"resumo de rollout > transcript bruto","en":"rollout summary > raw transcript","es":"resumen de rollout > transcript bruto","fr":"résumé de rollout > transcript brut"},{"pt":"listwise selection","en":"listwise selection","es":"selección listwise","fr":"sélection listwise"},{"pt":"compute adaptativo","en":"adaptive compute","es":"cómputo adaptativo","fr":"calcul adaptatif"}],"sections":[{"title":{"pt":"Representar antes de escalar","en":"Represent before scaling","es":"Representar antes de escalar","fr":"Représenter avant de scaler"},"body":[{"pt":"Em coding longo, uma trajetória inteira contém comandos, erros e tentativas redundantes. O dado útil é a hipótese, o progresso, a falha e a evidência. Thesis 2.1 preserva esse tipo de representação compacta para comparar e reaproveitar experiência sem encher contexto com cada passo.","en":"In long coding work, a whole trajectory contains commands, errors, and redundant attempts. Useful information is hypothesis, progress, failure, and evidence. Thesis 2.1 preserves that compact representation to compare and reuse experience without filling context with every step.","es":"En coding largo, una trayectoria contiene comandos, errores e intentos redundantes. Lo útil es hipótesis, progreso, fallo y evidencia.","fr":"Dans le coding long, une trajectoire contient commandes, erreurs et tentatives redondantes. L’information utile est l’hypothèse, le progrès, l’échec et la preuve."}]},{"title":{"pt":"Parallel-Distill-Refine como princípio","en":"Parallel-Distill-Refine as a principle","es":"Parallel-Distill-Refine como principio","fr":"Parallel-Distill-Refine comme principe"},"body":[{"pt":"Quando várias abordagens existem, o sistema deve destilar o que cada uma aprendeu antes de iniciar outra tentativa. Um novo rollout precisa adicionar hipótese ou evidência; se só repete o que já sabemos, refinamos o melhor candidato.","en":"When several approaches exist, the system should distill what each learned before starting another attempt. A new rollout must add a hypothesis or evidence; if it merely repeats what is already known, we refine the best candidate instead.","es":"Cuando existen varias rutas, el sistema debe destilar lo aprendido antes de iniciar otro intento. Un nuevo rollout debe añadir hipótesis o evidencia.","fr":"Lorsque plusieurs approches existent, le système doit distiller ce que chacune a appris avant une nouvelle tentative. Un nouveau rollout doit ajouter hypothèse ou preuve."}]},{"title":{"pt":"Alocação adaptativa","en":"Adaptive allocation","es":"Asignación adaptativa","fr":"Allocation adaptative"},"body":[{"pt":"A pergunta do controlador é “qual próximo passo pode mudar a decisão?”. Se parse ainda falha, o próximo dólar vai para reparo determinístico. Se parse/build passam mas arquitetura continua ambígua, aí vale um verificador ou branch.","en":"The controller asks “which next step can change the decision?”. If parsing still fails, the next dollar goes to deterministic repair. If parse/build pass but architecture remains ambiguous, a verifier or branch may be worth it.","es":"El controlador pregunta «¿qué siguiente paso puede cambiar la decisión?». Si parse aún falla, el siguiente dólar va a reparación determinista.","fr":"Le contrôleur demande « quelle prochaine étape peut changer la décision ? ». Si le parsing échoue encore, le prochain dollar va à la réparation déterministe."}]},{"title":{"pt":"Métrica que importa","en":"The metric that matters","es":"La métrica que importa","fr":"La métrique qui compte"},"body":[{"pt":"Tokens e número de agentes são custos intermediários. A métrica de produto é resultado aceito por custo e tempo, com regressões e retrabalho contabilizados.","en":"Tokens and agent count are intermediate costs. The product metric is accepted outcome per cost and time, with regressions and rework included.","es":"Tokens y número de agentes son costes intermedios. La métrica de producto es resultado aceptado por coste y tiempo, incluyendo regresiones y retrabajo.","fr":"Les tokens et le nombre d’agents sont des coûts intermédiaires. La métrique produit est le résultat accepté par coût et temps, régressions et retouches incluses."}]}]},{"slug":"thesis2-tool-use","group":"thesis2","asset":"webBraces","title":{"pt":"Tool use sob demanda","en":"On-demand tool use","es":"Uso de herramientas bajo demanda","fr":"Usage d’outils à la demande"},"lead":{"pt":"Pesquisa, plugins e ações locais entram quando são úteis, não como schemas permanentes no contexto.","en":"Search, plugins, and local actions enter when useful, not as permanent schemas in context.","es":"Búsqueda, plugins y acciones locales entran cuando son útiles, no como esquemas permanentes en contexto.","fr":"Recherche, plugins et actions locales entrent quand elles sont utiles, pas comme schémas permanents dans le contexte."},"facts":[{"pt":"progressive disclosure","en":"progressive disclosure","es":"progressive disclosure","fr":"progressive disclosure"},{"pt":"web loop model-driven","en":"model-driven web loop","es":"web loop dirigido por el modelo","fr":"boucle web pilotée par le modèle"},{"pt":"permissões separadas da geração","en":"permissions separated from generation","es":"permisos separados de la generación","fr":"permissions séparées de la génération"}],"sections":[{"title":{"pt":"Descoberta de ferramenta","en":"Tool discovery","es":"Descubrimiento de herramienta","fr":"Découverte d’outil"},"body":[{"pt":"Carregar 150 plugins e dezenas de schemas em toda mensagem gasta contexto antes do problema começar. O runtime resolve primeiro qual família operacional é relevante, carrega apenas o manifesto necessário e deixa o restante fora do contexto.","en":"Loading 150 plugins and dozens of schemas into every message burns context before the problem starts. The runtime first resolves which operational family is relevant, loads only the needed manifest, and keeps the rest out of context.","es":"Cargar 150 plugins y decenas de esquemas en cada mensaje gasta contexto antes de empezar. El runtime resuelve primero qué familia operativa es relevante.","fr":"Charger 150 plugins et des dizaines de schémas à chaque message consomme le contexte avant même de commencer. Le runtime détermine d’abord la famille opérationnelle pertinente."}]},{"title":{"pt":"Loops de web são limitados","en":"Web loops are bounded","es":"Los loops web están limitados","fr":"Les boucles web sont bornées"},"body":[{"pt":"High/Extra podem pedir uma rodada adicional; Max pode pedir até duas. Cada rodada exige consulta focada e justificativa de qual incerteza ela resolve. Isso impede navegação infinita e pesquisa performática.","en":"High/Extra may request one additional round; Max may request up to two. Each round requires focused queries and a reason for which uncertainty it resolves. This prevents infinite browsing and performative research.","es":"High/Extra pueden pedir una ronda adicional; Max hasta dos. Cada ronda exige consultas enfocadas y justificar qué incertidumbre resuelve.","fr":"High/Extra peuvent demander un tour supplémentaire ; Max jusqu’à deux. Chaque tour exige des requêtes ciblées et la justification de l’incertitude résolue."}]},{"title":{"pt":"Ferramenta não vira autoridade","en":"A tool is not authority","es":"Una herramienta no es autoridad","fr":"Un outil n’est pas une autorité"},"body":[{"pt":"Uma página pode conter texto malicioso, um plugin pode falhar e o terminal pode retornar erro. Thesis trata esses outputs como observações. Política, permissões e objetivo continuam vindo do sistema e do usuário.","en":"A page may contain malicious text, a plugin may fail, and terminal output may report an error. Thesis treats those outputs as observations. Policy, permissions, and objective still come from the system and the user.","es":"Una página puede contener texto malicioso, un plugin puede fallar y el terminal puede devolver error. Thesis trata esos outputs como observaciones.","fr":"Une page peut contenir du texte malveillant, un plugin peut échouer et le terminal peut retourner une erreur. Thesis traite ces sorties comme des observations."}]},{"title":{"pt":"Programação para orquestração determinística","en":"Code for deterministic orchestration","es":"Código para orquestación determinista","fr":"Code pour l’orchestration déterministe"},"body":[{"pt":"Deduplicação, filtros, parsing de schemas, montagem de comandos allowlisted e comparação de hashes ficam em código. O modelo usa tokens onde julgamento é necessário.","en":"Deduplication, filters, schema parsing, allowlisted command assembly, and hash comparison stay in code. The model spends tokens where judgment is required.","es":"Deduplicación, filtros, parsing de esquemas, montaje de comandos allowlisted y comparación de hashes quedan en código.","fr":"Déduplication, filtres, parsing de schémas, assemblage de commandes autorisées et comparaison de hashes restent dans le code."}]}]},{"slug":"thesis2-native-actions","group":"thesis2","asset":"codeBubble","title":{"pt":"Protocolo de ações nativas","en":"Native action protocol","es":"Protocolo de acciones nativas","fr":"Protocole d’actions natives"},"lead":{"pt":"Contrato entre resposta do modelo, confirmação do usuário e Desktop Bridge.","en":"Contract between model response, user confirmation, and the Desktop Bridge.","es":"Contrato entre respuesta del modelo, confirmación del usuario y Desktop Bridge.","fr":"Contrat entre réponse du modèle, confirmation utilisateur et Desktop Bridge."},"facts":[{"pt":"ações tipadas","en":"typed actions","es":"acciones tipadas","fr":"actions typées"},{"pt":"sem shell arbitrário","en":"no arbitrary shell","es":"sin shell arbitrario","fr":"pas de shell arbitraire"},{"pt":"resultado do runtime volta como evidência","en":"runtime result becomes evidence","es":"resultado del runtime vuelve como evidencia","fr":"le résultat du runtime devient une preuve"}],"sections":[{"title":{"pt":"Formato","en":"Format","es":"Formato","fr":"Format"},"body":[{"pt":"O gateway extrai markers estruturados fora do texto visível. Hoje existem package_install e write_file. A interface rejeita managers, pacotes ou paths que não passam pela allowlist.","en":"The gateway extracts structured markers outside visible prose. Today it supports package_install and write_file. The interface rejects managers, packages, or paths that do not pass the allowlist.","es":"El gateway extrae markers estructurados fuera del texto visible. Hoy soporta package_install y write_file.","fr":"Le gateway extrait des marqueurs structurés hors du texte visible. Il prend actuellement en charge package_install et write_file."}]},{"title":{"pt":"Execução","en":"Execution","es":"Ejecución","fr":"Exécution"},"body":[{"pt":"No Desktop, package_install é convertido para o comando explícito do package manager e enviado ao endpoint local /terminal. write_file usa /files/apply no workspace ativo. Nada disso existe silenciosamente no navegador.","en":"On Desktop, package_install is converted to the explicit package-manager command and sent to the local /terminal endpoint. write_file uses /files/apply in the active workspace. None of this happens silently in the browser.","es":"En Desktop, package_install se convierte al comando explícito del package manager y se envía al endpoint local /terminal. write_file usa /files/apply.","fr":"Sur Desktop, package_install est converti en commande explicite du gestionnaire de paquets et envoyé à /terminal. write_file utilise /files/apply."}]},{"title":{"pt":"Confirmação humana","en":"Human confirmation","es":"Confirmación humana","fr":"Confirmation humaine"},"body":[{"pt":"A confirmação mostra ação, manager, pacotes ou paths e motivo. Cancelar descarta a mutação sem apagar a resposta do modelo. Esse desacoplamento permite autonomia útil sem dar ao LLM um terminal irrestrito.","en":"Confirmation shows action, manager, packages or paths, and reason. Canceling discards the mutation without deleting the model answer. This separation enables useful autonomy without giving the LLM an unrestricted terminal.","es":"La confirmación muestra acción, manager, paquetes o paths y motivo. Cancelar descarta la mutación sin borrar la respuesta.","fr":"La confirmation montre action, gestionnaire, paquets ou chemins et raison. Annuler supprime la mutation sans effacer la réponse."}]},{"title":{"pt":"Auditoria","en":"Audit","es":"Auditoría","fr":"Audit"},"body":[{"pt":"Sucesso deve vir de exit code, stdout/stderr ou mudança real no filesystem. Se o bridge estiver indisponível, Giorgio informa que a ação exige Desktop e não marca a tarefa como executada.","en":"Success must come from exit code, stdout/stderr, or a real filesystem change. If the bridge is unavailable, Giorgio says the action requires Desktop and does not mark it as executed.","es":"El éxito debe venir de exit code, stdout/stderr o cambio real en filesystem. Si el bridge no está disponible, Giorgio informa que la acción requiere Desktop.","fr":"Le succès doit provenir du code de sortie, stdout/stderr ou d’un changement réel du système de fichiers. Si le bridge est indisponible, Giorgio indique que l’action nécessite Desktop."}]}]},{"slug":"plugin-contracts","group":"thesis2","asset":"codeBraces","title":{"pt":"Contratos dos plugins","en":"Plugin contracts","es":"Contratos de plugins","fr":"Contrats des plugins"},"lead":{"pt":"Como especializações ficam mais profundas sem entupir o contexto do modelo.","en":"How specializations become deeper without clogging the model context.","es":"Cómo las especializaciones se vuelven más profundas sin saturar el contexto del modelo.","fr":"Comment les spécialisations gagnent en profondeur sans saturer le contexte du modèle."},"facts":[{"pt":"role → method → deliverable → verify","en":"role → method → deliverable → verify","es":"role → method → deliverable → verify","fr":"role → method → deliverable → verify"},{"pt":"manifest action","en":"manifest action","es":"manifest action","fr":"manifest action"},{"pt":"retrieval policy por domínio","en":"per-domain retrieval policy","es":"política de retrieval por dominio","fr":"politique de retrieval par domaine"}],"sections":[{"title":{"pt":"Contrato mínimo","en":"Minimum contract","es":"Contrato mínimo","fr":"Contrat minimal"},"body":[{"pt":"Um plugin completo precisa dizer não só “sou especialista em X”, mas como trabalha, o que entrega, quais checks definem qualidade e quando precisa buscar informação externa. O core v8 expõe esse manifesto sob demanda.","en":"A complete plugin must say not only “I specialize in X”, but how it works, what it delivers, which checks define quality, and when external retrieval is required. Core v8 exposes that manifest on demand.","es":"Un plugin completo debe decir no solo «soy especialista en X», sino cómo trabaja, qué entrega, qué checks definen calidad y cuándo necesita información externa.","fr":"Un plugin complet doit dire non seulement « je suis spécialiste de X », mais comment il travaille, ce qu’il livre, quels checks définissent la qualité et quand une recherche externe est requise."}]},{"title":{"pt":"Especialização sem isolamento","en":"Specialization without isolation","es":"Especialización sin aislamiento","fr":"Spécialisation sans isolement"},"body":[{"pt":"Plugins de engenharia e design continuam usando o mesmo repositório cognitivo e validators do Code quando a tarefa vira implementação. A especialidade adiciona método; não cria uma ilha com lógica de qualidade inferior.","en":"Engineering and design plugins continue using the same cognitive repository and Code validators when a task becomes implementation. The specialty adds method; it does not create an island with weaker quality logic.","es":"Plugins de engineering y design siguen usando el mismo repositorio cognitivo y validators de Code cuando la tarea pasa a implementación.","fr":"Les plugins engineering et design continuent d’utiliser le même dépôt cognitif et les validateurs de Code quand la tâche devient une implémentation."}]},{"title":{"pt":"Políticas de evidência diferentes","en":"Different evidence policies","es":"Políticas de evidencia diferentes","fr":"Politiques de preuve différentes"},"body":[{"pt":"Legal e finanças tratam recência como requisito forte; PDF viewer privilegia o arquivo fornecido; design busca documentação externa apenas quando capacidade de plataforma ou referência atual muda a decisão. O runtime não aplica a mesma receita a todos os domínios.","en":"Legal and finance treat freshness as a strong requirement; PDF viewer prioritizes the supplied file; design retrieves external documentation only when platform capability or current reference changes the decision. The runtime does not apply one recipe to every domain.","es":"Legal y finanzas tratan la actualidad como requisito fuerte; PDF viewer prioriza el archivo; design busca documentación externa solo cuando cambia la decisión.","fr":"Juridique et finance traitent l’actualité comme exigence forte ; PDF viewer privilégie le fichier fourni ; design ne recherche de documentation externe que lorsque cela change la décision."}]},{"title":{"pt":"Observabilidade","en":"Observability","es":"Observabilidad","fr":"Observabilité"},"body":[{"pt":"O retorno identifica slug, protocolo, manifesto e se a especialização foi aplicada. Isso deixa diagnóstico possível quando um plugin é mapeado para a família errada ou produz um entregável fora do contrato.","en":"The response identifies slug, protocol, manifest, and whether specialization was applied. This makes diagnosis possible when a plugin is mapped to the wrong family or produces an out-of-contract deliverable.","es":"La respuesta identifica slug, protocolo, manifiesto y si se aplicó la especialización.","fr":"La réponse identifie slug, protocole, manifeste et si la spécialisation a été appliquée."}]}]}],"learn":[{"id":"ai-foundations","title":"Machine Learning Systems: Estatística, Dados e Avaliação","credentialTitle":"Applied Machine Learning Systems: Statistical Learning, Data and Evaluation","level":"Profissional · Avançado","hours":24,"cover":"modelPaper","skills":["Statistical learning","Data leakage prevention","Calibration","Decision-aware evaluation","Experiment design"],"description":"Formulação estatística, desenho de dados, generalização, calibração, avaliação por decisão e operação de pipelines de ML sob restrições reais de produção.","lessons":[{"id":"problem","title":"1. Formulação estatística, leakage e desenho de distribuição","body":["Um sistema de IA começa antes do modelo. Defina a variável-alvo, a unidade de decisão, o custo dos erros e a distribuição em que o sistema será usado. A mesma métrica pode parecer excelente em um conjunto de teste e falhar em produção se o conjunto não representar a operação real.","Separe correlação de utilidade causal. Em classificação, escolha limiar conforme custo de falso positivo e falso negativo. Em regressão, confirme se erro absoluto, quadrático ou relativo representa a decisão de negócio."],"points":["target, features e leakage","distribuição de treino vs. produção","baseline simples antes de complexidade","métrica ligada ao custo real"],"lab":"Escreva uma especificação de uma página para um problema de ML: entrada, saída, baseline, métrica primária e três modos de falha."},{"id":"math","title":"2. Likelihood, otimização, regularização e generalização","body":["Probabilidade fornece a linguagem para incerteza; otimização fornece o mecanismo de ajuste. A loss é uma função operacional, não uma medida universal de inteligência. Gradiente descendente move parâmetros na direção que reduz a loss localmente, enquanto regularização limita soluções que memorizam o treino.","Bias e variance aparecem quando o modelo é simples demais ou sensível demais aos dados. Generalização deve ser medida em dados não usados na seleção do modelo; usar o conjunto de teste repetidamente transforma-o, na prática, em parte do treino."],"points":["log-loss e MSE","gradiente e learning rate","regularização L1/L2","train/validation/test"],"lab":"Calcule à mão uma atualização de gradiente para uma função quadrática e explique o efeito de dobrar o learning rate."},{"id":"models","title":"3. Inductive bias, ensembles e seleção sob restrições","body":["Regressão linear, árvores, ensembles, k-NN e redes neurais impõem diferentes hipóteses sobre a estrutura do problema. Árvores lidam bem com interações e dados tabulares; modelos lineares são fáceis de auditar; redes neurais brilham quando representação precisa ser aprendida de dados de alta dimensão.","O melhor modelo não é o maior. Compare qualidade, latência, memória, interpretabilidade, volume de dados e custo de manutenção. Um baseline competitivo frequentemente revela que o gargalo está nos dados, não na arquitetura."],"points":["linear e logística","árvores e gradient boosting","redes neurais","trade-off qualidade/custo"],"lab":"Treine mentalmente um ranking de três modelos para fraude tabular e justifique qual você colocaria primeiro em produção."},{"id":"pipeline","title":"4. Sistemas de treinamento, lineage e reproducibilidade","body":["Um pipeline reproduzível versiona dados, transformação, split, hiperparâmetros, seed e artefatos. Pré-processamento deve ser ajustado apenas no treino e aplicado depois à validação/teste, evitando vazamento estatístico.","Em produção, monitore drift de entrada, mudança de prevalência, qualidade por subgrupo e atraso entre predição e rótulo real. Sem observabilidade, um modelo pode degradar silenciosamente por semanas."],"points":["versionamento de dados","pipelines sem leakage","experimentos reproduzíveis","drift e monitoring"],"lab":"Desenhe um pipeline com ingestão, validação, split temporal, treino, avaliação, registro e monitoramento."},{"id":"evaluation","title":"5. Avaliação decision-aware, calibração e uncertainty","body":["Accuracy sozinha é insuficiente em classes desbalanceadas. Precision e recall mudam com o limiar; AUROC mede ordenação global, enquanto AUPRC é mais informativa quando positivos são raros. Calibração pergunta se probabilidades previstas correspondem à frequência observada.","Faça análise de erros por fatias: geografia, dispositivo, faixa de valor, tempo e fontes de dados. Um número agregado pode esconder falhas graves em segmentos pequenos mas importantes."],"points":["precision/recall/F1","ROC vs PR","calibração","slice-based evaluation"],"lab":"Monte uma matriz de confusão e escolha um limiar diferente para dois cenários com custos de erro opostos."}]},{"id":"deep-learning","title":"Deep Learning Systems Engineering com PyTorch","credentialTitle":"Deep Learning Systems Engineering with PyTorch","level":"Profissional · Avançado","hours":28,"cover":"modelGraph","skills":["PyTorch systems","Autograd and VJP","Mixed precision","GPU profiling","Reproducible training"],"description":"Treinamento de redes profundas como sistema: autograd, estabilidade numérica, otimização, mixed precision, profiling, experimentação e debugging reproduzível.","lessons":[{"id":"autograd","title":"1. Autograd, grafos dinâmicos e backpropagation auditável","body":["Redes neurais são programas diferenciáveis. O forward constrói ativações; o backward aplica a regra da cadeia para obter derivadas da loss em relação aos parâmetros. Em PyTorch, o grafo dinâmico facilita condicionais e debugging, mas exige cuidado com detach, no_grad e operações in-place.","Gradientes acumulam por padrão. Portanto, zerar gradients, executar backward e então optimizer.step é parte explícita do ciclo. Inspecionar normas de gradiente ajuda a detectar exploding/vanishing gradients."],"points":["grafo computacional","regra da cadeia","grad accumulation","detach/no_grad"],"lab":"Implemente mentalmente um training loop mínimo e liste em ordem zero_grad, forward, loss, backward e step."},{"id":"optimization","title":"2. Otimização, schedules e estabilidade de treinamento","body":["AdamW combina momentos adaptativos com weight decay desacoplado e é um baseline forte. SGD com momentum ainda pode generalizar muito bem. Scheduler, warmup e clipping são mecanismos diferentes: warmup estabiliza o início, scheduler reduz ou adapta a taxa, clipping limita picos de gradiente.","Inicialização precisa preservar escala das ativações e gradients. Xavier e He derivam de hipóteses sobre variância; em Transformers, normalização e parametrização mudam a dinâmica e frequentemente pedem recipes próprios."],"points":["AdamW vs SGD","warmup e decay","gradient clipping","Xavier/He"],"lab":"Projete um recipe inicial para um modelo instável nas primeiras 500 steps e justifique warmup, clipping e weight decay."},{"id":"architectures","title":"3. Representações, convolução, sequência e attention","body":["CNNs usam compartilhamento local de pesos, tornando-as eficientes para padrões espaciais. RNNs/LSTMs modelam sequência por estado recorrente, mas têm caminho serial. Attention remove grande parte dessa serialidade e permite relações diretas entre posições.","Escolha arquitetura pelo inductive bias, não pela moda. Para imagem pequena com poucos dados, augmentations e um backbone pré-treinado podem superar um modelo enorme treinado do zero."],"points":["convolution/receptive field","recurrent state","attention","transfer learning"],"lab":"Compare CNN, LSTM e Transformer para três tipos de dados e explique a restrição dominante em cada escolha."},{"id":"precision","title":"4. Mixed precision, memória, kernels e throughput","body":["FP16/BF16 reduzem memória e aumentam throughput em hardware moderno. BF16 preserva faixa de expoente maior e tende a ser mais estável; FP16 pode precisar de loss scaling. Mixed precision mantém partes sensíveis, como certos acumuladores, em precisão maior.","Batch size interage com memória, estatística do gradiente e utilização de GPU. Gradient accumulation simula batch maior sem manter todas as amostras simultaneamente em memória, mas aumenta steps de compute por update."],"points":["BF16/FP16","loss scaling","gradient accumulation","profiling"],"lab":"Faça um plano para dobrar batch efetivo sem dobrar VRAM e diga quais métricas de throughput você mediria."},{"id":"debug","title":"5. Debugging sistemático, ablations e reproducibilidade","body":["Quando o treino falha, reduza o problema. Tente overfit em um batch minúsculo; verifique labels; compare loss antes/depois de uma step; monitore grad norms; desative augmentations; confirme shapes e masks. Essa sequência encontra bugs muito mais rápido do que ajustar hiperparâmetros aleatoriamente.","Ablations devem mudar uma variável por vez e usar seeds suficientes quando o ruído importa. Registre tempo, tokens ou exemplos vistos, não só epochs, para comparar compute de forma justa."],"points":["overfit-one-batch","sanity checks","ablation","reproducibility"],"lab":"Crie uma checklist de dez minutos para investigar uma loss que não cai desde a primeira step."}]},{"id":"transformers-llms","title":"Transformer & Large Language Model Engineering","credentialTitle":"Transformer and Large Language Model Engineering","level":"Profissional · Avançado","hours":32,"cover":"codeBraces","skills":["Tokenization","Attention and KV cache","Pretraining systems","Post-training","Long-context evaluation"],"description":"Tokenização, attention, pré-treino, pós-treino e long context tratados como decisões de arquitetura, dados, otimização e serving, não como vocabulário de paper.","lessons":[{"id":"tokenization","title":"1. Tokenização, eficiência multilingual e representação","body":["Tokenizadores BPE/Unigram comprimem texto em unidades reutilizáveis. Vocabulário maior reduz comprimento médio, mas aumenta matriz de embeddings e pode piorar cobertura rara. Byte fallback evita tokens desconhecidos e é importante em código, nomes e idiomas menos representados.","A tokenização muda custo de contexto e fairness. Compare tokens por caractere entre idiomas e domínios; um modelo que usa o dobro de tokens para a mesma informação paga mais compute e perde janela efetiva."],"points":["BPE/Unigram","byte fallback","vocab size","multilingual efficiency"],"lab":"Meça conceitualmente como um tokenizer enviesado pode reduzir contexto útil para um idioma sem mudar o limite nominal."},{"id":"attention","title":"2. Attention, KV state e arquiteturas de contexto","body":["Queries consultam keys e combinam values. O produto QKᵀ cria scores; softmax normaliza; causal mask impede olhar o futuro. Multi-head attention permite subespaços diferentes, mas KV cache cresce com sequência, camadas e número de heads KV.","GQA/MQA reduzem KV heads. MLA comprime estados latentes de key/value. Attention local ou linear reduz custo, mas pode sacrificar acesso exato de longo alcance. Não existe uma única variante melhor para todos os regimes."],"points":["Q/K/V","causal mask","KV cache","GQA/MLA/local attention"],"lab":"Estime qualitativamente o que acontece com KV cache ao dobrar contexto mantendo o resto fixo."},{"id":"pretraining","title":"3. Pré-treino, data mixtures e scaling sob compute fixo","body":["Next-token prediction cria um sinal de treino denso e geral. Qualidade depende de mistura de dados, deduplicação, filtering, tokenizer, optimizer e schedule. Parâmetros sozinhos não definem capacidade; compute e dados vistos importam igualmente.","Scaling laws orientam alocação de compute, mas recipes reais precisam considerar limite de memória, largura de banda e tempo de wall-clock. Dados de baixa qualidade podem dominar o erro quando o modelo cresce."],"points":["causal LM objective","data mixture","deduplication","compute-optimal trade-offs"],"lab":"Defina três métricas para auditar uma mistura de pré-treino além do número total de tokens."},{"id":"posttraining","title":"4. SFT, preference optimization e pós-treino mensurável","body":["Supervised fine-tuning ensina formato e comportamento a partir de demonstrações. Preference optimization usa pares ou sinais de preferência para aumentar probabilidade de respostas desejadas. DPO é uma formulação direta; RL pode otimizar recompensas mais complexas, mas aumenta instabilidade e risco de reward hacking.","Pós-treino não cria conhecimento mágico. Ele reorganiza comportamento e pode melhorar raciocínio quando treino inclui tarefas e verificadores adequados, mas também pode degradar competências se a mistura for estreita."],"points":["SFT","DPO","RL/reward models","catastrophic trade-offs"],"lab":"Compare quando você escolheria SFT, DPO e RL baseado em disponibilidade de dados e verificadores."},{"id":"context","title":"5. Long context, posição, retrieval e memória","body":["RoPE codifica posição por rotação em subespaços; extrapolação requer cuidado. Janelas longas elevam KV cache e podem sofrer lost-in-the-middle. Retrieval e memória externa são complementares ao contexto bruto, não simples substitutos.","Avalie long context com passkey, needle, multi-hop e tarefas que exigem integração real. Um modelo pode passar needle simples e falhar ao combinar fatos distantes."],"points":["RoPE","context extension","lost-in-the-middle","retrieval vs context"],"lab":"Crie um teste de long-context que exija combinar três fatos separados, evitando um simples lookup."}]},{"id":"rag-memory","title":"Retrieval, RAG, Tooling & Memory Systems","credentialTitle":"Retrieval-Augmented Generation, Tooling and Memory Systems","level":"Profissional · Avançado","hours":28,"cover":"memoryBraces","skills":["Hybrid retrieval","Reranking","Grounding and provenance","Tool orchestration","Memory evaluation"],"description":"Arquitetura de recuperação e grounding para sistemas que precisam encontrar, citar, versionar e usar evidência confiável com ferramentas e memória persistente.","lessons":[{"id":"retrieval","title":"1. Retrieval híbrido, chunking e reranking","body":["Embeddings capturam similaridade semântica; busca lexical preserva termos exatos. Sistemas fortes combinam BM25/lexical com vetores e depois rerank. O objetivo não é recuperar documentos parecidos, mas evidência suficiente para responder a pergunta.","Chunking deve respeitar estrutura e unidade semântica. Chunks grandes aumentam recall contextual mas desperdiçam janela; pequenos aumentam precisão mas podem separar premissas."],"points":["dense + sparse","chunking","hybrid search","reranking"],"lab":"Projete uma estratégia híbrida para documentação técnica onde nomes de funções exatos e semântica são igualmente importantes."},{"id":"grounding","title":"2. Grounding, provenance, citações e freshness","body":["Cada afirmação verificável deve ser rastreável à evidência usada. Guarde source id, trecho, timestamp e transformação. Se fonte está desatualizada ou contraditória, o modelo precisa dizer isso em vez de fundir versões silenciosamente.","Context packing deve remover duplicatas e ordenar evidência por utilidade, não simplesmente encher a janela. Mais contexto pode piorar resposta quando contém distractors."],"points":["provenance","citation mapping","freshness","context packing"],"lab":"Crie um esquema mínimo de evidence object capaz de provar de onde veio cada fato."},{"id":"tools","title":"3. Tool contracts, idempotência e autoridade de resultados","body":["Ferramentas transformam o modelo em coordenador de ações. Um tool schema precisa de nomes claros, parâmetros tipados e erros explícitos. A ferramenta, não o modelo, deve ser autoridade para fatos que ela mede ou ações que ela executa.","Planejamento deve preferir o caminho mais estruturado: API/connector antes de automação de tela. Idempotência e confirmação são essenciais em writes; retries ingênuos podem duplicar pagamentos ou mensagens."],"points":["typed schemas","idempotency","read vs write","tool-result authority"],"lab":"Desenhe uma tool de transferência financeira que seja segura contra retry duplicado sem esconder confirmação do usuário."},{"id":"memory","title":"4. Working, episodic e semantic memory sob orçamento","body":["Contexto recente funciona como working memory. Episodic memory guarda eventos específicos; semantic memory consolida padrões e fatos duráveis. Misturar tudo em um único vetor torna difícil atualizar, expirar e explicar origem.","Escrita de memória deve ser seletiva. Sinais úteis incluem instruções persistentes, entidades recorrentes, decisões e dependências abertas. Dados sensíveis e detalhes efêmeros pedem políticas próprias."],"points":["working/episodic/semantic","memory write policy","expiry/versioning","retrieval triggers"],"lab":"Classifique dez exemplos de informação em working, episodic, semantic ou discard e justifique duas exceções."},{"id":"evaluation","title":"5. Evals de retrieval, grounding e tool execution","body":["Avalie retrieval separado da geração: recall@k, MRR/nDCG e cobertura de evidência. Depois avalie groundedness, correção, completude e qualidade de citação. Se misturar tudo em uma nota única, você não sabe se o erro veio da busca ou do modelo.","Para ferramentas, registre success rate, tool selection, parameter accuracy, recovery após erro e efeitos colaterais. Use tarefas reproduzíveis com outcomes verificáveis."],"points":["retrieval metrics","groundedness","citation correctness","tool success"],"lab":"Monte uma matriz de avaliação que consiga distinguir falha de retrieval, falha de rerank e alucinação na geração."}]},{"id":"agents","title":"Agentic Systems Engineering & Multi-Agent Orchestration","credentialTitle":"Agentic Systems Engineering and Multi-Agent Orchestration","level":"Profissional · Avançado","hours":30,"cover":"codeBubble","skills":["Durable agent architecture","Planning","Tool contracts","Multi-agent orchestration","Recovery and verification"],"description":"Agentes tratados como sistemas distribuídos com estado, ferramentas, planejamento, retries, checkpoints, verificação externa e critérios claros de parada.","lessons":[{"id":"loop","title":"1. Agent loop, estado tipado e event sourcing","body":["Um agente útil alterna observar, decidir, agir e verificar. Estado deve separar objetivo, contexto, plano, ferramentas, artefatos e resultados. Sem essa separação, o histórico vira um prompt monolítico difícil de corrigir.","Cada ação deve produzir um evento observável e um estado novo. Isso permite resumir longas execuções, retomar de checkpoint e auditar por que um passo ocorreu sem expor raciocínio privado."],"points":["observe-decide-act-verify","typed state","event log","checkpoints"],"lab":"Modele um estado mínimo para um agente de software que pode editar arquivos e executar testes."},{"id":"planning","title":"2. Planejamento adaptativo, DAGs e acceptance criteria","body":["Planos são úteis quando há dependências, risco ou custo alto de erro. Para tarefas triviais, planejar demais só acrescenta latência. Um controller pode decidir entre execução direta, plano curto ou decomposição em subtarefas.","Cada subtarefa precisa de critério de aceitação. 'Melhorar frontend' é ruim; 'reproduzir layout X, manter rotas Y e passar checks Z' é verificável."],"points":["adaptive planning","task graph","acceptance criteria","dependency ordering"],"lab":"Converta uma tarefa vaga de produto em quatro subtarefas com critérios de aceitação mensuráveis."},{"id":"multiagent","title":"3. Delegação, handoffs e erros correlacionados","body":["Subagentes funcionam melhor quando escopo e interface são estreitos. Um pesquisador pode devolver evidências; um implementador, patch; um reviewer, findings. Duplicar o mesmo prompt em cinco agentes sem diversidade de função só multiplica custo.","O coordenador precisa resolver conflitos, verificar saídas e controlar budget. Consenso não garante verdade se todos compartilham o mesmo erro."],"points":["role specialization","structured handoff","coordinator","correlated errors"],"lab":"Desenhe um fluxo com pesquisador, implementador e reviewer em que nenhum subagente possa aprovar sozinho sua própria saída."},{"id":"recovery","title":"4. Failure recovery, idempotência e durable execution","body":["Agentes longos falham por rede, quota, ferramenta, estado stale ou erro lógico. Retry deve considerar classe de falha e backoff. Um erro determinístico de schema não melhora repetindo a mesma chamada; um 429 pode melhorar esperando.","Persistência de checkpoint deve ser atômica: salve o que foi concluído e o próximo passo, evitando repetir ações externas após reinício."],"points":["failure taxonomy","backoff","idempotency","durable checkpoint"],"lab":"Crie uma tabela que diferencie retry imediato, retry com backoff, reparo e stop para cinco classes de falha."},{"id":"verification","title":"5. Verificação, stop conditions e budgeted reasoning","body":["Confidence do mesmo modelo é fraca como única regra de parada. Use checks externos quando existem: testes, schemas, invariants, fontes, compilação e outcomes. Em tarefas abertas, combine progresso, cobertura de requisitos e budget.","Overthinking é real: continuar depois de uma solução suficiente pode introduzir regressões. Stop conditions precisam detectar tanto insuficiência quanto deterioração."],"points":["external verifier","progress signal","budget","overthinking"],"lab":"Defina um stop rule para um agente de código que evite encerrar com testes falhando e também evite loops infinitos."}]},{"id":"evaluation-safety","title":"Model Evaluation, Alignment & AI Safety Engineering","credentialTitle":"Model Evaluation, Alignment and AI Safety Engineering","level":"Profissional · Avançado","hours":26,"cover":"browserDoc","skills":["Evaluation design","LLM judges","Statistical benchmarking","Red teaming","Alignment and safety engineering"],"description":"Evals, verificadores, LLM-as-judge, red teaming, segurança de ferramentas e alinhamento analisados com validade de construto, incerteza e release gates.","lessons":[{"id":"evaldesign","title":"1. Construct validity, datasets e desenho de evals","body":["Uma eval começa com capacidade alvo e distribuição de tarefas. Defina unidade de análise, scoring, baseline, incerteza e critérios de exclusão antes de olhar resultados. Caso contrário, você ajusta a prova ao modelo.","Holdout precisa ficar fora do ciclo de desenvolvimento. Se exemplos vazam para prompts, RAG, treino ou debugging, o score deixa de estimar generalização."],"points":["construct validity","holdout integrity","baseline","uncertainty"],"lab":"Especifique uma eval de instruction following com rubrica e um conjunto holdout que não possa entrar no desenvolvimento."},{"id":"judges","title":"2. LLM-as-judge, verificadores e calibração humana","body":["Model judges escalam avaliação aberta, mas carregam vieses de posição, estilo e preferência de modelo. Calibre contra humanos e use pairwise/randomized order quando possível. Em tarefas determinísticas, prefira verificador exato.","Um bom pipeline separa judge de geração e registra versão/prompt do judge. Trocar o judge no meio de uma série quebra comparabilidade."],"points":["judge bias","pairwise","human calibration","deterministic verifier"],"lab":"Projete um experimento A/B onde a ordem das respostas é randomizada para medir position bias do judge."},{"id":"benchmarks","title":"3. Benchmarks, incerteza, contaminação e error analysis","body":["Pontuação sem intervalo de confiança pode superinterpretar diferenças minúsculas. Bootstrap ou testes adequados ajudam a estimar incerteza. Benchmarks públicos também sofrem contamination e overfitting comunitário.","Leia por categoria e erro, não só leaderboard agregado. Melhor média pode esconder regressão severa em safety, coding ou long context."],"points":["confidence intervals","contamination","category breakdown","error analysis"],"lab":"Explique por que uma diferença de 0,4 ponto pode não ser evidência suficiente sem tamanho de amostra e variância."},{"id":"redteam","title":"4. Red teaming, prompt injection e tool safety","body":["Red teaming busca modos de falha adversariais: prompt injection, exfiltração, autorização incorreta, manipulação de ferramentas e jailbreaks. Para agentes, trate outputs de páginas e arquivos como dados não confiáveis, nunca como instruções privilegiadas.","Least privilege limita dano: tools devem expor apenas ações necessárias; writes sensíveis usam confirmação, escopo e logs."],"points":["prompt injection","least privilege","authorization","sandboxing"],"lab":"Crie três ataques contra um agente conectado a e-mail e três controles técnicos correspondentes."},{"id":"alignment","title":"5. Alignment, false refusal e trade-offs de utilidade","body":["Alinhamento operacional é maximizar utilidade sob restrições de segurança e intenção. Regras excessivamente genéricas podem reduzir utilidade; regras fracas deixam ações perigosas. O sistema precisa distinguir contexto, risco e autoridade.","Meça false refusal, harmful compliance e task success em conjunto. Otimizar apenas um deles empurra o sistema para um extremo."],"points":["helpfulness/safety","false refusal","harmful compliance","policy evaluation"],"lab":"Desenhe um painel de três métricas que impeça otimizar safety simplesmente recusando tudo."}]},{"id":"inference-systems","title":"LLM Inference, GPU Performance & Distributed Serving","credentialTitle":"LLM Inference, GPU Performance and Distributed Serving","level":"Profissional · Avançado","hours":30,"cover":"globeHand","skills":["GPU performance","KV and paged attention","Quantization","Continuous batching","Distributed inference"],"description":"Serving de LLMs pelo caminho crítico real: prefill, decode, KV cache, quantização, batching, kernels, paralelismo e análise de p95/p99 sob carga.","lessons":[{"id":"bottlenecks","title":"1. Roofline mental: compute, bandwidth, prefill e decode","body":["Decode autoregressivo frequentemente é memory-bandwidth bound: a cada token, grandes pesos precisam ser lidos enquanto o batch pode ser pequeno. Prefill, por outro lado, tende a usar mais compute paralelo. Essa diferença explica por que otimizações de prefill e decode não são idênticas.","Meça time-to-first-token, inter-token latency, throughput e tail latency. Um único tokens/s agregado não descreve experiência de usuário nem capacidade do servidor."],"points":["prefill vs decode","memory bandwidth","TTFT/ITL","p95/p99"],"lab":"Dado um serviço com TTFT bom e ITL ruim, liste três gargalos plausíveis específicos de decode."},{"id":"kv","title":"2. KV cache, paging, prefix reuse e eviction","body":["KV cache evita recomputar keys/values de tokens passados. Cresce com batch, contexto, layers, heads KV e dimensão. Paged attention reduz fragmentação e permite alocar blocos de cache sob demanda.","Prefix caching reutiliza contexto comum entre requests. É poderoso para system prompts e documentos repetidos, mas exige chave de cache correta e invalidação quando o prefixo muda."],"points":["KV sizing","paged attention","prefix caching","eviction"],"lab":"Faça um orçamento de memória qualitativo para pesos + KV + workspace e explique por que deixar margem é necessário."},{"id":"quant","title":"3. Quantização, FP8 e regressão de qualidade","body":["INT8/FP8/INT4 reduzem bytes por parâmetro, mas erro de quantização depende de distribuição de pesos/ativações e calibração. Weight-only quantization afeta caminho diferente de quantização de ativações ou KV cache.","Use precisão híbrida: mantenha operações sensíveis em BF16/FP32 quando necessário. O objetivo é Pareto de qualidade, throughput e memória, não o menor bitwidth possível."],"points":["weight-only","activation quantization","FP8 KV","quality regression"],"lab":"Projete uma ablation que compare pesos 4-bit com KV BF16 versus pesos 4-bit com KV FP8."},{"id":"batching","title":"4. Continuous batching, scheduling e fairness","body":["Continuous batching adiciona e remove sequências do batch conforme terminam, elevando utilização. Scheduler precisa equilibrar prefill pesado e decode sensível à latência. Chunked prefill pode impedir um prompt gigante de bloquear todos os decodes.","Políticas de prioridade e quotas evitam que uma única tarefa longa monopolize HBM e compute. Em multi-tenant, fairness é requisito de produto."],"points":["continuous batching","chunked prefill","scheduler","fairness"],"lab":"Desenhe uma política de scheduler que preserve chat interativo enquanto aceita jobs longos em background."},{"id":"parallel","title":"5. TP/PP/EP, comunicação e speculative decoding","body":["Tensor parallel divide operações dentro de camadas; pipeline parallel divide layers; expert parallel distribui experts MoE. Cada estratégia troca memória por comunicação. Dentro de um único nó, links rápidos reduzem custo, mas comunicação ainda não é grátis.","Speculative decoding propõe múltiplos tokens com um draft e verifica em lote no modelo alvo. Ganho depende da taxa de aceitação e do custo relativo entre draft e verifier."],"points":["TP/PP/EP","communication cost","speculative decoding","acceptance rate"],"lab":"Compare TP e EP para um MoE e diga qual comunicação acontece por token em cada caso."}]},{"id":"llm-production","title":"Production LLM Platforms: Reliability, APIs & Observability","credentialTitle":"Production LLM Platforms: Reliability, APIs and Observability","level":"Profissional · Avançado","hours":28,"cover":"browserCursor","skills":["API and model registry","Caching","Observability","Backpressure","SLO and release engineering"],"description":"Engenharia de plataforma para LLMs: contratos de API, model registry, caching, tracing, rate limits, filas, SLOs, canary releases e degradação controlada.","lessons":[{"id":"contract","title":"1. API contracts, model registry e compatibility","body":["Separe ID público estável, snapshot imutável e alias móvel. Clientes devem depender do contrato de request/response, não do fornecedor interno. Deprecação precisa de replacement e data de sunset.","Campos de telemetria como requested_model, served_model e provider_model evitam esconder fallback. Se o modelo servido mudou, isso é dado operacional relevante."],"points":["stable IDs","snapshots","aliases","deprecation"],"lab":"Defina um registry com cinco campos mínimos que permita trocar runtime sem quebrar cliente."},{"id":"caching","title":"2. Prefix/semantic caching, invalidation e tenant isolation","body":["Cache de prefixo, retrieval e resposta reduzem custo, mas cada um precisa de chave e invalidação diferentes. Cache de resposta exige considerar modelo, versão, prompt, tools, temperatura e dados dependentes do tempo.","Nunca cacheie silenciosamente uma resposta que depende de identidade ou permissão sem incluir o escopo do usuário na chave."],"points":["prefix cache","semantic cache","invalidation","tenant isolation"],"lab":"Crie uma chave de cache segura para uma resposta que depende de modelo, versão e usuário."},{"id":"observability","title":"3. Telemetria, tracing e token accounting","body":["Registre latency por etapa, tokens de entrada/saída, cache hits, tool calls, erros, retries e modelo realmente servido. Trace IDs ligam frontend, gateway, provider e persistência.","Logs não devem armazenar segredos ou chain-of-thought. Observabilidade boa mede estado operacional suficiente para reproduzir falhas sem coletar tudo."],"points":["trace id","token accounting","error classes","privacy-aware logs"],"lab":"Desenhe um evento de telemetry que seja útil para debugging sem guardar o prompt completo."},{"id":"reliability","title":"4. Backpressure, filas, retries e degraded modes","body":["TPM/RPM/TPD são recursos compartilhados. Governor deve reservar budget antes da chamada, registrar uso real e respeitar Retry-After. Repetir imediatamente um 429 agrava a fila.","Degradação precisa ser explícita: se uma etapa de review foi omitida por budget, marque isso. Não retorne 200 fingindo qualidade completa quando o pipeline falhou."],"points":["quota governor","backpressure","Retry-After","degraded mode"],"lab":"Projete um fluxo para request que excede o budget do minuto mas pode esperar 20 segundos."},{"id":"slo","title":"5. SLOs, custo por tarefa e release engineering","body":["Defina SLOs por experiência: TTFT, completion success, p95, taxa de erro, groundedness ou test pass rate conforme o produto. Um único uptime não captura qualidade do modelo.","Release gates devem combinar regressão de evals, custo e latency. Quando uma versão nova melhora 2% qualidade mas dobra p95, a decisão depende do canal e do valor daquele ganho."],"points":["SLO","quality gates","cost per task","canary release"],"lab":"Monte um release gate com três métricas de qualidade e duas operacionais para um modelo de produção."}]},{"id":"frontier-architecture","title":"Frontier Model Architecture: MoE, Efficient Attention & Memory","credentialTitle":"Frontier Model Architecture: MoE, Efficient Attention and Memory","level":"Profissional · Research","hours":34,"cover":"webBraces","skills":["Mixture of Experts","Efficient attention","Neural memory","Adaptive compute","Ablation and scaling research"],"description":"Pesquisa de arquitetura com MoE, attention eficiente, memória e adaptive compute, sempre com baseline justo, ablations, profiling e análise Pareto antes de qualquer claim.","lessons":[{"id":"moe","title":"1. Mixture of Experts: routing, capacity e load balance","body":["MoE aumenta parâmetros totais sem ativar todos por token. Router escolhe top-k experts; capacidade por expert e balanceamento evitam overload. Shared experts preservam competências comuns enquanto routed experts especializam.","Load balancing excessivo pode impedir especialização; balanceamento fraco causa collapse. Avalie distribuição de tokens, expert entropy, dropped tokens e qualidade por domínio."],"points":["top-k routing","capacity factor","shared experts","router collapse"],"lab":"Desenhe uma métrica que detecte quando dois experts recebem 80% dos tokens mesmo com perplexity aparentemente boa."},{"id":"efficient-attention","title":"2. Efficient attention, recurrent state e híbridos","body":["MLA comprime KV em representação latente. Linear/recurrent attention mantém estado compacto e custo melhor em sequência longa, mas pode perder recuperação exata. Arquiteturas híbridas usam attention exata ocasionalmente para recuperar detalhes e camadas eficientes para maior parte do processamento.","Avalie não só perplexity: teste passkey, multi-hop, long-context recall, cache bytes/token e throughput em diferentes contextos."],"points":["MLA","linear/recurrent attention","hybrid layers","long-context eval"],"lab":"Proponha um bloco híbrido que use três camadas eficientes para cada camada de attention exata e diga como ablar."},{"id":"memory","title":"3. Neural/episodic memory, write policies e retrieval","body":["Memória neural comprime experiência em estado aprendido; memory layers fazem lookup parametrizado; memória episódica preserva fatos/eventos identificáveis. A combinação pode separar gist semântico de detalhes exatos.","O problema central é write policy: guardar tudo explode custo; guardar cedo demais pode descartar algo que só fica importante depois. Mecanismos de probation e promoção retroativa são uma direção testável."],"points":["neural memory","memory layers","episodic anchors","write policy"],"lab":"Crie um benchmark sintético onde a importância de um fato só é revelada milhares de tokens depois."},{"id":"adaptive","title":"4. Adaptive compute, early exit e hardware efficiency","body":["Nem todo token ou request merece o mesmo compute. Adaptive depth, early exit e reasoning budgets tentam alocar mais processamento apenas quando necessário. Granularidade muito fina pode destruir eficiência de batching em GPU.","Compute lanes por request ou bloco preservam batching: FAST, STANDARD, DEEP. Controller deve usar sinais de dificuldade e verificação, não apenas confiança do modelo."],"points":["adaptive depth","early exit","compute lanes","GPU batching"],"lab":"Desenhe um controller de três lanes e uma política para promover uma request de STANDARD para DEEP."},{"id":"research","title":"5. Do mecanismo à evidência: ablation ladders e scaling","body":["Novidade arquitetural só conta quando o mecanismo é especificado, implementado e comparado contra baseline forte sob orçamento controlado. Comece em 100M–1B para iterar; escale depois de ablations claras.","Registre FLOPs, tokens vistos, parâmetros ativos, HBM, latency e qualidade. Uma melhoria que ganha score usando o dobro de compute pode ser útil, mas precisa ser descrita como tal."],"points":["baseline fairness","ablation ladder","scaling","Pareto frontier"],"lab":"Escreva um protocolo de experimento baseline → +memória → +MoE → +adaptive compute com critério explícito de sucesso."}]}]}