Skip to content

Add control cost / benefit fields to support treatment decisions #60

Description

@JohnASRG

Motivation

controls[] and riskTreatmentDecisions[] currently support implementation status and justification text, but no structured economic context. Real treatment decisions weigh implementation cost, lifecycle cost, and treatment benefit — all important inputs to risk acceptance discussions. Adding optional structured fields makes those tradeoffs portable across tools.

Proposed change

On controls[]:

On riskTreatmentDecisions[]:

  • treatmentBenefitRationale
  • expectedRiskReduction: { from: bandBefore, to: bandAfter, confidence }
  • decisionCostRationale

All fields optional; existing examples continue to validate without modification.

References

  • AI peer review, "Open topic — Controls cost" and "Recommended backlog"

Acceptance criteria

  • Schema fields added (JSON + XSD)
  • Example demonstrates a control with implementation estimate and a treatment decision with expected risk reduction
  • Methodology note explains that monetary values are advisory only

Surfaced by external AI peer review; see chat transcript for full review text.

Metadata

Metadata

Assignees

No one assigned

    Labels

    ai-proposalProposed by the AI idea scout; needs human reviewenhancementNew feature or requestpeer-reviewSurfaced by external AI/peer review of the repopriority/P3Low priority — differentiating features

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions