К основному содержанию
правило CX Codex

tldr-cli — правило для Claude Code: анализ кода и установка

Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/tldr-cli.md
Открыть на GitHub

Что делает tldr-cli

tldr-cli направляет агента к командам для изучения кодовой базы: tree показывает файлы, search ищет совпадения, а context собирает текст для задачи. Для анализа функций доступны графы потока управления и данных, срез программы и поиск вызывающих функций.

Правило также описывает проверку импортов, поиск мёртвого кода и архитектурных слоёв, а change-impact находит тесты, затронутые изменениями. Команды обычно выдают JSON; context возвращает текст для языковой модели. Для работы tldr должен быть доступен через PATH. Проверка diagnostics запускает pyright и ruff; заявлена поддержка Python, TypeScript, Go и Rust.

Какие задачи решает

  • найти файлы и функции по структуре проекта
  • проследить вызовы и импорты перед рефакторингом
  • выявить неиспользуемый код и циклические зависимости
  • определить тесты, затронутые изменёнными файлами
  • проверить типы и стиль кода перед тестами

Примеры запросов агенту

  • Покажи структуру проекта и найди функцию process_data в src/.
  • Проследи, какие функции вызывают process_data, прежде чем менять её.
  • Найди тесты, затронутые изменениями в src/foo.py, и проверь файл на ошибки типов.

Как установить tldr-cli

Вручную: положить файлы

.claude/rules/tldr-cli.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о tldr-cli

Как установить tldr-cli в Claude Code?

Добавь файл правила .claude/rules/tldr-cli.md в проект.

Что делает tldr-cli?

Это правило подсказывает агенту использовать CLI tldr для анализа структуры проекта, вызовов, импортов и последствий изменений. Оно также описывает поиск мёртвого кода и выбор тестов.

Что нужно для работы tldr-cli?

Команда tldr должна быть доступна через PATH. Команда diagnostics использует pyright и ruff.

Исходный текст

tldr-cli.md · MIT
# TLDR CLI - Code Analysis Tool

You have `tldr` available on PATH for token-efficient code analysis.

## Commands

```bash
# Core analysis
tldr tree [path]                    # File tree
tldr structure [path] --lang <lang> # Code structure (codemaps)
tldr search <pattern> [path]        # Search files
tldr extract <file>                 # Full file info
tldr context <entry> --project .    # LLM-ready context

# Flow analysis
tldr cfg <file> <function>          # Control flow graph
tldr dfg <file> <function>          # Data flow graph
tldr slice <file> <func> <line>     # Program slice
tldr calls [path]                   # Cross-file call graph

# Codebase analysis
tldr impact <func> [path]           # Who calls this function? (reverse call graph)
tldr dead [path]                    # Find unreachable/dead code
tldr arch [path]                    # Detect architectural layers

# Import analysis
tldr imports <file>                 # Parse imports from a file
tldr importers <module> [path]      # Find all files that import a module

# Quality & testing (NEW)
tldr diagnostics <file|path>        # Type check + lint (pyright/ruff)
tldr change-impact [files...]       # Find tests affected by changes
```

## When to Use

- **Before reading files**: Run `tldr structure .` to see what exists
- **Finding code**: Use `tldr search "pattern"` instead of grep for structured results
- **Understanding functions**: Use `tldr cfg` for complexity, `tldr dfg` for data flow
- **Debugging**: Use `tldr slice file.py func 42` to find what affects line 42
- **Context for tasks**: Use `tldr context entry_point` to get relevant code
- **Impact analysis**: Use `tldr impact func_name` before refactoring to see what would break
- **Dead code**: Use `tldr dead src/` to find unused functions for cleanup
- **Architecture**: Use `tldr arch src/` to understand layer structure
- **Import tracking**: Use `tldr imports file.py` to see what a file imports
- **Reverse imports**: Use `tldr importers module_name src/` to find who imports a module
- **Before tests**: Use `tldr diagnostics .` to catch type errors before running tests
- **Selective testing**: Use `tldr change-impact` to run only affected tests

## Languages

Supports: `python`, `typescript`, `go`, `rust`

## Example Workflow

```bash
# 1. See project structure
tldr tree src/ --ext .py

# 2. Find relevant code
tldr search "process_data" src/

# 3. Get context for a function
tldr context process_data --project src/ --depth 2

# 4. Understand control flow
tldr cfg src/processor.py process_data

# 5. Before refactoring - check impact
tldr impact process_data src/ --depth 3

# 6. Find dead code to clean up
tldr dead src/ --entry main cli
```

## Codebase Analysis Commands

### Impact Analysis
```bash
tldr impact <function> [path] --depth N --file <filter>
```
Shows reverse call graph - all functions that call the target. Useful before refactoring.

### Dead Code Detection
```bash
tldr dead [path] --entry <patterns>
```
Finds functions never called (excluding entry points like main, test_, etc.)

### Architecture Detection
```bash
tldr arch [path]
```
Analyzes call patterns to detect:
- Entry layer (controllers/handlers)
- Middle layer (services)
- Leaf layer (utilities)
- Circular dependencies

### Import Analysis
```bash
tldr imports <file> [--lang python]
```
Parses all import statements from a file. Returns JSON with module names, imported names, aliases.

### Reverse Import Lookup
```bash
tldr importers <module> [path] [--lang python]
```
Finds all files that import a given module. Complements `tldr impact` which tracks function *calls* - this tracks *imports*.

### Diagnostics (Type Check + Lint)
```bash
tldr diagnostics <file>              # Single file
tldr diagnostics . --project         # Whole project
tldr diagnostics src/ --format text  # Human-readable output
tldr diagnostics src/ --no-lint      # Type check only
```
Runs pyright (types) + ruff (lint) and returns structured errors. Use before tests to catch type errors early.

### Change Impact (Selective Testing)
```bash
tldr change-impact                   # Auto-detect (session/git)
tldr change-impact src/foo.py        # Explicit files
tldr change-impact --session         # Session-modified files
tldr change-impact --git             # Git diff files
tldr change-impact --run             # Actually run affected tests
```
Finds which tests to run based on changed code. Uses call graph + import analysis.

## Output

All commands output JSON (except `context` which outputs LLM-ready text, `diagnostics --format text` for human output).

© parcadei · MIT · parcadei/Continuous-Claude-v3

Похожие правила IDE

Каталог правил IDE →
tldr-prompt официальный github Скилл для GitHub Copilot, Claude Code, Codex, Cursor, Gemini CLI, Windsurf и Claude.ai превращает настройки Copilot, документацию MCP и страницы Copilot в tldr-справки. Разбирает чужие конфигурации. CX Codex +1 8 800установок create-tldr-page официальный github Скилл create-tldr-page собирает страницу tldr из документации команды: короткое описание, ссылка на первоисточник и 5–8 примеров вызова. CX Codex +1 8 800установок tldr pwguler Скилл tldr для Claude Code и Codex формирует итоговый отчёт по задаче в виде результата без пересказа вызовов инструментов. Включается после сборок, тестов, релизов или по запросу о статусе. CX Codex +1 977установок audio-tldr AugustusW Скилл audio-tldr для Claude Code расшифровывает аудио и видео, а затем готовит выжимку, краткое содержание или перевод. Запускается по просьбе подвести итог записи, выделить главные мысли или перевести её. CX Codex +1 ★ 45звёзд репо context-mode Mert Koseoğlu Правило context-mode направляет вывод терминала и веб-страниц в песочницу MCP, чтобы сырой текст не забивал контекстное окно агента. CX Codex +1 ★ 34 370звёзд репо context-mode Mert Koseoğlu Правило направляет задачи анализа данных в MCP-инструменты context-mode и не даёт засорять диалог сырыми файлами. CX Codex +1 ★ 34 370звёзд репо json-structured-prompting calesthio Правило json-structured-prompting задаёт схему сборки промптов через JSON для сложных визуальных сцен с несколькими героями и точным расположением объектов. CX Codex +1 ★ 78 316звёзд репо i2i-prompting calesthio Правило i2i-prompting для Claude Code помогает составлять промпты для редактирования изображений через FLUX.2: менять отдельные объекты и текст, переносить стиль. CX Codex +1 ★ 78 316звёзд репо

Из того же набора161

Весь набор →
atlas Субагент atlas автоматизирует запуск сквозных сценариев и приёмочных тестов. Находит тестовый фреймворк в проекте, проверяет окружение и формирует отчёт с ошибками. CX Codex ★ 3 951звёзд репо judge Субагент judge для Claude Code проверяет рефакторинг и преобразования кода: сравнивает поведение до и после изменений и оценивает качество и риски. CX Codex ★ 3 951звёзд репо profiler Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции. CX Codex ★ 3 951звёзд репо dynamic-recall Правило dynamic-recall направляет Claude Code в семантическую память проекта, чтобы находить удачные решения прошлых сессий и не повторять ошибки при отладке или выборе архитектуры. CX Codex +1 ★ 3 951звёзд репо scout Субагент scout для систематического исследования архитектуры проекта. Ищет паттерны, соглашения об именовании и структуру кода, чтобы вы могли сосредоточиться на решении задач. CX Codex ★ 3 951звёзд репо herald Субагент herald готовит релизы проектов: анализирует коммиты по SemVer, обновляет номера версий в конфигах и формирует записи в CHANGELOG.md. CX Codex ★ 3 951звёзд репо surveyor Субагент surveyor для Claude Code проверяет миграции и обновления, выявляя старые API, смешанные состояния и незакрытые задачи. Проверяет код после смены версии или технологии. CX Codex ★ 3 951звёзд репо liaison liaison — субагент для Claude Code, который проверяет интеграции и API. Он подключается к задаче на ревью внешнего сервиса или обмена данными. CX Codex ★ 3 951звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой