manufosela/karajan-code

Караджанский кодекс

Окружающая среда, которая управляет развитием, управляемым ИИ, — ваш агент организует, Караджан управляет.

Leer en Español · Документация · Общественная дорожная карта

Ваш агент ИИ (Claude Code, Codex, Copilot, Antigravity, Cursor…) пишет код. Караджан управляет тем, как это происходит: он устанавливает метод, которым ваш агент следует за каждой задачей, и навязывает его с помощью гит-ворот, которые делают ложно-зеленую структуру невозможной.

**RAG перед принятием ** — kj rag query отвечает на то, что делает ваша кодовая база; никакой агент не догадывается. Установка подключает его как собственный инструмент MCP ([T1]), поэтому запрос индекса является самым дешевым способом агента. Работает из коробки: локальный Ollama или встроенный ONNX-вкладыш, когда ничего не может быть установлено; облачные вкладыши требуют явной декларации чувствительности и PII-редактировать каждый кусок. Дистиллированный инженерный канон ездит вдоль: kj rag query --library обслуживает карточки шаблонов (когда он применяется, когда он НЕ, каноническое цитирование), поэтому планы называют альтернативу зеленому полю вместо того, чтобы следовать линии наследия по инерции.

Karajan Code

The environment that governs AI-driven development — your agent orchestrates, Karajan governs.

Leer en Español · Documentation · Public roadmap

---

Your AI agent (Claude Code, Codex, Copilot, Antigravity, Cursor…) writes the code. Karajan governs how it happens: it installs a method your agent follows on every task, and enforces it with git gates that make a false green structurally impossible.

• RAG before assuming — kj rag query answers what your codebase does; no agent guesses. The install wires it as a native MCP tool (kj_rag_query) so querying the index is the agent’s cheapest path. Works out of the box: local Ollama, or the built-in ONNX embedder when nothing can be installed; cloud embedders require an explicit sensitivity declaration and PII-redact every chunk. A distilled engineering canon rides along: kj rag query --library serves pattern cards (when it applies, when it does NOT, the canonical citation) so plans name a greenfield alternative instead of following the legacy line by inertia.
• Card first, on YOUR board — every piece of work is tracked before it starts: kj’s HU Board (kj hu add|move|list), the Planning Game, or the board the project already uses (Linear, Trello, Jira, GitHub Issues) via your agent’s own MCP/tools. Declared, verified at install, never optional — Karajan does not run without a board. ADRs live in git (kj adr add|list).
• Tests prove behavior — the failing test exists first; the suite is never left red.
• Deterministic first, then cross-AI review — kj review --staged runs SonarQube on the changed files before any AI opinion (BLOCKER/CRITICAL reject on the spot), then binds a verdict from a different AI to the sha256 of the exact diff — stamped with the workspace it ran from. Without an approved verdict, the commit does not enter (pre-commit gate).