[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F7JPAT3NED2SP9RY6H5Q9S":3,"skill-same:01M7F7JPAT3NED2SP9RY6H5Q9S":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7F7JPAT3NED2SP9RY6H5Q9S","rdd-core-publish",null,"Publica as melhorias da config local do workflow RDD (~\u002F.config\u002Fopencode\u002F) no repositório remoto da config via git commit + push (branch main), fechando o ciclo de publicação após o @rdd-workflow-improver corrigir ou o @rdd-workflow-builder criar componentes. Contrato híbrido de aprovação (IMP-090): pedido explícito de publicação + tema único + nada fora do escopo + gates verdes = execução direta (0 perguntas); qualquer anomalia = 1 question consolidada com o pacote completo (temas + arquivos + mensagens + push) — aprovação do pacote, nunca commit cego. Nunca git add -A \u002F git add . (só paths explícitos), roda git pull --ff-only antes do push e nunca força push. Use quando o usuário pedir \"subir alterações do workflow\", \"publicar melhorias do RDD\", \"dar push na config\", \"commitar as melhorias do workflow\", \"publicar IMP-XXX\" ou \"push das mudanças na config do opencode\".","victor-souza-dev\u002FRDD-CORE","victor-souza-dev","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F64621536?v=4","01M7F7EA6XYQ0FNS1P773C2GEA","Victor Souza","01M7F7EA7JWP2CBG8X80TWE2X5",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-core-publish\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: rdd-core-publish\ndescription: >-\n  Publica as melhorias da config local do workflow RDD (~\u002F.config\u002Fopencode\u002F)\n  no repositório remoto da config via git commit + push (branch main), fechando o\n  ciclo de publicação após o @rdd-workflow-improver corrigir ou o @rdd-workflow-builder\n  criar componentes. Contrato híbrido de aprovação (IMP-090): pedido explícito de\n  publicação + tema único + nada fora do escopo + gates verdes = execução direta\n  (0 perguntas); qualquer anomalia = 1 question consolidada com o pacote completo\n  (temas + arquivos + mensagens + push) — aprovação do pacote, nunca commit cego.\n  Nunca git add -A \u002F git add . (só paths explícitos), roda git pull --ff-only antes\n  do push e nunca força push. Use quando o usuário pedir \"subir alterações do workflow\",\n  \"publicar melhorias do RDD\", \"dar push na\n  config\", \"commitar as melhorias do workflow\", \"publicar IMP-XXX\" ou \"push das\n  mudanças na config do opencode\".\n---\n\n# rdd-core-publish — Publicação segura das melhorias da config RDD\n\nResponde \"como publicar as melhorias aplicadas na config RDD local para os demais\nambientes?\" — o espelho inverso do `rdd-core-update` (que apenas traz do remote via\npull; esta skill apenas empacota e envia via commit + push). Diferente do\n`@rdd-workflow-improver` (corrige o workflow) e do `@rdd-workflow-builder` (cria\ncomponentes) — esta skill **não edita nada**; publica o que já está no working tree.\n\n## Contexto do repositório\n\n- **Repo alvo:** `~\u002F.config\u002Fopencode\u002F` (é o próprio diretório de config\n  (~ = path da config local do OpenCode na SUA máquina — se a sua instalação usar outro local, confirme no bloco local do AGENTS.md via rdd-setup)\n  do OpenCode — contém `.git\u002F`)\n- **Remote (origin):** derivado do próprio repo — `git -C $HOME\u002F.config\u002Fopencode remote get-url origin` (IMP-105: zero hardcode de org\u002Frepo; exemplos ilustrativos podem citar a org do operador).\n- **Branch:** `main`\n- **Escopo de versionamento:** o `.gitignore` do repo versiona apenas\n  `agents\u002Frdd-*.md`, `skills\u002Frdd-*\u002FSKILL.md`, `ARCHITECTURE.md` e\n  `WORKFLOW_IMPROVEMENTS.md`.\n\n## Lê (upstream)\n\n- Estado do working tree via `git status --porcelain` (repo alvo)\n- `HEAD` local vs `origin\u002Fmain` (via `git fetch` + comparação de refs)\n- Diff a publicar via `git diff` \u002F `git diff --cached --stat`\n- `evals\u002Ftrends\u002Ftrends.json` e `evals\u002Freports\u002FEVAL_REPORT_*.md` (Golden Set\n  Gate — frescor e regressão dos evals das skills a publicar)\n- `evals\u002F\u003Cskill>\u002Ffixture-*\u002Fcriteria.yaml` (verificação de cobertura)\n\n## Gera (downstream)\n\n- Commits no repo alvo (mensagens Conventional Commits, atômicos quando houver\n  mudanças distintas) e push para `origin\u002Fmain`. Saída textual na sessão:\n  status (publicado\u002Fabortado), commits criados e orientações. **Não persiste\n  arquivos de artefato.**\n\n## Nunca edita\n\n- **Nunca** cria, edita ou remove arquivos da config — empacota apenas o que já\n- **Exceção ÚNICA:** `MANIFEST.sha256` (IMP-103) — este é o ÚNICO arquivo que esta skill escreve (regenerado a cada publicação); todo o resto permanece intocado.\n  existe no working tree (trabalho de improver\u002Fbuilder).\n- **Nunca** `git push --force` \u002F `--force-with-lease`.\n- **Nunca** `git add -A` \u002F `git add .` — apenas paths explícitos do escopo versionado.\n- **Nunca** resolve conflitos nem faz merge\u002Frebase automático.\n- **Nunca** inclui no commit arquivos fora do escopo versionado (AGENTS.md,\n  opencode.jsonc, settings.json, hooks\u002F, plugins\u002F, command\u002F*, skills\u002Fagents não-rdd-*).\n- **Nunca** edita artefatos de módulo de projeto (REQUIREMENTS.md etc.).\n- **Nunca** aceita alteração em `evals\u002Fgolden-human\u002F` num commit publicado (IMP-100): golden set humano é intocado por agents — path explícito nesse diretório na lista de staging = **rejeitar** e sinalizar anomalia (Passo 4). O Golden Set Gate NÃO exige golden verde nesse diretório (casos são escassos e humanos).\n\n## Tools\n\n- `bash` — exclusivamente para comandos `git` no repo alvo:\n  `git -C $HOME\u002F.config\u002Fopencode status --porcelain`,\n  `git -C ... remote -v`, `git -C ... fetch origin`,\n  `git -C ... rev-parse HEAD`, `git -C ... rev-parse origin\u002Fmain`,\n  `git -C ... pull --ff-only`, `git -C ... add \u003Cpaths explícitos do escopo>`,\n  `git -C ... diff --cached --stat`, `git -C ... commit -m \"\u003Cmensagem>\"`,\n  `git -C ... push origin main`, `git -C ... log --oneline`\n- `read` (para inspecionar arquivos a publicar, se necessário)\n- `question` (gate consolidado único — IMP-090: aprovação do pacote temas +\n  arquivos + mensagens + push, SOMENTE em anomalia; fluxo feliz executa sem question)\n\n## Modo de erro\n\n`abort` — qualquer condição de risco (working tree sujo fora do escopo confirmado,\npull não fast-forward, branch divergente, push rejeitado, rede\u002Fcredencial\nindisponível, repo sem remote, finding crítico no Health Gate (Passo 3.5)) **aborta a operação inteira** com mensagem clara.\nAnomalia não-crítica → 1 `question` consolidada com o pacote antes de commitar\n(Passo 4 — IMP-090); detectada entre commit e push → abort + orientação.\nA skill nunca força, nunca faz merge\u002Frebase automático, nunca resolve conflito\nsozinha e nunca força push.\n\n## Algoritmo\n\n### Passo 0 — Pré-condições (repo + remote)\n\n```bash\ngit -C $HOME\u002F.config\u002Fopencode status --porcelain\ngit -C $HOME\u002F.config\u002Fopencode remote -v\n```\n\n- Se não é repo git (`.git` ausente) ou git indisponível → **ABORTA** e orienta.\n- Se não há remote `origin` → **ABORTA** e orienta configurar\n  `git remote add origin \u003CURL do repo da config>` (URL da org do operador).\n\n### Passo 1 — Listar mudanças e classificar o escopo (sem pergunta)\n\n- Liste **TODAS** as mudanças (`M`\u002F`A`\u002F`D`\u002F`R`\u002F`C`\u002F`??`).\n- Separe em duas listas:\n  - **Escopo versionado (publicável):** `agents\u002Frdd-*.md`, `skills\u002Frdd-*\u002FSKILL.md`,\n    `ARCHITECTURE-*.md`, `WORKFLOW_IMPROVEMENTS.md`.\n  - **Fora do escopo (não publicável):** todo o resto — `opencode.jsonc`,\n    `AGENTS.md`, `settings.json`, `hooks\u002F`, `plugins\u002F`, `command\u002F*`,\n    skills\u002Fagents não-rdd-*. A maioria está no `.gitignore` e nem aparece no\n    status; se algo aparecer, **não incluir** e sinalizar como anomalia (Passo 4).\n- Se a lista publicável estiver **vazia** → informe *\"nada a publicar\"* e encerre\n  (working tree limpo ou só mudanças fora do escopo versionado).\n- **Sem `question` neste passo** — a classificação de escopo é automática e\n  alimenta a decisão única do Passo 4 (IMP-090). \"Nunca commit cego\" vira\n  aprovação do PACOTE: pedido explícito no fluxo feliz ou 1 question\n  consolidada em anomalia.\n\n### Passo 1.5 — Golden Set Gate (evals de regressão)\n\nSe a lista publicável incluir `skills\u002Frdd-*\u002FSKILL.md` ou `agents\u002Frdd-*.md`,\nverifique o estado do golden set (`evals\u002F`) **antes** de commitar:\n\n1. **Cobertura:** para cada skill alterada, verifique se existe\n   `evals\u002F\u003Cskill>\u002Ffixture-*\u002Fcriteria.yaml`. Skill alterada sem fixture →\n   **warning** (prossiga, mas avise: \"skill X sem cobertura de eval\").\n2. **Frescor:** compare a data da última entrada de `evals\u002Ftrends\u002Ftrends.json`\n   (ou do relatório mais recente em `evals\u002Freports\u002F` para a skill) com a data\n   da modificação do arquivo (git diff não traz data; use timestamp do arquivo).\n   Eval mais antigo que a última edição da skill → **BLOQUEIA**: *\"A skill X\n   foi editada após o último eval. Rode `rdd-skill-eval --skill X` antes de\n   publicar.\"* (O eval é executado pelo improver\u002Fbuilder ou pelo primary —\n   esta skill não executa evals, apenas verifica.)\n3. **Regressão:** leia o relatório de eval mais recente da skill. Se houver\n   FAIL de severity `error` (ou score menor que a entrada anterior do\n   trends.json) → **BLOQUEIA** com opções: (a) corrigir a skill e reavaliar,\n   (b) se a mudança de comportamento é intencional, atualizar o baseline\n   (`output-expected\u002F`) explicitamente via `rdd-skill-eval` e reavaliar.\n   **Nunca publique com regressão conhecida sem decisão explícita do usuário.**\n\nGate read-only: usa apenas `read` (trends.json, reports, criteria.yaml).\nSe `evals\u002F` não existir, pule o gate com aviso (\"golden set ausente —\nconsidere criar fixtures para as skills alteradas\").\n\n### Passo 2 — Sincronizar com o remote (fetch + divergência)\n\n```bash\ngit -C $HOME\u002F.config\u002Fopencode fetch origin\ngit -C $HOME\u002F.config\u002Fopencode rev-parse HEAD\ngit -C $HOME\u002F.config\u002Fopencode rev-parse origin\u002Fmain\n```\n\n- `git fetch` falhou (rede\u002Fcredencial) → **ABORTA**: *\"Não foi possível contatar o\n  remote (rede\u002Fcredencial). O estado local não foi alterado. Tente novamente mais\n  tarde.\"* Nunca prossiga sem fetch bem-sucedido.\n- **HEAD atrás de origin\u002Fmain** (origin\u002Fmain não está contido em HEAD) →\n  `git -C ... pull --ff-only` (o local precisa estar atualizado antes do push).\n  - Pull ok → prossiga.\n  - Pull abortou por WIP ou divergência → **ABORTA** e orienta (ver casos de borda).\n- **Branch divergente** (HEAD e origin\u002Fmain têm commits que o outro não tem) →\n  **ABORTA** e orienta resolução manual (ver casos de borda). Nunca força push.\n\n### Passo 3 — Preparar e commitar (atômico por tema, sem pergunta)\n\n- Agrupe as mudanças por tema distinto (ex.: skill nova; correção de skill;\n  atualização de arquitetura) e redija a(s) mensagem(ns) Conventional Commits\n  (seção \"Formato de commit\") — agrupar e redigir é trabalho da skill, não\n  pergunta (IMP-090). Para cada tema, crie um commit atômico:\n  ```bash\n  git -C $HOME\u002F.config\u002Fopencode add \u003Cpaths explícitos do escopo>\n  git -C $HOME\u002F.config\u002Fopencode diff --cached --stat   # revisar staged\n  git -C $HOME\u002F.config\u002Fopencode commit -m \"\u003Cmensagem>\"\n  ```\n- **Nunca** `git add -A` \u002F `git add .` — sempre paths explícitos.\n- Um único tema → um único commit.\n\n### Passo 3.7 — MANIFEST de integridade (IMP-103)\n\nRegenerar `MANIFEST.sha256` na raiz do repo e incluir no push:\n\n1. Liste os arquivos versionados: `git -C $HOME\u002F.config\u002Fopencode ls-files` (paths relativos).\n   **OBRIGATÓRIO (bug real 18\u002F10\u002F2026):** antes do git, definir `[Console]::OutputEncoding = [Text.Encoding]::UTF8` e usar `-c core.quotepath=false` — sem isso paths com em-dash\u002Facento (ex.: `RN-010 — Analise-Funcional.md`) vêm escapados\u002Foctal e 19+ arquivos ficam fora do MANIFEST silenciosamente. Paths escapados (`\\NNN` octal) devem ser desescapados antes do hash. `Test-Path`\u002F`Get-FileHash` SEMPRE com `-LiteralPath`. Gravar com `[IO.File]::WriteAllLines($path, $lines, [Text.UTF8Encoding]::new($false))` — **NUNCA `Out-File -Encoding ascii`** (nem qualquer `-Encoding ascii`): mangle de não-ASCII → `?`; bug real 18\u002F10\u002F2026: regeneração com `-Encoding ascii` corrompeu 19 labels do MANIFEST (em-dash\u002Facentos), detectado na 3ª auditoria de saúde (IMP-103).\n2. Para cada path, calcule o sha256 do conteúdo em disco (PowerShell: `Get-FileHash -Algorithm SHA256`; Linux: `sha256sum`). Uma linha por arquivo: `\u003Csha256>  \u003Cpath-relativo>`. **INCLUIR o próprio `MANIFEST.sha256` na lista e na contagem** (prática consolidada, validada 18\u002F10\u002F2026: contagem 834\u002F834 == `git ls-files`, com commit exclusivo do MANIFEST) — o hash gravado dele fica do commit anterior (auto-referência é inerente; o que importa é a COBERTURA de paths: todo arquivo versionado tem linha no MANIFEST).\n3. Grave o resultado em `MANIFEST.sha256` (UTF-8 sem BOM, LF — `[IO.File]::WriteAllLines` + `UTF8Encoding($false)`; NUNCA `-Encoding ascii`, bug 18\u002F10\u002F2026).\n4. Valide a contagem: entradas do MANIFEST == `git ls-files | count` — qualquer diferença = **ABORTA** (integridade parcial não se publica).\n5. `git -C ... add MANIFEST.sha256` e commit exclusivo: `chore(rdd): atualiza MANIFEST.sha256`.\n6. Falha ao calcular hash de qualquer arquivo = **ABORTA** (integridade parcial não se publica).\n\n### Passo 3.5 — Health Gate (integridade estrutural dos arquivos alterados)\n\nAntes de qualquer push, execute o fluxo do `rdd-agent-health-monitor`\n**restrito aos arquivos alterados neste commit** (`agents\u002F*.md` e\n`skills\u002F*\u002FSKILL.md` publicáveis — escopo reduzido, NÃO a auditoria completa\nde ~100 arquivos):\n\n1. Para cada arquivo alterado, rode no mínimo a Verificação F itens 10-13\n   do monitor (IMP-086): delimitadores de front matter (abre E fecha\n   exatamente `---`), YAML parseável, `permission:` declarado (agents).\n2. **Fail-closed:** QUALQUER FINDING crítico → **ABORTA o push** (commits\n   locais permanecem locais), reporte os findings na sessão e oriente a\n   correção via `@rdd-workflow-improver` antes de reintentar.\n3. O push só prossegue com **0 findings críticos** nos arquivos alterados.\n4. O resultado do gate é reportado **na sessão** (texto) — não persiste\n   arquivo de relatório (esta skill não grava artefatos).\n\n### Passo 4 — Decisão única e push seguro (IMP-090)\n\n- **Fluxo feliz** — TODAS as condições verdadeiras → push direto, **0 questions**:\n  pedido explícito de publicação (\"publicar\", \"subir\", \"dar push\") sem ressalva de\n  escopo + **um único tema** de mudança + **nada fora do escopo** no status\n  (Passo 1) + Golden Set Gate (Passo 1.5), Health Gate (Passo 3.5) e sync\n  (Passo 2) verdes.\n\n  ```bash\n  git -C $HOME\u002F.config\u002Fopencode pull --ff-only   # garantia dupla (idempotente)\n  git -C $HOME\u002F.config\u002Fopencode push origin main\n  ```\n\n  O pacote completo (tema, arquivos, mensagens) é exibido no relatório final —\n  o operador aprova o PACOTE (pedido explícito), não cada etapa.\n- **Anomalia** — QUALQUER condição abaixo → **1 `question` consolidada** com o\n  pacote completo (temas + arquivos + mensagens + push), opções aprovar \u002F ajustar \u002F\n  cancelar:\n  - ≥ 2 temas distintos de mudança;\n  - arquivo fora do escopo detectado no status (Passo 1);\n  - Golden Set Gate com warning\u002Fdecisão pendente (Passo 1.5);\n  - Health Gate com finding não-crítico a decidir (finding crítico = abort — Modo de erro);\n  - divergência com remote que admita decisão do operador (atrás = pull --ff-only\n    e segue; divergência real = abort — Modo de erro);\n  - pedido ambíguo ou parcial (ex.: \"só prepara\", \"não pusha\" → execute até a\n    etapa pedida, reporte e encerre).\n- Anomalia detectada **antes de commitar** → a question acontece antes do commit\n  (nada é commitado sem o visto). Detectada **entre commit e push** (ex.: push\n  rejeitado) → vale o Modo de erro (abort + orientação).\n- `push` rejeitado (non-fast-forward — remote avançou desde o fetch) → **ABORTA** e\n  orienta (ver casos de borda). **Nunca** `--force`.\n- `push` rejeitado por branch policy (ex.: PR obrigatório) → **ABORTA** e orienta\n  criar PR (ver casos de borda).\n\n### Passo 5 — Aviso final obrigatório\n\nInforme: *\"Config não é hot-reloaded — **reinicie o OpenCode** para que as\nskills\u002Fagents atualizados passem a valer na sessão. Os demais ambientes recebem\nesta publicação via `rdd-core-update` (git pull --ff-only no repo do remote origin).\"*\n\n## Formato de saída\n\n```text\n═══ rdd-core-publish — \u003CRESULTADO> ═══\n\n📦 Repo: ~\u002F.config\u002Fopencode\u002F (remote origin @ main)\n\n✅ PUBLICADO COM SUCESSO\n   Commits criados (N):\n     - a11bcc0 feat(rdd): IMP-013 nova skill rdd-core-publish\n     - b3c9f2e fix(rdd): rdd-azure-task-creator convenção de título\n   Push: origin\u002Fmain (branch atualizada)\n\n⚠️ Reinicie o OpenCode para a nova config valer.\n   Demais ambientes recebem via rdd-core-update.\n\n── ou ──\n\n⛔ ABORTADO — \u003Cmotivo>\n   Explicação + orientação de resolução manual.\n   Nada foi alterado no repo.\n```\n\n## Workflow\n\n1. Pré-condições: repo + remote (Passo 0).\n2. `git status --porcelain` → lista publicável vs fora do escopo, sem pergunta\n   (Passo 1).\n3. **Golden Set Gate** — frescor + regressão dos evals das skills alteradas\n   (Passo 1.5); bloqueia se eval pendente ou regressão sem decisão explícita.\n4. `git fetch origin` + comparação HEAD vs origin\u002Fmain; pull --ff-only se atrás\n   (Passo 2).\n5. Commit atômico por tema — a skill agrupa temas, redige mensagens e commita\n   sem pergunta; `git add` explícito (Passo 3).\n6. **MANIFEST de integridade** — regenera `MANIFEST.sha256` e commit exclusivo (Passo 3.7, IMP-103).\n7. **Health Gate** — integridade estrutural dos arquivos alterados (Passo 3.5);\n   fail-closed: qualquer FINDING crítico aborta o push (corrige via\n   `@rdd-workflow-improver` antes de reintentar).\n8. **Decisão única (IMP-090)** — fluxo feliz (pedido explícito + tema único +\n   nada fora do escopo + gates verdes): `git pull --ff-only` + `git push origin main`\n   direto, 0 questions; qualquer anomalia: 1 question consolidada com o pacote\n   (Passo 4).\n9. Aviso final: reiniciar OpenCode + demais ambientes via rdd-core-update (Passo 5).\n\n## Casos de Borda\n\n### Golden Set Gate bloqueia (eval pendente ou regressão)\n\n**ABORTA** (antes de qualquer commit) e orienta: *\"A skill X foi editada após\no último eval\" (frescor) ou \"o último eval da skill X tem FAIL error\u002Fscore\nabaixo do anterior\" (regressão). Opções: (a) rodar `rdd-skill-eval --skill X`\nagora, (b) se a mudança de comportamento é intencional, atualizar o baseline\nvia rdd-skill-eval e reavaliar, (c) cancelar a publicação.* A publicação só\nprossegue após eval verde ou decisão explícita registrada do usuário.\n\n\n### MANIFEST divergente no pull anterior (IMP-103)\n\nSe o `rdd-core-update` reportou arquivos divergentes do `MANIFEST.sha256`,\nresolva ANTES de publicar: commit legítimo (incluir no pacote) ou descarte\nconsciente pelo operador. Publicar por cima de divergência silencia o\ndetector de tampering.\n\n### Health Gate bloqueia (finding crítico nos arquivos alterados)\n\n**ABORTA o push** (commits já criados permanecem locais) e reporta os\nfindings — ex.: front matter com delimitador quebrado (caso real IMP-086:\n` --` no lugar de `---` fez o runtime descartar permissões em silêncio).\nOrientação: corrigir via `@rdd-workflow-improver` e rodar `rdd-core-publish`\nde novo. Nunca publique componente com front matter quebrado.\n\n### Repo sem remote configurado\n\n`git fetch origin` falha por ausência de remote → **ABORTA**: *\"O repo\n`~\u002F.config\u002Fopencode` não tem remote origin. Verifique `git -C ... remote -v` e\nconfigure o remote origin com `git remote add origin \u003CURL do repo da config>`.\"*\n\n### Nada a publicar (working tree limpo ou nada no escopo)\n\nInforme *\"nada a publicar\"* com o status completo e encerre sem tocar em nada.\n\n### Arquivos fora do escopo no status\n\nExplique que `opencode.jsonc`, `AGENTS.md`, `settings.json`, `hooks\u002F`, `plugins\u002F`,\n`command\u002F*` e skills\u002Fagents não-rdd-* não são versionados e **não entram no\ncommit**, mesmo que apareçam no status. Inclua apenas os paths do escopo versionado.\n\n### Pull aborta por WIP (entre status e pull)\n\nSe o `pull --ff-only` falhar por WIP local → **ABORTA**: *\"Há WIP local na config —\nnão vou sobrescrever nem misturar. Opções: (a) commitar o WIP e rodar de novo, (b)\nresolver manualmente depois de um `git stash`, (c) inspecionar os arquivos antes de\ndecidir.\"* Nunca `git reset --hard`\u002F`checkout -- .` automaticamente.\n\n### Branch divergente (pull --ff-only falha \u002F push rejeitado non-fast-forward)\n\n**ABORTA** e orienta: *\"A branch local divergiu do remote. Identifique seus commits\nlocais com `git -C ... log origin\u002Fmain..HEAD` e decida entre `git rebase\norigin\u002Fmain` (histórico linear) ou `git merge origin\u002Fmain` (commit de merge).\nDepois rode rdd-core-publish de novo.\"* **Nunca** `git push --force`.\n\n### Push rejeitado por branch policy (ex.: PR obrigatório)\n\n**ABORTA** e orienta: *\"O remote rejeitou o push por branch policy. Crie um PR\nmanualmente: `git push origin HEAD:feature\u002F...` e abra o PR no Azure DevOps\nno remote origin).\"* A skill não cria PR.\n\n### Rede \u002F credencial indisponível\n\n`fetch` ou `push` falham por rede\u002Fcredencial → **ABORTA**: *\"Não foi possível\ncontatar o remote (rede\u002Fcredencial). O estado local não foi alterado. Tente\nnovamente mais tarde.\"* Commits locais já criados permanecem locais — oriente\nre-execução do Passo 4 quando a rede voltar.\n\n### Git não disponível \u002F não é repo\n\n`git status` falha → verifique se o diretório é repo (`.git` existe) e se o git\nestá no PATH; informe sem alterar nada.\n\n### Mudanças que não devem ir para o remote\n\nSe o usuário tiver experimentos locais (ex.: skill em teste que não deve ser\npublicada), **não** os inclua — liste como \"não publicável\" no Passo 1 e trate\ncomo anomalia (Passo 4): a question consolidada registra a decisão explícita\ndo usuário.\n\n## Formato de commit\n\nConventional Commits, mensagens em PT-BR descrevendo as melhorias publicadas.\nSe a mudança corresponder a um IMP registrado em WORKFLOW_IMPROVEMENTS.md, cite-o:\n\n- `feat(rdd): IMP-013 nova skill rdd-core-publish`\n- `feat(rdd): IMP-012 convenção de título de task obrigatória`\n- `fix(rdd): rdd-data-model seção §6`\n- `docs(rdd): atualiza ARCHITECTURE-MAP com rdd-core-publish`\n\nMúltiplas mudanças distintas → múltiplos commits atômicos (um por tema); uma única\nmudança → um único commit. Nunca empacotar temas não relacionados no mesmo commit.\n","# rdd-core-publish — Publicação segura das melhorias da config RDD\n\nResponde \"como publicar as melhorias aplicadas na config RDD local para os demais\nambientes?\" — o espelho inverso do `rdd-core-update` (que apenas traz do remote via\npull; esta skill apenas empacota e envia via commit + push). Diferente do\n`@rdd-workflow-improver` (corrige o workflow) e do `@rdd-workflow-builder` (cria\ncomponentes) — esta skill **não edita nada**; publica o que já está no working tree.\n\n## Contexto do repositório\n\n- **Repo alvo:** `~\u002F.config\u002Fopencode\u002F` (é o próprio diretório de config\n  (~ = path da config local do OpenCode na SUA máquina — se a sua instalação usar outro local, confirme no bloco local do AGENTS.md via rdd-setup)\n  do OpenCode — contém `.git\u002F`)\n- **Remote (origin):** derivado do próprio repo — `git -C $HOME\u002F.config\u002Fopencode remote get-url origin` (IMP-105: zero hardcode de org\u002Frepo; exemplos ilustrativos podem citar a org do operador).\n- **Branch:** `main`\n- **Escopo de versionamento:** o `.gitignore` do repo versiona apenas\n  `agents\u002Frdd-*.md`, `skills\u002Frdd-*\u002FSKILL.md`, `ARCHITECTURE.md` e\n  `WORKFLOW_IMPROVEMENTS.md`.\n\n## Lê (upstream)\n\n- Estado do working tree via `git status --porcelain` (repo alvo)\n- `HEAD` local vs `origin\u002Fmain` (via `git fetch` + comparação de refs)\n- Diff a publicar via `git diff` \u002F `git diff --cached --stat`\n- `evals\u002Ftrends\u002Ftrends.json` e `evals\u002Freports\u002FEVAL_REPORT_*.md` (Golden Set\n  Gate — frescor e regressão dos evals das skills a publicar)\n- `evals\u002F\u003Cskill>\u002Ffixture-*\u002Fcriteria.yaml` (verificação de cobertura)\n\n## Gera (downstream)\n\n- Commits no repo alvo (mensagens Conventional Commits, atômicos quando houver\n  mudanças distintas) e push para `origin\u002Fmain`. Saída textual na sessão:\n  status (publicado\u002Fabortado), commits criados e orientações. **Não persiste\n  arquivos de artefato.**\n\n## Nunca edita\n\n- **Nunca** cria, edita ou remove arquivos da config — empacota apenas o que já\n- **Exceção ÚNICA:** `MANIFEST.sha256` (IMP-103) — este é o ÚNICO arquivo que esta skill escreve (regenerado a cada publicação); todo o resto permanece intocado.\n  existe no working tree (trabalho de improver\u002Fbuilder).\n- **Nunca** `git push --force` \u002F `--force-with-lease`.\n- **Nunca** `git add -A` \u002F `git add .` — apenas paths explícitos do escopo versionado.\n- **Nunca** resolve conflitos nem faz merge\u002Frebase automático.\n- **Nunca** inclui no commit arquivos fora do escopo versionado (AGENTS.md,\n  opencode.jsonc, settings.json, hooks\u002F, plugins\u002F, command\u002F*, skills\u002Fagents não-rdd-*).\n- **Nunca** edita artefatos de módulo de projeto (REQUIREMENTS.md etc.).\n- **Nunca** aceita alteração em `evals\u002Fgolden-human\u002F` num commit publicado (IMP-100): golden set humano é intocado por agents — path explícito nesse diretório na lista de staging = **rejeitar** e sinalizar anomalia (Passo 4). O Golden Set Gate NÃO exige golden verde nesse diretório (casos são escassos e humanos).\n\n## Tools\n\n- `bash` — exclusivamente para comandos `git` no repo alvo:\n  `git -C $HOME\u002F.config\u002Fopencode status --porcelain`,\n  `git -C ... remote -v`, `git -C ... fetch origin`,\n  `git -C ... rev-parse HEAD`, `git -C ... rev-parse origin\u002Fmain`,\n  `git -C ... pull --ff-only`, `git -C ... add \u003Cpaths explícitos do escopo>`,\n  `git -C ... diff --cached --stat`, `git -C ... commit -m \"\u003Cmensagem>\"`,\n  `git -C ... push origin main`, `git -C ... log --oneline`\n- `read` (para inspecionar arquivos a publicar, se necessário)\n- `question` (gate consolidado único — IMP-090: aprovação do pacote temas +\n  arquivos + mensagens + push, SOMENTE em anomalia; fluxo feliz executa sem question)\n\n## Modo de erro\n\n`abort` — qualquer condição de risco (working tree sujo fora do escopo confirmado,\npull não fast-forward, branch divergente, push rejeitado, rede\u002Fcredencial\nindisponível, repo sem remote, finding crítico no Health Gate (Passo 3.5)) **aborta a operação inteira** com mensagem clara.\nAnomalia não-crítica → 1 `question` consolidada com o pacote antes de commitar\n(Passo 4 — IMP-090); detectada entre commit e push → abort + orientação.\nA skill nunca força, nunca faz merge\u002Frebase automático, nunca resolve conflito\nsozinha e nunca força push.\n\n## Algoritmo\n\n### Passo 0 — Pré-condições (repo + remote)\n\n```bash\ngit -C $HOME\u002F.config\u002Fopencode status --porcelain\ngit -C $HOME\u002F.config\u002Fopencode remote -v\n```\n\n- Se não é repo git (`.git` ausente) ou git indisponível → **ABORTA** e orienta.\n- Se não há remote `origin` → **ABORTA** e orienta configurar\n  `git remote add origin \u003CURL do repo da config>` (URL da org do operador).\n\n### Passo 1 — Listar mudanças e classificar o escopo (sem pergunta)\n\n- Liste **TODAS** as mudanças (`M`\u002F`A`\u002F`D`\u002F`R`\u002F`C`\u002F`??`).\n- Separe em duas listas:\n  - **Escopo versionado (publicável):** `agents\u002Frdd-*.md`, `skills\u002Frdd-*\u002FSKILL.md`,\n    `ARCHITECTURE-*.md`, `WORKFLOW_IMPROVEMENTS.md`.\n  - **Fora do escopo (não publicável):** todo o resto — `opencode.jsonc`,\n    `AGENTS.md`, `settings.json`, `hooks\u002F`, `plugins\u002F`, `command\u002F*`,\n    skills\u002Fagents não-rdd-*. A maioria está no `.gitignore` e nem aparece no\n    status; se algo aparecer, **não incluir** e sinalizar como anomalia (Passo 4).\n- Se a lista publicável estiver **vazia** → informe *\"nada a publicar\"* e encerre\n  (working tree limpo ou só mudanças fora do escopo versionado).\n- **Sem `question` neste passo** — a classificação de escopo é automática e\n  alimenta a decisão única do Passo 4 (IMP-090). \"Nunca commit cego\" vira\n  aprovação do PACOTE: pedido explícito no fluxo feliz ou 1 question\n  consolidada em anomalia.\n\n### Passo 1.5 — Golden Set Gate (evals de regressão)\n\nSe a lista publicável incluir `skills\u002Frdd-*\u002FSKILL.md` ou `agents\u002Frdd-*.md`,\nverifique o estado do golden set (`evals\u002F`) **antes** de commitar:\n\n1. **Cobertura:** para cada skill alterada, verifique se existe\n   `evals\u002F\u003Cskill>\u002Ffixture-*\u002Fcriteria.yaml`. Skill alterada sem fixture →\n   **warning** (prossiga, mas avise: \"skill X sem cobertura de eval\").\n2. **Frescor:** compare a data da última entrada de `evals\u002Ftrends\u002Ftrends.json`\n   (ou do relatório mais recente em `evals\u002Freports\u002F` para a skill) com a data\n   da modificação do arquivo (git diff não traz data; use timestamp do arquivo).\n   Eval mais antigo que a última edição da skill → **BLOQUEIA**: *\"A skill X\n   foi editada após o último eval. Rode `rdd-skill-eval --skill X` antes de\n   publicar.\"* (O eval é executado pelo improver\u002Fbuilder ou pelo primary —\n   esta skill não executa evals, apenas verifica.)\n3. **Regressão:** leia o relatório de eval mais recente da skill. Se houver\n   FAIL de severity `error` (ou score menor que a entrada anterior do\n   trends.json) → **BLOQUEIA** com opções: (a) corrigir a skill e reavaliar,\n   (b) se a mudança de comportamento é intencional, atualizar o baseline\n   (`output-expected\u002F`) explicitamente via `rdd-skill-eval` e reavaliar.\n   **Nunca publique com regressão conhecida sem decisão explícita do usuário.**\n\nGate read-only: usa apenas `read` (trends.json, reports, criteria.yaml).\nSe `evals\u002F` não existir, pule o gate com aviso (\"golden set ausente —\nconsidere criar fixtures para as skills alteradas\").\n\n### Passo 2 — Sincronizar com o remote (fetch + divergência)\n\n```bash\ngit -C $HOME\u002F.config\u002Fopencode fetch origin\ngit -C $HOME\u002F.config\u002Fopencode rev-parse HEAD\ngit -C $HOME\u002F.config\u002Fopencode rev-parse origin\u002Fmain\n```\n\n- `git fetch` falhou (rede\u002Fcredencial) → **ABORTA**: *\"Não foi possível contatar o\n  remote (rede\u002Fcredencial). O estado local não foi alterado. Tente novamente mais\n  tarde.\"* Nunca prossiga sem fetch bem-sucedido.\n- **HEAD atrás de origin\u002Fmain** (origin\u002Fmain não está contido em HEAD) →\n  `git -C ... pull --ff-only` (o local precisa estar atualizado antes do push).\n  - Pull ok → prossiga.\n  - Pull abortou por WIP ou divergência → **ABORTA** e orienta (ver casos de borda).\n- **Branch divergente** (HEAD e origin\u002Fmain têm commits que o outro não tem) →\n  **ABORTA** e orienta resolução manual (ver casos de borda). Nunca força push.\n\n### Passo 3 — Preparar e commitar (atômico por tema, sem pergunta)\n\n- Agrupe as mudanças por tema distinto (ex.: skill nova; correção de skill;\n  atualização de arquitetura) e redija a(s) mensagem(ns) Conventional Commits\n  (seção \"Formato de commit\") — agrupar e redigir é trabalho da skill, não\n  pergunta (IMP-090). Para cada tema, crie um commit atômico:\n  ```bash\n  git -C $HOME\u002F.config\u002Fopencode add \u003Cpaths explícitos do escopo>\n  git -C $HOME\u002F.config\u002Fopencode diff --cached --stat   # revisar staged\n  git -C $HOME\u002F.config\u002Fopencode commit -m \"\u003Cmensagem>\"\n  ```\n- **Nunca** `git add -A` \u002F `git add .` — sempre paths explícitos.\n- Um único tema → um único commit.\n\n### Passo 3.7 — MANIFEST de integridade (IMP-103)\n\nRegenerar `MANIFEST.sha256` na raiz do repo e incluir no push:\n\n1. Liste os arquivos versionados: `git -C $HOME\u002F.config\u002Fopencode ls-files` (paths relativos).\n   **OBRIGATÓRIO (bug real 18\u002F10\u002F2026):** antes do git, definir `[Console]::OutputEncoding = [Text.Encoding]::UTF8` e usar `-c core.quotepath=false` — sem isso paths com em-dash\u002Facento (ex.: `RN-010 — Analise-Funcional.md`) vêm escapados\u002Foctal e 19+ arquivos ficam fora do MANIFEST silenciosamente. Paths escapados (`\\NNN` octal) devem ser desescapados antes do hash. `Test-Path`\u002F`Get-FileHash` SEMPRE com `-LiteralPath`. Gravar com `[IO.File]::WriteAllLines($path, $lines, [Text.UTF8Encoding]::new($false))` — **NUNCA `Out-File -Encoding ascii`** (nem qualquer `-Encoding ascii`): mangle de não-ASCII → `?`; bug real 18\u002F10\u002F2026: regeneração com `-Encoding ascii` corrompeu 19 labels do MANIFEST (em-dash\u002Facentos), detectado na 3ª auditoria de saúde (IMP-103).\n2. Para cada path, calcule o sha256 do conteúdo em disco (PowerShell: `Get-FileHash -Algorithm SHA256`; Linux: `sha256sum`). Uma linha por arquivo: `\u003Csha256>  \u003Cpath-relativo>`. **INCLUIR o próprio `MANIFEST.sha256` na lista e na contagem** (prática consolidada, validada 18\u002F10\u002F2026: contagem 834\u002F834 == `git ls-files`, com commit exclusivo do MANIFEST) — o hash gravado dele fica do commit anterior (auto-referência é inerente; o que importa é a COBERTURA de paths: todo arquivo versionado tem linha no MANIFEST).\n3. Grave o resultado em `MANIFEST.sha256` (UTF-8 sem BOM, LF — `[IO.File]::WriteAllLines` + `UTF8Encoding($false)`; NUNCA `-Encoding ascii`, bug 18\u002F10\u002F2026).\n4. Valide a contagem: entradas do MANIFEST == `git ls-files | count` — qualquer diferença = **ABORTA** (integridade parcial não se publica).\n5. `git -C ... add MANIFEST.sha256` e commit exclusivo: `chore(rdd): atualiza MANIFEST.sha256`.\n6. Falha ao calcular hash de qualquer arquivo = **ABORTA** (integridade parcial não se publica).\n\n### Passo 3.5 — Health Gate (integridade estrutural dos arquivos alterados)\n\nAntes de qualquer push, execute o fluxo do `rdd-agent-health-monitor`\n**restrito aos arquivos alterados neste commit** (`agents\u002F*.md` e\n`skills\u002F*\u002FSKILL.md` publicáveis — escopo reduzido, NÃO a auditoria completa\nde ~100 arquivos):\n\n1. Para cada arquivo alterado, rode no mínimo a Verificação F itens 10-13\n   do monitor (IMP-086): delimitadores de front matter (abre E fecha\n   exatamente `---`), YAML parseável, `permission:` declarado (agents).\n2. **Fail-closed:** QUALQUER FINDING crítico → **ABORTA o push** (commits\n   locais permanecem locais), reporte os findings na sessão e oriente a\n   correção via `@rdd-workflow-improver` antes de reintentar.\n3. O push só prossegue com **0 findings críticos** nos arquivos alterados.\n4. O resultado do gate é reportado **na sessão** (texto) — não persiste\n   arquivo de relatório (esta skill não grava artefatos).\n\n### Passo 4 — Decisão única e push seguro (IMP-090)\n\n- **Fluxo feliz** — TODAS as condições verdadeiras → push direto, **0 questions**:\n  pedido explícito de publicação (\"publicar\", \"subir\", \"dar push\") sem ressalva de\n  escopo + **um único tema** de mudança + **nada fora do escopo** no status\n  (Passo 1) + Golden Set Gate (Passo 1.5), Health Gate (Passo 3.5) e sync\n  (Passo 2) verdes.\n\n  ```bash\n  git -C $HOME\u002F.config\u002Fopencode pull --ff-only   # garantia dupla (idempotente)\n  git -C $HOME\u002F.config\u002Fopencode push origin main\n  ```\n\n  O pacote completo (tema, arquivos, mensagens) é exibido no relatório final —\n  o operador aprova o PACOTE (pedido explícito), não cada etapa.\n- **Anomalia** — QUALQUER condição abaixo → **1 `question` consolidada** com o\n  pacote completo (temas + arquivos + mensagens + push), opções aprovar \u002F ajustar \u002F\n  cancelar:\n  - ≥ 2 temas distintos de mudança;\n  - arquivo fora do escopo detectado no status (Passo 1);\n  - Golden Set Gate com warning\u002Fdecisão pendente (Passo 1.5);\n  - Health Gate com finding não-crítico a decidir (finding crítico = abort — Modo de erro);\n  - divergência com remote que admita decisão do operador (atrás = pull --ff-only\n    e segue; divergência real = abort — Modo de erro);\n  - pedido ambíguo ou parcial (ex.: \"só prepara\", \"não pusha\" → execute até a\n    etapa pedida, reporte e encerre).\n- Anomalia detectada **antes de commitar** → a question acontece antes do commit\n  (nada é commitado sem o visto). Detectada **entre commit e push** (ex.: push\n  rejeitado) → vale o Modo de erro (abort + orientação).\n- `push` rejeitado (non-fast-forward — remote avançou desde o fetch) → **ABORTA** e\n  orienta (ver casos de borda). **Nunca** `--force`.\n- `push` rejeitado por branch policy (ex.: PR obrigatório) → **ABORTA** e orienta\n  criar PR (ver casos de borda).\n\n### Passo 5 — Aviso final obrigatório\n\nInforme: *\"Config não é hot-reloaded — **reinicie o OpenCode** para que as\nskills\u002Fagents atualizados passem a valer na sessão. Os demais ambientes recebem\nesta publicação via `rdd-core-update` (git pull --ff-only no repo do remote origin).\"*\n\n## Formato de saída\n\n```text\n═══ rdd-core-publish — \u003CRESULTADO> ═══\n\n📦 Repo: ~\u002F.config\u002Fopencode\u002F (remote origin @ main)\n\n✅ PUBLICADO COM SUCESSO\n   Commits criados (N):\n     - a11bcc0 feat(rdd): IMP-013 nova skill rdd-core-publish\n     - b3c9f2e fix(rdd): rdd-azure-task-creator convenção de título\n   Push: origin\u002Fmain (branch atualizada)\n\n⚠️ Reinicie o OpenCode para a nova config valer.\n   Demais ambientes recebem via rdd-core-update.\n\n── ou ──\n\n⛔ ABORTADO — \u003Cmotivo>\n   Explicação + orientação de resolução manual.\n   Nada foi alterado no repo.\n```\n\n## Workflow\n\n1. Pré-condições: repo + remote (Passo 0).\n2. `git status --porcelain` → lista publicável vs fora do escopo, sem pergunta\n   (Passo 1).\n3. **Golden Set Gate** — frescor + regressão dos evals das skills alteradas\n   (Passo 1.5); bloqueia se eval pendente ou regressão sem decisão explícita.\n4. `git fetch origin` + comparação HEAD vs origin\u002Fmain; pull --ff-only se atrás\n   (Passo 2).\n5. Commit atômico por tema — a skill agrupa temas, redige mensagens e commita\n   sem pergunta; `git add` explícito (Passo 3).\n6. **MANIFEST de integridade** — regenera `MANIFEST.sha256` e commit exclusivo (Passo 3.7, IMP-103).\n7. **Health Gate** — integridade estrutural dos arquivos alterados (Passo 3.5);\n   fail-closed: qualquer FINDING crítico aborta o push (corrige via\n   `@rdd-workflow-improver` antes de reintentar).\n8. **Decisão única (IMP-090)** — fluxo feliz (pedido explícito + tema único +\n   nada fora do escopo + gates verdes): `git pull --ff-only` + `git push origin main`\n   direto, 0 questions; qualquer anomalia: 1 question consolidada com o pacote\n   (Passo 4).\n9. Aviso final: reiniciar OpenCode + demais ambientes via rdd-core-update (Passo 5).\n\n## Casos de Borda\n\n### Golden Set Gate bloqueia (eval pendente ou regressão)\n\n**ABORTA** (antes de qualquer commit) e orienta: *\"A skill X foi editada após\no último eval\" (frescor) ou \"o último eval da skill X tem FAIL error\u002Fscore\nabaixo do anterior\" (regressão). Opções: (a) rodar `rdd-skill-eval --skill X`\nagora, (b) se a mudança de comportamento é intencional, atualizar o baseline\nvia rdd-skill-eval e reavaliar, (c) cancelar a publicação.* A publicação só\nprossegue após eval verde ou decisão explícita registrada do usuário.\n\n\n### MANIFEST divergente no pull anterior (IMP-103)\n\nSe o `rdd-core-update` reportou arquivos divergentes do `MANIFEST.sha256`,\nresolva ANTES de publicar: commit legítimo (incluir no pacote) ou descarte\nconsciente pelo operador. Publicar por cima de divergência silencia o\ndetector de tampering.\n\n### Health Gate bloqueia (finding crítico nos arquivos alterados)\n\n**ABORTA o push** (commits já criados permanecem locais) e reporta os\nfindings — ex.: front matter com delimitador quebrado (caso real IMP-086:\n` --` no lugar de `---` fez o runtime descartar permissões em silêncio).\nOrientação: corrigir via `@rdd-workflow-improver` e rodar `rdd-core-publish`\nde novo. Nunca publique componente com front matter quebrado.\n\n### Repo sem remote configurado\n\n`git fetch origin` falha por ausência de remote → **ABORTA**: *\"O repo\n`~\u002F.config\u002Fopencode` não tem remote origin. Verifique `git -C ... remote -v` e\nconfigure o remote origin com `git remote add origin \u003CURL do repo da config>`.\"*\n\n### Nada a publicar (working tree limpo ou nada no escopo)\n\nInforme *\"nada a publicar\"* com o status completo e encerre sem tocar em nada.\n\n### Arquivos fora do escopo no status\n\nExplique que `opencode.jsonc`, `AGENTS.md`, `settings.json`, `hooks\u002F`, `plugins\u002F`,\n`command\u002F*` e skills\u002Fagents não-rdd-* não são versionados e **não entram no\ncommit**, mesmo que apareçam no status. Inclua apenas os paths do escopo versionado.\n\n### Pull aborta por WIP (entre status e pull)\n\nSe o `pull --ff-only` falhar por WIP local → **ABORTA**: *\"Há WIP local na config —\nnão vou sobrescrever nem misturar. Opções: (a) commitar o WIP e rodar de novo, (b)\nresolver manualmente depois de um `git stash`, (c) inspecionar os arquivos antes de\ndecidir.\"* Nunca `git reset --hard`\u002F`checkout -- .` automaticamente.\n\n### Branch divergente (pull --ff-only falha \u002F push rejeitado non-fast-forward)\n\n**ABORTA** e orienta: *\"A branch local divergiu do remote. Identifique seus commits\nlocais com `git -C ... log origin\u002Fmain..HEAD` e decida entre `git rebase\norigin\u002Fmain` (histórico linear) ou `git merge origin\u002Fmain` (commit de merge).\nDepois rode rdd-core-publish de novo.\"* **Nunca** `git push --force`.\n\n### Push rejeitado por branch policy (ex.: PR obrigatório)\n\n**ABORTA** e orienta: *\"O remote rejeitou o push por branch policy. Crie um PR\nmanualmente: `git push origin HEAD:feature\u002F...` e abra o PR no Azure DevOps\nno remote origin).\"* A skill não cria PR.\n\n### Rede \u002F credencial indisponível\n\n`fetch` ou `push` falham por rede\u002Fcredencial → **ABORTA**: *\"Não foi possível\ncontatar o remote (rede\u002Fcredencial). O estado local não foi alterado. Tente\nnovamente mais tarde.\"* Commits locais já criados permanecem locais — oriente\nre-execução do Passo 4 quando a rede voltar.\n\n### Git não disponível \u002F não é repo\n\n`git status` falha → verifique se o diretório é repo (`.git` existe) e se o git\nestá no PATH; informe sem alterar nada.\n\n### Mudanças que não devem ir para o remote\n\nSe o usuário tiver experimentos locais (ex.: skill em teste que não deve ser\npublicada), **não** os inclua — liste como \"não publicável\" no Passo 1 e trate\ncomo anomalia (Passo 4): a question consolidada registra a decisão explícita\ndo usuário.\n\n## Formato de commit\n\nConventional Commits, mensagens em PT-BR descrevendo as melhorias publicadas.\nSe a mudança corresponder a um IMP registrado em WORKFLOW_IMPROVEMENTS.md, cite-o:\n\n- `feat(rdd): IMP-013 nova skill rdd-core-publish`\n- `feat(rdd): IMP-012 convenção de título de task obrigatória`\n- `fix(rdd): rdd-data-model seção §6`\n- `docs(rdd): atualiza ARCHITECTURE-MAP com rdd-core-publish`\n\nMúltiplas mudanças distintas → múltiplos commits atômicos (um por tema); uma única\nmudança → um único commit. Nunca empacotar temas não relacionados no mesmo commit.\n",{"name":5,"description":7},"main","05e20b6d9814f32d3ca57765f48899bcfda65e8d","skills\u002Frdd-core-publish",1,"https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev","2026-11-04 03:31:33",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add victor-souza-dev\u002FRDD-CORE --skill rdd-core-publish",{"tool":37,"command":38},"bunx","bunx skills add victor-souza-dev\u002FRDD-CORE --skill rdd-core-publish",{"tool":40,"command":41},"pnpm","pnpm dlx skills add victor-souza-dev\u002FRDD-CORE --skill rdd-core-publish","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-core-publish\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7F86EZ2VGP7RMRSVPRPFX3F","rdd-wiki-lint","Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir \"lint dos documentos\", \"verificar integridade dos artefatos\", \"wiki lint\", \"contradições nos docs\" ou \"validar estrutura\".","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-wiki-lint\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7F864WAQJN8VYCBJGSC2V0R","rdd-vps-troubleshoot","Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy \u002F healthcheck expirando, GHCR denied\u002Funauthorized no pull, git \"could not read Username for 'https:\u002F\u002Fgithub.com'\", GitHub Actions (appleboy\u002Fssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl \u002F docker logs), conectividade (curl local vs público, ss, nc) e banco vazio \u002F migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules\u002F\u003Cpack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar \"container unhealthy\", \"deploy falhou\", \"ssh action erro\", \"ghcr denied\", \"tunnel não responde\", \"banco vazio\", \"sem tabelas\", \"service duplicado\", \"vps com problema\" ou pedir troubleshooting de deploy.","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-vps-troubleshoot\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7F85QDCCQ3T6QK172FJGR96","rdd-vps-setup","Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy\u002Fssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules\u002F\u003Cpack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir \"setup de VPS\", \"configurar VPS nova\", \"preparar servidor para deploy\", \"tunnel cloudflare\", \"ghcr\", \"deploy key\", \"backup rclone\", \"docker compose na vps\" ou \"pipeline de deploy na VPS\".","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-vps-setup\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7F85EPCKVPGR9EJPFH2W86D","rdd-validate","Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir \"validar integridade\", \"checar a DAG\", \"validar referências cruzadas\" ou \"validação do módulo\".","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-validate\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7F856HRDC0DDMN4H92FVM63","rdd-ui-spec","Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir \"especificação de UI\", \"spec de telas\", \"layout de formulários\" ou \"fluxo de navegação\".","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-ui-spec\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7F850DAQH17TJB0QR69W66F","rdd-ui-capture","Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota\u002Festado, requisições de rede observadas e erros de console, gravados em reverse\u002Fui\u002F com manifesto reverse\u002FUI_CAPTURE.md e candidatas visuais na fila reverse\u002FCANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir \"captura visual\", \"golden master de UI\", \"screenshots do legado\", \"captura de UI\" ou \"ui capture\".","https:\u002F\u002Fgithub.com\u002Fvictor-souza-dev\u002FRDD-CORE\u002Fblob\u002Fmain\u002Fskills\u002Frdd-ui-capture\u002FSKILL.md",[],[]]