Converge: Semantic Governance & Alignment

Converge is a vision for semantic governance. We move from fragmented intent to unified, converged states through a deterministic alignment engine. Our mission is to provide a stable foundation for complex decision-making where human authority and AI agency coexist in a transparent, explainable ecosystem.

Converge Application

Quick Start

# Install
cargo install converge-application

# Start server
converge serve

# Run a job
converge run --template growth-strategy --seeds @seeds.json

What This Is

converge-application is the distribution layer of the Converge ecosystem. It packages:

• Domain packs (growth-strategy, sdr-pipeline, etc.)
• LLM providers (Anthropic, OpenAI, etc.)
• Runtime server (HTTP/gRPC APIs)
• CLI tools

Built around the Jobs To Be Done (JTBD) philosophy: refocusing from tool-centric automation to business-centric outcomes.

Documentation

• Knowledgebase: See converge-business/knowledgebase/
• Architecture: See converge-business/knowledgebase/application-ARCHITECTURE.md
• CLI Contract: See converge-business/knowledgebase/application-CLI_CONTRACT.md
• For LLMs: See AGENTS.md

Usage

Start the server

# Start with defaults
converge serve

# Start with specific host and port
converge serve -H 127.0.0.1 -p 3000

# Start with specific domain packs
converge serve --packs growth-strategy,sdr-pipeline

Run a job from CLI

converge run --template growth-strategy --seeds @seeds.json

Related Projects

• converge-platform - Core platform
• converge-runtime - Runtime server
• converge-business - Documentation and strategy

Sub-applications

• formfiller - TUI/CLI for form filling experiments
• university-course-application - PDF-first course application planner

License

MIT License - see LICENSE for details.

Development Tools

This project is built with the help of modern AI-assisted development tools:

Agent Tooling (Examples)

This project supports a tool-agnostic agent workflow. Claude, Codex, Gemini, Cursor, and similar tools are optional frontends; the shared contract is visible task state, scoped changes, validation, and explicit handoffs.

• Claude Code - Example interactive coding agent
• Cursor - Example AI-powered IDE workflow
• Antigravity - Example AI pair-programming tool
• Frontier models (Claude / Gemini / others) - Use any provider that fits the task and team policy

Version Control & Task Tracking

• Jujutsu (jj) - Use jj on top of Git for day-to-day version control (commit/diff/rebase/undo)
• Task tracking (tool-agnostic) - Use GitHub Issues, Jira, Linear, or a repo-local TASKS.md

# Quick workflow (agent-friendly)
jj status                 # See changes
jj diff                   # Review changes
jj commit -m "message"    # Commit
jj git push               # Push via git remote
# Update tracker or TASKS.md with status + handoff

Key Rust Crates