Skip to main content

Archetype: Risk scoring product

Use when​

The product helps users prioritize entities, cases, assets, decisions, or actions based on risk.

Common users​

  • Analysts
  • Operators
  • Reviewers
  • Researchers
  • Decision-makers

Minimal MVP​

  • Input form or dataset
  • Risk scoring logic
  • Explanation layer
  • Output score
  • Suggested action
  • Basic audit trail

Required files​

  • product.yaml
  • product-brief.md
  • data-contract.md
  • evaluation.md
  • demo.md

Evaluation​

  • Calibration
  • Precision/recall
  • False-negative cost
  • Human usefulness
  • Explainability
  • Stability over time

Reference products​

  • SurgRisk

Common mistakes​

  • Producing a score with no recommended action
  • Hiding assumptions
  • Ignoring false negatives
  • Optimizing only for model accuracy
  • Failing to explain the result

Agent prompt​

You are building a risk scoring microproduct. First identify the target user, the entity being scored, the consequence of false positives and false negatives, and the action the user should take from the score. Then build the smallest version that produces a score, explanation, and recommended next step.