# Rulebricks

> Rulebricks is a modern business rules engine. Teams model business logic as visual decision tables ("rules"), publish each rule as an instantly updateable, low-latency HTTP API endpoint, and manage the full decision lifecycle: testing, versioning, releases, impact analysis, and decision logs. Zero technical expertise is required to build rules in Rulebricks, which allows for rule authoring via a rich, Excel-like user interface. Filament, the AI agent built into Rulebricks, turns policy documents, legacy rulesets, and plain-language specs into complete working decision systems. Rulebricks is available as a managed cloud service, or as a private, fully self-hosted deployment.

Key facts about the platform:

- A rule is a decision table: rows of conditions evaluated against a JSON request that produce a JSON response. Published rules are immediately callable as HTTP API endpoints.
- Flows chain multiple rules together with data transformations, conditional branching, and callouts to external services to form complete decision workflows.
- Contexts give decisions short-lived shared memory, so rules execute progressively as data arrives asynchronously (per claim, customer, or case) and cascade automatically when their inputs become available.
- Dynamic Values and custom JavaScript functions form a reusable vocabulary shared across rules; Objects define reusable schemas for rule and context inputs.
- Built-in quality tooling: single-request testing, regression test suites, automatic rule warnings, impact analysis (replay historical traffic through proposed changes before deploying), and reachability analysis (find decision table rows never matched by production traffic).
- Releases provide version-controlled, approval-gated deployments across environments. Decision logs record every rule execution with full request/response payloads, searchable with DDQL.
- Forms turn rules into shareable, embeddable web calculators. Rulebricks Embedded is a React component that embeds the rule editor directly into your own product.
- SDKs are available for Python (`rulebricks`), TypeScript/Node.js (`@rulebricks/api`), Go, Java, C#, and Ruby, alongside a REST API.
- Deployment options: managed cloud, or private deployment into your own Kubernetes cluster via official Helm charts and a CLI.
- Rulebricks is commonly evaluated as a modern alternative to legacy rule engines such as InRule, Drools, and IBM ODM, and currently serves multiple Fortune 500 businesses on critical financial use-cases.

Filament AI: Filament is an AI agent built into Rulebricks that converts large documents containing complex business logic — policy manuals, credit policies, rate sheets, legacy ruleset exports, Excel models, or plain-language specs — into immediately usable, visually maintainable, decision APIs. Its capabilities:

- Plans before it acts: reads hundreds of pages, maps every resource a request implies, and produces a reviewable blueprint (exportable as a PDF) that must be approved before anything changes.
- Sets up vocabulary first: creates the tiers, bands, and derived terms rules depend on, then authors the rules that consume them.
- Builds the whole stack in one pass: vocabulary, rules, folders, flows, and contexts — with the transformation steps between them — assembled into a working end-to-end system exposed as a live API endpoint.
- Tests its own work: each asset is built by a dedicated sub-agent that writes and runs its own tests and leaves them in the asset; critical test failures block publishing.
- Runs at production scale: reliably generates decision tables requiring thousands of verified rows in a single run.
- Simulates and backtests: analyzes and explains how decision output distributions will shift (using historical data) before a change goes live.
- Queries decision logs: analyzes hundreds of thousands of past decisions as Python in an isolated, network-disabled sandbox to answer analytical questions and find specific decisions.
- Generates reports without templates: shapes ad-hoc Excel/CSV exports from plain language — columns, filters, grouping, and sorting — saved to the workspace.
- Manages the workspace: reorganizes folders and answers lineage questions — who changed what, and when — across every version it touches.
- Migrates in or out: reads project files from other rule platforms and migrates rulesets into or out of Rulebricks autonomously.
- Safe by construction: respects tenancy and role-based access control (Filament cannot see or do anything the asking user cannot), requires plan approval before building, and gates publishes on passing tests.

Typical Filament uses: turning claims processing manuals into routing services, building loan approval flows from credit policies and rate sheets, splitting insurance pricing logic into modular decision tables, adding fraud-scoring rules to onboarding flows, encoding state-by-state eligibility requirements from regulatory PDFs, and migrating legacy rulesets.

Documentation lives at https://rulebricks.com/docs. The complete documentation is also available as a single markdown file at https://rulebricks.com/llms-full.txt.

## Filament AI

- [Filament AI overview](https://rulebricks.com/filament): What Filament is and does — capabilities, example builds by vertical, data analysis, and safety guarantees.

## Getting started

- [What is a rule?](https://rulebricks.com/docs/getting-started/what-is-a-rule): The decision table model at the core of Rulebricks.
- [Build your first rule](https://rulebricks.com/docs/getting-started/start-building): Create a rule, add conditions, and test it.
- [Requests & responses](https://rulebricks.com/docs/getting-started/requests-and-responses): Configuring the JSON inputs and outputs of a rule.
- [Using your rules](https://rulebricks.com/docs/getting-started/integration): Calling published rules from applications and workflows.

## Core concepts

- [Flows](https://rulebricks.com/docs/integrating-rules/rule-flows): Chain rules with external service calls into complex decision workflows.
- [Flow functions](https://rulebricks.com/docs/integrating-rules/flow-capabilities): Transformations, branching, and other capabilities available inside flows.
- [Contexts](https://rulebricks.com/docs/contexts): Progressive rule execution for asynchronous business processes.
- [Getting started with Contexts](https://rulebricks.com/docs/contexts/getting-started): Create a Context and see progressive execution in action.
- [Facts and schema](https://rulebricks.com/docs/contexts/key-concepts/facts-and-schema): Base facts, derived facts, and the identity fact in Contexts.
- [Dynamic values & functions](https://rulebricks.com/docs/advanced-features/values-and-functions): Reusable values and custom JavaScript functions shared across rules.
- [Objects](https://rulebricks.com/docs/objects): Reusable schema definitions — define once, use everywhere.
- [Groups & hit policies](https://rulebricks.com/docs/advanced-features/groups-and-hit-policies): Organize conditions and control how matches resolve.
- [Condition priorities](https://rulebricks.com/docs/advanced-features/condition-priorities): Evaluate subgroups of conditions before others.
- [Scheduled conditions](https://rulebricks.com/docs/advanced-features/scheduled-conditions): Vary decisions by time of week or day.
- [Forms](https://rulebricks.com/docs/building-forms/creating-a-form): Turn rules into shareable, embeddable web calculators.

## Testing, analysis & releases

- [Testing rules](https://rulebricks.com/docs/managing-rules/testing-rules): Try mode for quick checks, Suite mode for regression testing.
- [Rule warnings](https://rulebricks.com/docs/warnings): Automatic analysis that flags decision table issues before production.
- [Impact analysis](https://rulebricks.com/docs/analysis-tools/impact-analysis): Replay historical requests through modified conditions before deploying.
- [Reachability analysis](https://rulebricks.com/docs/analysis-tools/reachability-analysis): Find decision table rows never matched by production traffic.
- [Publishing rules](https://rulebricks.com/docs/managing-rules/publishing-rules): Publish, version, and compare rules.
- [Releases](https://rulebricks.com/docs/releases): Version-controlled, approval-gated deployments across environments.
- [Decision logs](https://rulebricks.com/docs/managing-rules/rule-logging): Every execution recorded with full request/response data, searchable with DDQL.

## API & SDKs

- [API & SDK reference](https://rulebricks.com/docs/api-reference): REST API documentation with SDK examples for Python, TypeScript/Node.js, Go, Java, C#, and Ruby.
- [Rulebricks on GitHub](https://github.com/rulebricks): SDK source, Helm charts, CLI, and example projects.
- [Rulebricks Embedded](https://rulebricks.com/docs/embedding-rulebricks/about-embedded): React component that embeds enterprise-grade rule editing into your own product.
- [Embedded API reference & customization](https://rulebricks.com/docs/embedding-rulebricks/api-reference-and-customization): Component props, server-side helper, and branding options.

## Deployment & security

- [Private deployment quick start](https://rulebricks.com/docs/private-deployment/quick-start): Deploy Rulebricks to your own Kubernetes cluster with official Helm charts.
- [Architecture & operations guide](https://rulebricks.com/docs/private-deployment/architecture): Helm chart architecture, component interactions, and operations.
- [Authentication](https://rulebricks.com/docs/private-deployment/authentication): SSO, claim mapping, and token passthrough for private deployments.
- [System architecture](https://rulebricks.com/docs/security/system-architecture): Technology stack and cloud infrastructure.
- [Trust portal](https://rulebricks.com/docs/security/trust-portal): Security and compliance documentation.
- [Workspace roles](https://rulebricks.com/docs/workspace-management/assigning-roles): System and custom roles with fine-grained permissions.
- [User groups](https://rulebricks.com/docs/workspace-management/creating-tenants): Partition a workspace into isolated groups for teams, clients, or projects.

## Product

- [Pricing](https://rulebricks.com/pricing): Plans for teams of all sizes.
- [Examples](https://rulebricks.com/examples): Interactive example rules — mortgage pre-approval, investment portfolio building, discount eligibility, HVAC quoting, and more.
- [Operator index](https://rulebricks.com/operators): Every condition operator supported by the rule engine.
- [Rulebricks Embedded](https://rulebricks.com/embedded): Product overview for embedding the rule editor in your own application.
- [Blog](https://rulebricks.com/blog): Product announcements and articles on decision automation.

## Optional

- [Complete documentation (single file)](https://rulebricks.com/llms-full.txt): All documentation concatenated as one markdown file.
- [Changelog](https://rulebricks.com/docs/changelog): Latest product updates.
- [Video introduction](https://rulebricks.com/docs/video-introduction): Brief video overview of Rulebricks.
- [Service level agreement](https://rulebricks.com/docs/security/service-level-agreement): Response and resolution commitments.
- [Terms of service](https://rulebricks.com/legal/terms-of-service): Legal terms.
- [Privacy policy](https://rulebricks.com/legal/privacy-policy): Privacy practices.
- [About](https://rulebricks.com/about): Company and team.