Defame1297
e9234f6d8a
cli-reference.md said vale exits non-zero for any alert at or above
MinAlertLevel. The exit code keys on error-level alerts alone;
MinAlertLevel filters display only. LESSONS.md records this exact
misconception as costing two review rounds, and this research doc is
the cited provenance source for the skills that state it correctly.
CONTEXT.md claimed a SKILL.md outside plugins/ matches no glob section.
[**/SKILL.md] matches any path ending in SKILL.md — the sentence is a
stale leftover from the path-scoped globs at cbc33d9, and contradicted
its own paragraph two sentences earlier. The NOT-RUN 0-files guard it
justifies is correct and is unchanged; only the rationale was wrong.
CONTEXT.md also cited the local files: regex as the scoping mechanism,
where the shipped manifest deliberately stays layout-agnostic.
ADR-0014 records the entry[0]-only prefixing constraint as the reason
the self-locating design is required, and that no entry may grow a
repo-internal path argument.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MCQ648fLSFXPHGZdQ8gn58
docs/
Plugin documentation. Not read automatically by Claude Code or GitHub Copilot CLI — reference specific files from skill bodies or agent prompts as needed.
research/
Upstream reference material gathered during skill authoring. Not shipped with the plugin — used at development time only.
| Path | Purpose |
|---|---|
research/docs/vale/ |
Vale documentation (vale.sh), gathered while authoring vale-config/vale-run — see below |
research/docs/vale/
| File | Covers |
|---|---|
overview.md |
What Vale is; the style/rule/check configuration model; the built-in Vale style's four rules; styles directory layout |
installation.md |
Installing Vale via OS package managers (Homebrew, Snap, Chocolatey) and Docker |
configuration.md |
.vale.ini structure — global, [formats], and per-glob sections |
cli-reference.md |
Core invocation and key subcommands/flags (vale sync, vale ls-config, etc.) |
examples.md |
Walkthroughs — project initialization, typical .vale.ini configs |
troubleshooting.md |
Suppressing false positives via inline markup (format-specific vale off/vale on syntax, spelling ignore lists) |
sources.md |
Provenance record for this directory — source URL, description, and which files above were extracted from it |
Each file's frontmatter carries a source_keys entry keyed to the same provenance record. The plugin-level provenance file, plugins/lint/sources.md, cross-references this directory from the context7-websites-vale-sh entry and lists the agents/skills whose content drew on it.
vale-config and vale-run are the skills that consume this research — read the relevant file here before changing either skill's Vale-facing behavior.