Cascading Goals Framework PRD¶

Product Requirements Document

Version: 1.0.0 Date: 2026-05-22 Author: PRISM Team Status: Draft

Executive Summary¶

This PRD defines requirements for a unified cascading goals framework that supports both OKR and V2MOM methodologies. The framework enables organizations to cascade strategic goals from company level through teams to individuals, with automatic alignment validation and maturity-driven goal suggestion.

Problem Statement¶

Current Challenges¶

1. Framework Fragmentation - Organizations using OKRs lack built-in cascading; V2MOM has cascading but lower adoption
2. Manual Alignment - Child goals must be manually aligned with parent goals
3. Disconnected Maturity - PRISM maturity goals don't automatically cascade through organizational hierarchy
4. No Goal Suggestions - Teams manually identify SLI gaps without automated recommendations

User Pain Points¶

Goals and Success Metrics¶

Primary Goals¶

Non-Goals¶

• Real-time collaborative editing (out of scope for v1)
• AI-generated goal text (may be added later)
• Integration with external OKR tools (Lattice, 15Five, etc.)

User Stories¶

Epic 1: Cascading Goals¶

As an Engineering Director
I want to cascade my OKRs to team-level OKRs
So that team goals automatically align with organizational objectives

Acceptance Criteria:

• [ ] Can create child OKR linked to parent via ParentObjectiveID
• [ ] Child Key Results map to parent Objectives
• [ ] Validation warns when child goals don't support parent
• [ ] prism goals cascade generates child goal templates

Epic 2: Unified Goals Interface¶

As a Platform Team Lead
I want to use the same commands for OKR and V2MOM
So that I don't need to learn two different workflows

Acceptance Criteria:

• [ ] prism goals list works for both OKR and V2MOM documents
• [ ] prism goals align validates alignment in either framework
• [ ] prism goals import imports either format to PRISM
• [ ] Framework auto-detected from document structure

Epic 3: Maturity-Driven Planning¶

As an SRE Manager
I want PRISM to suggest goals based on SLI gaps
So that I can prioritize maturity improvements effectively

Acceptance Criteria:

• [ ] prism goals suggest analyzes current SLI state vs targets
• [ ] Suggestions include estimated effort and impact
• [ ] Suggestions map to specific maturity level improvements
• [ ] Can filter suggestions by domain, layer, or priority

Functional Requirements¶

FR1: OKR Cascading Support¶

FR2: Unified Goals Interface¶

FR3: Maturity-Driven Planning¶

FR4: CLI Commands¶

Non-Functional Requirements¶

Performance¶

Compatibility¶

• Go 1.21+
• JSON Schema validation
• Existing OKR/V2MOM document formats preserved

Data Model Changes¶

OKR Extensions¶

type Objective struct {
    // ... existing fields ...

    // Cascading support
    ParentObjectiveID string   `json:"parentObjectiveId,omitempty"`
    CompanyOKRIDs     []string `json:"companyOkrIds,omitempty"`
    ChildObjectiveIDs []string `json:"childObjectiveIds,omitempty"`
}

type KeyResult struct {
    // ... existing fields ...

    // Alignment tracking
    SupportsObjectiveIDs []string `json:"supportsObjectiveIds,omitempty"`
}

Unified Interface¶

type Framework interface {
    Type() string                    // "okr" or "v2mom"
    GoalItems() []GoalItem           // Objectives or Methods
    ResultItems() []ResultItem       // Key Results or Measures
    Validate(opts ValidationOptions) []ValidationError
    Cascade(parent Framework) (Framework, error)
    AlignmentScore(parent Framework) float64
}

type GoalItem struct {
    ID          string
    Name        string
    Description string
    Owner       string
    Status      string
    Progress    float64
    ParentID    string
    Children    []string
    Results     []ResultItem
}

type ResultItem struct {
    ID       string
    Name     string
    Baseline string
    Target   string
    Current  string
    Score    float64
    GoalID   string
}

User Interface¶

CLI Examples¶

# Cascade company OKRs to team OKRs
prism goals cascade company-okrs.json \
  --team "Platform Team" \
  --output team-okrs.json

# Validate team alignment with company
prism goals align team-okrs.json company-okrs.json

# Suggest goals from maturity gaps
prism goals suggest \
  --model model.json \
  --state state.json \
  --target-level M4

# Import OKRs to PRISM goals
prism goals import team-okrs.json \
  --format okr \
  --to-prism goals-output.json

# Generate maturity improvement plan
prism goals plan \
  --model model.json \
  --state state.json \
  --from-level M2 \
  --to-level M4 \
  --phases 4

Output Formats¶

• JSON (default)
• Markdown tables
• Marp slides (for presentations)

Dependencies¶

Risks and Mitigations¶

Timeline¶

See ROADMAP.md for detailed timeline.

Appendix¶

A. Framework Comparison¶

B. Related Documents¶

• TRD.md - Technical Requirements Document
• ROADMAP.md - Implementation Roadmap