Skip to content

Invariantes de doc ausentes: drift PT/EN e limite do frontmatter da description #15

Description

@CRangelP

Problema

Duas invariantes de documentação ausentes:

  1. Drift PT/EN: o coherence_test compara README.md e README.en.md em só três pontos — presença de GATE_TIMEOUT, da string exit 0/1/2/3/4 (scripts/coherence_test.sh:182-194) e a árvore de arquivos, que filtra apenas *.sh (scripts/coherence_test.sh:267 em diante). Tabela de níveis, lista de stacks com cap e limites conhecidos podem divergir entre as línguas sem nada falhar.

  2. Frontmatter da description: a linha 3 da SKILL.md tem 1018 caracteres contra o limite usual de 1024 do host. Qualquer gatilho novo estoura e a skill some do disparo automático. O coherence_test não lê o frontmatter, então é o único ponto do repo onde uma edição de uma linha quebra a skill sem nenhum teste acusar.

Etapas

  • Escolher os pontos normativos dos READMEs que precisam bater entre PT e EN (tabela de níveis, caps por stack, contrato de exit) e cobri-los no coherence_test.
  • Estender a checagem de árvore para incluir references/*.md, SKILL.md e LICENSE, não só *.sh.
  • Invariante do frontmatter: comprimento da description com margem (por exemplo, falhar acima de 1000 caracteres).
  • Atualizar as contagens de invariantes citadas nos READMEs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions