Finance Notes Reorganization Plan

Date: 2026-04-18

Problem

The finance notes have two structural issues:

  1. Forward references to DeFi from foundational notes. 13 of 16 non-DeFi notes reference AMM/LP/IL concepts. A reader learning volatility shouldn’t need to know what an AMM is. Knowledge should flow forward in the reading order, not backward.

  2. Specific clarity gaps. Reader feedback identified missing definitions (broker vs dealer, ATS/MTF), unexplained conventions (iid returns, sqrt(365) scaling), and missing foundational notes (trade types, IPO process).

Workstream A: Strip DeFi forward-references

Reverse the direction of cross-references: foundational notes teach their topic cleanly; DeFi notes link back to foundational topics.

Commits (ordered by contamination severity)

  1. volatility.md + code/volatility/notebook.py — remove LP break-even, AMM fee rate, 4 DeFi wikilinks. Notebook: replace LP sections with rolling vol windows, VIX overlay, regime detection.

  2. the-greeks.md — remove “LP-gamma connection” from title, strip LP-as-short-straddle section, clean 6 DeFi wikilinks.

  3. options-basics.md + code/options-payoffs/notebook.py — remove LP preview section. Notebook: move Section 4 (“Short Straddle vs IL”) to DeFi.

  4. Microstructure batch — ho-stoll: remove “Connection to AMM IL” section. kyle-lambda: remove AMM price impact comparison. spread-decomposition: remove Uniswap v3/v4 fee mechanism. trading-fundamentals: trim “From Pit to Protocol” to brief forward pointer. glosten-milgrom: remove bonding curve comparison.

  5. settlement-and-clearing.md + market-fundamentals.md — restructure DeFi contrast paragraphs into brief forward pointers.

  6. DeFi notes gain back-links — impermanent-loss.md gains gamma mapping. lp-profitability.md gains volatility connection. constant-product-amm.md gains Ho-Stoll, Kyle, spread-decomp mappings. bonding-curves.md gains Glosten-Milgrom adverse selection mapping.

  7. code/defi-lp-profitability/notebook.py — gains moved LP visualizations.

  8. study-guide.md — update phase descriptions.

Workstream B: Specific note fixes (execute first)

Inline edits (no research needed)

NoteFix
market-fundamentals.mdDefine “cost of carry” before Contango section
market-fundamentals.mdExpand broker vs dealer (agent vs principal)
market-fundamentals.mdExpand ATS/MTF/CCP acronyms on first use
market-fundamentals.mdExpand greenshoe mechanism
market-fundamentals.mdExpand IDO/IEO/ICO definitions
settlement-and-clearing.mdClarify margin scope (CCP vs broker vs Reg T)
settlement-and-clearing.mdAdd forward ref to order-books for order types
trading-fundamentals.mdRewrite “five numbers” as two primitives + three derived
volatility.mdExplain iid assumption inline + Prerequisites callout
volatility.mdExplain sqrt(365) via variance additivity

Research prompts needed

ItemWhy
settlement-and-clearing.md CLS expansionExact PvP mechanism, funding window, BIS numbers
NEW trade-types.mdAgency vs principal, block trades, algo execution, PFOF
NEW IPO process noteS-1, roadshow, book building, direct listings, SPACs