Files
holocron/plugins/lint/.apm/skills/vale-config/references/sources.md
Defame1297 b07d54ad7a fix(lint): correct four Vale behaviours the skills described wrongly
Each of these would send a user down a path Vale does not support:

Core options placed under a glob header are not scoped to that glob — Vale
rejects them with E201, so the guidance to nest them produced a config that
will not load. The built-in `Vale` style is compiled in, but Vale still
requires StylesPath to exist on disk before it will run, so the "no StylesPath
needed" shortcut fails. The MDX guidance was inverted: under `[formats]
mdx = md` the mapping is what makes MDX lint at all, and it needs the mdx2vast
prerequisite that was never mentioned. And a spelling rule's `ignore` paths
resolve against StylesPath, not against the rule file's own directory, so the
documented relative paths silently matched nothing.
2026-08-31 08:01:26 +00:00

1.4 KiB

Sources

context7-websites-vale-sh

  • URL: context7:/websites/vale_sh
  • Description: Official Vale documentation site (vale.sh) indexed by Context7 — .vale.ini config reference, style/rule/check model, installation across package managers and Docker.
  • Research doc: plugins/lint/docs/research/docs/vale/sources.md
  • Contributing files: SKILL.md, references/configuration-reference.md
  • Status: extracted

house-vale-3-15-2-repro

  • URL: (house-verified — reproduced locally against the vale binary, not an external source)
  • Description: Behaviour of Vale 3.15.2 established by running it against purpose-built fixtures in this repo, where vale.sh documents nothing: the E100 [loadStyles] / exit-2 failure for a BasedOnStyles name absent from StylesPath, vale sync reporting Synced 0 package(s) for a name not declared in Packages, the E201 / exit-2 failure when the StylesPath directory does not exist, the exit-0 no-op of an empty style directory, the E201 / exit-2 failure when a core option is written below a [glob] header (with Packages as the silent exception), and the text.frontmatter.<key> scope matrix across multi-line YAML forms.
  • Research doc: none — house-verified reproduction, not part of the plugin's research corpus (no plugins/lint/docs/research/ topic file backs this entry)
  • Contributing files: SKILL.md, references/configuration-reference.md
  • Status: extracted