A shared operating system connecting Insurance General Counsels and Defense Law Firms through standardized workflows and intelligent automation.
Spec-OS Shared Suite bridges the gap between insurance carriers and defense law firms by providing:
- Billing QA Automation - Pre-validate invoices against carrier rules before submission
- Intake & Triage - Standardized matter assignment workflows
- Shared Matter Records - Synchronized case status across organizations
- Guidelines as Code - Carrier billing rules as executable specifications
- Reporting Automation - Automated compliance and status reporting
- Tenant Pairing - Secure carrier-firm relationships
┌─────────────────────────────────────────────────────────────┐
│ Spec-OS Shared Suite │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Firm Portal │ │ Event Bus │ │ Carrier │ │
│ │ │◄─┤ (Realtime) ├─►│ Portal │ │
│ └──────┬──────┘ └─────────────┘ └──────┬──────┘ │
│ │ │ │
│ ┌──────▼──────────────────────────────────▼──────┐ │
│ │ HITL AI Agents │ │
│ │ • Billing QA Agent │ │
│ │ • Intake Triage Agent │ │
│ │ • Reporting Agent │ │
│ └─────────────────────┬──────────────────────────┘ │
│ │ │
│ ┌─────────────────────▼──────────────────────────┐ │
│ │ Supabase (PostgreSQL + Auth) │ │
│ │ • Row Level Security (Multi-tenant) │ │
│ │ • Realtime Subscriptions │ │
│ │ • Edge Functions │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
- Python 3.11+
- Node.js 18+
- Git
- Supabase CLI (optional)
# Clone the repository
git clone https://github.com/your-org/spec-os-shared-suite.git
cd spec-os-shared-suite
# Check prerequisites
./.specify/scripts/check-prerequisites.sh
# Install Python dependencies
pip install -e .
# Install frontend dependencies
cd frontend && npm install && cd ..
# Set up environment variables
cp .env.example .env
# Edit .env with your Supabase credentials
# Run database migrations
supabase db push
# Start development servers
uvicorn src.api.main:app --reload # Backend
npm run dev # Frontend (in separate terminal)spec-os-shared-suite/
├── .specify/ # Spec-Kit specifications
│ ├── memory/
│ │ └── constitution.md # Project principles
│ ├── scripts/ # Utility scripts
│ ├── specs/ # Feature specifications
│ │ ├── 001-billing-qa/
│ │ │ ├── spec.md # Requirements
│ │ │ ├── plan.md # Implementation plan
│ │ │ ├── tasks.md # Task breakdown
│ │ │ ├── data-model.md # Database schema
│ │ │ ├── research.md # Technical research
│ │ │ └── contracts/ # API specifications
│ │ ├── 002-intake-triage/
│ │ └── ...
│ └── templates/ # Spec templates
├── src/ # Python source code
│ ├── agents/ # AI agents
│ ├── api/ # FastAPI routes
│ ├── core/ # Business logic
│ ├── events/ # Event handlers
│ ├── models/ # Pydantic models
│ ├── repositories/ # Data access
│ ├── services/ # Business services
│ └── workflows/ # Workflow definitions
├── tests/ # Test suites
│ ├── unit/
│ ├── integration/
│ └── e2e/
├── frontend/ # React frontend
├── supabase/ # Supabase config & migrations
├── docs/ # Documentation
├── carriers/ # Carrier-specific configs
│ ├── general/ # Generic carrier
│ └── liberty-mutual/ # Liberty Mutual specific
├── CLAUDE.md # AI agent instructions
├── pyproject.toml # Python project config
└── README.md
This project uses GitHub Spec-Kit for spec-driven development:
# Define project principles
/speckit.constitution
# Create a new feature specification
/speckit.specify Build a new reporting dashboard...
# Create implementation plan
/speckit.plan Use React with Recharts for visualization...
# Generate task breakdown
/speckit.tasks
# Implement the feature
/speckit.implement# All tests
pytest
# Unit tests only
pytest tests/unit/
# With coverage
pytest --cov=src tests/
# Integration tests (requires database)
pytest tests/integration/# Lint Python
ruff check src/
# Format Python
ruff format src/
# Type check
mypy src/Pre-validates legal invoices against carrier billing rules:
- LEDES 1998B and 2.x parsing
- Carrier-specific rule evaluation
- AI-powered suggestion generation
- HITL approval workflows
- Real-time compliance scoring
Status: Implementation Ready
Standardized matter intake and assignment workflows.
Synchronized case status tracking across organizations.
Carrier billing guidelines as executable specifications.
Automated compliance and status reporting.
Secure carrier-firm relationship management.
- Multi-tenant Isolation: Row Level Security (RLS) on all tables
- Authentication: OAuth 2.0 / OIDC via Supabase Auth
- Encryption: TLS 1.3 in transit, AES-256 at rest
- Audit Logging: Complete audit trail of all actions
- Constitution - Project principles
- Billing QA Spec - Feature requirements
- API Specification - OpenAPI docs
- Data Model - Database schema
- Check the constitution for project principles
- Review the current spec for the feature you're working on
- Follow the task breakdown in
tasks.md - Ensure tests pass and coverage is maintained
- Submit a PR with clear description
Proprietary License. Copyright © 2025 Execture Inc. All rights reserved. See LICENSE for details.
- GitHub Spec-Kit - Spec-driven development framework
- Supabase - Backend infrastructure
- LEDES.org - Legal billing standards
- UTBMS - Task-based management codes