Pular para o conteúdo

standards

standards responde à pergunta “qual é nosso padrão pra X, e por quê?” a partir das fontes escritas do seu time — e cita de onde a resposta veio. É a contraparte read-only de escrever um padrão: você pergunta, ela busca, ela nunca inventa.

O que resolve

Convenções vivem espalhadas por ADRs, arquivos de regras, um doc de vocabulário e conhecimento capturado — então “usamos X ou Y aqui?” é respondido de memória, ou chutado, e o chute desvia do que o time de fato decidiu. Gente nova não consegue se virar sozinha; a resposta com o seu raciocínio fica enterrada. Esta skill torna as próprias decisões do time consultáveis, com o racional anexado.

Como resolve

  • Busca por precedência — consulta as fontes numa ordem fixa: docs/adr/ (decisões) → rules/ (regras de código, incluindo overrides *.local.md) → CONTEXT.md (vocabulário) → knowledge/ (fatos confirmados). A fonte de maior precedência que cobre o tópico vence.
  • Citada, com racional — a resposta nomeia sua fonte e explica por que o padrão é o que é, não só o que é.
  • Nunca inventa — quando nenhuma fonte cobre o tópico, ela diz isso claramente e te direciona pra autorar o padrão faltante (doc-adr, ou um override de rules) em vez de fabricar um.
  • Read-only, nunca bloqueia — ela informa; nunca trava um commit ou uma mudança.

Faz par com audit-grounding (que sinaliza desvio num diff contra as mesmas fontes) e doc-adr (que autora o padrão que está faltando).

Quando usar

Sempre que você precisa saber o padrão do time sobre algo e o raciocínio por trás dele — antes de escrever código que deve conformar, no onboarding, ou pra resolver uma questão “é assim que fazemos aqui?”. Registrada no bundle docs.