Skip to content

Insurance vertical — academic tutorial

Released in FCC v1.2.0. You are teaching or studying persona-driven agent workflows and want to use the Insurance pack as a case study. This tutorial connects the persona's R.I.S.C.E.A.R. specification to the underlying regulatory standards and shows how to cite them properly in classwork or publications.

The Insurance pack in one paragraph

The insurance vertical pack (at src/fcc/data/verticals/insurance.yaml) contains 6 personas spanning underwriting, actuarial reserving, IFRS 17 / Solvency II reporting, claims fraud detection, reinsurance structuring, and parametric / climate risk. Headline compliance frameworks: ACORD Reference Architecture, IFRS 17, Solvency II, NAIC Model Laws.

Focus persona: ACT — Actuarial Reserving Specialist

We'll anchor this tutorial on ACT, because it's the one most relevant to the academic audience in the Insurance domain.

from fcc.verticals.registry import VerticalRegistry

reg = VerticalRegistry.from_builtin()
pack = reg.get("insurance")
persona = next(p for p in pack.personas if p.id == "ACT")

print(persona.name)
print(persona.risk_category or "minimal")
riscear = persona.riscear or {}
print("Archetype:", riscear.get("archetype"))
print("Role:", riscear.get("role"))

Connecting the persona to its regulatory standards

ACT (Actuarial Reserving Specialist) was selected because its responsibilities map cleanly onto published standards in the insurance domain. The research note at src/fcc/data/verticals/research/insurance.research.md lists the exact sources.

When citing this persona in classwork or a publication, use both:

  1. The FCC framework citation (see docs/community/citation.md).
  2. The underlying standards cited in the research note.

Extracting persona constraints for comparison

A common assignment is to compare the R.I.S.C.E.A.R. constraints across several personas and argue which are regulatory versus organizational in origin.

for p in pack.personas:
    r = p.riscear or {}
    print(f"=== {p.id} — {p.name} ===")
    for c in r.get("constraints", []):
        print(f"  - {c}")
    print()

Your homework: classify each constraint as regulatory, organizational, or professional-ethical.

Generating a model card for citation

fcc model-card generate --persona ACT --output _output/cards

Model cards follow Mitchell et al. (2019) and include a bibliographic field you can cite directly.

Verify what you did

Run the vertical test suite to make sure your changes didn't break anything:

pytest tests/test_verticals.py -k "insurance" -v

All academic-path steps in this tutorial leave your working tree unchanged — the pack YAML is read-only from your perspective. The only state that accumulates is in _output/ (scenario run traces) and docs/model-cards/ (if you regenerated cards).

Next steps