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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions