OPS68 — docs: drift GitHub-era no AGENT-OPS/README — reescrita da parte 2 do OPS50 #83

Merged

fsolla merged 3 commits from OPS68-docs-drift-github-era-no-agent-ops-readme-gh-pr-vercel into main

2026-08-19 13:33:06 +00:00

fsolla commented

2026-08-19 13:13:42 +00:00

Owner

O que é

Fechamento da parte 2 do OPS50: reescrita linha-a-linha dos docs canônicos operacionais que ainda descreviam a era GitHub/Vercel — 12 arquivos, edições pontuais (78+/82−).

docs/AGENT-OPS.md — norte "só Forgejo + Cursor"; fonte canônica = Issues do Forgejo; fluxo do agente e Contrato de PR sem gh (criação via API/MCP + merge pelo safety net agent-pr-ready-automerge.yml, que espera o rollup CI (PR) / checks); "Só humano" = envs ~/stack/teqo-1313.env + branch protection + runbook; tabela de secrets sem POOL_GITHUB_TOKEN (legado — script o ignora) e nota de pool dormente; linha archive-cursor-agent.yml na tabela CI.
README.md — cheatsheet de 5 linhas reescrito (claim → push → PR via API/MCP → safety net mergea → ci.yml janela 30 min + deploy homeserver); Neon → homeserver Postgres; PROD_DATABASE_URL = DATABASE_URL de ~/stack/teqo-1313.env; migrações no deploy via teqo-1313-migrate; "GitHub mirror" → Forgejo Actions; papéis coordinator/advisor/leader/candidate; "electoral nuclei" → municípios; Issues → link Forgejo.
docs/roadmap.md — só o ponteiro da fonte canônica (o stub continua congelado).
AGENTS.md — refs Neon → homeserver teqo_1313; job do gate check→gate (key real do YAML); "Vercel preview" → host genérico na rationale WebAuthn.
.agents/rules/agent-pr-workflow.mdc — comandos gh pr create/merge/checks morrem (gh não existe em nenhuma máquina — OPS50); regra descreve API/MCP + safety net; "There is no deploy from CI" corrigido (OPS53 colocou o deploy no ci.yml).
Skills — work-issue (SKILL + execution-pipeline), plan-issue (frontmatter, gate "nada no Forgejo", dedup via pnpm issue all), project-status, capture-review-debts, engineering-audit (gh issue list → pnpm issue all/API; issue-done-on-stage-merge.yml→on-main; merge stage→main), worktree-next-issue, agent-pool (Forgejo Actions; workflow marcado removido OPS65; estado em pool-state.json).

Mantido como registro histórico (exclusões explícitas do impl plan): menções de Vercel/Neon/POOL_GITHUB_TOKEN que documentam remoções (AGENTS.md L15/L105/L167, AGENT-OPS L94/L98, "Vercel/Git-integration deploy gate" como guardrail no rule).

Docs-only: CI roda os docs-guards (a suíte unit não roda por scope). Gate local: format:check verde, changelog:build/changelog:check verdes, grep de saída zero nas classes gh pr/gh issue/github.com/fsolla/GitHub Issues/GitHub mirror/POOL_GITHUB/Neon-em-uso nos 12 alvos.

Closes #74

## O que é Fechamento da parte 2 do OPS50: reescrita linha-a-linha dos docs canônicos operacionais que ainda descreviam a era GitHub/Vercel — 12 arquivos, edições pontuais (78+/82−). - **`docs/AGENT-OPS.md`** — norte "só Forgejo + Cursor"; fonte canônica = Issues do Forgejo; fluxo do agente e Contrato de PR sem `gh` (criação via API/MCP + merge pelo safety net `agent-pr-ready-automerge.yml`, que espera o rollup `CI (PR) / checks`); "Só humano" = envs `~/stack/teqo-1313.env` + branch protection + runbook; tabela de secrets sem `POOL_GITHUB_TOKEN` (legado — script o ignora) e nota de pool dormente; linha `archive-cursor-agent.yml` na tabela CI. - **`README.md`** — cheatsheet de 5 linhas reescrito (claim → push → PR via API/MCP → safety net mergea → `ci.yml` janela 30 min + deploy homeserver); Neon → homeserver Postgres; `PROD_DATABASE_URL` = `DATABASE_URL` de `~/stack/teqo-1313.env`; migrações no deploy via `teqo-1313-migrate`; "GitHub mirror" → Forgejo Actions; papéis `coordinator/advisor/leader/candidate`; "electoral nuclei" → municípios; Issues → link Forgejo. - **`docs/roadmap.md`** — só o ponteiro da fonte canônica (o stub continua congelado). - **`AGENTS.md`** — refs Neon → homeserver `teqo_1313`; job do gate `check`→`gate` (key real do YAML); "Vercel preview" → host genérico na rationale WebAuthn. - **`.agents/rules/agent-pr-workflow.mdc`** — comandos `gh pr create/merge/checks` morrem (`gh` não existe em nenhuma máquina — OPS50); regra descreve API/MCP + safety net; "There is no deploy from CI" corrigido (OPS53 colocou o deploy no `ci.yml`). - **Skills** — `work-issue` (SKILL + `execution-pipeline`), `plan-issue` (frontmatter, gate "nada no Forgejo", dedup via `pnpm issue all`), `project-status`, `capture-review-debts`, `engineering-audit` (`gh issue list` → `pnpm issue all`/API; `issue-done-on-stage-merge.yml`→`on-main`; merge `stage`→`main`), `worktree-next-issue`, `agent-pool` (Forgejo Actions; workflow marcado removido OPS65; estado em `pool-state.json`). **Mantido como registro histórico** (exclusões explícitas do impl plan): menções de Vercel/Neon/`POOL_GITHUB_TOKEN` que documentam remoções (AGENTS.md L15/L105/L167, AGENT-OPS L94/L98, "Vercel/Git-integration deploy gate" como guardrail no rule). Docs-only: CI roda os docs-guards (a suíte unit não roda por scope). Gate local: `format:check` verde, `changelog:build`/`changelog:check` verdes, grep de saída zero nas classes `gh pr`/`gh issue`/`github.com/fsolla`/`GitHub Issues`/`GitHub mirror`/`POOL_GITHUB`/Neon-em-uso nos 12 alvos. Closes #74

fsolla added 1 commit 2026-08-19 13:13:42 +00:00

docs(OPS68): reescreve docs canônicos da era GitHub/Vercel para Forgejo/homeserver

CI (PR) / checks (pull_request) Successful in 1m32s

Details

PR Ready + auto-merge / ready-automerge (pull_request) Failing after 2m19s

Details

d64c2c9c36

Parte 2 do OPS50 (fechamento): AGENT-OPS, README, roadmap (ponteiro),
AGENTS.md (refs Neon/job gate), rule agent-pr-workflow e 8 skills de
operação sem comandos gh (API/MCP + safety net) nem secrets Vercel —
fonte canônica única: git.solla.dev/fsolla/teqo.

fsolla force-pushed OPS68-docs-drift-github-era-no-agent-ops-readme-gh-pr-vercel from d64c2c9c36 to 235cf36dc1

2026-08-19 13:27:08 +00:00

Compare

fsolla added 1 commit 2026-08-19 13:31:45 +00:00

docs(OPS68): agregado do changelog com a entrada OPS68 (ficou fora do rebase)

CI (PR) / checks (pull_request) Successful in 1m15s

Details

PR Ready + auto-merge / ready-automerge (pull_request) Successful in 1m21s

Details

Promote plan-issue Related on main merge / plan-issue-ready (pull_request) Has been skipped

Details

Main merge flips claimed issues to done + in-prod / issue-done (pull_request) Successful in 12s

Details

bc1a109239

O --ours no conflito do agregado (OPS66) deixou a entrada OPS68 fora do
commit; changelog:build regenera e o docs-guard do CI exige o agregado
commitado.