Objectives

Ohtools uses project context docs and validation scripts as the maintenance harness. This page points to the local sources that define readiness.

When to use this: use it before a release, compatibility change, or docs update that needs more than a narrow smoke test.

bun run validate
bun run release:check

Harness Documents

  • OKRs: docs/OKRS.md
  • KPIs: docs/KPIS.md
  • Definition of ready and done: docs/TASK-HARNESS.md
  • Validation scripts: docs/VALIDATION.md

Release Checks

validate runs the release-blocking local checks. release:check aliases validate so release docs and automation can use a stable command.

Docs-facing changes should usually include:

  • bun run docs:build
  • bun run docs:links
  • bun run docs:snippets
  • bun run format:check when layout or prose changed broadly

Use Changelog to record compatibility notes.