@zaip-ai/cli 3.1.0 → 3.3.0

package/templates/.agents/runtime/checksums.sha256

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-b2f44d3b6e29f8b1b73ea4735f006affc4d198e1fd9c7d50e736159b1ef636c6  VERSION
-07eff6c6d3ef380212d06003dd3e7b11b681d8100fd92846a6ed13742867219e  bin/zaip.mjs
-309fea15107cf79a2ef729be126a4cb65572215b480dc5a8820fb3aad6f515ab  manifest.json
+5eee6c0c5c6901f5e523f0a434bca4106e1ff7136deb451f982b0bb1a7b13716  VERSION
+4db3d63944b2c9f28019e705e4f125f6bcceb877e3efa5954cc7555a99b73536  bin/zaip.mjs
+dd2a7c216fd2c9d4f33164ae850af05db51b0b3ff885ddf03760d00fc1dcd491  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
 2d738247131a923ea6e3a32d0d1d6de763866fd96a8a8dc75d127a343809b0aa  pnpm-lock.sha256
-d2b2105141802e9e6bc46833181de0bb01532a7efaeda5e5b2db62ab02f89855  provenance.json
-e3b827a4931e99acbe3ad9819648e651e672dc5b2cd1056a6d59ae4d56f4b2c6  sbom.cdx.json
+dd21d399e85ec0791965450a32fa13af51e71e17b86cc7ee11e8ce8072868c32  provenance.json
+cc111be184be67dd46cb46fb3f8fe75b192e33f3114d8c6c9cc0639a841962cf  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

package/templates/.agents/runtime/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "node": ">=22",
   "files": [
     "LICENSE",

package/templates/.agents/runtime/provenance.json

@@ -2,10 +2,10 @@
   "schema_version": 1,
   "statement_type": "self_reported_build_integrity",
   "authenticity": "unverified",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "source_origin": "zaip-aios:local-build",
   "lockfile_sha256": "f8557f3600849eb880b8f245b63b80fed9a3e9addf2c5f2c6d492547af900219",
-  "sbom_sha256": "e3b827a4931e99acbe3ad9819648e651e672dc5b2cd1056a6d59ae4d56f4b2c6",
-  "runtime_sha256": "78b53fdb2c310ef79d25cae1952b57810af6fa1e02bd2e62fefbc16cc3fa34a1",
-  "statement_sha256": "22b6a50ec6c2af719fd2795fa1010d42be59e5de432914943032bf305838973e"
+  "sbom_sha256": "cc111be184be67dd46cb46fb3f8fe75b192e33f3114d8c6c9cc0639a841962cf",
+  "runtime_sha256": "3925086e5b413bca4e23fc2f7bda7298ab11e28cb803b65e67492d1ef7a66f10",
+  "statement_sha256": "bb71d94b1a0092923e1480b2bced65a01ee0875f24740349155ad9bbff058039"
 }

package/templates/.agents/runtime/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "3.1.0"
+      "version": "3.3.0"
     }
   },
   "components": [

package/templates/.agents/skills/zaip-aios/SKILL.md

@@ -1,5 +1,4 @@
 ---
-# zaip-managed generated-do-not-edit source=discovery-skill version=2.5.0 sha256=76f3edc1dc8dfecc8c1b3c5b789557a515d05e270c044bf35e758923dff0aa0f
 name: zaip-aios
 description: Discover and apply the repository-local ZAIP-AIOS framework.
 ---

package/templates/.agents/skills/zaip-skill-author-skills/scripts/audit-skill-catalog.mjs

@@ -18,6 +18,7 @@ for (const agent of catalog.agents ?? []) {
   }
 }
 for (const [agentId, requiredSkill] of [
+  ["agent-builder", "zaip-skill-update-version-doc"],
   ["agent-frontend", "zaip-skill-frontend"],
   ["agent-frontend", "zaip-skill-frontend-componentization"],
   ["agent-backend", "zaip-skill-backend"],

package/templates/.agents/skills/zaip-skill-config/SKILL.md

@@ -9,6 +9,18 @@ Use esta skill para pedidos como “me ajude a configurar meu projeto”, “pri
 
 Escopo de configuração: nome, timezone, stack, clients, tracking e destinos de deploy; Rules locais pertencem a `$zaip-skill-rules`.
 
+## Onboarding após instalação
+
+Uma resposta afirmativa a “Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?” ativa esta skill, tanto após a instalação quanto após o setup GitHub. Leia a configuração existente, explique em linguagem simples o que pode ser personalizado e faça uma entrevista curta antes de editar:
+
+- Nome e finalidade do projeto, fuso horário e preferências já existentes.
+- Stack e partes necessárias da aplicação, clientes Codex/Claude e acompanhamento de uso/custos.
+- Destinos e branches de deploy, apenas quando pertinentes ao projeto.
+
+Agrupe até cinco perguntas necessárias por turno; mostre os valores atuais para que o usuário possa mantê-los e não solicite novamente escolhas já respondidas. O aceite da ajuda inicia a entrevista, sem autorizar credenciais, recursos externos ou valores presumidos. Não peça segredos no chat. Explique as dependências somente das opções escolhidas e encaminhe às skills específicas deste procedimento.
+
+Depois de aplicar e validar as escolhas autorizadas, informe o que foi configurado e encerre o onboarding de instalação, sem outro CTA de setup, publicação automática ou retorno à pergunta sobre GitHub. Se houver recusa ou adiamento, encerre sem insistência; se houver falha, descreva a pendência sem declarar configuração concluída.
+
 1. Confirme que ZAIP-AIOS já está instalado por meio de `.agents/config/project.yaml`. Se estiver ausente, explique que a instalação é um pré-requisito e encaminhe para `$zaip-skill-setup`; não instale nem reinstale durante a configuração.
 2. Leia `.agents/config/project.yaml`, o schema vigente e somente as Rules ligadas ao ajuste solicitado; não existe comando `config set`, portanto edite o YAML canônico diretamente.
 3. Para primeiros passos, apresente as opções de personalização pertinentes antes de alterar valores e só aplique a configuração autorizada pelo usuário.

package/templates/.agents/skills/zaip-skill-github-setup/SKILL.md

@@ -7,6 +7,12 @@ description: Configure Git, GitHub, and folder-scoped SSH when requested; setup
 
 Configure the requested Git/GitHub state idempotently while preserving unrelated repositories and identities. Separate setup, first commit, and publication so that creating or configuring a repository cannot push by accident.
 
+## Installation onboarding
+
+An affirmative response to the installation question “Deseja ajuda para configurar seu repositório Git?” selects this skill. First explain the relevant setup options below and inspect the existing state. Ask concise questions only for missing choices: the intended Git identity, an existing repository URL or the owner/name/visibility for a new repository, and the preferred authentication method. Never ask for private keys or tokens in chat. Ask key-path and passphrase questions only when creating a requested key. Do not initialize Git, create a remote, change identity, or make a first commit merely because the user accepted help; apply the choices once supplied.
+
+After the requested GitHub setup succeeds and is verified, summarize the observed changes and end with exactly: **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?** An affirmative response selects `$zaip-skill-config`, which explains configuration options and asks the necessary questions before editing. If setup is incomplete, report the actual pending step rather than claiming completion. A refusal or request to defer ends installation onboarding without repeated offers or automatic setup.
+
 ## Select the requested mode
 
 Support these independent modes:
@@ -78,7 +84,7 @@ An explicit request for initialization or first commit authorizes `git add -A` a
 
 ## Publish only when explicit
 
-When the same user request explicitly includes deploy/push, read and follow `../zaip-skill-github-deploy/SKILL.md` after setup succeeds. Otherwise finish with the exact push command the user may authorize later.
+When the same user request explicitly includes deploy/push, read and follow `../zaip-skill-github-deploy/SKILL.md` after setup succeeds. Otherwise do not publish. During installation onboarding, end with the project-configuration CTA above; outside onboarding, provide the exact push command only when relevant to the requested setup.
 
 ## Verify and report
 

package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md

@@ -7,6 +7,10 @@ description: Qualify an exact ZAIP release candidate through source-template-pac
 
 Use before deciding whether a concrete candidate is ready. It does not publish.
 
+For the framework installer, first apply `zaip-skill-update-version-doc` and its
+executable source check. Candidate identity comes from the root manifest;
+generated artifact hashes and exact-package proof remain mandatory below.
+
 This skill is mandatory before every frontend/backend GitHub deploy and framework release.
 Follow [the executable preparation guide](references/local-preparation.md). Synchronize and commit
 the candidate first. The framework helper runs fixed gates in an isolated checkout, builds the

package/templates/.agents/skills/zaip-skill-setup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: zaip-skill-setup
-description: Install ZAIP-AIOS and its authorized prerequisites in a new workspace.
+description: Install ZAIP-AIOS and format the final chat response after init, including installations started before this skill was available.
 ---
 
 # Instalar ZAIP-AIOS
@@ -16,7 +16,7 @@ For the isolated SQLite dashboard, also discover and use `$zaip-skill-sqlite-rea
 Create the disposable dashboard database only from canonical `.agents/records` and
 `.agents/config` sources.
 
-1. Confirme que o usuário quer instalar ZAIP-AIOS em um workspace que ainda não o possui. Se já houver `.agents/config/project.yaml`, não reinstale: encaminhe configuração, personalização, primeiros passos ou edição para `$zaip-skill-config`.
+1. Se o `init` acabou de concluir neste turno, vá diretamente ao modelo obrigatório de resposta abaixo; não reinstale nem inicie configuração. Para uma nova instalação, confirme que o usuário quer instalar ZAIP-AIOS em um workspace que ainda não o possui. Se já houver `.agents/config/project.yaml`, não reinstale: encaminhe configuração, personalização, primeiros passos ou edição para `$zaip-skill-config`.
 2. Faça dry-run e detecte apenas conflitos que impeçam a instalação inicial, como checksum, ownership ou arquivos do usuário que seriam sobrescritos.
 3. Verifique Node.js 22+; instale a versão LTS com `winget` somente quando o usuário tiver autorizado a instalação automática do pré-requisito.
 4. Instale e valide o conteúdo do release: `config/project.yaml`, `config/framework.lock.yaml`, Rules core, Requirements e skills gerenciados pelo manifest, raízes V3 de `records` e, quando distribuído, o dashboard frontend-only em `.agents/dashboard`. Preserve arquivos e Rules locais do projeto.
@@ -25,6 +25,40 @@ Create the disposable dashboard database only from canonical `.agents/records` a
 7. Após a instalação, use `$zaip-skill-dev-environment` para inventariar apenas nomes e presença de pré-requisitos. Para configurar o projeto, personalizar perfis Codex ou seguir os primeiros passos, use `$zaip-skill-config`.
 8. A instalação deixa `beta` como ramo padrão de frontend, backend e banco, mas não cria uma branch Supabase hospedada, integração GitHub, credencial ou custo adicional. A configuração protegida de migrations é uma escolha posterior e explícita pelo `$zaip-skill-config`.
 
+## Resposta final obrigatória após instalação
+
+Este contrato vale para a **resposta final do assistente no chat**, além do output da CLI. Aplique-o mesmo quando o usuário pediu apenas o comando npx, a instalação começou sem skills disponíveis ou esta skill só foi descoberta depois do init. Releia esta seção antes de responder. A existência de project.yaml recém-instalado não deve desviar a resposta para uma configuração automática.
+
+Reproduza a estrutura abaixo como Markdown renderizado: frase inicial, linha “Resumo:”, lista de bullets e uma pergunta final. Não use bloco de código para envolver a resposta, não converta a lista em parágrafos e não substitua o link por negrito, texto simples ou código. Use o comando realmente executado ou sua forma npx equivalente; nunca copie a versão ou as contagens do exemplo do usuário.
+
+Modelo (substitua todos os campos por resultados observados):
+
+```markdown
+ZAIP-AIOS foi instalado com sucesso no projeto atual usando `npx @zaip-ai/cli@latest init`.
+
+Resumo:
+
+- Versão instalada: [v{VERSÃO}](https://www.npmjs.com/package/@zaip-ai/cli/v/{VERSÃO})
+- {ADICIONADOS} arquivos adicionados
+- {SOBRESCRITOS} arquivos existentes sobrescritos
+- Dashboard SQLite configurado
+- `doctor --json`: válido, sem problemas
+- {ESTADO_OBSERVADO_DO_GIT_GITHUB}
+
+Deseja ajuda para configurar seu repositório Git?
+```
+
+- Substitua VERSÃO pela versão instalada, sem prefixo v no URL. Obtenha números e resultados da execução; dado ausente deve aparecer como “não informado”. Não declare sucesso de SQLite/doctor quando não executados ou falhos. Dry-run e instalação falha não usam a frase de sucesso.
+- Se não houver repositório, use “O diretório ainda não possui um repositório Git configurado.” Outros estados devem descrever a pendência real. Git, identidade, repositório, commit inicial e GitHub não são pré-requisitos de instalação; informe que podem ser configurados depois. Estado local não comprova autenticação.
+- Com GitHub pendente ou inconclusivo, termine com **Deseja ajuda para configurar seu repositório Git?** Com GitHub configurado localmente, substitua apenas a pergunta por **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?**
+- Termine com exatamente uma dessas perguntas. Não escreva nada depois dela nem ofereça as duas alternativas juntas. Antes de enviar, confirme: bullets presentes; versão clicável no npm correto; pergunta correspondente ao estado e última linha da resposta.
+
+## Aceite e encerramento do onboarding
+
+O CTA da CLI é texto, sem bloquear aguardando entrada. No chat, “sim” à pergunta de Git ativa `$zaip-skill-github-setup`; “sim” à configuração inicial ativa `$zaip-skill-config`. A skill explica opções e faz perguntas curtas antes de aplicar escolhas; o aceite não autoriza valores presumidos, credenciais, recursos externos ou publicação.
+
+Depois de configurar e verificar GitHub, ofereça a configuração inicial com **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?** Depois de concluir a configuração inicial, encerre o onboarding. Recusa ou adiamento encerra a oferta sem insistência; uma solicitação posterior pode retomá-la.
+
 Esta skill não executa nem descreve upgrade, migração ou rollback como ações primárias. Esses fluxos somente podem ser encaminhados às skills `zaip-update` ou `zaip-rollback` quando estiverem disponíveis e forem aplicáveis; elas não são uma dependência portátil desta skill.
 
 ## Perfis Codex ZAIP-AIOS

package/templates/.agents/skills/zaip-skill-setup/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "ZAIP Setup"
-  short_description: "Install ZAIP-AIOS in a new workspace."
-  default_prompt: "Use $zaip-skill-setup to install ZAIP-AIOS in a workspace that does not yet have ZAIP."
+  short_description: "Install ZAIP-AIOS and format the installation reply."
+  default_prompt: "Use $zaip-skill-setup to install ZAIP-AIOS or format the final reply after init with Markdown bullets, the installed-version npm link and the final setup question."

package/templates/.agents/skills/zaip-skill-update-version-doc/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: zaip-skill-update-version-doc
+description: Update and verify the ZAIP-AIOS installer candidate version, code identities and documentation; mandatory for the framework builder before build, packing or release qualification.
+---
+
+# Update version doc
+
+Use in the ZAIP-AIOS framework source. The installed copy explains maintenance;
+it must not change a consumer application's version. This workflow does not publish.
+
+1. Read the root `package.json` and the authorized release target. Its `version`
+   is the only product-version input; public manifests and runtime constants are projections.
+   Run `node scripts/update-version-doc.mjs inspect`, then `plan N.N.0` to inspect
+   the exact owned files before `apply N.N.0`. Omit the target to repair current identity.
+2. Keep general instructions versionless. Link to the generated
+   `docs/release-identity.md` in source documentation; installed guidance uses
+   `zaip version --json`. Preserve historical releases, evidence, upgrade fixtures,
+   schema versions, dependencies and compatibility minima. Never replace a number globally.
+   A newly introduced product identity must enter the updater inventory and tests.
+3. Review current instructions against actual CLI behavior: Node requirement from the public
+   manifest, Git optional for installation, commands/flags, supported environments and
+   managed-runtime limitations. Updating numbers alone does not validate documentation.
+4. Run `node scripts/update-version-doc.mjs check` before building. Build source,
+   regenerate adapters from their canonical generator, and build release artifacts. Synchronize
+   framework lock after release generation updates managed manifests, then sync the public
+   template. `pnpm release:artifacts:prepared` enforces this order. Never relabel a stale binary.
+   Check again after generation; run `verify-package` against the prepared artifacts.
+5. Apply `zaip-skill-release-qualification` to the final committed candidate.
+   Bind results to its SHA and TGZ hashes. Report candidate, installed and published versions
+   separately. A missing registry observation remains unavailable; local checks do not prove
+   publication or sustained stability.
+
+The builder must run this workflow for every installer release. Its source check is also called
+by build/pack gates. A failed check blocks qualification. `apply` validates every proposed edit
+before writing and can resume idempotently after interruption; it does not certify artifacts.
+
+In a distributed skill context, the wrapper
+`node .agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.mjs inspect`
+locates the maintainer helper or fails without mutating the consumer.

package/templates/.agents/skills/zaip-skill-update-version-doc/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Update version doc"
+  short_description: "Sincronizar versão, código e documentação"
+  default_prompt: "Use $zaip-skill-update-version-doc para preparar e verificar a versão do instalador ZAIP-AIOS."

package/templates/.agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.mjs

@@ -0,0 +1,21 @@
+import { access, readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const root = resolve(import.meta.dirname, "../../../..");
+const helper = resolve(root, "scripts/update-version-doc.mjs");
+const manifest = JSON.parse(await readFile(resolve(root, "package.json"), "utf8"));
+if (manifest.name !== "@zaip-ai/aios") {
+  throw new Error(
+    "Framework source required; a consumer application's version must remain unchanged.",
+  );
+}
+try {
+  await access(helper);
+} catch {
+  throw new Error(
+    "Run this framework release skill in the ZAIP-AIOS source repository; do not rewrite a consumer project's version.",
+  );
+}
+const { main } = await import(pathToFileURL(helper).href);
+process.stdout.write(`${JSON.stringify(await main(process.argv.slice(2), root), null, 2)}\n`);

package/templates/.agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.test.mjs

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { access, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, resolve } from "node:path";
+import test from "node:test";
+
+test("installed consumer wrapper refuses before importing an unrelated project helper", async (t) => {
+  const root = await mkdtemp(resolve(tmpdir(), "zaip-skill-version-"));
+  t.after(() => rm(root, { recursive: true, force: true }));
+  const wrapper = resolve(
+    root,
+    ".agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.mjs",
+  );
+  await mkdir(dirname(wrapper), { recursive: true });
+  await writeFile(wrapper, await readFile(new URL("./update-version-doc.mjs", import.meta.url)));
+  await writeFile(resolve(root, "package.json"), '{"name":"consumer-app","version":"1.0.0"}');
+  await mkdir(resolve(root, "scripts"));
+  await writeFile(
+    resolve(root, "scripts/update-version-doc.mjs"),
+    'import { writeFileSync } from "node:fs"; writeFileSync("unexpected-import", "bad"); export function main() {}',
+  );
+  const result = spawnSync(process.execPath, [wrapper, "apply", "9.9.0"], {
+    cwd: root,
+    encoding: "utf8",
+    windowsHide: true,
+  });
+  assert.notEqual(result.status, 0);
+  assert.match(result.stderr, /consumer application's version must remain unchanged/);
+  await assert.rejects(access(resolve(root, "unexpected-import")), { code: "ENOENT" });
+  assert.equal(JSON.parse(await readFile(resolve(root, "package.json"))).version, "1.0.0");
+});

package/templates/.agents/zaip-aios/README.md

@@ -68,7 +68,8 @@ nem reabertura de entregas históricas bloqueadas.
 
 A documentação descreve `autonomy-v1`; publicação e qualificação devem ser
 confirmadas pelos artefatos da release, não apenas pela versão deste checkout.
-Os manifests deste checkout identificam o candidato `3.1.0`. Novos templates usam
+<!-- zaip-version-reference -->
+Consulte a versão instalada com `zaip version --json` e a identidade do checkout no manifesto raiz. Novos templates usam
 Equilibrado e `execution.runtime: managed`: PRDs/SPECs gerenciados e tarefas
 avulsas preferencialmente diretas. Configurações legadas sem essa opção mantêm
 o default manual do schema; salvar configuração não inicia execução.

package/templates/.agents/zaip-aios/VERSION

@@ -1 +1 @@
-3.1
+3.3

package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md

@@ -5,9 +5,12 @@ Este guia descreve o modelo de lifecycle V2 no layout V3. Durante a transição,
 ## Pré-requisitos
 
 - Node.js 22.16.0 ou superior, conforme o requisito do pacote, com `node:sqlite` disponível;
-- Git;
 - permissões de escrita no repositório consumidor.
 
+Git, identidade de autor, repositório, commit inicial e configuração do GitHub
+podem ser preparados depois da instalação. O runtime exige Git e histórico local
+antes de iniciar entregas; essa exigência não bloqueia `init`.
+
 O consumidor não precisa compilar o monorepo nem instalar pnpm para executar
 o runtime distribuído. No checkout mantenedor, use o pnpm fixado em
 `packageManager` (11.12.0 neste snapshot), com `corepack pnpm` quando disponível.
@@ -30,6 +33,28 @@ instalador; nos exemplos de lifecycle deste guia, `zaip ...` é uma abreviação
 de `node .agents/runtime/bin/zaip.mjs ...` no projeto consumidor. Use o caminho
 explícito para evitar colisão entre os dois CLIs.
 
+### Resumo e próximos passos
+
+A resposta final do assistente mantém a frase inicial com o comando, a linha
+“Resumo:”, bullets e exatamente uma pergunta no final. Siga o modelo obrigatório
+de `.agents/skills/zaip-skill-setup/SKILL.md`, inclusive quando a instalação começou
+antes de as skills estarem disponíveis. Não converta o resumo em parágrafos.
+A versão instalada usa o rótulo `vVERSÃO` com link para sua página no npm,
+contagens reais de arquivos e resultados de SQLite e `doctor`. O link usa
+`https://www.npmjs.com/package/@zaip-ai/cli/v/<versão-instalada>`.
+
+Quando o GitHub ainda precisa de configuração, a última pergunta é:
+**Deseja ajuda para configurar seu repositório Git?**
+Se a configuração local já estiver identificada, a pergunta será:
+**Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?**
+Configuração local não comprova autenticação remota.
+
+No terminal, a pergunta é textual: o comando encerra normalmente. No chat,
+responder “sim” encaminha à skill de GitHub ou de configuração do projeto.
+A skill apresenta o que pode configurar e coleta as escolhas antes de editar.
+Concluído o GitHub, oferece a configuração do projeto; concluído o projeto,
+encerra o onboarding. Uma recusa ou adiamento encerra a oferta sem insistência.
+
 ### Manuais e seleção de modelos
 
 Antes de usar os comandos de desenvolvimento abaixo, consulte os manuais instalados