Growth maturity — calibration, goals, and narration (v3)¶

This page pairs with Growth. It explains how v3 calibrates your organisation, how pillars are built from four primitives, and how HERC suggests next steps — without engineering detail.

1. What is the maturity model?¶

Growth scores six pillars (catalog coverage, glossary, quality/contracts, automation, intelligence adoption, stewardship). Each pillar is a 0–100 composite of coverage, density, usage, and quality, interpreted against an organisational baseline (your shape and history — not raw global counts). Think of it like a fitness tracker: your journey is personalised to your organisation’s size and industry, and everyone can start — the model asks “how far along your expected path are you?” rather than ranking you on raw catalogue size.

The org headline blends all pillars (equal weights by default). The bottleneck pillar is called out separately when one area lags — your headline is not “only as good as the worst pillar.”

2. How is each pillar scored?¶

Primitive	Meaning (plain language)
Coverage	How much of what we expect for your org (terms, assets, contracts, products, active users) you actually have — a ratio, not a headline count.
Density	How interconnected things are: links, lineage, contract monitoring, graph relationships, fewer orphans.
Usage	Consumption of governed artefacts: HERC and dashboard activity, glossary lookups, steward engagement — not vanity production alone.
Quality	Durability under use: sensible glossary churn, fewer contract violations, freshness, steward responsiveness, answer satisfaction.

Primitives roll up per pillar (default: geometric mean so one zero drags honestly).

3. How is the headline determined?¶

The composite stage reflects all pillars. If one pillar is ≥5 points behind the next-lowest on the composite, the home page shows a bottleneck callout with that pillar’s name and the approximate lift if you closed the gap. Tight clusters hide the callout so noise does not look like a crisis.

4. Production vs Consumption¶

The production vs consumption insight compares governed output to downstream use (analytics, HERC, references). A healthy band is often around 0.5–2.0 (tuned per org). When the ratio sits outside that band, the home page folds the imbalance into the bottleneck callout as a single editorial line ("Consumption is outpacing production by 1.4× — this pillar would also lift adoption") — useful for deciding whether to publish more or activate what exists. The standalone dial moved to the /dna panel in the visual uplift; the home keeps the same insight in fewer pixels.

5. Confidence¶

Coverage and projections show low / medium / high:

Low — little baseline yet, or noisy fit — treat as directional only.
Medium — observed or hybrid baseline with enough confidence for prioritisation.
High — strong baseline (and, when industry priors apply after opt-in, sharper denominators).

Headline confidence is the weakest pillar band so the UI does not overclaim. Goal and pace projections use R² on recent history: fewer than 14 days or R² below 0.30 → low; 0.30–0.70 → medium; 0.70 or above → high.

6. Setting goals¶

You can set one active goal per pillar (target stage/score and deadline). Pace and horizon estimates are projected against that goal. HERC can discuss goals via the assistant when your permissions allow.

7. Next actions from HERC¶

When conditions allow, HERC may suggest a ranked next action (what to do, expected lift, rough time horizon). Each suggestion carries a confidence cue aligned with headline/baseline reliability — same low / medium / high idea as elsewhere: prefer acting on medium+ when you need a crisp priority. Suggestions never auto-apply — you choose what to run. The platform keeps an audit trail of what was suggested and acknowledged for accountability.

If headline confidence is low, suggestions may be suppressed so we do not prescribe from unstable baselines.

8. AI Fluency¶

AI Fluency is a sublayer of Intelligence Adoption (not a seventh pillar). It reflects how deeply HERC and agents learn your org over time — diary depth, query diversity, retry patterns, satisfaction trend, and related signals. Depth and balanced use matter more than raw chat volume alone.

9. Opt-in to industry priors¶

Your administrator can opt in to contributing aggregate telemetry (industry and size band buckets) so Datahub can refresh industry priors used to promote baseline confidence toward high for similar organisation shapes.

Privacy: payloads are aggregate-only (bucketed counts/ratios, k-anonymity safeguards on the collector) — not raw assets, terms, names, or user identifiers.
Default: off for everyone. You can turn the toggle off at any time.
Stub mode (during rollout): operations set DATAHUB_GROWTH_PRIORS_COLLECTOR_BASE_URL (empty by default). While it is empty, the app stays in stub mode: no outbound POST and no payloads leave the environment — regardless of opt-in. Opt-in still records intent; live upstream delivery starts only when this URL and signing keys are configured.

Previously submitted aggregates are not recalled from the product UI; operational retention is defined by your collector and release process.

10. FAQ¶

Question	Answer
Why did my score drop?	Baselines and primitives can move when expectations catch up to observation, when usage/consumption shifts, or when quality signals worsen. Check the bottleneck and primitive breakdown on home.
Why no recommendation today?	Often low headline confidence (baseline still thin or noisy) or engine suppression — finish onboarding, wait for more daily snapshots, or check the confidence labels on home before expecting a prescription.
Can I get a different baseline?	Re-run onboarding or let passive observation refine expectations; admins control industry priors opt-in where applicable.
What changed from before?	v3 replaces weakest-pillar-only headline with a composite + bottleneck callout, adds primitives and baseline ratios, goals-first projections, the production vs consumption insight, AI Fluency, and optional industry priors — scores are not point-for-point comparable to older major versions.

11. What changed in your home (visual uplift, Apr 2026)¶

The Growth home was redesigned for storytelling over information density. Same data, same numbers, same hooks — different shell.

Section	Before	Now
Hero	Composite number on a warm radial blob	Composite ring (WHOOP-style two-arc gauge) on a cosmic canvas with a small "EXPLORE YOUR JOURNEY →" CTA below. Five hero compositions (`ring`, `blob`, `vertical`, `compact`, `wide`) are available — `ring` is the default.
Production vs Consumption	Standalone chat-bubble dial competing with the hero	Removed from the home. Insight folded into the bottleneck callout as a single editorial line. Dial still lives on `/dna`.
Pillars	Compact rows with a flat range bar	Editorial 4-column rows: pillar identity (name + score + stage badge), full-width range bar with stage-band gradient + circle marker, narrative right column, pace delta + "VIEW TREND →". A 30 day / 6 month time-window pill sits at the section header.
Journey	Bare grey horizontal line with a text list below	JourneyTimeline organism: dates above the line, milestone names below, Today pulse marker on the right edge, capability-unlock chips. Vertical "ladder" and curved "river" variants are available.
Just unlocked	(no surface)	CapabilityUnlockCard — full-bleed cosmic ember tile rendered inline when an unlock crossed in the last 7 days. Two CTAs (`TRY IT NOW` / `WHAT CHANGES FOR ME?`) plus a HERC-notified line.
Empty / stale states	Bare hint placeholders	MaturityStateCard — section-aware copy with always-on CTA (`Resume jobs`, `Continue quickstart`, `What counts as a signal?`, `Retry now`).
What if	Flat form drawer	1·2·3 step layout: Pick a signal (grid of pillar cards) → Set the delta → Projected outcome with stage-tinted range bar. The closed-state tile (`WhatIfInsight`) carries a sparkline preview.

Tour selectors are unchanged (growth-pillars, growth-journey, growth-whatif) so existing screenshots and support docs continue to land on the right anchors.

12. What you see on day 1 / day 10 / day 30 (narrative, May 2026)¶

The Growth home now answers one question from first load: "where am I heading next?" You never land on a stack of "HERC is calibrating" empties. Two additions make that possible.

Forward milestones¶

A "Where you're heading next" panel sits at the top of the Growth home. It shows up to four milestones HERC projects on your horizon. Each step carries:

A day chip — Today, Tomorrow, or in N days.
A confidence badge — gaining clarity, on track, or confident.
A headline — the pillar and stage you are about to cross (e.g. "In 12 days: Proactive on Catalog Coverage").
A body line — one concrete signal that would move you across.
An optional Act on this button that deep-links into the catalog / glossary / contracts surface where that signal is created.

When there is not yet enough signal to project a date, the copy pivots to an optimistic calibrating voice — never "we don't have your data yet". It reads "First personalised milestones in about a week — keep working in Datahub and the picture sharpens."

Default goals on day one¶

Every organisation starts with six default goals — one per pillar — seeded on the day onboarding completes (or when an admin skips onboarding). Each default goal:

Targets the next stage up from your current pillar score (Reactive → Proactive → Predictive → Prescriptive), never beyond Prescriptive.
Sets the target score at the middle of that stage band.
Carries a 60-day deadline for your two weakest pillars (HERC gives the bottleneck the tighter loop) and a 90-day deadline for the rest.
Wears a "Default goal — tweak anytime" badge on the Goals surface and on the spotlight GoalCard on home.

Editing any field on a default goal (target stage, target score, or deadline) immediately clears the badge — it becomes yours. You can also archive the goal and create a different one on the same pillar.

For organisations that existed before this change, a one-shot backfill ran on deploy: every org that lacked an active goal on a pillar received the matching default. Any goals you had already set were preserved unchanged.

Reading the home on day 1 vs day 10 vs day 30¶

Day	What you see	Why it matters
Day 1 (baseline just captured / skipped)	ForwardMilestonesPanel with a `calibrating` step + 6 default goals in the Goals surface, each with the "Default goal — tweak anytime" badge.	You have a starting horizon and a starting plan from the first login. Nothing empty.
Day 10 (first snapshots in)	At least one milestone flips to `steady_climb` copy as HERC sees your primitives move. Pillars with positive slope start projecting precise dates.	You see the first real pace signal and learn which pillars are already compounding.
Day 30 (calibration threshold crossed)	Milestones flip to `reachable` with concrete `in N days: Stage on Pillar` headlines. Your 60-day bottleneck goal is typically two-thirds of the way to target.	The home transitions from aspirational to precisely predictive — the forward panel stays as the ongoing 30/60/90 motivator.

13. What you see — the new tiered home (May 2026 amendment)¶

The Growth home is now a tiered grid, not a full-width stack. Same data, same numbers, same engine — different shell, designed for business users and analysts who land here for guidance rather than diagnostics.

Tier	What you see	Why it is there
1 — Hero ring	Composite ring on a cosmic canvas with two satellites and one stage-aware narration line. The left satellite is `Stage N of 4 · Reactive/Proactive/Predictive/Prescriptive` so you immediately know where you are on the four-stage ladder. The right satellite celebrates a recent win: a capability unlocked in the last week, or the pillar with the biggest 30-day jump, or — for a brand-new org — a hopeful "First wins are weeks away". The narration line tells you what unlocks at the next stage, by name, against your weakest pillar.	One question, one stage, one win, one next step. No "+0 pts aggregate movement (30d)" jargon.
2 — Where you are heading next	A 1/2 + 1/2 row pairing the ForwardMilestonesPanel with either HERC's confident next-best action (when one is available) or your spotlight goal card.	The two forward-looking surfaces sit side by side instead of stacked under each other, so the page reads as a plan, not a list.
3 — Where the maturity comes from	Six pillar cards in a 2-column grid. Each card carries the pillar score, stage badge, full-width range bar with a stage-band gradient, narrative line, Open pillar button, and a primitives chevron in the bottom-right gutter. A pillar holding steady at zero movement shows a muted minus and a "Holding steady" label — never a red down-arrow.	Six tiles read as a dashboard; six full-width rows read as a wall of text. The neutral pace icon ends the demotivating mismatch where a flat pillar showed a coloured "regressing" arrow.
4 — Your story	A 2/3 + 1/3 row. On the left, the JourneyTimeline is wrapped in a card titled "How you got here" so it anchors the lower half of the page; when there are no unlocks yet, the empty timeline is a friendly dotted line plus an aspirational ETA ("Your first capability is roughly 3 weeks away at this pace"). On the right, the recent capability unlock celebration card if one crossed in the last week; otherwise this month's contribution summary.	The journey now reads as a section, not a floating timeline. The sidebar slot honours the "celebrate wins" tenet without occupying full-width real estate.
5 — Try a small change	A full-width what-if insight tile and drawer for modelling small actions against the projected stage crossings.	Unchanged from the visual uplift — the experimentation surface stays at the bottom so it does not interrupt the day-1 narrative.

A slim bottleneck banner appears between the stage strip and Tier 2 only when one pillar lags the next-lowest by 5 points or more, with the production-vs-consumption insight folded in as a single line.

If for any reason you land on a Goals surface that has no rows — for example, your organisation joined Datahub before the default-goals seeding shipped — the home page seeds the six defaults for you on the next visit, idempotently. You should never see an empty Goals page from now on; the safety net exists so you never have to.

Architectural decisions for this amendment are also available to the engineering team in the internal decision log.