Skip to content

v01.01

Choose a tag to compare

@DustinVK DustinVK released this 25 Jun 22:15
wherefore

wherefore captures the why behind engineering decisions: what was chosen, why, and
what was rejected, as plain markdown in your repo. No cloud, no database, no lock-in.

This release covers the dashboard package (@dustinvk/wherefore-dashboard), which
renders a wherefore/ directory as a browsable static site.

What's in 0.1.1

  • Standardized decision frontmatter to a single underscore key convention
    (superseded_by, superseded_date), fixing a schema mismatch that could drop
    supersession links between decisions.
  • Added AGENTS.md so coding agents beyond Claude (Codex, Copilot, Cursor, Gemini)
    can read and maintain the wherefore log.
  • Rewrote the README: flagless quick start, and guidance on previewing a build
    locally (serve it over HTTP rather than opening the file directly).
  • Dev server fix: stopped the "outside of Vite serving allow list" errors caused by
    running the dashboard across directories.
  • Editor tooling: added a tsconfig so the package's TypeScript resolves cleanly.

Install

No install needed:

npx @dustinvk/wherefore-dashboard dev

From any directory containing a wherefore/ folder.

Early but real. Feedback welcome via Issues.