Mercury Genesys Token Calculator

README.md

@@ -23,12 +23,14 @@ Every master obeys one **three-layer contract** (the always-on rules live in
 |---|---|---|---|
 | **Study** | Reproduction of a dated base document (Forrester TEI or similar), personalized as an overlay | `YYYYMM_TEI_Vendor_Product` / `YYYYMM_Client_Engagement` (dated) | `studies/` |
 | **Assessment** | Reusable workshop instrument (discovery workshop, diagnostic) | `Instrument_Name` (undated, living) | `assessments/` |
+| **Calculator** | Prices a vendor's product from that vendor's published rate card — verbatim anchor + client overlay | `Vendor_Subject_Calculator` (undated, living) | `calculators/` |
 | **Engagement copy** | A master copied out for a client engagement — acquires client data, becomes **confidential** | `YYYYMM_Client_Instrument`, stamped at copy-time | **outside this repo** |
 
 Masters in this repo stay **client-clean**: placeholder engagement data, published or
 synthetic numbers, nothing a client said. Patterns:
 [Assessment](docs/Assessment_Pattern_V1-00.md) ·
 [Study](docs/Study_Pattern_V1-00.md) ·
+[Calculator](docs/Calculator_Pattern_V1-00.md) ·
 [shared Mercury mechanics](docs/Mercury_Notebook_Pattern_V1-00.md).
 
 ## Repository layout
@@ -39,6 +41,8 @@ palladium/
 ├── assessments/
 │   ├── CX_Discovery_Workshop/         # ★ reference implementation (notebook-first model)
 │   └── CX_AI_Diagnostic/              # capability diagnostic (pre-redesign: generated notebook)
+├── calculators/
+│   └── Genesys_Token_Calculator/      # ★ Genesys Cloud AI token cost — published rate card, 2026-07-12
 ├── studies/
 │   ├── 202512_TEI_Genesys_CX_Cloud/   # Forrester TEI reproduction — NPV $10.8M · ROI 266%
 │   ├── 202602_TEI_Amazon_Connect/     # Forrester TEI reproduction — NPV $78.7M · ROI 342%
@@ -109,7 +113,9 @@ For an **Assessment**, start from the reference implementation and its pattern d
 `assessments/CX_Discovery_Workshop/` + [Assessment Pattern](docs/Assessment_Pattern_V1-00.md).
 For a **Study**, copy `template/MercuryNotebook/` and follow the
 [Study Pattern](docs/Study_Pattern_V1-00.md) (note: the template still encodes the
-py-engine model; its notebook-first rework is a recorded follow-up). Either way:
+py-engine model; its notebook-first rework is a recorded follow-up). For a
+**Calculator**, start from `calculators/Genesys_Token_Calculator/` +
+[Calculator Pattern](docs/Calculator_Pattern_V1-00.md). Any of them:
 underscores in names (never dashes — directories are Python packages), and register
 the new notebook in [tests/nbcheck.py](tests/nbcheck.py) — the completeness test
 fails until you classify it.