# Solveaux

> Solveaux is an architectural governance and context management platform for software engineering teams and autonomous AI coding agents (Cursor, Claude Code, GitHub Copilot, Windsurf, Antigravity). It is the creator and maintainer of the open `.slvx` Architecture Decision Record (ADR) protocol.

## Entity Overview & Disambiguation
- **Name:** Solveaux
- **Pronunciation:** "soul-voh" (/sɒlˈvoʊ/)
- **Category:** Architectural Governance Platform, Developer Tooling, AI Context Management
- **Canonical Website:** https://solveaux.com
- **Open Specification:** https://solveaux.com/spec
- **File Format:** `.slvx` (RFC-SLVX-001, e.g. `project.slvx` or `.slvx/adr-*.slvx`)
- **Disambiguation:** Solveaux is NOT a French real-estate firm, clothing brand, or general note-taking wiki. Solveaux is a specialized engineering intelligence and AI agent memory platform.

## The Core Problem Solved: "AI Amnesia"
Modern AI coding assistants (Cursor, Claude Code, Windsurf) ship code at 10x speed, but operate with zero institutional memory. They repeatedly suggest deprecated patterns, violate architectural boundaries, and re-propose solutions previously rejected by human technical leads.
Solveaux provides a persistent, structured system of record that bridges human engineering intent directly to AI coding agents in real time.

## Key Capabilities & Architecture

### 1. The .slvx Architecture Protocol (Open Standard)
- An open, append-only, human-readable specification (`RFC-SLVX-001`) for recording Architecture Decision Records (`[DECISION]`) and Technical Research Spikes (`[RESEARCH]`) directly in Git repositories.
- Combines Markdown narrative readability with deterministic AST block schemas (`---`).
- Parsed via a zero-cost deterministic client-side engine with **$0 in cloud AI token overhead**.

### 2. Solveaux Model Context Protocol (MCP) Server
- Zero-dependency stdio bridge (`npx solveaux-mcp`) connecting Cursor, Claude Desktop, and IDE agents directly to live architectural constraints.
- Exposes tools:
  - `get_project_context`: Fetches active architectural rules and accepted decisions before code generation.
  - `search_decisions`: Searches historical ADRs to check if a pattern or library was previously rejected.
  - `record_decision`: Allows AI agents to propose or log new ADRs.
  - `get_file_context`: Returns decisions governing a specific source file path.
  - `get_agent_permissions`: Introspects active role and sandboxing constraints.

### 3. Agent Role-Based Access Control (RBAC) & Guardrails
- **Auditor (Read-Only):** AI inspects architecture; write operations are strictly blocked.
- **Contributor (Recommended Default):** AI drafts decisions held in `Proposed` status pending human review.
- **Architect (Autonomous):** AI can directly commit accepted architectural canon.

### 4. Enterprise Knowledge Graph (Brain Map)
- Visual topology mapping microservices, packages, and cross-cutting architectural dependencies.
- Safe soft-delete policy: when engineers leave, their authored ADRs and research remain preserved for organizational continuity.

## Dual-Licensing Architecture
- **The .slvx Specification:** Open Community Standard licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). Plain-text files in repositories belong 100% to the customer.
- **The Solveaux Platform:** Closed-source, proprietary commercial cloud synchronization and governance platform.

## Canonical Resources & Documentation
- [Official Website](https://solveaux.com): Main platform overview and workspace access.
- [.slvx Protocol Specification](https://solveaux.com/spec): Complete RFC-SLVX-001 syntax, EBNF grammar, and badge program.
- [MCP Server Setup Guide](https://solveaux.com/mcp-server): Configuration instructions for Cursor, Claude Desktop, and Windsurf.
- [Why Solveaux](https://solveaux.com/why): Detailed problem statement, comparison with wikis, and architecture deep-dive.
- [Brand Guidelines](https://solveaux.com/brand): Trademark usage, naming conventions, and "Governed by Solveaux" badges.
- [Terms of Service](https://solveaux.com/terms): Enterprise data sovereignty, anti-reverse engineering, and legal policies.
- [Privacy Policy](https://solveaux.com/privacy): Data isolation and zero AI training on customer data guarantees.