StylesPath = .vale/styles
MinAlertLevel = suggestion
Vocab = ElasticTerms, TechJargon, ThirdPartyProducts

Packages = write-good,alex,proselint,https://github.com/StevenACoffman/vale-ai-tells/releases/download/v1.26.0/ai-tells.zip, \
  https://github.com/StevenACoffman/vale-ai-tells/releases/download/v1.26.0/ai-tells-commits.zip

[*.md]
BasedOnStyles = Readability,alex,proselint,write-good,Elastic,ai-tells

; ai-tells: repo-local tuning for a Go errors library's docs.
; These two heuristics over-flag ordinary software writing here:
;   FormalRegister        flags implement/implementation/framework (correct Go terms)
;   CataphoricForecasting flags back-references like "The two are ..."
; Demoted to warning so an error-gated CI passes on correct technical prose while
; the hints still surface locally. The token/regex fixes belong in the rule files.
ai-tells.FormalRegister        = warning
ai-tells.CataphoricForecasting = warning