agentlens

agentlens

AgentLens — это инструмент, который даёт AI-ассистентам «рентгеновское зрение» для работы с кодовой базой. Он создаёт структурированный слой документации, позволяющий ориентироваться в проекте без необходимости читать исходные файлы целиком. :

Проблема

Современные AI-помощники плохо справляются с большими кодовыми базами. Они не видят общей структуры проекта, не понимают взаимосвязи модулей и вынуждены читать файлы полностью, чтобы найти нужную информацию.

• Непонятно, какие модули существуют и как они связаны
• Трудно найти функции и классы без полного чтения файлов
• Скрытые TODO, предупреждения и критические участки остаются незамеченными
• Навигация по проекту становится неэффективной

Решение

AgentLens генерирует иерархическую документацию, которая выступает в роли карты проекта. Вместо анализа сырого кода ассистент работает с уже структурированной информацией.

.agentlens/
├── INDEX.md # Глобальная карта проекта
├── modules/
│ └── {module}/
│ ├── MODULE.md # Обзор модуля
│ ├── outline.md # Карта символов
│ ├── memory.md # TODO, предупреждения
│ └── imports.md # Зависимости
└── files/
 └── {file}.md # Детальная документация

Результат — ассистент загружает только нужные части кода, вместо того чтобы читать всё подряд. :

Как это работает

AgentLens организует знания о проекте в несколько уровней:

• INDEX.md — список всех модулей и точек входа
• MODULE.md — описание конкретного модуля
• outline.md — функции, классы и их расположение
• memory.md — TODO, WARNING, FIXME и бизнес-правила
• imports.md — зависимости между файлами

Такая структура позволяет двигаться по коду сверху вниз: от общего обзора к конкретным строкам.

Когда использовать

• При изучении нового проекта
• При поиске функции или класса в большом файле
• Перед рефакторингом и изменением кода
• Для анализа зависимостей
• Для поиска TODO и потенциальных проблем

Типовой workflow

Пример того, как AI-ассистент использует AgentLens:

• Открывает .agentlens/INDEX.md и получает список модулей
• Находит нужный модуль по ключевому слову
• Читает MODULE.md для понимания области ответственности
• Использует outline.md для поиска нужной функции
• Открывает только нужный фрагмент исходного кода

Лучшие практики

• Не читать исходные файлы напрямую в больших проектах
• Сначала использовать outline.md для поиска символов
• Проверять memory.md перед изменениями
• Обновлять документацию при её устаревании

Такой подход позволяет сократить количество обрабатываемых токенов и ускорить работу ассистента в разы. :

Итог

AgentLens превращает кодовую базу в навигационную систему для AI. Вместо слепого чтения файлов ассистент получает структурированную карту проекта и работает точечно — быстрее, дешевле и эффективнее.