<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Ugur</title>
    <description>The latest articles on DEV Community by Ugur (@ugur_4a11ebf0266058e5240b).</description>
    <link>https://dev.to/ugur_4a11ebf0266058e5240b</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4206758%2F198cb05d-11f2-4551-8fc3-2af27fc1dc98.png</url>
      <title>DEV Community: Ugur</title>
      <link>https://dev.to/ugur_4a11ebf0266058e5240b</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/ugur_4a11ebf0266058e5240b"/>
    <language>en</language>
    <item>
      <title>I write specs for a living. Claude Code built my NBA forecast</title>
      <dc:creator>Ugur</dc:creator>
      <pubDate>Fri, 13 Nov 2026 17:56:52 +0000</pubDate>
      <link>https://dev.to/ugur_4a11ebf0266058e5240b/i-write-specs-for-a-living-claude-code-built-my-nba-forecast-184p</link>
      <guid>https://dev.to/ugur_4a11ebf0266058e5240b/i-write-specs-for-a-living-claude-code-built-my-nba-forecast-184p</guid>
      <description>&lt;p&gt;Originally published at clutchledger.com/story.&lt;/p&gt;

&lt;p&gt;I'm a senior business analyst and an AI product owner. At work I decide what a product should do and write it down so that developers can build it. This autumn I did that for myself: an NBA forecast called Clutch, with Claude Code as my developer. I don't write the code. This post is about how that works, what rules I set, and what the honest result looks like.&lt;/p&gt;

&lt;p&gt;What it does, in one paragraph&lt;br&gt;
Every night of the NBA season, Clutch puts one number on every game: the chance that the home team wins. Before the game tips, that number is written to a public Git repository, hashed and chained to the file before it, so I can't quietly change it later. After the final, it is graded in public, on the same games as ESPN's BPI, the market's final price and the simplest rule there is: pick the home team.&lt;/p&gt;

&lt;p&gt;How an analyst and Claude Code build it&lt;br&gt;
There is no server. Python jobs run on a schedule on GitHub Actions. They fetch the night's games, the injury report and the market's prices, write the numbers into a Postgres database (Supabase) and seal them. The iPhone app and the web app are one Expo codebase that reads those rows. The game simulation and the What-If lab run on the device.&lt;/p&gt;

&lt;p&gt;My part is the same as at work: I decide what Clutch should do, write down what counts as right, check every change in the simulator and the browser, and say yes or no. Claude Code writes the code and the tests. Since September 1 there have been more than 1,400 commits across the project's four repositories, and about 95 in 100 of them name Claude as co-author. More than 5,400 automated tests run before anything ships.&lt;/p&gt;

&lt;p&gt;What I'd tell another analyst&lt;br&gt;
If you write specs for a living and want to build your own product this way:&lt;/p&gt;

&lt;p&gt;Write it like an analysis. Before anything is built, write down what counts as right: the acceptance criteria, the limits, the words that must never appear. Claude writes the code; what to build is yours. For Clutch, one of those rules is that you can never put money on a game in it, and a test fails the build if a single word from that world shows up in the app's text.&lt;br&gt;
"Done" isn't enough. Ask for proof. For every change: the tests, a preview, a screenshot. Don't accept anything you haven't looked at yourself.&lt;br&gt;
Guard rails first. Keep production writes, releases and builds in your own hands. Claude can't write to the production database, deploy a server function or start an App Store build. For those it hands me one script that checks itself first (dry run, apply, re-test), and I run it.&lt;br&gt;
Measure honestly. Decide the comparison before you see the result, and publish whatever comes out. For Clutch that meant writing on the page that my model didn't beat the market, and keeping every graded game as it was graded.&lt;br&gt;
Sealed before tip, and how to check it&lt;br&gt;
Each time a number changes, a scheduled job writes the night's numbers to a file in github.com/uguraltunbas/clutch-receipts. Every file carries the SHA-256 hash of the file before it, so the files form a chain. A few numbers are only for paying readers before tip; those go in as a hash of the numbers plus a random salt, and the numbers and the salt are published after the final.&lt;/p&gt;

&lt;p&gt;You don't have to trust me. Clone the repo and run this in its folder (Python 3, no packages)&lt;/p&gt;

&lt;p&gt;Try it&lt;br&gt;
app.clutchledger.com: tonight's games; make your own call on one, no account needed. It locks at tip and is graded after the final.&lt;br&gt;
The Ledger: every graded game, with ESPN's BPI, the market and the home team beside Clutch.&lt;br&gt;
Open data: the sealed numbers as plain JSON and CSV files.&lt;br&gt;
I wrote this post with Claude's help, the same way I built the app.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>webdev</category>
      <category>showdev</category>
      <category>productivity</category>
    </item>
    <item>
      <title>I seal every NBA prediction before tip-off with SHA-256 and a public Git repo</title>
      <dc:creator>Ugur</dc:creator>
      <pubDate>Sun, 25 Oct 2026 18:21:59 +0000</pubDate>
      <link>https://dev.to/ugur_4a11ebf0266058e5240b/i-seal-every-nba-prediction-before-tip-off-with-sha-256-and-a-public-git-repo-32k3</link>
      <guid>https://dev.to/ugur_4a11ebf0266058e5240b/i-seal-every-nba-prediction-before-tip-off-with-sha-256-and-a-public-git-repo-32k3</guid>
      <description>&lt;p&gt;Every sports prediction account has a great record. That's the problem. Once the final score is in, anyone can say they called it, and the easy ways to fake a track record don't need a single lie you can point to: post the calls that came in, quietly delete the ones that didn't, nudge a number after the injury news, or write the "prediction" up after the game.&lt;/p&gt;

&lt;p&gt;I build &lt;a href="https://clutchledger.com" rel="noopener noreferrer"&gt;Clutch&lt;/a&gt;, an NBA app that puts one number on every game: the chance the side it favours wins. I wanted its record to be something you can check without trusting me. Here's how it works, and the code to verify it yourself.&lt;/p&gt;

&lt;h2&gt;
  
  
  The three things a real pregame prediction needs
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;A fingerprint of the numbers, published before tip.&lt;/strong&gt; If the numbers change later, the fingerprint won't match.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A clock the forecaster can't set.&lt;/strong&gt; A date I type proves nothing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A record that keeps the misses.&lt;/strong&gt; Old entries can't be swapped out or dropped.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;None of this needs a blockchain. A hash function, a public Git host and a little discipline cover all three.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Seal: hash the night's numbers before the games
&lt;/h2&gt;

&lt;p&gt;Each morning (US Eastern), a scheduled job writes every game of the night still to tip into a JSON file, a &lt;strong&gt;seal&lt;/strong&gt;, with the number the app shows everyone for it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"format"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"clutch-receipt-v1"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"seal"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"slate_date"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2026-10-24"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"season"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2026-27"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"sealed_at"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2026-10-24T14:01:23Z"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"prev_sha256"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"n_games"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"games"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"game_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"home"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"ATL"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"away"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"HOU"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"tip_utc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"2026-10-25T00:30:00Z"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"prediction_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"model_version"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"clutch-20260929"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"home_win_prob"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"0.5094"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"pro_commitment"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"5c9f7129eb71e43e…14adc888"&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The file's SHA-256 is its fingerprint: 64 hex characters computed from its bytes. Change one digit of one probability and the fingerprint is completely different.&lt;/p&gt;

&lt;p&gt;If news moves a number during the day (a star ruled out at 5 PM, say), the job writes a &lt;strong&gt;new&lt;/strong&gt; seal. Nothing is edited in place. The game is graded on the last seal that arrived before its tip. That Hawks–Rockets number above was sealed seven times on Oct 24, drifting from 50.9% to 48.8% for Atlanta; the last one is what got graded (Houston won 121–114, so the call held).&lt;/p&gt;

&lt;h2&gt;
  
  
  2. The clock: GitHub's, not mine
&lt;/h2&gt;

&lt;p&gt;The seal is pushed to a public repository, &lt;a href="https://github.com/uguraltunbas/clutch-receipts" rel="noopener noreferrer"&gt;uguraltunbas/clutch-receipts&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;One subtlety: commit dates are worthless as proof, because whoever makes the commit writes them. What counts is when GitHub &lt;em&gt;received&lt;/em&gt; the push. The repository's &lt;a href="https://github.com/uguraltunbas/clutch-receipts/activity" rel="noopener noreferrer"&gt;Activity view&lt;/a&gt; lists every push with GitHub's own timestamp, and it lists force pushes too, so rewriting history would show.&lt;/p&gt;

&lt;p&gt;On Oct 24 the night's first seal arrived 7 hours 58 minutes before the first tip.&lt;/p&gt;

&lt;p&gt;The job pushes with a deploy key that can write to that one repository only.&lt;/p&gt;

&lt;h2&gt;
  
  
  3. The chain: misses can't be dropped
&lt;/h2&gt;

&lt;p&gt;Every file includes &lt;code&gt;prev_sha256&lt;/code&gt;, the fingerprint of the file before it. That makes the repository a hash chain: change or delete any old file and every later file stops matching. &lt;code&gt;index.jsonl&lt;/code&gt; lists every file in order with its fingerprint.&lt;/p&gt;

&lt;p&gt;Checking the whole chain takes a few lines of Python, standard library only:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;

&lt;span class="n"&gt;prev&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="bp"&gt;None&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;line&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;index.jsonl&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;encoding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ascii&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;entry&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;loads&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;line&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;data&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;path&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;rb&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="n"&gt;receipt&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;loads&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;assert&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sha256&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;hexdigest&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sha256&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;path&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;: fingerprint&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="k"&gt;assert&lt;/span&gt; &lt;span class="n"&gt;receipt&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prev_sha256&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prev_sha256&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;path&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;: chain&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="n"&gt;prev&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;entry&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sha256&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;chain ok, latest&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Or one file at a time, with what your computer already has:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/uguraltunbas/clutch-receipts
&lt;span class="nb"&gt;cd &lt;/span&gt;clutch-receipts
shasum &lt;span class="nt"&gt;-a&lt;/span&gt; 256 2026-27/2026-10-20/seal-182205Z.json   &lt;span class="c"&gt;# Linux: sha256sum, Windows: certutil -hashfile&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  4. Commit-reveal for the numbers I can't publish yet
&lt;/h2&gt;

&lt;p&gt;Some numbers are for paying members before tip (the model's own probability next to the market's). I still want those provably fixed before the game, without giving them away.&lt;/p&gt;

&lt;p&gt;That's a classic &lt;strong&gt;commit-reveal&lt;/strong&gt; scheme. Before tip, the seal carries only &lt;code&gt;pro_commitment&lt;/code&gt;: the SHA-256 of those numbers plus a long random secret (a salt), serialized canonically. The salt matters: a probability with four decimals has only 10,000 possible values, so without it anyone could find the hidden number by hashing every one.&lt;/p&gt;

&lt;p&gt;After the final, a &lt;strong&gt;reveal&lt;/strong&gt; file publishes the numbers and the salt, plus the score and whether the call was right. Anyone can recompute the hash:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;canonical&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;obj&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;dumps&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;obj&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sort_keys&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="bp"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;separators&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;,&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;:&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="n"&gt;ensure_ascii&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="bp"&gt;True&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ascii&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;fingerprint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;game_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;opening&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sha256&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;canonical&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;format&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;clutch-commitment-v1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;game_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;game_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prediction_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;opening&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prediction_id&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;pro&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;opening&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;pro&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
        &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;salt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;opening&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;salt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="p"&gt;})).&lt;/span&gt;&lt;span class="nf"&gt;hexdigest&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If the result is in a seal from before tip, the revealed numbers are the numbers that were sealed. (The canonical serialization, with sorted keys and fixed separators, is what makes the hash reproducible in any language.)&lt;/p&gt;

&lt;h2&gt;
  
  
  5. Grading, misses included
&lt;/h2&gt;

&lt;p&gt;After each final, the Ledger grades the sealed number: right or wrong, next to ESPN's BPI, the market's price and the dumbest baseline there is, always picking the home team. Games whose number can't be shown to predate tip aren't graded at all, and the Ledger says how many.&lt;/p&gt;

&lt;p&gt;The live record is on &lt;a href="https://clutchledger.com/ledger/" rel="noopener noreferrer"&gt;the Ledger&lt;/a&gt;: 24–12 on 36 graded calls as of Oct 25. That's early-season noise, and the Ledger says so. The more useful question is calibration: when Clutch says 70%, does it happen about 70% of the time? In a replay of the last two seasons (2,631 games, each predicted only from games before it), every band landed within 2.4 points of what it said. The &lt;a href="https://clutchledger.com/accuracy/" rel="noopener noreferrer"&gt;accuracy page&lt;/a&gt; has the bands, and I wrote up &lt;a href="https://clutchledger.com/learn/calibration-and-brier-score/" rel="noopener noreferrer"&gt;calibration and the Brier score&lt;/a&gt; separately.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a seal doesn't prove
&lt;/h2&gt;

&lt;p&gt;A seal proves &lt;em&gt;when&lt;/em&gt; a number was made, not that it was any good. One night, or one week, tells you nothing. That's why the misses have to stay: a record is only worth something if it's complete.&lt;/p&gt;

&lt;h2&gt;
  
  
  The stack, briefly
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Python jobs on GitHub Actions write predictions to Postgres (Supabase) and push the receipts.&lt;/li&gt;
&lt;li&gt;The app (Expo / React Native, iPhone and web) reads only what each tier may see, enforced by row-level security.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://clutchledger.com" rel="noopener noreferrer"&gt;clutchledger.com&lt;/a&gt; is a static site rebuilt from the same tables: a page per game, per team and per matchup.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you try the verification and something doesn't match, I want to know. That's the whole point. The receipts repo is &lt;a href="https://github.com/uguraltunbas/clutch-receipts" rel="noopener noreferrer"&gt;here&lt;/a&gt;, and the step-by-step check is in its &lt;code&gt;VERIFY.md&lt;/code&gt;.&lt;/p&gt;

</description>
      <category>showdev</category>
      <category>datascience</category>
      <category>github</category>
      <category>python</category>
    </item>
  </channel>
</rss>
