Compare Periodscompare_periods
Period-over-period comparison with named deltas explaining what changed. Compares pipeline, cost, yield, event mix, and capacity across two periods. Identifies top drivers of each change and flags concerning trends.
Answer
When to use Compare Periods
Use to compare two governed portfolio periods and name the drivers of change.
Governed tool contract
- Job
- Justify spend · Choose a better mix
- Output type
- Associative
- Write contract
- Read-only; no approval or commit action
- Governance
- Policy-backed (Attribution, Capacity) with confidence and provenance
- Scope
- Chapter Isolated
- Role
- Member
Inputs
| Name | Type | Required | Accepted values / notes |
|---|---|---|---|
currentPeriod | String | Yes | Q1 · Q2 · Q3 · Q4 · year |
currentYear | Number | Yes | Catalog-defined value |
previousPeriod | String | Yes | Q1 · Q2 · Q3 · Q4 · year |
previousYear | Number | Yes | Catalog-defined value |
dimensions | String List | No | pipeline · cost · yield · mix · capacity |
verbosity | String | No | summary · standard · detailed |
Question patterns
“What changed quarter over quarter?”
“Why did portfolio performance move?”
Do not
Do not treat scenario, planned, committed, and actual values as interchangeable or bypass governed provenance.
Related references
Glossary terms
- period comparison
- trend driver
Related capabilities
- Analyze Portfolio Yield
analyze_portfolio_yield - Explain Variance
explain_variance
Machine references
Compare this human reference with the generated public catalog and the live, authenticated capability contract.