Skip to content

Commit 30d4447

Browse files
README/docs style pass: drop 'buyer' for 'category manager', remove contrastive 'X not Y' phrasing
- README: replace every 'buyer' with 'category manager'; rewrite all 'X, not Y' constructions into direct statements; confirm zero em/en dashes - Replace remaining 'buyer' usages across the case studies
1 parent b3df3de commit 30d4447

4 files changed

Lines changed: 26 additions & 26 deletions

File tree

‎README.md‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,13 @@
1717

1818
## The problem
1919

20-
Your team negotiates thousands of prices a year on gut feel and last year's PO. The senior buyer who *knew* what a part should cost is retiring. Engineering adds a tolerance and nobody can say what it costs. A supplier quote lands and your buyer has no defensible number to push back with.
20+
Your team negotiates thousands of prices a year on gut feel and last year's PO. The senior category manager who *knew* what a part should cost is retiring. Engineering adds a tolerance and nobody can say what it costs. A supplier quote lands and your category manager has no defensible number to push back with.
2121

22-
The pricing knowledge is sitting in your purchase history. It just isn't usable yet.
22+
The pricing knowledge is sitting in your purchase history, waiting to be used.
2323

2424
## What P2Predict does
2525

26-
P2Predict learns from your own purchasing data what drives the price of a part: supplier, material, size, spec, region. Then it gives your team a defensible target for any new or proposed part. Your buyers ask in plain English. The answer comes back grounded in what you have actually paid.
26+
P2Predict learns from your own purchasing data what drives the price of a part: supplier, material, size, spec, region. Then it gives your team a defensible target for any new or proposed part. Your category managers ask in plain English. The answer comes back grounded in what you have actually paid.
2727

2828
It runs on your machine, on your data, through any AI agent your team already uses. Nothing is uploaded. No vendor catalog, no cloud, no per-seat data-sharing.
2929

@@ -33,29 +33,29 @@ This is where P2Predict earns its keep. Every one of these is a real question yo
3333

3434
### "Is this quote fair?"
3535

36-
Your buyer drops the quote on the agent.
36+
Your category manager drops the quote on the agent.
3737

38-
> **Buyer:** *"Supplier quotes $14.20 for this part. What should it cost?"*
38+
> **Category manager:** *"Supplier quotes $14.20 for this part. What should it cost?"*
3939
>
4040
> **P2Predict:** *"$12.40. Nine times in ten the real price lands between $10.80 and $13.90. This quote is running about 15% high."*
4141
42-
Your buyer walks in with a number and a range, not a hunch.
42+
Your category manager now knows exactly where they can push back, with real data behind it.
4343

4444
### When the supplier pushes back: "Are you sure that's the right price?"
4545

46-
This is the moment most buyers fold. Now you have an answer. Ask for the breakdown.
46+
This is where most negotiations stall. Now you have an answer. Ask for the breakdown.
4747

48-
> **Buyer:** *"Why $12.40? Break it down."*
48+
> **Category manager:** *"Why $12.40? Break it down."*
4949
>
5050
> **P2Predict:** *"Supplier choice +$0.85, rush delivery +$1.20, tighter tolerance +$0.42, size +$0.40."*
5151
52-
Now you argue the components, not the total: *"We agreed standard lead time. Take the $1.20 rush charge off and we're aligned."* A supplier can wave away a total. A line item is much harder to defend.
52+
Now you argue the components line by line: *"We agreed standard lead time. Take the $1.20 rush charge off and we're aligned."* A line item is hard to wave away.
5353

5454
### "What if we switch supplier?"
5555

5656
Hold the spec fixed, swap the supplier, read the delta.
5757

58-
> **Buyer:** *"What happens if we move this 16-cell pack monitor from Supplier A to Supplier B?"*
58+
> **Category manager:** *"What happens if we move this 16-cell pack monitor from Supplier A to Supplier B?"*
5959
>
6060
> **P2Predict:** *"Down 37.7%, about $2.07 a unit, with the per-feature breakdown to back it up."*
6161
@@ -67,11 +67,11 @@ Engineering proposes a tighter tolerance. Before it gets locked in, cost it.
6767

6868
> **Engineer:** *"We want to go from ±0.1mm to ±0.05mm."*
6969
>
70-
> **Buyer to the agent:** *"What does that do to cost?"*
70+
> **Category manager to the agent:** *"What does that do to cost?"*
7171
>
7272
> **P2Predict:** *"+$0.42 a unit, +18%, likely range $0.30 to $0.55."*
7373
74-
Now the conversation is *"is 18% worth this requirement?"* That is a costed trade-off, not the loudest voice winning.
74+
Now the conversation is *"is 18% worth this requirement?"*, a costed trade-off the room decides on numbers.
7575

7676
### In the cost-down workshop: "What is the design paying for that it doesn't need?"
7777

@@ -87,11 +87,11 @@ Most tools hand you a number and walk away. P2Predict hands you the number **and
8787

8888
![Honest confidence ranges, per part](./case-studies/battery-management-ics/assets/intervals_comparison.png)
8989

90-
Three real parts, three different confidence ranges. The model is tight on the part it knows well and openly uncertain on the ones it doesn't. A narrow range means negotiate hard. A wide one means get a quote first. Your buyer always knows which.
90+
Three real parts, three different confidence ranges. The model is tight on the part it knows well and openly uncertain on the ones it doesn't. A narrow range means negotiate hard. A wide one means get a quote first. Your category manager always knows which.
9191

92-
- **A confidence range on every estimate.** Not "$12.40" but "$12.40, and nine times in ten the real price lands between $10.80 and $13.90."
92+
- **A confidence range on every estimate.** "$12.40, and nine times in ten the real price lands between $10.80 and $13.90."
9393
- **An honest map of where the model is strong and where it is thin.** P2Predict flags which parts of your category it can benchmark with confidence and which need a real quote, so nobody negotiates off a number the data can't support.
94-
- **A reason for every number.** Every estimate breaks down into what each spec and the supplier contribute. You argue the components, not the total.
94+
- **A reason for every number.** Every estimate breaks down into what each spec and the supplier contribute, so you argue the components line by line.
9595

9696
## See what actually drives the cost
9797

@@ -101,29 +101,29 @@ Point P2Predict at a category and it shows you the levers. These charts come str
101101

102102
![Supplier premium on an identical part](./case-studies/battery-management-ics/assets/manufacturer_premium.png)
103103

104-
The premium supplier is priced at roughly four times the value option for the same part. That is a number you take into a negotiation, not a hunch.
104+
The premium supplier is priced at roughly four times the value option for the same part. That is a number you take into a negotiation, backed by your own data.
105105

106106
**Every estimate breaks down spec by spec.** Ask why a part costs what it does and you get the receipt:
107107

108108
![Per-feature dollar breakdown for one part](./case-studies/battery-management-ics/assets/ev_bms_attribution.png)
109109

110-
Package size, supplier premium, multi-cell architecture: each one in dollars, each one adding up exactly to the predicted price. This is what lets your buyer say *"I know what I'm paying for, and here's the line I want to cut."*
110+
Package size, supplier premium, multi-cell architecture: each one in dollars, each one adding up exactly to the predicted price. This is what lets your category manager say *"I know what I'm paying for, and here's the line I want to cut."*
111111

112112
## How it fits your stack
113113

114-
P2Predict speaks to **any AI agent**: Claude, and any other assistant your team runs, through a standard connector. Your buyers don't learn a new tool. They ask the assistant they already use, and it does the analysis.
114+
P2Predict speaks to **any AI agent**: Claude, and any other assistant your team runs, through a standard connector. Your category managers don't learn a new tool. They ask the assistant they already use, and it does the analysis.
115115

116116
Everything runs **locally**. Your purchasing data is your most sensitive commercial asset, so it stays on your machine. No upload, no third-party model training on your spend, no data-residency conversation with legal.
117117

118-
It complements should-cost tools. Bottom-up should-costing builds a part up from material, labor, and machine time. P2Predict answers the other question every buyer actually asks: *what has the market charged us for parts like this, and what should the next one cost?*
118+
It complements should-cost tools. Bottom-up should-costing builds a part up from material, labor, and machine time. P2Predict answers the other question every category manager actually asks: *what has the market charged us for parts like this, and what should the next one cost?*
119119

120120
## Proof on public data
121121

122122
Three worked case studies, each reproducible end to end on data anyone can download:
123123

124-
- **[Battery Management ICs](case-studies/battery-management-ics/):** the closest thing to a real procurement job. A small, realistic parts slice, a supplier-premium lever you can quote, and an honest read on where the model is solid and where it isn't.
124+
- **[Battery Management ICs](case-studies/battery-management-ics/):** the closest thing to a real procurement job. A small, realistic parts slice, a supplier-premium lever you can quote, and an honest read on where the model is strong and where it needs a real quote.
125125
- **[Used vehicles](case-studies/used-cars/):** the easy-to-follow walkthrough on prices that span orders of magnitude.
126-
- **[Aerospace fasteners](case-studies/aerospace-fasteners/):** the honesty story. How P2Predict tells you when the data, not the model, is the limit, so you stop chasing accuracy that isn't there.
126+
- **[Aerospace fasteners](case-studies/aerospace-fasteners/):** the honesty story. How P2Predict shows you when the data itself sets the limit, so you stop chasing accuracy the data can't give.
127127

128128
Each one leads with results, shows where to trust them, and points to exactly where every number comes from.
129129

‎case-studies/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Three real-world stories that show P2Predict on data anyone can download and ver
44

55
| Case study | Audience | Data source | Demonstrates |
66
|---|---|---|---|
7-
| [Battery Management ICs](battery-management-ics/) | EE procurement engineers, electronics buyers, hardware BOM owners | Octopart / Mouser / DigiKey API | The classic parametric procurement use case — `--explain` and `--whatif` for spec-driven cost trade-offs |
7+
| [Battery Management ICs](battery-management-ics/) | EE procurement engineers, electronics category managers, hardware BOM owners | Octopart / Mouser / DigiKey API | The classic parametric procurement use case — `--explain` and `--whatif` for spec-driven cost trade-offs |
88
| [Used vehicles](used-cars/) | Anyone — the universally-relatable tutorial | Kaggle (CC license) | Log-target SHAP + multiplicative explanations on prices that span orders of magnitude |
99
| [Aerospace fasteners](aerospace-fasteners/) | Fastener / MRO category managers, federal procurement, cost engineers | DLA PUB LOG / FLIS catalog (public domain) | **Detecting noisy data** — measuring a model's R² ceiling before tuning, plus log-target multiplicative SHAP on a heavily-skewed price |
1010

‎case-studies/battery-management-ics/README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> **The closest thing to a real procurement job.** Real catalog data from
44
> the DigiKey API, a deliberately small dataset (~150 parts — the size a real
5-
> BOM-benchmarking exercise actually has), and the question every buyer asks:
5+
> BOM-benchmarking exercise actually has), and the question every category manager asks:
66
> what should this part cost, how sure are we, and which supplier premium can
77
> we negotiate away? It shows P2Predict working on exactly the thin, real-world
88
> parts slice a procurement team faces every day — and is honest about where
@@ -307,7 +307,7 @@ ADI/Maxim to Microchip, and the model expects the part to land **37.7%
307307
cheaper**. That's the procurement negotiation lever, computed from real
308308
DigiKey catalog patterns. Whether a Microchip part actually meets your
309309
electrical spec is your engineer's call — the model only knows the
310-
catalog. But it tells your buyer exactly where to push, with a number.
310+
catalog. But it tells your category manager exactly where to push, with a number.
311311

312312
## So what? — six findings the analysis surfaces
313313

‎case-studies/used-cars/README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Three reasons:
2222
1. **The math shows up clearly.** Used-car prices span $500 → $200k. That
2323
heavy right tail triggers P2Predict's log-target wrap automatically,
2424
which makes the SHAP attribution *multiplicative in price space* — and
25-
that's the form that most resembles how a buyer actually reasons
25+
that's the form that most resembles how a category manager actually reasons
2626
("low miles add about 19%, FWD pulls about 15% off"). The math is
2727
identical to what you'd want on a procurement BOM; the *vocabulary* is
2828
one everyone already speaks.
@@ -516,7 +516,7 @@ to learn.
516516
> data actually works, makes the model better behaved on the right
517517
> tail, and — as we'll see in the SHAP section — lets the per-feature
518518
> attribution become *multiplicative factors* in dollars, which is
519-
> exactly how a procurement buyer already reasons.
519+
> exactly how a category manager already reasons.
520520
521521
**What's measured.** The Fisher–Pearson sample skewness of the target
522522
column. Positive means right-tailed (many small values, a few big

0 commit comments

Comments
 (0)