The new AI content guardrails (#58) found existing issues in content:
Summary
- 37 structural warnings (schema/frontmatter)
- 39 terminology inconsistencies
- ~200 prose warnings (passive voice, wordy phrases, marketing language)
Terminology Issues (39)
Most common:
- "ZK proof" → "zero-knowledge proof" (20+ instances)
- "zkSNARK/zkSTARK" → "zk-SNARK/zk-STARK" (6 instances)
- "data availability" → "Data Availability" (2 instances)
Run npm run check-terms for full list.
Schema/Structure Warnings (37)
- Broken internal links (files renamed/moved)
- Non-standard
maturity values in vendors
- Frontmatter fields not matching schema
Run npm run validate for full list.
Prose Warnings (~200)
- 174 passive voice
- 114 marketing language ("only", etc.)
- 57 terminology casing
Run npm run lint:vale for full list.
Recommended Approach
- Fix terminology issues first (highest signal)
- Fix broken links
- Address schema warnings
- Prose warnings are lower priority (many are stylistic)
Related: #58
The new AI content guardrails (#58) found existing issues in content:
Summary
Terminology Issues (39)
Most common:
Run
npm run check-termsfor full list.Schema/Structure Warnings (37)
maturityvalues in vendorsRun
npm run validatefor full list.Prose Warnings (~200)
Run
npm run lint:valefor full list.Recommended Approach
Related: #58