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 derules) 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.