Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

refactor(lint): retrofit vale-config to the ADR-0020 context contract

Browse Source 
Description 657 -> 244 chars, body 504 -> 342 words, Gotchas 50% -> 24%.
The 50% was the worst ratio in the corpus and a real inverted body, not
the denominator artefact the ratio usually flags: half the body was a
Gotchas section doing duty as reference material.

A clean-context audit caught the split leaving a false statement behind.
Gotcha 1's kernel lost the qualifier that only package styles need
fetching, so it asserted that any style vale sync has not fetched fails
-- contradicting the same file twice, since the built-in Vale style and
any committed custom style are never fetched. An agent adding a custom
style would have added a spurious Packages entry and broken vale sync
outright. The qualifier is restored in the body rather than behind a
fourth reference pointer.

Also corrects the moved fixture's framing, which tabulated a control row
under a heading claiming it came from a multi-line fixture.

Refs #99
This commit is contained in:
Defame1297
2026-08-30 15:07:15 +00:00
parent c59e4bf0c5
commit 45cd26045a
6 changed files with 52 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
plugins/lint/skills/vale-config/README.md
View File

@@ -19,5 +19,5 @@ Describe what you want configured: initial setup, adding a third-party style pac
| File | Purpose |
|------|---------|
| `SKILL.md` | Skill instructions for agents |
| `references/configuration-reference.md` | Full `.vale.ini` field and rule-header reference |
| `references/configuration-reference.md` | Full `.vale.ini` fields, rule-header fields, and frontmatter-scope behaviour |
| `references/sources.md` | Research sources backing the Vale configuration guidance |