Promptless
Promptless suggests doc updates when your product changes. You review, edit, and ship.
⚙️ How Promptless uses Vale
Vale runs on the draft, before a human is asked to read it.
Sync
Downloads the external style packages your config references, when they aren't already vendored in your repository.
Lint
Lints every prose file it creates or substantially edits.
Fix
Fixes findings against your MinAlertLevel — every finding Vale reports when you set one, or error-severity as blocking when you leave it unset.
Vale is “enabled automatically when Promptless detects a Vale configuration file in your docs repository”, and from then on it lints “every prose file it creates or substantially edits.”
Set MinAlertLevel and Promptless “fixes every finding Vale reports at
or above that level, including warnings and suggestions.” Leave it unset and it treats error rules as hard constraints, weighing warnings and suggestions against
the voice already in your docs.
It reads the Vale job in your GitHub Actions workflows and reproduces that invocation locally on the changed files, confirming they pass before the suggestion is raised. When a run fails on a Promptless pull request anyway, it analyzes the failure and pushes the fix to the branch.
Your .vale.ini is what tells an agent how your team writes. The style
guide stops being a document people are asked to remember and becomes the constraint the drafts
are generated against.
Support Vale's future
Sponsor Vale
Vale is free, open source, and primarily maintained by one person. Sponsorship buys the focused maintenance time that keeps it fast, reliable, and independent.
$1,000+
Sponsor Spotlight eligibility
Open source
Funding goes back into Vale
Two paths
Sponsor through Open Collective or GitHub