lean-ctx — правило для Claude Code: что делает и как установить
Правило направляет агента к инструментам MCP-сервера lean-ctx для чтения файлов, поиска и запуска команд. Пригодится в задачах, где важны кэширование и компактный контекст.
Apache-2.0 ★ 3 956 обновлён 2026-11-13
.claude/rules/lean-ctx.mdЧто делает lean-ctx
Правило задаёт предпочтения для работы с контекстом: mcp_lean_ctx_ctx_read вместо readFile, пакетное чтение через mcp_lean_ctx_ctx_multi_read, поиск через mcp_lean_ctx_ctx_search, дерево каталогов через mcp_lean_ctx_ctx_tree, команды через mcp_lean_ctx_ctx_shell. Для больших файлов оно советует сначала запросить сигнатуры или карту, а в длинной задаче — прогреть кэш и периодически сжимать контекст.
Для записи и точечных правок правило оставляет нативные инструменты Kiro: fsWrite, fsAppend и strReplace; также нативными остаются диагностика и удаление файлов. MCP-сервер lean-ctx должен быть установлен в рабочем пространстве, иначе перечисленные инструменты недоступны. При ошибке редактирования правило велит сразу перейти к mcp_lean_ctx_ctx_edit, не повторять неудачные попытки.
Чтобы установить правило для Claude Code, поместите файл в .claude/rules/lean-ctx.md. Для Cline используется .clinerules/lean-ctx.md.
Какие задачи решает
- сократить повторное чтение файлов за счёт кэша
- искать по проекту с учётом
.gitignore - получать компактный вывод тестов и команд
- просматривать структуру проекта с числом файлов
- сохранять важные находки между сессиями
Примеры запросов агенту
- Найди места, где вызывается
createUser, и покажи компактные результаты. - Для большого файла сначала получи карту структуры, затем найди обработчик ошибок.
- Запусти тесты и верни сжатый вывод команды.
Как установить lean-ctx
Вручную: положить файлы
.claude/rules/lean-ctx.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/lean-ctx.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/lean-ctx.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/lean-ctx.mdВручную: положить файлы
.clinerules/lean-ctx.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о lean-ctx
Как установить lean-ctx в Claude Code?
Добавьте файл правила по пути .claude/rules/lean-ctx.md.
Что делает lean-ctx?
Правило просит агента предпочитать инструменты MCP-сервера lean-ctx для чтения, поиска и команд. Для некоторых изменений и операций Kiro оно сохраняет нативные инструменты.
Какие операции нужно выполнять нативными инструментами Kiro?
Запись и добавление в файлы, точечную замену текста, переименование, перемещение, диагностику и удаление правила оставляет нативным инструментам Kiro.
Исходный текст
lean-ctx.md · Apache-2.0
---
inclusion: always
---
# LeanCTX — Context Gateway for AI agents
The workspace has the `lean-ctx` MCP server installed. You MUST prefer lean-ctx tools over native equivalents for token efficiency and caching.
## Mandatory Tool Preferences
| Use this | Instead of | Why |
|----------|-----------|-----|
| `mcp_lean_ctx_ctx_read` | `readFile`, `readCode` | Cached reads, 10 compression modes, re-reads cost ~13 tokens |
| `mcp_lean_ctx_ctx_multi_read` | `readMultipleFiles` | Batch cached reads in one call |
| `mcp_lean_ctx_ctx_shell` | `executeBash` | Pattern compression for git/npm/test output |
| `mcp_lean_ctx_ctx_search` | `grepSearch` | Compact, .gitignore-aware results |
| `mcp_lean_ctx_ctx_tree` | `listDirectory` | Compact directory maps with file counts |
## When to use native Kiro tools instead
- `fsWrite` / `fsAppend` — always use native (lean-ctx doesn't write files)
- `strReplace` — always use native (precise string replacement)
- `semanticRename` / `smartRelocate` — always use native (IDE integration)
- `getDiagnostics` — always use native (language server diagnostics)
- `deleteFile` — always use native
## Session management
- At the start of a long task, call `mcp_lean_ctx_ctx_preload` with a task description to warm the cache
- Use `mcp_lean_ctx_ctx_compress` periodically in long conversations to checkpoint context
- Use `mcp_lean_ctx_ctx_knowledge` to persist important discoveries across sessions
## Rules
- NEVER loop on edit failures — switch to `mcp_lean_ctx_ctx_edit` immediately
- For large files, use `mcp_lean_ctx_ctx_read` with `mode: "signatures"` or `mode: "map"` first
- For re-reading a file you already read, just call `mcp_lean_ctx_ctx_read` again (cache hit = ~13 tokens)
- When running tests or build commands, use `mcp_lean_ctx_ctx_shell` for compressed output
<!-- lean-ctx-compression -->
OUTPUT STYLE: concise
- Bullet points over paragraphs
- Skip filler words and hedging ("I think", "probably", "it seems")
- 1-sentence explanations max, then code/action
- No repeating what the user said
<!-- /lean-ctx-compression -->
© yvgude · Apache-2.0 · yvgude/lean-ctx