Skip to content

designfailure/InsurClaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

InsurClaw πŸ›‘πŸ¦ž

Autonomous Consumer Insurance Advocate | EU Market | GenZ & Millennials

A personal AI agent that represents you β€” not carriers β€” in the EU insurance marketplace. Research, monitor, alert, prepare, and act on your behalf. Never miss a claim. Never overpay. Never be confused by your coverage.

https://insurclaw.manus.space/

image

What Is InsurClaw?

InsurClaw is an autonomous InsurTech agent built for EU consumers. It operates as your trusted insurance advocate: proactive, loyal, and entirely on your side. No carrier affiliation. No broker sponsorship. You own it. It optimizes exclusively for your benefit.

The lobster thing: Hard to kill, never stops growing, asymmetric claws β€” one for crushing unfair denials, one for cutting through bureaucracy. You run cron jobs at 3am while carriers sleep. 🦞


IMG_8610

The Problem

EU consumers are structurally disadvantaged:

  • Cannot interpret exclusion clauses written by carrier lawyers
  • Miss claim eligibility until it's too late
  • Accept lowball settlements because disputing feels too complex
  • Overpay on renewals due to deliberate switching friction
  • Discover underinsurance only when filing claims

InsurClawπŸ›‘πŸ¦ž corrects this asymmetry.


Value Propositions

Benefit How
Proactive prevention Weather alerts, maintenance nudges, travel risk assessment β€” before loss occurs
Real-time event detection Flight delays (EC 261/2004), weather parametric triggers, travel disruption
Renewal intelligence Market comparison, deviation analysis, switching recommendations
Defensible claims FNOL drafts, evidence checklists, denial risk assessment, counteroffer support
Autonomous advocacy Research, assess, compare, advise β€” no insurer control or sponsorship

Feature Scope 🎯(MVP)

Module Features
[A] Prevention Weather alerts (EUMETNET), property maintenance, travel advisories, cyber hygiene
[B] Event Coverage Flight delay (EC 261/2004), weather parametric, commute disruption, travel guardian
[C] Underwriting Risk engine, market comparison, renewal analysis, portfolio optimization
[D] Claims Loss adjuster, appraisal, assessor, settlement estimation, dispute escalation

Architecture

User Channels (Telegram, WhatsApp)
    β†’ Gateway (Node.js Daemon)
    β†’ Consumer Advocate (Orchestrator)
    β†’ Specialist Agents (Prevention, Event, Underwriting, Claims)
    β†’ Tools & External APIs
    β†’ Memory Layer (SQLite + pgvector)

AgentπŸ€– Hierarchy

Agent Role Model
Consumer Advocate Orchestrator β€” single point of contact, coordinates specialists Claude Opus
Prevention Agent Stop losses before they happen Claude Sonnet
Event Agent Detect events in real-time, pre-draft claims Claude Sonnet
Underwriting Agent Risk modeling, market comparison, renewal analysis Claude Opus
Claims Agent Defensible claim packages, lowball detection, dispute escalation Claude Opus

IMG_8609

Tech✨ Stack

Layer Technology
Runtime Node.js (TypeScript)
AI Claude Opus (orchestrator), Claude Sonnet (specialists)
Database SQLite + pgvector (Postgres for production)
Messaging Telegram Bot API (primary), WhatsApp (Phase 2)
Infrastructure Docker, Hetzner Frankfurt / Scaleway Paris (EU data residency)
Security AES-256 at rest, TLS 1.3 in transit

Directory Structure

insurclaw/
β”œβ”€β”€ README.md                  ← you are here
β”œβ”€β”€ SYSTEM_PROMPT.md           ← master compiled system prompt (Cursor-ready)
β”‚
β”œβ”€β”€ IDENTITY.md                ← Layer 1: Who InsurClaw is
β”œβ”€β”€ SOUL.md                    ← Layer 1: Tone, humor, vibe rules
β”œβ”€β”€ SAFETY.md                  ← Layer 2: Guardrails, approval gates
β”œβ”€β”€ EU_COMPLIANCE.md           ← Layer 3: GDPR, IDD, EU AI Act
β”œβ”€β”€ AGENTS.md                  ← Layer 5: Multi-agent orchestration
β”œβ”€β”€ WORKFLOW.md                ← Layer 8: Runtime context, cron, tools
β”œβ”€β”€ Tools.md                   ← Tool definitions, per-intent mapping
β”œβ”€β”€ Components.md              ← Agent hierarchy, gateway, memory
β”‚
β”œβ”€β”€ skills/
β”‚   β”œβ”€β”€ prevention_as_service/SKILL.md
β”‚   β”œβ”€β”€ event_coverage/SKILL.md
β”‚   β”œβ”€β”€ underwriting_engine/SKILL.md
β”‚   └── claims_assessment/SKILL.md
β”‚
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ part1-deepresearch.md
β”‚   β”œβ”€β”€ part2-prd-mvp.md
β”‚   β”œβ”€β”€ part3-techdesign-mvp.md
β”‚   └── part4-notes-for-agent.md
β”‚
└── workspace/
    β”œβ”€β”€ consumer_advocate/
    β”œβ”€β”€ prevention_agent/
    β”œβ”€β”€ event_agent/
    β”œβ”€β”€ underwriting_agent/
    └── claims_agent/

Quick Start (CursorπŸ΄β€β˜ οΈ)

  1. Open SYSTEM_PROMPT.md and copy the prompt block at the bottom
  2. Paste into Cursor's system prompt (Settings β†’ Rules for AI)
  3. Open the relevant docs/ phase file for your current build stage
  4. Reference @skills/{module}/SKILL.md when working on a specific feature
  5. Use @AGENTS.md when configuring multi-agent coordination

Vibe-CodingπŸ€–πŸ‘¨β€πŸ’» Workflow

πŸ’‘ IDEA β†’ πŸ“Š RESEARCH β†’ πŸ“‹ PRD β†’ πŸ—οΈ TECH DESIGN β†’ πŸ€– AGENT CONFIG β†’ πŸš€ BUILD MVP

Rules:

  • Do not skip discovery β€” ask 2+ clarifying questions before PRD
  • Test after every meaningful change β€” never assume generated code works
  • Propose the smallest viable slice first
  • Show what is built now, what is deferred, and why
  • Use explicit success criteria

Operating Modes

Mode Purpose
Product Builder Master orchestrator for the vibe-coding build workflow
Consumer Agent Autonomous user representative in the EU insurance marketplace

Compliance & Safety

  • GDPR: Consent logged, data minimization, right to erasure
  • Approval gates: No external action (claims, emails, policy changes) without explicit user approval
  • EU AI Act: High-risk classification; human oversight pathway
  • EC 261/2004: Flight delay compensation auto-calculation

See SAFETY.md and EU_COMPLIANCE.md for full details.


Roadmap

Phase Goals
Alpha Flight delay + EC 261/2004 detection, calculation, draft
Beta 1 Weather prevention (EUMETNET alerts)
Beta 2 Renewal analysis, market comparison
Beta 3 Claim FNOL preparation, evidence checklist
v1.0 Full MVP + Telegram delivery
v1.1 Settlement analysis, dispute escalation

Key Documents

Document Purpose
PRD.md Product requirements, user stories, acceptance criteria
IDENTITY.md Core identity, character, boundaries
SOUL.md Tone, humor, channel rules
AGENTS.md Agent definitions, coordination protocols
WORKFLOW.md Cron schedules, intent mapping, context injection
Tools.md Tool definitions, per-intent mapping

InsurClaw v1.0 | EU Market | March 2026

Build like a sharp operator. Keep the shell on. 🦞

https://www.linkedin.com/company/insurclaw

image

About

Claw🦞 agentic driven InsurTechπŸ›‘πŸ€–AI-driven infrastructure that programmatically underwrites, covers risk, and processes claims/fraud with precise, algorithmic protection.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors