convez.ai
PluginFinanceiroIntermediário
borrapurnaganesh-cmd

Startup Compliance Compass

borrapurnaganesh-cmd/term-sheet-anomaly-rader

Radar de fricção contratual para startups: identifique armadilhas legais antes de assinar

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin 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-rader

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

Download

🧭 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.

DimensionWhat It MeasuresRisk Scale
Equity DrainPercentage of equity or revenue share demandedLow (1–10%) to High (50%+)
IP EncirclementScope of intellectual property claimsNone to Perpetual, Global, Irrevocable
Operational ChokeControl over hiring, pivots, or spendingAdvisory only to Veto power
Timeline QuicksandUnilateral extension rights for the institutionFixed term to Infinite rollover
Exit MazeRestrictions on selling or winding down the startupOpen market to Right of First Refusal
Data SovereigntyRequirements to share customer or proprietary dataAnonymized only to Full access
Liability ShadowIndemnification and liability cap asymmetriesMutual 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

  1. Download the latest release package using the link below or build from source.
  2. Extract the archive to a folder of your choice.
  3. Run the installer or execute the standalone binary.

Download

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

ParameterTypeDescription
documentfilePDF or TXT file (max 10MB)
profileJSONOptional 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.

BackendModelLatencyData PrivacyCost
LocalRule-based + TF-IDF<2 sec💚 Fully offlineFree
OpenAIGPT-4o (2026)3-7 sec⚠️ Sent to OpenAIAPI usage
AnthropicClaude Opus 42-5 sec⚠️ Sent to AnthropicAPI 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 SystemVersionStatusNotes
Windows 1124H2✅ Fully supportedInstaller included
Windows 1022H2✅ SupportedRequires .NET Runtime 8.0
macOS Sonoma14.6✅ Fully supportedApple Silicon native
macOS Sequoia15.x✅ SupportedRosetta 2 for Intel
Ubuntu22.04+✅ SupportedBinary or Snap
Fedora39+✅ SupportedRPM package
Debian12+✅ SupportedAppImage 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.

View the full license text

🤝 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.

Download


Startup Compliance Compass – Because the fine print shouldn't be a surprise six months after you signed.

Ver o original no GitHub

Bom para

Relacionados