01
Frontmatter
Required keys, version, canonical URL, verification date and claimed state.
Free and open tooling
One script validates the one file.
Download the validator, point it at a local path or URL and receive the achieved state, claimed state, fact count, answer count, dimension coverage, errors and warnings.
No purchase, account or API key is required.
Run locally
Node 20 or newer. No dependencies.
The same script accepts a local file path or a public URL.
Local file
node answerworthy-validator.mjs ./answerworthy.mdRemote file
node answerworthy-validator.mjs https://example.com/answerworthy.mdThis repository
pnpm validate:answerworthyWhat it checks
Grammar, sourcing, dimensions and the M2 to M3 boundary.
02
Sections
Identity and Answers are required; sourced facts and Conformance establish the stronger states.
03
Canonical facts
Every material fact carries statement, basis, source class, source and verification date.
04
Answers
Every answer has a question-form heading, self-contained response and absolute source URL.
05
Dimensions
The report shows coverage across the six canonical identifiers.
06
Attestation
M3 and M4 require an independent URL and SHA-256 hash inside the file.
Agent checklist
A coding agent can run the complete free loop.
The checklist creates no public companion artifact. Working notes remain in the user's repository or session.
01
Generate
Read the public site, draft answerworthy.md and mark unsupported facts for confirmation.
02
Validate
Run the open script and resolve grammar errors before claiming a state.
03
Audit
Map findings to the six dimensions and preserve blocked or unavailable evidence.
04
Remediate
Apply only permitted changes, then update the canonical file.
05
Refresh
Re-fetch the site, update last_verified and preserve material history.
Open implementation
Build another implementation against the same grammar.
Specification prose: CC BY 4.0. Tooling: Apache-2.0. The registry is open to implementations that resolve their output to a published answerworthy.md file.