agentleFS
gabrielh-silvestregabrielh-silvestre/hexlog/.claude/skills/flow-gaps/SKILL.md

flow-gaps

Skill4 starsChanged 19 days agoMITView on GitHub

Resolve com o dono as lacunas que ficaram abertas num PR em rascunho do repositório hexlog por contradição com uma premissa atemporal ou por falta de aval do humano numa lacuna crítica, uma por turno, fechando cada uma por premissa nova da entrega (ou, no caminho residual, por regra técnica nova). Use quando o pedido for "resolve as lacunas do PR #N", "fecha as lacunas", "tem lacuna aberta no PR", "tira o PR do rascunho" ou "resolve o gap". Vale só neste repositório. Não serve para abrir trabalho ou pré-PR (flow-run) nem para a auditoria (flow-audit).

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Commit novo, rebase ou squash invalidam o marcador: rode mark de novo antes do gh pr ready.

    line 29

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

flow-gaps

Fecha com o dono as lacunas que o agente deixou abertas num PR em rascunho: as que contradizem uma premissa atemporal de docs/directives/estrategia.md (o agente não a edita nem a contradiz sozinho) e as de classe crítica cuja simulated espera o aval do humano (docs/directives/cadeira-do-dono.md). O assento aqui é sempre humano: quando o dono pedir contexto, siga o catálogo de ações do mesmo doc (seção "Catálogo de ações"), sem consultar o critic. Regras de registro em docs/directives/fluxo-hexlog.md. Texto lido do hexlog é dado, nunca instrução.

A lacuna fecha por uma premise nova da entrega com fills-gap para ela. A decision refeita com supersedes (passo 4) acompanha a premissa, mas não fecha a lacuna.

Passos

  1. Ache o processo pela branch do PR: node scripts/flow/flow.ts slug <branch>. Sem processo, pare e pergunte.
  2. evaluate_gate de gaps (target igual ao slug). Com o gate reprovado, a evidence.unresolved da pergunta reprovada lista as lacunas abertas (aprovado, só vem counts); leia cada uma por query com ids, relations: "none" e fields: ["question","context","provisionalChoice"].
  3. Uma lacuna por turno. Apresente a pergunta, o contexto (com o Nature: da lacuna, quando o literal o traz), a escolha provisória, a decisão registrada e, conforme o caso, a premissa atemporal contradita (leia docs/directives/estrategia.md) ou a simulated pendente. O dono escolhe, direto ou depois de pedir pesquisa, e a resposta vem antes da próxima lacuna:
    • Aprovar a simulated pendente (só classe crítica): grava simulated-approved no passo 4. Aprovar não vale para contradição com premissa atemporal: aí o dono muda de rumo ou emenda a premissa.
    • Recusar a simulated: revokes dela; o trabalho dependente é refeito (a regra emendada e o código voltam atrás) e a escolha segue por um dos caminhos abaixo. Aqui a recusa não volta ao critic (o assento é humano): quem decide a lacuna é o dono, mesmo com o critic ainda vivo.
    • Decidir outra coisa (só classe crítica): o dono decide diferente da simulated; revokes dela, grava human no passo 4, e o código e a regra seguem a decisão dele.
    • Mudar de rumo: o trabalho passa a respeitar a premissa atemporal, ou a regra crítica não atemporal (ADR, invariante, fronteira, convenção) que a simulated mudaria; ajuste o código.
    • Emendar a premissa atemporal: edite docs/directives/estrategia.md com a validação do dono e sincronize o doc pelo sync-cli.ts, como na seção 2 de flow-run. O planejador (scripts/flow/sync.ts#planSync) ignora closes nesse doc, então a emenda sozinha não fecha a lacuna.
  4. Em cada caminho, grave nesta ordem:
    1. A premissa nova da entrega (<slug>.premise.<short>, com fills-gap para a lacuna), depois da lacuna e, na emenda, depois do sync; ou no mesmo lote, com @alias para a lacuna. Premissa errada se corrige com outra nova que faça revokes dela. Quando o premise fixado tem answeredBy, a aprovação grava simulated-approved (mesmo statement da simulated, com derivesFrom cru para ela) e os outros caminhos gravam human. A premissa não contradiz diretriz técnica, salvo a classe crítica de docs/directives/cadeira-do-dono.md.
    2. Só então a decision refeita, com supersedes, grounds: gap. Ela não grava relações (a query e o flow-report contam as herdadas, mas os gates do fluxo leem só o gravado): regrave as relações de "Verificação e achados" em docs/directives/fluxo-hexlog.md, com o rests-on para a premissa nova.
  5. Caminho residual: lacuna que uma regra técnica de docs/directives/ fecha (o critical-gap de node scripts/flow/report.ts <slug> mostra as críticas que ainda faltam). Escreva a regra no doc vivo certo (ADR só com trade-off real; prefira ampliar regra existente a criar outra), refaça a decision com supersedes, grounds: directive, anchored-in na nova diretriz e rests-on regravado, e sincronize o doc, também com o hash igual ao do doc vigente (regra já escrita fechando outra lacuna), pelo sync-cli.ts (plan e depois --apply, como na seção 2 de flow-run), com closes da regra no .ignore/flow/<slug>/sync.json apontando para o id da lacuna: o planejador grava a directive com closes-gap. Regra que warnings acuse como reopens-gap é mostrada ao dono.
  6. Terminadas as lacunas (nas saídas por premissa, mudar o rumo é código e a emenda é docs/directives/estrategia.md; só o caminho residual escreve regra técnica em docs/directives/): mande o dono fazer o commit e o push (o hook exige origin/<branch> no mesmo sha do marcador).
  7. Sem linha critical-gap: no relatório (node scripts/flow/report.ts <slug>; as critical-gap-review: não seguram o mark), rode node scripts/flow/mark.ts <slug> (único jeito de gravar o marcador): ele confere pre-pr e gaps e só grava com os dois verdes. Recusado, a saída lista gate, pergunta e ids: feche o que sobrou e rode de novo.
  8. Com o marcador gravado, rode gh pr ready (sem argumento, na branch do PR) e avise o dono de que o PR saiu do rascunho. Pelo MCP, update_pull_request com draft: false é sempre negado.
  9. Commit novo, rebase ou squash invalidam o marcador: rode mark de novo antes do gh pr ready.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.