Skip to content

docs(napkin-math): add methodology doc with assessment-slideshow content#728

Merged
neoneye merged 1 commit into
mainfrom
docs/napkin-math-methodology
May 18, 2026
Merged

docs(napkin-math): add methodology doc with assessment-slideshow content#728
neoneye merged 1 commit into
mainfrom
docs/napkin-math-methodology

Conversation

@neoneye
Copy link
Copy Markdown
Member

@neoneye neoneye commented May 18, 2026

Summary

Adds experiments/napkin_math/docs/methology.md describing how the napkin-math Monte Carlo works end-to-end: the 8 pipeline stages, single-run sampling discipline, where bounds come from (with the data vs assumption source label), where thresholds come from (threshold_basis enum), and the worst-gate framing.

Includes a slideshow section with two slides intended for insertion before the plan roster in the assessment slideshow — directly addressing reviewer feedback that a skeptical reader will ask "where did the distributions come from?" and "who decided the thresholds?".

The doc is paradigm-agnostic (no LLM/AI references) so it stays accurate as the implementation evolves. Versioning is not hardcoded so the doc can carry forward across future slideshow generations.

Test plan

  • Markdown renders cleanly on GitHub.
  • No internal links broken (none introduced).

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@neoneye neoneye merged commit 8a1924f into main May 18, 2026
3 checks passed
@neoneye neoneye deleted the docs/napkin-math-methodology branch May 18, 2026 14:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant