Contract Lifecycle Crew

End-to-end contract lifecycle management powered by CrewAI patterns. Role-specialized AI agents handle contract analysis, clause extraction, risk assessment, negotiation strategy, and approval routing through hierarchical Crews and event-driven Flows.

What This Demonstrates

| Concept | Implementation | |---------|---------------| | CrewAI | Agent(role, goal, backstory), Task, Crew, Flow patterns | | Role-Based Agents | 5 specialized agents with distinct legal/business personas | | Hierarchical Process | Senior Legal Analyst supervises Risk Assessor + Compliance Officer | | Sequential Process | Negotiation and approval crews run tasks in order | | Flow Orchestration | Full lifecycle: Intake → Analyze → Risk Route → Negotiate → Approve → Execute | | Conditional Routing | Low risk → auto-approve, Medium → standard review, High → full negotiation | | Enterprise Domain | Legal/procurement contract management with realistic mock data |

Architecture

                      Contract Lifecycle Flow
                      =======================

  [Intake] ─── validate + store contract
      |
      ▼
  Analysis Crew (hierarchical)
  ┌──────────────────────────────────────────┐
  │  Manager: [Legal Analyst]                │
  │  Workers: [Risk Assessor] [Compliance]   │
  │  Tasks: extract clauses → assess risk    │
  └──────────────────────────────────────────┘
      |
      ▼
  [Risk Router] ── conditional branching
      |
  ┌───┼───────────┐
  ▼   ▼           ▼
 LOW  MEDIUM    HIGH/CRITICAL
  |     |           |
  ▼     ▼           ▼
[Auto  [Standard  Negotiation Crew (sequential)
Approve] Review]  ┌─────────────────────────┐
  |     |        │ [Negotiation Strategist] │
  |     |        │ [Legal Analyst review]   │
  |     |        └─────────────────────────┘
  |     |              |
  |     ▼              ▼
  |  [Manager      [Multi-Level Approval]
  |   Approval]    (VP → Legal → CFO)
  |     |              |
  └─────┴──────────────┘
           |
           ▼
      [Execute Contract]

Quick Start

Option 1: Docker (Recommended)

git clone https://github.com/samuelvinay91/contract-lifecycle-crew.git
cd contract-lifecycle-crew

docker build -t contract-lifecycle-crew .
docker run -p 8014:8000 --env-file .env contract-lifecycle-crew

The API will be available at http://localhost:8014. Docs at http://localhost:8014/docs.

Option 2: Local Development

git clone https://github.com/samuelvinay91/contract-lifecycle-crew.git
cd contract-lifecycle-crew

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

cp .env.example .env
python -m contract_lifecycle.main

Option 3: uv (Fast)

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
python -m contract_lifecycle.main

No API keys required! Regex-based clause extraction and rule-based risk assessment work out of the box.

API Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /api/v1/contracts | Submit a contract for analysis | | GET | /api/v1/contracts/{id} | Get contract session status | | GET | /api/v1/contracts/{id}/stream | SSE stream of lifecycle progress | | POST | /api/v1/contracts/{id}/approve | Approve at current level | | POST | /api/v1/contracts/{id}/reject | Reject with comments | | POST | /api/v1/contracts/{id}/renegotiate | Submit counter-terms | | POST | /api/v1/contracts/{id}/execute | Mark contract as executed | | GET | /api/v1/contracts/{id}/report | Download full analysis report | | GET | /api/v1/templates | List contract templates | | GET | /api/v1/contracts | List all contracts | | GET | /health | Health check |

Example Usage

# Submit a contract
curl -X POST http://localhost:8014/api/v1/contracts \
  -H "Content-Type: application/json" \
  -d '{
    "contract_text": "MASTER SERVICES AGREEMENT\n\nThis Agreement is between TechCorp and CloudVendor...\n\n1. TERM\nThis Agreement shall continue for 36 months with auto-renewal..."
  }'

# Stream lifecycle progress
curl http://localhost:8014/api/v1/contracts/{session_id}/stream

# Approve contract
curl -X POST http://localhost:8014/api/v1/contracts/{session_id}/approve \
  -H "Content-Type: application/json" \
  -d '{"approver": "vp@techcorp.com", "comments": "Approved"}'

Agents (CrewAI Roles)

| Agent | Role | Backstory | |-------|------|-----------| | Legal Analyst | Senior Legal Analyst | 15 years corporate law, technology agreements specialist | | Risk Assessor | Risk Assessment Specialist | Former Big Four consultant, enterprise risk management | | Compliance Officer | Compliance Officer | Regulatory compliance expert (GDPR, SOX, industry-specific) | | Negotiation Strategist | Negotiation Strategist | Game theory background, contract optimization expert | | Approval Router | Approval Workflow Manager | Enterprise governance and workflow automation specialist |

Risk-Based Routing

| Risk Level | Approval Path | Contract Examples | |-----------|---------------|-------------------| | LOW | Auto-approve | Standard NDAs, low-value renewals | | MEDIUM | Manager approval | Standard SaaS agreements, consulting contracts | | HIGH | Manager → VP → Legal | Large vendor MSAs, employment agreements with non-competes | | CRITICAL | Manager → VP → Legal → CFO | Unlimited liability, broad indemnification, IP transfers |

Mock Contracts

The project includes 4 realistic sample contracts for immediate testing:

1. SaaS Agreement - with risky auto-renewal and unlimited liability clauses
2. NDA - with aggressive non-compete and broad confidentiality definitions
3. Vendor MSA - with favorable SLA but weak termination rights
4. Employment Agreement - standard terms, low risk

Testing

pytest tests/ -v
pytest tests/ -v --cov=src/contract_lifecycle
pytest tests/ -v -m "not slow and not integration"

Project Structure

contract-lifecycle-crew/
├── src/contract_lifecycle/
│   ├── agents/           # CrewAI-pattern role-based agents
│   ├── crews/            # Analysis, Negotiation, Approval crews
│   ├── flow/             # Lifecycle Flow orchestration
│   ├── tools/            # Clause extraction, risk calc, templates
│   ├── mock_data/        # Contracts, templates, precedents
│   ├── api.py            # FastAPI application
│   ├── config.py         # Settings
│   ├── models.py         # Pydantic domain models
│   ├── streaming.py      # SSE event stream
│   └── main.py           # Entry point
├── tests/
├── k8s/
├── Dockerfile
├── docker-compose.yml
└── pyproject.toml

License

MIT License - see LICENSE for details.