ARIS4U — Governance + Per-Client Memory plugin for Claude Code

Engine: V16.9 (shipped) · plugin 16.9.0 (.claude-plugin/plugin.json)

• Documento maestro (fuente de verdad única): architecture/ARIS4U_MASTER.md — identidad, estado, diferenciación, comparativo, gaps, visión y plan.
• Estado vivo (auto-generado, verificado): STATUS.md — manda sobre cualquier cifra escrita a mano.
• Arquitectura técnica: architecture/V16.9_ARCHITECTURE.md · índice architecture/INDEX.md.

Qué es

ARIS4U es un plugin de Claude Code que envuelve cada sesión con memoria local + reglas que se cumplen (guards) + trazabilidad por cliente — sin enviar tu código ni tus datos a ninguna API (ni a la de Anthropic) y sin gastar un token extra (cero-inferencia-propia: solo cuenta tokens y reutiliza tu Claude). La cognición se renta de Claude Opus 4.8; ARIS4U pone la capa alrededor.

Las 4 capas: (1) memoria local (3 DBs en disco: claude-mem.db narrativa FTS5 · sessions.db decisiones/guards por-cliente · aris_vectors.db vectores bge-m3/sqlite-vec), (2) gobernanza (~9 guards bloqueantes PreToolUse), (3) integración nativa (24 registros de hooks en 7 eventos + 7 MCP tools FastMCP), (4) inferencia auxiliar 100% local (Ollama: embeddings + dialéctica).

How It Works

User prompt → Claude Code event bus → hooks/hooks.json routes to hooks (7 eventos)
                                                    │
                                          call engine/v16/ modules
                                                    │
                         ┌──────────────────────────┼──────────────────────────┐
                         ▼                           ▼                           ▼
                 ~/.claude-mem/claude-mem.db    data/sessions.db        data/aris_vectors.db
                   (narrativa, FTS5)         (decisiones/guards)        (bge-m3, sqlite-vec)

Cifras vivas (counts) → ver STATUS.md. La arquitectura completa → architecture/V16.9_ARCHITECTURE.md.

MCP Tools (7, FastMCP)

aris_ingest · aris_search · aris_recall_client · aris_dialectic · aris_health · aris_structure · aris_critique (las dos últimas = amplificador F1 local PRE/POST, opt-in cuerpo MLX). (aris_recall/aris_ask/aris_dispatch fueron RETIRADAS en V16.9 — no referenciarlas.)

Directory Map

Dir	Purpose
engine/v16/	Python modules — F1-F9 pipeline + orchestrator + utilities
hooks/ + hooks/hooks.json	hooks ARIS (PreToolUse guards, depth, memory) + registro del plugin
hooks/guards/	guards bloqueantes (PHI, type-hints, docker-latest, supabase-RLS, …)
integrations/	MCP server (mcp_server.py, 7 tools)
tools/	CLI scripts (hook-wired + user-invocable) + adapt/ (auto-adaptación, modo SOMBRA)
architecture/	ARIS4U_MASTER.md (canónico) + V16.9_ARCHITECTURE.md + V17_* + CHANGELOG.md + INDEX.md
data/	sessions.db + aris_vectors.db + sessions/ digests
.planning/	PROJECT/REQUIREMENTS/ROADMAP/STATE
tests/	pytest suite
skills/	skills locales del plugin; user-level en ~/.claude/skills/
config/	config por-usuario (endpoints/W2)

Requisitos

Requisito	Necesidad	Nota
Python ≥ 3.11 (3.12 recomendado)	obligatorio	venv en .venv312/; install.sh lo verifica
Claude Code CLI	obligatorio	Opus 4.8, prompt caching; ARIS4U cabalga su event bus
jq	obligatorio	lo usan hooks/redact_secrets.sh y hooks/guards/gpu-crash-guard.sh
Ollama (local)	opcional	embeddings semánticos + dialéctica; degrada limpio si falta (FTS5 + guards siguen)

Install

Instalación nativa (recomendada — 3 comandos)

Dentro de Claude Code, registra el marketplace e instala el plugin. Los skills/, agents/, hooks/hooks.json y el servidor MCP (.mcp.json) se auto-descubren:

/plugin marketplace add https://github.com/aris4u-dev/aris4u.git
/plugin install aris4u@aris4u-dev
/reload-plugins

En la primera sesión, el hook SessionStart (hooks/bootstrap_venv.sh) crea el entorno Python (.venv312 + deps) una sola vez, de forma automática. Luego corre el onboarding guiado — detecta lo que falte, genera tu config y te muestra exactamente qué variables de entorno pegar en ~/.claude/settings.json (el único paso manual):

/aris-onboard

Verifica el resultado con /aris-status.

Instalación manual / desarrollo (alternativa)

git clone https://github.com/aris4u-dev/aris4u ~/projects/aris4u
cd ~/projects/aris4u
./install.sh                 # idempotente: pre-check Python, venv, deps, smoke-test gate, aris4u init
# ./install.sh --cron        # opcional: cron de auto-adaptación (arranca en modo SOMBRA)
claude plugin marketplace add ~/projects/aris4u
claude plugin install aris4u@aris4u-dev

⚠️ Si esta máquina ya tenía ARIS4U cableado a mano en ~/.claude/settings.json, quita esos bloques (con backup) tras confirmar que el plugin carga, o los hooks correrían dos veces. install.sh no lo hace por ti (operación consciente).

CI

.github/workflows/ci.yml corre la suite unitaria (pytest -m "not integration") en Ubuntu + Python 3.12, sin Ollama. Los tests que requieren recursos reales (Ollama, claude-mem.db poblada, LLM) están marcados integration y se deseleccionan.

Identity

• Author: (el dueño de la instalación)
• Hardware: tu propia máquina (local-first); un worker remoto opcional para inferencia local
• Primary loop: el usuario → Claude Code CLI + ARIS4U hooks → verified per-client memory

License

MIT (core) — declarado en .claude-plugin/plugin.json y pyproject.toml (unificado).