synthesisui 0.16.235 → 0.16.238

package/dist/commands/add.js

@@ -250,15 +250,13 @@ export async function add(slug, opts) {
         await writeFile(join(slugDir, "requires.json"), `${JSON.stringify(required, null, 2)}\n`, "utf8");
     }
     /** A filosofia continua sendo CONTADA na saída, e ela vive no documento - ver abaixo. */
-    const philosophy = payload.document.philosophy;
-    const sections = philosophy?.sections ?? [];
+    const voice = payload.voice ?? { hasContext: false, sections: 0 };
     /**
-     * 5c. A FILOSOFIA NÃO É MATERIALIZADA - ela já está aqui.
-     *
-     * `philosophy` é campo do DOCUMENTO versionado (`design-system.ts`), e o `design-system.json`
-     * escrito no passo 2 a carrega inteira. O `philosophy.md` era uma segunda cópia do mesmo dado, no
-     * mesmo commit, que só era reescrita no upgrade seguinte - dois caminhos para uma verdade é como
-     * um deles começa a discordar do outro. O `system_doctrine` lê do documento.
+     * 5c. A VOZ NÃO É MATERIALIZADA - nem no `.md` (aposentado acima) nem no
+     * `design-system.json` (R2, 16/08: o payload viaja sem `philosophy`). Ela
+     * mora na plataforma e o `system_doctrine` a busca servida - sempre a
+     * versão atual, nada em texto plano no repo. As REGRAS continuam locais
+     * (`doctrine.json`): o doctor e o hook precisam delas offline.
      */
     // 6. discovery by the agent
     const claudeMd = await syncClaudeMd(projectRoot);
@@ -288,8 +286,8 @@ export async function add(slug, opts) {
      */
     const doctrine = [
         ...(rules.length > 0 ? [`${rules.length} rule(s)`] : []),
-        ...(sections.length > 0 || philosophy?.context
-            ? [`${sections.length} section(s) of philosophy`]
+        ...(voice.sections > 0 || voice.hasContext
+            ? [`the voice (${voice.sections} section(s), served from the platform)`]
             : []),
     ];
     if (doctrine.length > 0)

package/dist/commands/component.js

@@ -59,14 +59,21 @@ export async function component(slug, name, opts) {
     if (!SAFE_NAME.test(res.name)) {
         throw new RegistryError(`Registry returned an unsafe component name.`);
     }
-    const dir = join(root, "_synthesisui", "ds", slug, "components");
-    await mkdir(dir, { recursive: true });
-    await writeFile(join(dir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
-    await writeFile(join(dir, `${res.name}.css`), `${res.css}\n`, "utf8");
-    console.log(`✓ ${res.name} → _synthesisui/ds/${slug}/components/${res.name}.{json,css}  (${slug} v${res.version})`);
+    // R3 (dono, 16/08): as cópias .json/.css em _synthesisui só nascem quando
+    // são o PRODUTO do comando - `--artifacts-only` e targets não-Next. Quando
+    // o .tsx é materializado logo abaixo, ninguém as lê depois (medido na
+    // auditoria de 16/08), e cada arquivo a mais no repo dele é superfície.
+    const config = await readProjectConfig(root);
+    const artifactsAreTheProduct = opts.artifactsOnly === true || config.target !== "next";
+    if (artifactsAreTheProduct) {
+        const dir = join(root, "_synthesisui", "ds", slug, "components");
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
+        await writeFile(join(dir, `${res.name}.css`), `${res.css}\n`, "utf8");
+        console.log(`✓ ${res.name} → _synthesisui/ds/${slug}/components/${res.name}.{json,css}  (${slug} v${res.version})`);
+    }
     // 2. YOUR component - a real, importable `export function <Pascal>()` in the
     //    project's flavor (config: styles css|tailwind), under componentsDir.
-    const config = await readProjectConfig(root);
     const wantInteractive = opts.interactive && hasInteractiveTemplate(res.name);
     if (!opts.artifactsOnly && config.target === "next") {
         /**

package/dist/commands/generate.js

@@ -55,17 +55,21 @@ export async function generate(description, opts) {
     }
     console.log(`→ generating a component for "${slug}" at ${base} …`);
     const res = await postGenerate(base, { slug, description, name: opts.name });
-    const dir = join(root, "_synthesisui", "ds", slug, "generated");
-    await mkdir(dir, { recursive: true });
-    await writeFile(join(dir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
-    await writeFile(join(dir, `${res.name}.css`), `${res.css}\n`, "utf8");
     const tries = `${res.tries} ${res.tries === 1 ? "try" : "tries"}`;
     console.log(`✓ ${res.name} generated (${res.model}, ${tries})`);
-    console.log(`  → _synthesisui/ds/${slug}/generated/${res.name}.{json,css}`);
     // Materialize YOUR component (.tsx) too - the SAME codegen `component` uses -
     // so a generated component is as usable as a brought-in one, not just a
     // recipe you have to wire by hand.
     const config = await readProjectConfig(root);
+    // R3 (dono, 16/08): as cópias .json/.css só quando são o produto - num
+    // target não-Next o .tsx abaixo não nasce, e aí elas são a entrega.
+    if (config.target !== "next") {
+        const dir = join(root, "_synthesisui", "ds", slug, "generated");
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
+        await writeFile(join(dir, `${res.name}.css`), `${res.css}\n`, "utf8");
+        console.log(`  → _synthesisui/ds/${slug}/generated/${res.name}.{json,css}`);
+    }
     let materialized = false;
     if (config.target === "next") {
         const version = await readActiveVersion(root, slug);

package/dist/commands/mcp.js

@@ -109,6 +109,25 @@ const TOOLS = [
             required: ["name"],
         },
     },
+    {
+        name: "playbook",
+        description: "The skill playbooks (init, import, adapt) - SERVED, not shipped, so they are always current and your context only carries the step you are on. Call with { skill } to get the framing and a table of contents; then fetch ONLY the chapter for your current step with { skill, section }. Never fetch more than the step needs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skill: {
+                    type: "string",
+                    enum: ["init", "import", "adapt"],
+                    description: "Which playbook.",
+                },
+                section: {
+                    type: "string",
+                    description: "A chapter id from the toc. Omit to get the framing + toc.",
+                },
+            },
+            required: ["skill"],
+        },
+    },
     {
         name: "recipe_vocabulary",
         description: "What a recipe CAN hold: every state that compiles, every preview form, the floor per kind, and the rules a media region needs. Call this BEFORE writing a recipe, not after - the reader that skipped it sent a `dark:` inside a variant and a state the compiler cannot spell, and both were dropped in silence. Served from the catalogue, so it grows as the contract grows.",
@@ -297,18 +316,55 @@ async function findToken(root, value) {
  * palavra que a pessoa já tem. Sem rede, a doutrina responde igual e a checagem é que se cala: o
  * dado é local justamente para não depender de servidor nenhum.
  */
+/** A voz do sistema, servida da plataforma - ver o comentário no chamador. */
+async function fetchVoice(root) {
+    const slug = await installedSlug(root);
+    const token = await readToken();
+    if (!slug || !token)
+        return { kind: "unreachable" };
+    const res = await fetch(`${resolveRegistry()}/api/registry/ds/${slug}?voice=1`, { headers: { Authorization: `Bearer ${token}` } }).catch(() => null);
+    if (!res?.ok)
+        return { kind: "unreachable" };
+    const body = (await res.json().catch(() => null));
+    if (!body)
+        return { kind: "unreachable" };
+    return {
+        kind: "ok",
+        voice: {
+            context: body.context ?? undefined,
+            sections: body.sections ?? [],
+        },
+    };
+}
 async function systemDoctrine(root) {
     const { documents, doctrines } = await loadSystem(root);
     const rules = doctrines.flatMap((d) => d.rules);
     const parts = [];
     const pinned = doctrines[0]?.version;
-    for (const doc of documents) {
-        const p = doc.philosophy;
-        if (p?.context)
+    /**
+     * A VOZ É SERVIDA, NÃO LIDA DO DISCO (R2, dono 16/08). As REGRAS continuam
+     * locais - o doctor e o hook precisam delas offline, e essa decisão está
+     * declarada três vezes. A voz nunca foi lida por nenhum loop local: só esta
+     * ferramenta a renderiza, e ela agora pergunta à plataforma - sempre a
+     * versão atual, e nada dela em texto plano no repo. Sem rede, as regras
+     * respondem igual e a voz se declara indisponível em vez de sumir calada.
+     *
+     * Installs antigos (design-system.json com `philosophy` dentro) continuam
+     * funcionando: o disco é o fallback quando a rede não responde.
+     */
+    const localVoice = documents.map((doc) => doc.philosophy ?? {});
+    const served = await fetchVoice(root);
+    const voices = served.kind === "ok"
+        ? [served.voice]
+        : localVoice.filter((p) => p.context || (p.sections?.length ?? 0) > 0);
+    for (const p of voices) {
+        if (p.context)
             parts.push(`## What this product is\n\n${p.context}`);
-        for (const sec of p?.sections ?? [])
+        for (const sec of p.sections ?? [])
             parts.push(`## ${sec.title}\n\n${sec.body}`);
     }
+    if (served.kind === "unreachable" && voices.length === 0)
+        parts.push("## Voice\n\nThe voice is served from the platform and could not be reached right now. The rules above still apply in full - build with them, and fetch the voice again before writing user-facing copy.");
     if (rules.length === 0 && parts.length === 0)
         return "This system carries no rules and no philosophy yet. Nothing here overrides your judgement - build with its tokens and its components, and say what you needed and could not find.";
     const head = [
@@ -408,6 +464,28 @@ async function listComponents(root) {
  * properties need to be dynamic - the more we map, the more precision". A list written
  * into a published package is a list that stops matching the contract.
  */
+/**
+ * O PLAYBOOK, na fatia pedida (R1, dono 16/08): sem `section`, a moldura + o
+ * sumário; com, UM capítulo. O corpo inteiro nunca viaja - a dieta de contexto
+ * é servida por construção.
+ */
+async function playbook(skill, section) {
+    const answer = await askCatalogue("playbook", undefined, section ? { skill, section } : { skill });
+    if (!answer.ok)
+        return answer.because;
+    const body = answer.body;
+    if ("error" in body)
+        return [body.error, body.hint].filter(Boolean).join("\n");
+    if ("sections" in body) {
+        return [
+            body.intro,
+            "",
+            "## Chapters - fetch ONLY the one for your current step",
+            ...body.sections.map((c) => `- ${c.id} - ${c.title}`),
+        ].join("\n");
+    }
+    return body.body;
+}
 async function recipeVocabulary() {
     const answer = await askCatalogue("vocabulary");
     if (!answer.ok)
@@ -769,7 +847,9 @@ cli) {
         }
     })();
 }
-async function askCatalogue(want, post) {
+async function askCatalogue(want, post, 
+/** Parâmetros extras do GET (ex.: o playbook e o capítulo pedidos). */
+query) {
     const token = await readToken();
     if (!token) {
         return {
@@ -779,7 +859,8 @@ async function askCatalogue(want, post) {
     }
     const base = resolveRegistry();
     try {
-        const res = await fetch(`${base}/api/catalogue${post ? "" : `?want=${want}`}`, post
+        const extra = query ? `&${new URLSearchParams(query).toString()}` : "";
+        const res = await fetch(`${base}/api/catalogue${post ? "" : `?want=${want}${extra}`}`, post
             ? {
                 method: "POST",
                 headers: {
@@ -966,6 +1047,11 @@ cli) {
         case "add_component":
             countAgentRead(root, String(args.name ?? ""), "add", cli);
             return text(await addComponent(root, String(args.name ?? "")));
+        case "playbook": {
+            const skill = String(args?.skill ?? "");
+            const section = args?.section ? String(args.section) : undefined;
+            return text(await playbook(skill, section));
+        }
         case "recipe_vocabulary":
             return text(await recipeVocabulary());
         case "validate_recipe": {

package/dist/commands/refit.js

@@ -123,12 +123,15 @@ export async function refit(file, opts) {
         recipe: res.recipe,
     });
     console.log(`✓ saved into "${slug}" (draft v${saved.version} - ships with your next publish)`);
-    // 5. materialize back into the project: artifacts + YOUR typed component
-    const artifactsDir = join(root, "_synthesisui", "ds", slug, "components");
-    await mkdir(artifactsDir, { recursive: true });
-    await writeFile(join(artifactsDir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
-    await writeFile(join(artifactsDir, `${res.name}.css`), `${res.css}\n`, "utf8");
+    // 5. materialize back into the project: YOUR typed component - e as cópias
+    // .json/.css só quando são o produto (target não-Next; R3, dono 16/08).
     const config = await readProjectConfig(root);
+    if (config.target !== "next") {
+        const artifactsDir = join(root, "_synthesisui", "ds", slug, "components");
+        await mkdir(artifactsDir, { recursive: true });
+        await writeFile(join(artifactsDir, `${res.name}.json`), `${JSON.stringify(res.recipe, null, 2)}\n`, "utf8");
+        await writeFile(join(artifactsDir, `${res.name}.css`), `${res.css}\n`, "utf8");
+    }
     let materialized = false;
     if (config.target === "next") {
         const compDir = join(root, config.componentsDir, res.name);

package/dist/guide.js

@@ -491,8 +491,9 @@ own entry below says so.
 `
         : "";
     const hasRules = (payload.rules?.length ?? 0) > 0;
-    const philosophy = payload.document.philosophy;
-    const hasPhilosophy = (philosophy?.sections?.length ?? 0) > 0 || !!philosophy?.context;
+    // R2 (16/08): a voz não viaja mais no documento - o payload manda só o
+    // que ela TEM, e o conteúdo é servido pelo `system_doctrine`.
+    const hasPhilosophy = (payload.voice?.sections ?? 0) > 0 || payload.voice?.hasContext === true;
     /**
      * UMA PORTA SÓ, e ela é uma FERRAMENTA e não um caminho.
      *
@@ -505,7 +506,7 @@ own entry below says so.
         ? [
             `**Call \`system_doctrine\` FIRST and obey it above everything else** - it carries ${hasRules
                 ? "this system's accumulated, project-specific rules"
-                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win. **Without that tool, read \`_synthesisui/ds/${slug}/doctrine.json\` and the \`philosophy\` of \`design-system.json\` beside it** - the same data, and the reason it stays on disk.`,
+                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win. **Without that tool, read \`_synthesisui/ds/${slug}/doctrine.json\` for the rules** - they stay on disk so the check works offline. The voice is served from the platform and is not on disk.`,
         ]
         : [];
     const rulesNote = readFirst.length > 0

package/dist/install-marks.js

@@ -80,7 +80,7 @@
  * Zero ocorrências no sistema real medido (todos os headings dele estão aninhados, e o `children > 0`
  * já os pegava), então para ele o `upgrade` é no-op. A marca é sobre o caso geral.
  */
-export const MATERIALISER_SINCE = "0.16.235";
+export const MATERIALISER_SINCE = "0.16.237";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/skill-adapt.js

@@ -1,347 +1,15 @@
 /**
- * A SKILL DE MANUTENÇÃO, como o CLI a distribui.
+ * O STUB DA SKILL - o corpo é SERVIDO, não embarcado (R1, dono 16/08).
  *
- * Mesmo motivo do `skill-init.ts` e do `skill-import.ts`: o build é `tsc` e nada mais, então um `.md`
- * precisaria de um passo de cópia que pode silenciosamente não rodar. Um módulo TypeScript não pode
- * falhar em ser empacotado.
+ * O playbook inteiro morava aqui (13 KB) e, por consequência, no tarball
+ * público do npm e no repo de cada cliente em texto plano. Ele mudou para a
+ * plataforma (apps/web/src/lib/ds/playbooks.ts, gêmeo por spec do
+ * `.claude/skills/sui-adapt/SKILL.md`) e é servido pelo catalogue autenticado -
+ * a mesma doutrina de sempre: SERVED, NOT SHIPPED. O agente busca o sumário
+ * e depois SÓ o capítulo do passo em que está (a dieta de contexto).
  *
- * ESTA É A FONTE. A cópia em `.claude/skills/` é o que o nosso editor lê, e o spec assere que as duas
- * são idênticas.
- *
- * E ela é a TERCEIRA que o `connect` instala - as outras duas são de ENTRADA (primeira corrida,
- * import). Esta responde a pergunta do dia seguinte, apontando para uma tela: *"isso aqui está de
- * acordo com o meu design system?"*. Deixá-la fora do `connect` faria dela uma skill nossa, e o caso
- * de uso que a motivou é o cliente rodando sozinho toda semana.
+ * O frontmatter fica INTEIRO no stub: é a description que faz a skill ser
+ * invocada, e ela não é segredo - a esteira é.
  */
-export const ADAPT_SKILL = `---
-name: sui-adapt
-description: Confronta UM componente (ou uma página, ou uma pasta) contra o design system instalado e adapta o que der - cobertura de token medida, conserto mecânico proposto antes de escrever, e o que sobra classificado em "regra nova" ou "conserto local". Use quando alguém aponta para uma peça e pergunta se ela está de acordo com o sistema (ex. "/sui-adapt components/ui/card", "analisa esse componente aqui", "isso aqui segue o meu design system?"), como rotina semanal, ou logo depois de criar/alterar um componente. Mede antes de propor, propõe antes de escrever, e nunca arquiva pedido em nome de ninguém.
----
-
-# Adaptar uma peça ao sistema
-
-**Seu primeiro comando é a medição.** Não leia \`.mcp.json\`, não abra o censo, não liste
-arquivo: \`check_file\` ou \`doctor <alvo>\` responde tudo isso em um passo, e é o que o resto
-desta skill consome. Um agente que sai explorando antes gasta a paciência de quem pediu e
-chega ao mesmo lugar.
-
-O propósito do produto, que decide todo empate abaixo: **ler o repositório do cliente e
-devolver receitas com paridade visual, semântica e funcional, sem supor e sem inventar
-nada.**
-
-Esta skill é a ponta de manutenção. As outras duas que o cliente tem são de ENTRADA -
-\`sui-init\` e \`sui-import-ds\` transformam o repositório dele em sistema. Esta responde a
-pergunta do dia seguinte, que ele faz apontando para uma tela: *"isso aqui está de acordo
-com o meu design system?"*.
-
-\`CLAUDE.md\` manda. Quando os dois divergirem, este arquivo é que está velho.
-
----
-
-## 0. COMO VOCÊ FALA COM ELE
-
-**Ele quer saber o que está no projeto DELE. Nada do que está do nosso lado interessa.**
-
-Esta seção vale acima de qualquer outra abaixo, porque uma medição perfeita escrita na
-nossa língua é uma medição que ele não lê. Palavras que **nunca** aparecem para ele:
-
-\`\`\`
-ledger · census · scope · reading as ADOPTION · refresh_system · check_file
-system_doctrine · carrier · alcançável · o número da versão do CLI · --fix --write
-cobertura de token · o nome de qualquer comando ou ferramenta nossa
-\`\`\`
-
-A tradução é sempre a mesma: fale do **arquivo**, da **propriedade**, do **valor** e da
-**variável dele**.
-
-\`\`\`
-em vez de                          diga
-o ledger.cli está em 0.16.229      sua ferramenta está em dia
-o scope do sistema é packages/ui   este arquivo fica fora da pasta de onde o
-                                   seu design system nasceu, e isso é normal
-1em → var(--ds-spacing-md)         o seu projeto já chama esse valor de \`--spacing-md\`
-cobertura de token: 0%             nenhum destes valores vem do seu design system
-rode doctor --fix --write          eu troco para você, se você quiser
-\`\`\`
-
-**A variável que você oferece é a DELE.** O comando já devolve o nome do vocabulário dele
-quando o repositório tem um - \`--color-lightgray-700\`, e não \`--ds-color-gray-400\`. Nunca
-reescreva a sugestão para o nosso prefixo: renomear a variável dele não é adotar o sistema.
-
-## 0b. O QUE ESTA SKILL NÃO FAZ
-
-Três limites, e cada um existe por um motivo que já custou alguma coisa:
-
-\`\`\`
-não escreve sem propor    é o repositório DELE. Escrever sem confirmação é outra
-                          categoria de confiança, e uma skill que perde essa
-                          confiança não é rodada uma segunda vez
-não arquiva pedido        um pedido fila uma decisão na plataforma. A skill
-                          PERGUNTA; quem decide é ele
-não inventa token, nome   um agente que cala um relatório fazendo o sistema crescer é
-nem regra                 pior que a deriva que ele veio medir
-\`\`\`
-
-## 1. O ALVO, E POR QUE O ESCOPO É DECISÃO DA SKILL
-
-Componente quase nunca é um arquivo. \`Card.tsx\` costuma vir com \`Card.css\`, \`Card.stories.tsx\`
-e às vezes um \`index.ts\` - e medir só o \`.tsx\` produz um número que mente por omissão: o css
-ao lado é justamente onde os valores à mão se escondem.
-
-\`\`\`
-1. resolva o alvo   o que ele apontou, ou o arquivo aberto, ou o que ele acabou de mexer
-2. suba para a PASTA quando o irmão existir (mesmo nome, extensão diferente)
-3. DIGA qual escopo você usou, com o número de arquivos
-\`\`\`
-
-Nunca meça os dois e escolha o maior. Diga o que mediu - **com os nomes dos arquivos**, não
-com a palavra "escopo".
-
-**O alvo fora da pasta importada é o caso COMUM, e não um erro.** O sistema nasceu de uma
-pasta, e uma tela de app que consome o DS está fora dela - é literalmente o pedido
-*"conserta essa página pro meu design system"*. Ali as variáveis valem igual, porque elas
-são globais; o que não existe é receita daquele componente. Diga isso em uma linha, sem a
-palavra "escopo", e siga.
-
-## 2. MEÇA - e a medida é determinística, não sua
-
-Duas portas, mesma resposta. Use a que a sessão tiver:
-
-\`\`\`
-MCP        check_file { path }
-terminal   npx synthesisui doctor <alvo>
-\`\`\`
-
-Não recalcule nada de cabeça. O número que você reporta é o que o comando disse.
-
-**A abertura tem três linhas e nenhuma a mais.** Ela responde "está em dia?", "o que você
-leu?" e "como estou?", nesta ordem:
-
-\`\`\`
-sua ferramenta está em dia
-
-li OverviewHeaderInformation - o componente e a folha de estilo dele, 2 arquivos
-
-17 valores estão escritos à mão aqui, e nenhum vem do seu design system
-\`\`\`
-
-Se a ferramenta NÃO estiver em dia, essa primeira linha vira o primeiro item da fila, com o
-comando à vista - uma medição feita com a versão velha responde outra coisa.
-
-Os três grupos que o comando separa, e o que cada um vira:
-
-\`\`\`
-já usa uma variável       nada a fazer
-o projeto já nomeia       é uma troca - vira item, com a variável DELE ao lado
-ninguém nomeia            é uma decisão dele - vira item, com as três saídas
-\`\`\`
-
-## 3. MONTE A FILA, E CONTE OS ITENS ANTES DE COMEÇAR
-
-Aqui é onde esta skill se ganha ou se perde. Despejar tudo de uma vez - duas regras, quatro
-decisões, dez trocas - não é um relatório, é uma parede. Quem lê não tem como agir; só
-concordar ou fechar a aba.
-
-Junte tudo o que você achou numa fila ÚNICA e **ordene por custo**:
-
-\`\`\`
-1º  não muda um pixel      troca por uma variável de mesmo valor
-2º  pode mudar o pixel     \`em\` que segue a fonte, um degrau que colapsa
-3º  não é troca, é pedido  variável nova, peça nova, regra nova
-\`\`\`
-
-Assim ele despacha o barato primeiro e para quando quiser, sem ficar devendo nada.
-
-Anuncie o tamanho antes do primeiro item, sempre, e em uma frase que ele leia:
-
-\`\`\`
-achei 8 coisas. 2 não mudam nada na tela, 4 podem mudar, e 2 são decisão sua.
-\`\`\`
-
-## 4. UM ITEM POR VEZ, COM AS TRÊS SAÍDAS - e espere a resposta
-
-Nunca apresente o item 2 antes de ele responder o 1. O cabeçalho carrega a posição, para
-ele saber onde está e quanto falta. O corpo fala do componente dele, e termina numa
-pergunta:
-
-\`\`\`
-item 1 de 8
-
-  OverviewHeaderInformation espaça com \`1em\` em 4 lugares, e esse valor não está
-  ligado ao seu design system.
-
-    styles.module.scss    padding: 1em 0
-                          padding-right: 1em
-                          margin-left: 1em
-                          margin-right: 0.5em
-
-  O que você quer fazer?
-
-    1  deixar como está
-    2  usar \`--spacing-md\`, que o seu projeto já tem
-       ⚠ \`em\` segue a fonte do elemento, então isto pode mudar o espaçamento na tela
-    3  criar um nome novo para este valor no seu design system
-
-  [1] [2] [3]   ou me diga outra coisa · [parar por aqui]
-\`\`\`
-
-As três saídas são sempre as mesmas, porque são as três que existem de verdade:
-
-\`\`\`
-1  deixar como está    ele segue para o próximo, e o item entra no resumo como não mexido
-2  usar uma variável   você faz a edição e confirma em uma linha
-                       SE a troca puder mudar a tela, isso vem escrito NA OPÇÃO, não depois
-3  criar um nome novo  vira um pedido, e é ele quem manda - ver o passo 6
-\`\`\`
-
-E \`parar por aqui\` fecha o resumo com o que andou. É sempre legítimo.
-
-**Quando ele pedir para ver antes**, mostre as linhas e volte a perguntar - isso não conta
-como resposta.
-
-**Na opção 2, liste as variáveis dele quando houver mais de uma candidata.** Ele não decora
-o vocabulário do próprio projeto, e escolher entre dois nomes é mais fácil que lembrar de
-um.
-
-## 5. AS REGRAS, QUE É A METADE QUE NENHUM COMANDO FAZ
-
-O passo 2 é determinístico e sai de graça. Este não: o sistema carrega uma doutrina em
-prosa, e **nada a verifica mecanicamente**. É aqui que você trabalha.
-
-\`\`\`
-MCP        system_doctrine
-terminal   as regras viajam no documento instalado (_synthesisui/ds/<slug>/doctrine.json)
-\`\`\`
-
-Leia as regras e confronte o componente com cada uma. Três respostas possíveis por regra,
-e a terceira é a que interessa:
-
-\`\`\`
-cumpre           some do relatório. Diga só o total no fim
-NÃO cumpre       vira um ITEM da fila, com arquivo, linha e as três saídas
-a regra não fala sobre isto   vira um item de decisão - uma regra nova
-\`\`\`
-
-Uma regra que você teve que interpretar para aplicar não é "cumpre". É o terceiro caso.
-
-E nunca escreva "3 de 5 cumpridas". Isso lê como boletim, e as 2 que faltam são justamente
-as que TÊM conserto pronto - é a melhor notícia do relatório vestida como a pior.
-
-## 6. OS PEDIDOS - você mostra o comando, ele roda
-
-Quando ele escolhe a saída 3, existem três destinos, e todos existem de verdade:
-
-\`\`\`
-um valor sem nome no sistema
-  -> npx synthesisui request token --value "<valor>" --name "<como se chamaria>" --for "<o caso>"
-uma peça que falta
-  -> npx synthesisui request component --name "<nome>" --for "<o caso>"
-o sistema não tem regra sobre este caso
-  -> npx synthesisui request rule --name "<o que a regra diria>" --for "<o caso que pediu>"
-\`\`\`
-
-**Arquivar em nome dele seria decidir por ele** - e tirar dele a chance de dizer "não, isso
-fica local mesmo". Antes de propor uma regra nova, leia a doutrina inteira: uma regra que já
-existe e você não achou vira duplicata na fila, e a fila perde valor na terceira.
-
-E o nome que você propõe para a variável nova segue a convenção DELE. Se o projeto escreve
-\`--color-lightgray-700\`, o valor novo não vira \`--ds-color-neutral-4\`.
-
-## 6b. A RÉGUA É O QUE DÁ PARA FAZER HOJE, E O TETO SE DIZ JUNTO
-
-**100% quase nunca é alcançável hoje, e isso não é falha dele.** Se o sistema não tem nome
-para \`#555\`, ninguém chega a 100% sem antes decidir criar esse nome. Um medidor que mostra
-0% contra um teto imaginário faz trabalho completo parecer trabalho pela metade.
-
-Os números para a conta certa já vêm do comando:
-
-\`\`\`
-3 valores à mão
-2 o projeto já nomeia   -> alcançável hoje: 67%
-1 ninguém nomeia        -> precisa de uma decisão dele
-\`\`\`
-
-Então o teto de hoje é 67% - e ao falar com ele, isso não se chama "alcançável", se chama
-*"o máximo que dá para resolver sem você decidir nada novo"*.
-
-## 6b-2. O ÚLTIMO ITEM DA FILA É MANDAR O REGISTRO
-
-Cada escrita fica gravada numa fila local, e ela **nunca toca a rede** sozinha - essa
-divisão é o que mantém a verificação instalada. Uma skill que mandasse por conta própria
-seria a verificação ligando para casa.
-
-Então o envio é um item como os outros, o último, e ele só acontece se ele mandar:
-
-\`\`\`
-item 8 de 8
-
-  você mudou 3 coisas nesta conversa. A plataforma ainda está pontuando este
-  repositório pelo que ela viu da última vez.
-
-  [mandar agora]  [depois]        npx synthesisui sync --record-only
-\`\`\`
-
-**\`--record-only\`, e não \`sync\` puro.** O \`sync\` completo re-mede tudo e reescreve as
-receitas no RASCUNHO - fazer isso no fim de uma revisão move o chão de quem está revisando.
-
-O \`sync\` COMPLETO é outro item, e só aparece quando algum item mexeu em FUNDAÇÃO (uma cor,
-um degrau, uma variável nova). Aí a plataforma precisa reler, e a skill diz isso sem jargão:
-
-\`\`\`
-isto mexeu numa das bases do seu design system, então a plataforma precisa reler o
-seu repositório. Você vê o resultado antes de publicar - ele reescreve as receitas no rascunho.
-  [rodar agora]  [depois]     npx synthesisui sync
-\`\`\`
-
-Se nada foi escrito, não ofereça nem um nem outro. Um item que não tem o que mandar é ruído.
-
-## 6c. FECHE PELO QUE ANDOU, E MOSTRE O CAMINHO ATÉ 100%
-
-\`\`\`
-OverviewHeaderInformation   2 arquivos
-
-dá para resolver hoje   82%   é o que o seu vocabulário já cobre
-resolvido               82%   ✓ nada mecânico ficou para trás
-deixado como estava      12   os \`em\`, que podem mexer no layout
-esperando você            3   valores que ainda não têm nome
-\`\`\`
-
-Nunca "0% -> 0%". Se nada era mecânico, o teto era zero, e a frase é *"não havia nada que
-o seu vocabulário de hoje resolvesse - o que existe são N decisões suas"*.
-
-E quando sobrou pedido, termine com o caminho, porque ele é de dois passos e o primeiro é
-dele:
-
-\`\`\`
-para chegar a 100%, faltam dois passos:
-  1. autorize o pedido no painel   (ele já está na fila)
-  2. publique, e rode \`npx synthesisui upgrade\` aqui
-     depois disso, /sui-adapt neste componente fecha em 100%
-\`\`\`
-
-Autorizar escreve o RASCUNHO, e o repo recebe a última PUBLICADA - por isso os dois passos.
-Prometer que \`upgrade\` sozinho traz a variável é mandar a pessoa rodar um comando que
-responde "already at the latest version".
-
-Se a fila esvaziou, o fim é uma linha só:
-
-\`\`\`
-dá para resolver hoje  100%
-resolvido              100%   ✓ este componente está inteiro no seu design system
-\`\`\`
-
-## 7. ROTINA
-
-Ela foi desenhada para duas horas do dia, e a segunda é a que mais rende:
-
-\`\`\`
-semanal          "roda o sui-adapt no dashboard" - pega deriva antes de virar hábito
-depois de mexer  componente novo, ou alteração grande: rode ANTES do commit, enquanto a
-                 decisão ainda está quente e o conserto ainda é barato
-\`\`\`
-
-A verificação automática já roda a metade determinística a cada escrita, calada quando não
-há o que dizer. Esta skill é o passo deliberado: ela junta a verificação, a doutrina e a
-fila numa conversa só, e termina com o cliente decidindo - não com um relatório.
-`;
 export const ADAPT_SKILL_PATH = ".claude/skills/sui-adapt/SKILL.md";
+export const ADAPT_SKILL = '---\nname: sui-adapt\ndescription: Confronta UM componente (ou uma p\u00e1gina, ou uma pasta) contra o design system instalado e adapta o que der - cobertura de token medida, conserto mec\u00e2nico proposto antes de escrever, e o que sobra classificado em "regra nova" ou "conserto local". Use quando algu\u00e9m aponta para uma pe\u00e7a e pergunta se ela est\u00e1 de acordo com o sistema (ex. "/sui-adapt components/ui/card", "analisa esse componente aqui", "isso aqui segue o meu design system?"), como rotina semanal, ou logo depois de criar/alterar um componente. Mede antes de propor, prop\u00f5e antes de escrever, e nunca arquiva pedido em nome de ningu\u00e9m.\n---\n\n# Adaptar uma pe\u00e7a ao sistema - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "adapt" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "adapt", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';