Capture what was decided, why it happened, and what came next — across people, projects, and AI agents.
Next.js App Router & Server Components
Adopted for sub-50ms TTFB, search indexing, and isolation of sensitive tokens.
Cursor — reading context
Last decision: 3 min ago
3 linked decisions, 2 open spikes
Last updated today
A structured hub for your team's architectural decision records, research spikes, and project dependencies — searchable, linked, and always in sync with your codebase.
Every ADR, spike, and task linked in a live network map. Click any node to inspect its decisions and source files.
Decisions are parsed deterministically from plain-text .slvx files. No cloud LLM required — ever.
| ID | Decision Record | Status | Author |
|---|---|---|---|
| ADR-001 | Adopt Block-Based .slvx Specification for AI Ingestion | Accepted | Deep Chauhan |
| ADR-014 | PostgreSQL with Row-Level Security for Multi-Tenancy | Accepted | SecOps Lead |
| ADR-018 | Distributed Edge Caching with SWR Invalidation | Accepted | Performance Eng |
| ADR-022 | Model Context Protocol (MCP) Server for Assistant Guardrails | Proposed | Cursor AI Agent |
Enforces database-level tenant isolation instead of application code checks.
src/lib/supabase.ts, migrations/003.sql
The .slvx protocol stores human-readable, append-only decision records directly inside your git repository. Zero cloud LLM token bills, zero merge conflicts.
---
[DECISION] ADR-001: Adopt Block-Based .slvx Specification
Status: Accepted
Author: Deep Chauhan (via Claude 3.7 / Cursor)
Date: 2026-09-08
Files: src/lib/solveauxParser.ts, src/components/SolveauxSyncModal.tsx
Model: Claude 3.7 Sonnet
## Context
AI coding assistants write code at 10x velocity, but trade-offs remain
trapped in ephemeral chat sessions or unreadable git diffs.
## Options Considered
1. JSON-Only Manifest (.slvx.json) -> Rejected (severe git merge conflicts)
2. Cloud LLM Summarizer -> Rejected ($$$ recurring token bills)
3. Block-Based .slvx Specification -> Accepted ($0 compute, git conflict-free)
## Decision & Trade-offs
We adopt human-readable .slvx blocks. AI local tools append records;
Solveaux ingests them deterministically via state-machine parsing.
## Consequences
- Zero ongoing AI API cost overhead
- Bi-directional file linking on Solveaux Brain Map
---Each decision is an append-only Markdown block separated by `---`. Human-readable in GitHub PRs, machine-parseable with zero compute token costs.
Zero cloud LLM compute cost. Solveaux parses markdown blocks deterministically in client and backend state-machines.
Modular `.slvx/` individual files per feature PR eliminate the severe git conflicts inherent in monolithic documentation.
Tagging source files directly associates decisions with code components across your team's project repositories.
Connect Cursor, Claude, and Windsurf directly to Solveaux via Model Context Protocol (MCP). Agents query architectural rules before writing code — preventing re-introduced patterns you already rejected.
Role: PROPOSE-ONLY · 4 tools
> solveaux.get_file_context(filePath: "src/lib/auth.ts")
ADR-014 (Accepted): Multi-tenant queries MUST use Postgres Row-Level Security. Redis session caching rejected due to cross-region consistency issues.
Claude / Cursor response: "I checked your Solveaux project rules. ADR-014 prohibits using Redis session caching for multi-tenant auth in favor of Postgres RLS. I will refactor src/lib/auth.ts using Postgres RLS instead."
Agent connections are bound to their authorized project only. Cannot browse org directories.
Database connection strings, user emails, and server traces are scrubbed before reaching AI models.
Decisions submitted via MCP are permanently tagged with the authoring model (e.g. Claude 3.7 Sonnet).
Every phase of engineering thought flows into your team's permanent architectural memory.
Capture experiments, latency benchmarks, and prototype learnings before context evaporates.
Promote findings into an ADR with rationale, deciders, and rejected alternatives in Git.
Connect decisions to source files, services, tasks, and the people who own them.
AI coding assistants automatically respect past decisions when refactoring your code.
Evaluated distributed edge workers for live API proxies against centralized origin polling to eliminate cross-region latency.
Solveaux structures how engineering teams turn ideas into shipped code — with dedicated spaces for research, ADRs, brain maps, and AI governance.
Document latency benchmarks, library evaluations, and trade-offs in structured notes — not scattered Slack threads that disappear when engineers leave.
60% memory savings confirmed — ready to promote to ADR.
ADRs with full context, deciders, and rejected alternatives stored directly in Git — so future teams understand the why behind every architectural choice.
[DECISION] ADR-001
Status: Accepted
Author: Deep Chauhan
Files: solveauxParser.ts
## Decision & Trade-offs
Adopt .slvx blocks. $0 token cost.
Research, decisions, and sprint tasks link automatically. Trace architecture dependencies across your entire project stack instantly.
Connect Cursor, Claude, and Windsurf directly to Solveaux via Model Context Protocol. Prevent AI from re-introducing previously rejected patterns.
The difference between fragmented team chats and a permanent engineering intelligence engine.
Capture critical technical choices with deciders, accepted trade-offs, and rejected options — eliminating circular debates forever.
Visualize your multi-project architecture. See how technical research, ADRs, tasks, and validations connect across repos.
Give Cursor and Claude instant awareness of accepted ADRs so agents never write code that violates team standards.
Safeguard your team’s institutional mental models so new hires ramp up in days rather than months of reverse engineering.
Everything you need to know about the Early Access Program, .slvx open specification, and MCP AI agent memory.
Solveaux is completely free during Early Access. Capture decisions with the .slvx protocol and connect your AI assistants via Model Context Protocol (MCP).
Early adopters lock in 6 months of complimentary Pro tier when commercial plans launch. No credit card required.