Startup Compliance Compass
borrapurnaganesh-cmd/term-sheet-anomaly-rader
Radar de fricção contratual para startups: identifique armadilhas legais antes de assinar
Ver no GitHubPlugin que analisa contratos de grants e aceleradoras através de um sistema de pontuação em 7 dimensões de risco (equity, IP, controle operacional, timeline, exit, dados e liability). Transforma documentos legais em mapas visuais de fricção, ajudando founders a identificar cláusulas problemáticas antes de consultar advogados.
Instalação
npx convez-ai borrapurnaganesh-cmd/term-sheet-anomaly-rader1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise pré-jurídica de contratos de aceleradoras e programas de grants
- Identificação de cláusulas de equity clawback e IP assignment prejudiciais
- Comparação de termos entre múltiplas ofertas de financiamento não-dilutivo
- Preparação de founders para negociações com investidores institucionais
Veredito

Ferramenta legítima de due diligence que preenche uma lacuna real no processo de análise contratual de startups. A abordagem multi-dimensional é robusta, mas o disclamer correto de que não substitui assessoria jurídica é essencial e está bem colocado.
README
A tradução para o português deste README ainda está na fila.
Startup Compliance Compass: Automated Grant Agreement & Accelerator Term Analyzer for Early-Stage Ventures
🧭 Navigating the Fine Print: Your Co-Pilot for Grant and Accelerator Agreements
In the rush of securing non-dilutive funding or landing a spot in a prestigious accelerator, founders often sign away rights they never knew they had. Startup Compliance Compass is a privacy-first, offline-capable analysis engine that transforms dense legalese into actionable, color-coded friction maps. Think of it as a metal detector for buried clauses—it doesn't tell you what to sign, but it shines a light on what you're agreeing to.
This tool is not a replacement for a lawyer. It is a pre-screening radar that helps you ask the right questions before you pay for legal counsel.
🔍 The Core Problem: Why Your Accelerator Contract Might Be a Trap
Most startup grants and accelerator agreements are written by institutions that have done this thousands of times—while you're doing it for the first time. The power dynamic is inherently unequal. Common hidden pitfalls include:
- Equity clawback clauses masked as "success fees"
- Unlimited IP assignments disguised as "participation requirements"
- Liquidation preference waterfalls that dilute founder equity
- Non-compete windows that lock you out of your own market
- Automatic renewal terms with no opt-out
Startup Compliance Compass surfaces these exact patterns and scores them on seven independent dimensions.
📊 7-Dimension Friction Scoring: Decoding the Risk Anatomy
Imagine a lighthouse with seven beams. Each beam illuminates a different risk corridor. The score (0–100) tells you how aggressively that dimension favors the institution versus your venture.
| Dimension | What It Measures | Risk Scale |
|---|---|---|
| Equity Drain | Percentage of equity or revenue share demanded | Low (1–10%) to High (50%+) |
| IP Encirclement | Scope of intellectual property claims | None to Perpetual, Global, Irrevocable |
| Operational Choke | Control over hiring, pivots, or spending | Advisory only to Veto power |
| Timeline Quicksand | Unilateral extension rights for the institution | Fixed term to Infinite rollover |
| Exit Maze | Restrictions on selling or winding down the startup | Open market to Right of First Refusal |
| Data Sovereignty | Requirements to share customer or proprietary data | Anonymized only to Full access |
| Liability Shadow | Indemnification and liability cap asymmetries | Mutual to Unlimited founder liability |
Each clause is tagged, weighted, and aggregated into a single Overall Friction Score—a number from 0 (fully founder-friendly) to 100 (extreme institutional capture).
🧩 Architecture Overview: How the Compass Works
The system operates as a pipeline with four distinct stages, each feeding into the next:
graph TD
A[PDF/Plaintext Agreement] --> B{Document Parser}
B --> C[Clause Extraction Engine]
C --> D[Semantic Risk Classifier]
D --> E[Embedded Rule Library]
E --> F[Scoring Aggregator]
F --> G[7-D Friction Dashboard]
G --> H[Export: CSV/JSON/PDF Report]
style A fill:#4a90d9,stroke:#333,color:#fff
style G fill:#e67e22,stroke:#333,color:#fff
style H fill:#27ae60,stroke:#333,color:#fff
🚀 Getting Started: From ZIP to First Analysis in Under 3 Minutes
Prerequisites
You'll need a machine running any modern operating system (Windows 10+, macOS 11+, Ubuntu 20.04+). No cloud dependencies. No API keys required for the base functionality.
Installation
- Download the latest release package using the link below or build from source.
- Extract the archive to a folder of your choice.
- Run the installer or execute the standalone binary.
Example Profile Configuration
Before analyzing documents, you can define your startup's risk appetite in a simple YAML profile. This tells the engine which friction levels are acceptable and which should trigger red alerts.
# my_startup_profile.yaml
startup:
name: "NovaSight Biotech"
stage: "Seed"
sector: "MedTech"
risk_tolerance:
equity_drain_max: 15
ip_encirclement_max: 30
operational_choke_max: 20
timeline_quicksand_max: 25
exit_maze_max: 40
data_sovereignty_max: 10
liability_shadow_max: 35
alerts:
notify_on_overall_high: true
auto_export_flagged_clauses: false
Example Console Invocation
Once configured, run the analysis from your terminal. The tool accepts both single documents and batch folder processing.
# Analyze a single grant agreement
startup-compass analyze --input ./agreements/ycombinator_safe_2026.pdf --profile my_startup_profile.yaml
# Batch analyze an entire folder of accelerator agreements
startup-compass analyze --input ./accelerators/ --batch --output ./reports/
# Quick scan with default profile (no config file needed)
startup-compass scan --url https://example.com/terms.pdf
Expected console output after running a scan:
[2026-03-15 10:45:12] Initialized parser for 7 dimensions...
[2026-03-15 10:45:14] Extracted 42 risk-relevant clauses from 14 pages
[2026-03-15 10:45:17] Scoring in progress...
[2026-03-15 10:45:19] === OVERALL FRICTION SCORE: 67/100 (HIGH) ===
[2026-03-15 10:45:20] Top 3 high-risk clauses:
1. Clause 12(b): "Perpetual, worldwide, sublicensable grant to all IP"
2. Clause 8(a): "Unilateral right to increase equity upon milestone changes"
3. Clause 19(c): "Founder personal liability for program fees"
🔌 API Integration: Extend the Compass into Your Workflow
For teams that want to integrate this analysis into a custom platform, the engine exposes a lightweight REST API.
Endpoint: POST /analyze
| Parameter | Type | Description |
|---|---|---|
| document | file | PDF or TXT file (max 10MB) |
| profile | JSON | Optional risk tolerance configuration |
Response Schema
{
"friction_score": 67,
"dimensions": {
"equity_drain": { "score": 72, "severity": "high" },
"ip_encirclement": { "score": 81, "severity": "critical" },
"operational_choke": { "score": 34, "severity": "low" }
},
"flagged_clauses": [
{
"clause_id": "12(b)",
"text": "Perpetual, worldwide...",
"dimension": "ip_encirclement",
"risk_level": "critical"
}
]
}
To start the API server:
startup-compass serve --port 8080 --allow-origins *
🧠 Intelligence Backend: Supported AI Models (2026)
The engine supports two different analysis backends. The Local Model runs entirely offline and protects sensitive agreement data. The Cloud Models (OpenAI and Claude) offer deeper semantic understanding but require API keys for usage.
| Backend | Model | Latency | Data Privacy | Cost |
|---|---|---|---|---|
| Local | Rule-based + TF-IDF | <2 sec | 💚 Fully offline | Free |
| OpenAI | GPT-4o (2026) | 3-7 sec | ⚠️ Sent to OpenAI | API usage |
| Anthropic | Claude Opus 4 | 2-5 sec | ⚠️ Sent to Anthropic | API usage |
To enable cloud analysis, set environment variables:
export OPENAI_API_KEY="sk-your-key-here"
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
# Then run with cloud backend
startup-compass analyze --input ./agreement.pdf --backend openai
💻 Operating System Compatibility
The engine has been tested and is supported across all major desktop platforms.
| Operating System | Version | Status | Notes |
|---|---|---|---|
| Windows 11 | 24H2 | ✅ Fully supported | Installer included |
| Windows 10 | 22H2 | ✅ Supported | Requires .NET Runtime 8.0 |
| macOS Sonoma | 14.6 | ✅ Fully supported | Apple Silicon native |
| macOS Sequoia | 15.x | ✅ Supported | Rosetta 2 for Intel |
| Ubuntu | 22.04+ | ✅ Supported | Binary or Snap |
| Fedora | 39+ | ✅ Supported | RPM package |
| Debian | 12+ | ✅ Supported | AppImage available |
🔬 Key Features for 2026
- Responsive Terminal UI – The dashboard adapts to any terminal width, from a 24-inch monitor down to a 6-inch smartphone display via SSH. Colors and spacing adjust dynamically.
- Multilingual Clause Detection – The rule library natively supports English, Spanish, French, German, and Japanese legal phrasing. A sixth language (Mandarin Chinese) is in active development for Q3 2026.
- 24/7 Offline Analysis – Unlike web-based competitors, this tool works completely disconnected from the internet. Run your analysis on a plane, in a coffee shop with no WiFi, or in a basement without network access.
- Signature Comparison Mode – Upload two agreements side-by-side to visualize the exact differences in friction scores. Particularly useful when comparing offers from multiple accelerators.
- Version History Tracking – As grant agreements get revised (which happens frequently before signature), the tool can diff two versions of the same document and highlight which dimensions shifted.
- Export to Legal Brief – Generate a plain-language summary that you can share with your co-founder or forward to your attorney as a starting point for their deeper review.
🛡️ Disclaimer: Important Legal Notice
This software is provided for informational and educational purposes only. It is not a substitute for professional legal advice. The friction scores, risk assessments, and clause flagging are generated by a statistical model and rule-based engine that may produce false positives or false negatives. Always consult a qualified attorney before signing any legally binding agreement.
The creators of Startup Compliance Compass make no warranties, expressed or implied, regarding the accuracy, completeness, or legal sufficiency of the analysis. By using this tool, you acknowledge that any decisions made based on its output are your own responsibility.
🧪 Roadmap: What's Coming in 2026
- Q2 2026 – Native GUI desktop application (Electron-free, Rust-based)
- Q3 2026 – Mandarin Chinese clause library
- Q4 2026 – Multi-party agreement analysis (investor + employee + grant)
📄 License
This project is distributed under the MIT License, which grants permission for free commercial and personal use, modification, and redistribution with the inclusion of the original copyright notice.
🤝 Contributing
We welcome contributions from legal researchers, software engineers, and startup founders. If you've found a clause pattern we missed, or if you'd like to add a new language to the rule library, please open an issue or submit a pull request.
Startup Compliance Compass – Because the fine print shouldn't be a surprise six months after you signed.