Crate driven 

Driven

Professional AI-assisted development orchestrator with binary-first architecture.

Driven brings structure, consistency, and intelligence to AI-powered coding workflows by combining template-driven approaches with methodical frameworks, reimagined in Rust with DX’s binary-first philosophy for unparalleled performance.

Features

• Universal Rule Format: One source of truth, convert to any editor
• Binary-First Storage: Using DX serializer principles for 70%+ size reduction
• Context Intelligence: Deep project analysis for AI guidance
• Professional Templates: Battle-tested patterns for AI agents
• Zero-Parse Loading: Instant rule loading with memory-mapped binaries
• DX Binary Dawn: SIMD scanning, XOR patching, Ed25519 signing

Quick Start

use driven::{DrivenConfig, RuleSet};

// Load existing rules
let rules = RuleSet::load(".cursorrules")?;

// Convert to different formats
rules.emit_copilot(".github/copilot-instructions.md")?;
rules.emit_windsurf(".windsurfrules")?;

// Or use binary format for maximum efficiency
rules.save_binary(".driven/rules.drv")?;

Architecture

Driven is organized into several key modules:

• [format]: Binary rule format (.drv) encoding/decoding
• parser: Universal parser for all editor rule formats
• emitter: Target format generators for each editor
• templates: Template system with built-in library
• context: AI context intelligence and project analysis
• sync: Multi-editor synchronization
• validation: Rule validation and linting

DX Binary Dawn Modules

• binary: DX ∞ infinity format, zero-copy schemas, SIMD tokenizer
• fusion: Pre-compiled templates, hot cache, speculative loading
• streaming: HTIP delivery, XOR patching, ETag negotiation
• security: Ed25519 signing, capability manifest, sandbox
• state: Dirty-bit tracking, shared rules, atomic sync

Re-exports

pub use context::ProjectAnalyzer;

pub use context::ProjectContext;

pub use emitter::Emitter;

pub use format::DrvDecoder;

pub use format::DrvEncoder;

pub use format::DrvHeader;

pub use format::RuleCategory;

pub use parser::ParsedRule;

pub use parser::Parser;

pub use parser::UnifiedRule;

pub use sync::SyncEngine;

pub use templates::Template;

pub use templates::TemplateRegistry;

pub use validation::Linter;

pub use validation::ValidationResult;

pub use binary::Blake3Checksum;

pub use binary::InfinityHeader;

pub use binary::InfinityRule;

pub use binary::MappedRule;

pub use binary::SimdTokenizer;

pub use binary::StringId;

pub use binary::StringTable;

pub use binary::StringTableBuilder;

pub use fusion::BinaryCache;

pub use fusion::FusionModule;

pub use fusion::HotCache;

pub use fusion::SpeculativeLoader;

pub use security::Capability;

pub use security::CapabilityManifest;

pub use security::Ed25519Signer;

pub use security::IntegrityGuard;

pub use security::Sandbox;

pub use state::AtomicSync;

pub use state::DirtyBits;

pub use state::RuleSnapshot;

pub use state::SharedRules;

pub use state::SnapshotManager;

pub use streaming::ChunkStreamer;

pub use streaming::ETagNegotiator;

pub use streaming::HtipDelivery;

pub use streaming::XorPatcher;

pub use dx_integration::DxSerializable;

pub use dx_integration::DxDocumentable;

pub use dx_integration::DxMarkdownConfig;

pub use dx_integration::DxMarkdownFormat;

pub use dx_integration::rules_to_dx_markdown;

pub use dx_integration::LegacyConverter;

pub use dx_integration::LegacyFormat;

pub use dx_integration::LegacySerializable;

pub use dcp::ConnectionState;

pub use dcp::DcpClient;

pub use dcp::DcpConfig;

pub use dcp::ToolDefinition;

pub use generator_integration::DrivenTemplate;

pub use generator_integration::DrivenTemplateProvider;

pub use generator_integration::DrivenTemplateType;

pub use generator_integration::GenerateParams;

pub use generator_integration::GeneratedFile;

pub use generator_integration::GeneratorBridge;

pub use generator_integration::TemplateCategory;

pub use generator_integration::TemplateInfo;

pub use integration::BinaryFormatChecker;

pub use integration::CrossCrateHeader;

pub use integration::DrivenDcpBridge;

pub use integration::DrivenTool;

pub use integration::DrivenToolCategory;

pub use integration::HookMessage;

pub use integration::HookMessenger;

pub use integration::SourceCrate;

pub use integration::SpecScaffoldResult;

pub use integration::SpecScaffolder;

pub use integration::ValidationResult as IntegrationValidationResult;

pub use error::EnhancedError;

pub use error::EnhancedResult;

pub use error::ErrorContext;

pub use config_validation::ConfigValidator;

pub use config_validation::ValidationError;

pub use config_validation::ValidationReport;

pub use config_validation::ValidationWarning;

pub use config_validation::validate_config;

pub use hooks::AgentHook;

pub use hooks::BuildEvent;

pub use hooks::GitOp;

pub use hooks::HookAction;

pub use hooks::HookCondition;

pub use hooks::HookContext;

pub use hooks::HookEngine;

pub use hooks::HookExecutionResult;

pub use hooks::HookTrigger;

pub use hooks::TestFilter;

pub use hooks::TestResult;

pub use hooks::TestStatus;

pub use steering::AgentContext;

pub use steering::FileReference;

pub use steering::SteeringEngine;

pub use steering::SteeringInclusion;

pub use steering::SteeringRule;

pub use strategy::ClaimId;

pub use strategy::ClaimStatus;

pub use strategy::ClaimToken;

pub use strategy::CommandEvidence;

pub use strategy::CommandProof;

pub use strategy::CommandStatus;

pub use strategy::FileProof;

pub use strategy::GitCheckoutKind;

pub use strategy::LaneClaim;

pub use strategy::LaneId;

pub use strategy::LanePassAssignment;

pub use strategy::LanePassAssignmentStatus;

pub use strategy::LanePassConfig;

pub use strategy::LanePassStatePaths;

pub use strategy::LanePassStore;

pub use strategy::NextPassHandoff;

pub use strategy::OutcomeProof;

pub use strategy::PassNumber;

pub use strategy::PassOutcome;

pub use strategy::ProofReceipt;

pub use strategy::ReceiptFormat;

pub use strategy::SubagentDelegation;

pub use strategy::VerificationClass;

pub use strategy::WorkerId;

pub use strategy::WorkerIdentity;

pub use strategy::WorkerKind;

pub use strategy::WorktreeCreationDecision;

pub use strategy::WorktreeIsolationMode;

pub use strategy::WorktreeIsolationPlan;

pub use strategy::WorktreeMetadata;

pub use strategy::detect_worktree_metadata;

pub use strategy::plan_worktree_isolation;

pub use sysinfo::BuildToolInfo;

pub use sysinfo::GitInfo;

pub use sysinfo::LanguageInfo;

pub use sysinfo::OsInfo;

pub use sysinfo::PackageManagerInfo;

pub use sysinfo::ProjectInfo;

pub use sysinfo::ProjectType;

pub use sysinfo::ShellInfo;

pub use sysinfo::SystemInfo;

pub use sysinfo::SystemInfoCache;

pub use sysinfo::SystemInfoProvider;

pub use sysinfo::TestFrameworkInfo;

pub use agents::Agent;

pub use agents::AgentPersona;

pub use agents::AgentRegistry;

pub use agents::DelegationRequest;

pub use agents::DelegationResult;

pub use workflows::StepResult;

pub use workflows::Workflow;

pub use workflows::WorkflowBranch;

pub use workflows::WorkflowEngine;

pub use workflows::WorkflowPhase;

pub use workflows::WorkflowProgress;

pub use workflows::WorkflowSession;

pub use workflows::WorkflowStep;

pub use scale::ComplexityAnalyzer;

pub use scale::DependencyAnalyzer;

pub use scale::FileSizeAnalyzer;

pub use scale::HistoryAnalyzer;

pub use scale::ProjectContext as ScaleProjectContext;

pub use scale::ProjectScale;

pub use scale::ScaleAnalyzer;

pub use scale::ScaleDetector;

pub use scale::ScaleRecommendation;

pub use scale::TeamSizeAnalyzer;

pub use modules::Module;

pub use modules::ModuleDependency;

pub use modules::ModuleManager;

pub use modules::ModuleStatus;

Modules

agents

Expanded Agent Library

binary

DX Binary Dawn - Binary-First Rule Format

cli

CLI Command Handlers

config_validation

Configuration Validation Module

context

AI Context Intelligence

dcp

DCP (Development Context Protocol) Integration

dx_integration

DX Ecosystem Integration

emitter

Target Format Generators

error

Comprehensive Error Handling Module

format

Binary Rule Format (.drv - Driven Rule)

fusion

DX Fusion Mode - Pre-Compiled Template System

generator_integration

Generator Integration Module

hooks

Agent Hooks System

integration

Cross-Crate Integration Module

modules

Module System

parser

Universal Rule Parser

scale

Scale-Adaptive Intelligence

security

Security Module - Ed25519 Signing & Capability-Based Access

state

State Module - Dirty-Bit Tracking & Atomic Sync

steering

Agent Steering System

strategy

DX lane/pass strategy contracts.

streaming

Streaming Protocol - HTIP-Inspired Delivery

sync

Multi-Editor Synchronization

sysinfo

System Information Provider

templates

Template System

validation

Rule Validation

workflows

Expanded Workflow Library

Structs

ContextConfig

Context analysis configuration

DrivenConfig

Configuration for Driven

EditorConfig

Editor enablement configuration

RuleSet

A complete rule set that can be converted between formats

SyncConfig

Synchronization configuration

TemplateConfig

Template configuration

Enums

DrivenError

Main error type for Driven

Editor

Supported AI code editors

Type Aliases

Result

Result type alias for Driven operations