perf-wiki-builder

Use when creating or updating JS/TS performance evidence notes, iteration logs, research notes, generated docs/perf indexes, or searchable benchmark/result summaries.

SKILL.md

GitHub

Perf Wiki Builder

The perf wiki is a searchable evidence index over notes and benchmark rows.

Workflow

  1. Search existing memory before adding new notes:
npm run docs:perf:search -- <topic terms>
  1. Add or update an iteration note under iterations/.
  2. Add source maps or research notes under research/ when external ideas shaped the work. If the note depends on external material, include the fetcher, manifest, cache path, URL, commit, or hash.
  3. Ensure benchmark JSON lives under benchmarks/results/*latest.json.
  4. Generate docs:
npx evidence-kit docs
  1. Check generated docs before finishing:
npx evidence-kit docs --check

Note Shape

Iteration notes should include:

  • Goal
  • Implemented
  • Current Result
  • Decision
  • Deferred
  • Verification

Use verdicts: accepted, rejected, regressed, needs-revisit, measured, reference, or logged.

Rule

Historical notes are evidence, not current truth. For current API or performance claims, check current source and latest benchmark JSON.