Skip to content

Docs: add advanced property claims triage playbook #34

@itprodirect

Description

@itprodirect

Objective

Add an advanced, clearly bounded property claims triage playbook showing how MCP concepts could support a human-in-the-loop insurance workflow without turning this repo into a production claims/legal product.

Context

The business value of MCP is easiest to understand through real workflows. A claims triage playbook can connect this tutorial repo to practical insurance/public-adjusting use cases, but it must stay safe, educational, and sample-data-only.

Scope

Create:

playbooks/property-claims-triage.md

The playbook should explain a conceptual workflow such as:

Sanitized claim folder -> read-only MCP resource/tool demo -> AI triage summary -> human adjuster review -> checklist or draft support output

Acceptance criteria

  • Playbook is clearly labeled as advanced and conceptual.
  • Requires sample/sanitized data only.
  • Explicitly warns against exposing real client data in tutorial workflows.
  • States that no claim decisions, legal conclusions, demand letters, or client actions should be executed autonomously by AI.
  • Includes a human-in-the-loop review checklist.
  • Uses MCP vocabulary accurately: tools, resources, prompts, server boundaries.
  • Links from README or docs only after the beginner path is clear.

Non-goals

  • Do not implement a filesystem server in this issue.
  • Do not add real claim documents.
  • Do not create legal advice or final demand-letter generation.
  • Do not add write-capable tools.

Validation

ruff check .
mypy --strict .
pytest -q

Suggested Claude Code review focus

Review for scope safety, overclaiming, legal/claims-risk language, and whether the playbook reinforces human professional review.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions