chore(ci-shared): saneia refs a repos arquivados, cria config e fatia docs [INFRA-68876] #58

Merged

tmf-ia merged 1 commit from fix/ci-shared-refs-arquivadas-e-docs into develop

2026-10-08 11:49:15 -03:00

tmf-ia commented

2026-10-08 11:15:27 -03:00

Owner

O que

Saneamento do ci-shared após o arquivamento de TMF/TMF_Claude_Specs e TMF/infra (07/10). Epic INFRA-68876.

1. Referências a repos arquivados (INFRA-68877)

Cabeçalho CANÔNICO de 10 workflows (ci, ci-base, docs-lint, generate-docs, hub-issue-sync, install-aws-kubectl, install-docker, login-forgejo-registry, smoke-test-health, sync-docs-to-hub, verificar-docs-produto): Standards/ADRs: TMF/TMF_Claude_Specs → TMF/ORG.

2. Mensagens "Build CI Images no TMF/infra" (INFRA-68880 — decisão)

As 3 mensagens de erro do gate de Trivy (ci.yml, ci-base.yml, reusable-trivy-scan.yml) mandavam rodar Build CI Images no TMF/infra arquivado (não roda Actions). Investigação confirmou um buraco de migração: o epic INFRA-66795 ("migrar o build para o ci-shared") está Done mas o build-ci-images.yml nunca saiu do TMF/infra. As mensagens passam a dizer a verdade (rebuild sem lar ativo) e apontam INFRA-68880, onde registrei a decisão com 3 opções + recomendação. Exemplo uses: do reusable-trivy-scan corrigido de TMF/infra → TMF/ci-shared.

Comentários/TODOs internos que só descrevem a história ("vivia no TMF/infra") foram deixados de propósito para o epic de migração INFRA-68880 resolver, evitando inflar este PR.

3. `.claude/config.json` (INFRA-68878)

O repo não tinha config — o resolver devolvia issue_product/client_id vazios. Criado com issue_product=infra, client_id, prefixo INFRA, owner/repo.

4. Fatiar o README (INFRA-68879)

README de 1457 → 40 linhas (índice). Conteúdo movido para docs/:

docs/workflows-reusaveis.md — catálogo de cada workflow/action
docs/guia-de-adocao.md — adoção do CI/release/deploy único
docs/scripts.md — scripts, router blue-green + rollback, apêndice nginx
docs/runbook-ci-vermelho.md — regras anti-verde-falso

Removida a duplicação literal das seções de adoção (bloco de 207 linhas). Fatiamento determinístico por intervalos (corte literal, sem reescrita). Os testes que liam a doc do README (tests/ci-unico, tests/release) passam a ler do novo local em docs/.

Validação

Suítes locais: ci-config, ci-unico, hub-issue-sync, if-em-caller, infisical-secrets, nginx-log, release (353), reusable-publico, soberania → verdes. generate-docs falha só localmente por python ausente nesta máquina (returncode 127); passa na imagem de CI.
Cobertura do fatiamento conferida: as únicas linhas não migradas são a duplicação removida.
YAML dos 12 workflows validado.

Escopo

Nenhuma mudança de comportamento de CI/CD — só cabeçalhos, mensagens de erro, config e documentação. Sem deploy, sem tag.

Epic: INFRA-68876 · Subtasks: INFRA-68877, INFRA-68878, INFRA-68879 · Decisão: INFRA-68880 (needs_human)

🤖 Generated with Claude Code

## O que Saneamento do `ci-shared` após o arquivamento de `TMF/TMF_Claude_Specs` e `TMF/infra` (07/10). Epic **INFRA-68876**. ### 1. Referências a repos arquivados (INFRA-68877) Cabeçalho CANÔNICO de **10 workflows** (`ci`, `ci-base`, `docs-lint`, `generate-docs`, `hub-issue-sync`, `install-aws-kubectl`, `install-docker`, `login-forgejo-registry`, `smoke-test-health`, `sync-docs-to-hub`, `verificar-docs-produto`): `Standards/ADRs: TMF/TMF_Claude_Specs` → `TMF/ORG`. ### 2. Mensagens "Build CI Images no TMF/infra" (INFRA-68880 — decisão) As 3 mensagens de erro do gate de Trivy (`ci.yml`, `ci-base.yml`, `reusable-trivy-scan.yml`) mandavam rodar `Build CI Images` no `TMF/infra` **arquivado** (não roda Actions). Investigação confirmou um **buraco de migração**: o epic INFRA-66795 ("migrar o build para o ci-shared") está `Done` mas o `build-ci-images.yml` nunca saiu do TMF/infra. As mensagens passam a dizer a verdade (rebuild sem lar ativo) e apontam **INFRA-68880**, onde registrei a decisão com 3 opções + recomendação. Exemplo `uses:` do `reusable-trivy-scan` corrigido de `TMF/infra` → `TMF/ci-shared`. > Comentários/TODOs internos que só descrevem a história ("vivia no TMF/infra") foram deixados de propósito para o epic de migração INFRA-68880 resolver, evitando inflar este PR. ### 3. `.claude/config.json` (INFRA-68878) O repo não tinha config — o resolver devolvia `issue_product`/`client_id` vazios. Criado com `issue_product=infra`, `client_id`, prefixo `INFRA`, owner/repo. ### 4. Fatiar o README (INFRA-68879) README de **1457 → 40 linhas** (índice). Conteúdo movido para `docs/`: - `docs/workflows-reusaveis.md` — catálogo de cada workflow/action - `docs/guia-de-adocao.md` — adoção do CI/release/deploy único - `docs/scripts.md` — scripts, router blue-green + rollback, apêndice nginx - `docs/runbook-ci-vermelho.md` — regras anti-verde-falso Removida a **duplicação literal** das seções de adoção (bloco de 207 linhas). Fatiamento determinístico por intervalos (corte literal, sem reescrita). Os testes que liam a doc do README (`tests/ci-unico`, `tests/release`) passam a ler do novo local em `docs/`. ## Validação - Suítes locais: `ci-config`, `ci-unico`, `hub-issue-sync`, `if-em-caller`, `infisical-secrets`, `nginx-log`, `release` (353), `reusable-publico`, `soberania` → **verdes**. `generate-docs` falha só localmente por `python` ausente nesta máquina (returncode 127); passa na imagem de CI. - Cobertura do fatiamento conferida: as únicas linhas não migradas são a duplicação removida. - YAML dos 12 workflows validado. ## Escopo Nenhuma mudança de comportamento de CI/CD — só cabeçalhos, mensagens de erro, config e documentação. Sem deploy, sem tag. Epic: **INFRA-68876** · Subtasks: INFRA-68877, INFRA-68878, INFRA-68879 · Decisão: **INFRA-68880** (needs_human) 🤖 Generated with [Claude Code](https://claude.com/claude-code)

tmf-ia added 1 commit

2026-10-08 11:15:27 -03:00

chore(ci-shared): saneia refs a repos arquivados, cria config e fatia docs [INFRA-68876]

PR checks (ci-shared) / testes (pull_request) Successful in 3m10s

Details

e2dea5e171

Em 2026-10-07 foram arquivados TMF/TMF_Claude_Specs (standards/ADRs migraram para
TMF/ORG) e TMF/infra (monorepo de infra). Este PR corrige o que o ci-shared ainda
apontava para esses repos mortos, cria o config do projeto e fatia o README.

- refs [INFRA-68877]: cabeçalho CANÔNICO de 10 workflows TMF/TMF_Claude_Specs -> TMF/ORG.
- build-ci-images [INFRA-68880]: as 3 mensagens de erro do gate de Trivy deixam de
  mandar "rodar 'Build CI Images' no TMF/infra" (arquivado) e passam a dizer a verdade
  (rebuild sem lar ativo), apontando a decisão INFRA-68880. Exemplo `uses:` do
  reusable-trivy-scan corrigido de TMF/infra para TMF/ci-shared.
- config [INFRA-68878]: cria .claude/config.json (issue_product=infra, client_id).
- docs [INFRA-68879]: fatia o README (1457 -> 40 linhas) em docs/ (workflows reusáveis,
  guia de adoção, scripts, runbook de CI vermelho) + README de índice; remove a
  duplicação literal das seções de adoção. Os testes que liam a documentação do README
  (tests/ci-unico, tests/release) passam a ler do novo local em docs/.

A migração do build de imagens (epic INFRA-66795, marcado Done sem aterrissar no
ci-shared) fica registrada como a decisão INFRA-68880 (needs_human, com opções).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SCXwCdbp97ioN6p3rC3diT

tmf-ia referenced this pull request

2026-10-08 11:33:08 -03:00

feat(ci-images): restaura o build das imagens de CI no ci-shared [INFRA-68880] #59

tmf-ia merged commit 46e151a0e2 into develop

2026-10-08 11:49:15 -03:00

tmf-ia referenced this pull request from a commit

2026-10-08 11:49:17 -03:00

Merge pull request 'chore(ci-shared): saneia refs a repos arquivados, cria config e fatia docs [INFRA-68876]' (#58) from fix/ci-shared-refs-arquivadas-e-docs into develop