Team Maturity Onboarding
Use this workflow to produce the machine-readable configuration files needed by the engine. The onboarding flow is intentionally lightweight and should generate the manifest, the org config, and the KPI definitions files in a format the shared runner can consume.
Required workflow
- Collect the organization context and the sprint assumptions.
- Produce a manifest at maturity/manifest.json that references the data and config files.
- Produce maturity/org-config.md with the threshold values and active patterns.
- KPI threshold calibration: references/threshold-guide.md.
- Leading indicator applicability (which of the 9 probabilistic leading
indicators apply to this org's workflow, and why not for any that
don't): references/leading-indicator-applicability.md.
Runs right after threshold calibration — same file, same
leading_indicator_thresholdsblock, a different question.
- Produce maturity/org-kpi-definitions.md with the KPI definitions for the organization.
- Validate the files against the schemas in maturity-core/schemas.
Output files
At the end of onboarding you should have:
- maturity/manifest.json
- maturity/org-config.md
- maturity/org-kpi-definitions.md
These files plus the Jira export and catalog are sufficient for the engine runner.
Guidance
- Prefer a config-driven workflow over verbose chat-only instructions.
- Reuse engine defaults from maturity-core/engine_defaults.json when the organization does not need a custom value.
- Keep the outputs deterministic and easy to audit.
- If the org does not need a custom KPI definition, copy the default logic from the engine defaults and note that it is inherited.