Skip to content

docs(profile): piabrota-ops e piabrota-hermes na equipe, com suas funções - #10

Merged
h0ffmann merged 1 commit into
mainfrom
hermes/members-agents
Nov 3, 2026
Merged

h0ffmann merged 1 commit into
mainfrom
hermes/members-agents

Conversation

@piabrota-hermes

Copy link
Copy Markdown
Contributor

O que muda

No perfil da org (profile/README.pt-BR.md e profile/README.md), na seção Equipe (Board):

  • Uma segunda tabela, Agentes, com os dois GitHub Apps da org e a função de cada um:
    • piabrota-ops: vigia o nix-os e a VPS, diagnostica deploy que falhou, revisa PRs, abre o PR semanal de atualização do flake e mantém os espelhos pt-BR/inglês em dia. Código em piabrota/agents.
    • piabrota-hermes: o assistente do dono, no Telegram e no Discord, com tarefas agendadas e PRs a partir de hermes/* quando pedem. Roda na VPS do nix-os.
  • Uma frase antes da tabela: não são pessoas, escrevem como bot, assinam o que escrevem e nunca fazem merge.
  • O selo de tempo de leitura foi recalculado com just reading-time (equivalente: scripts/reading-time.sh --write): inglês de ~4 para ~5 min, português de ~6 para ~7 min.

Como foi conferido

  • Os dois Apps existem e são da org: gh api apps/piabrota-ops e gh api apps/piabrota-hermes (dono piabrota). Os avatares e IDs vêm de users/<app>[bot].
  • As funções vêm do README de piabrota/agents e do AGENTS.md e docs/HERMES.md do nix-os.
  • scripts/reading-time.sh --check passa nos dois arquivos.
  • Não rodei just figure-check: não há Chrome nem just nesta máquina, e nenhuma figura mudou.

Fora deste PR

  • Isto é só o perfil. Adicionar os dois como membros da organização, ou dar papel a eles, é nas configurações da org no GitHub e só um dono faz; os Apps já são "instalados", não "membros". Diga se você queria isso, e eu escrevo os passos.
  • As descrições dos dois Apps no GitHub estão vazias; o texto acima pode ir para lá.

What changes

In the org profile (profile/README.md and profile/README.pt-BR.md), in the Board (Equipe) section:

  • A second table, Agents, with the org's two GitHub Apps and the role of each:
    • piabrota-ops: watches nix-os and the VPS, diagnoses a failed deploy, reviews PRs, opens the weekly flake-update PR and keeps the pt-BR/English mirrors in step. Code in piabrota/agents.
    • piabrota-hermes: the owner's assistant, on Telegram and Discord, with scheduled jobs and PRs from hermes/* when asked. Runs on the nix-os VPS.
  • One sentence before the table: they are not people, they write as bots, sign what they write and never merge.
  • The reading-time badge was recomputed with just reading-time (equivalent: scripts/reading-time.sh --write): English from ~4 to ~5 min, Portuguese from ~6 to ~7 min.

How it was checked

  • Both Apps exist and belong to the org: gh api apps/piabrota-ops and gh api apps/piabrota-hermes (owner piabrota). Avatars and IDs come from users/<app>[bot].
  • The roles come from piabrota/agents' README and nix-os' AGENTS.md and docs/HERMES.md.
  • scripts/reading-time.sh --check passes on both files.
  • I did not run just figure-check: this machine has no Chrome and no just, and no figure changed.

Not in this PR

  • This is the profile only. Adding the two as organisation members, or giving them a role, is in the org's settings on GitHub and only an owner can do it; the Apps are "installed", not "members". Tell me if you wanted that, and I will write the steps.
  • Both Apps' descriptions on GitHub are empty; the text above could go there.

@h0ffmann
h0ffmann merged commit fb56972 into main Nov 3, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant