Pipeline
How the number is computed
Five steps turn raw company data into a score. The last step, scoring, reads its rubric from a config file.
The ETL pipeline
enrich is opt-in: it must be explicitly requested for the
features step to see freshly enriched data, since
features always reads from enrich's
output directory.
The score step is config-driven: its rubric, which
signals count, how they're combined, how they're scaled, and how many points each is
worth, lives in a YAML file the engine reads.
The scoring engine
Adding a new scoring method
- Write a function taking a raw
pd.Seriesplus its own parameters (must includepoints), returning apd.Seriesbounded[0, points]. - Register it in
src/etl/scaling.py'sSCALING_METHODSdict. - Reference it from a bucket's
method:field in a rubric YAML. - Add a unit test for the function itself.
No changes to score.py,
pipeline.py, rubric.py, or any other
bucket's config.
Why YAML
The rubric lives in config/rubric_v2.yaml. Each
bucket's cap and points value carries an inline comment explaining its rationale,
the deep_tech bucket's cap: 2 comment
reads “2+ tags = maximally deep-tech,” for example. That context stays
attached to the number it explains.
Known limitations
- enrich must be requested explicitly. The pipeline orchestrator's
default step list excludes it, but
featuresalways reads its output directory. - Team-size correlation is weak.
complexity_scorecorrelates with log(team size) at r≈0.10, roughly half the dataset carries no deep-tech signal at all, which caps how strongly team size can track the score. - Complexity does not predict success. Point-biserial correlation with
the
topCompanybadge is r≈0 (n=91), and with Acquired or Public status is r≈−0.11 (n=598). A confound-controlled logistic regression traces that negative reading to batch vintage and team growth, not to complexity itself, complexity's own coefficient is not significant once those are controlled for. See the dashboard's success section andnotebooks/complexity_analysis.ipynb, section 11.
Checked against outside research
The success-correlation result above was compared against published research on
founder pedigree, team growth, and VC vintage-year effects. Three of the four findings
line up with existing literature, including a paper studying founder backgrounds
within Y Combinator itself. Full comparison and sources in the
dashboard and in
documentation/plan_complexity_metric/objectives_and_metrics.md,
section 5.