sourcebook

ИИ умеет читать ваш код. Но он все еще не знает, как работает ваш проект.

sourcebook фиксирует знания о проекте, которые хранятся в головах вашей команды — соглашения, шаблоны, ловушки и то, где на самом деле что лежит — и превращает их в контекст, который может использовать ваш ИИ-ассистент для программирования.

npx sourcebook init

Инструменты вроде Repomix дают ИИ всю вашу кодовую базу. sourcebook дает ему знания о вашем проекте.

Зачем это нужно

ИИ-агенты тратят большую часть своего контекстного окна на ориентацию — чтение файлов для построения ментальной модели перед выполнением реальной работы. Большинство контекстных файлов (CLAUDE.md, .cursorrules) являются общими и быстро устаревают.

Исследования показывают, что автоматически сгенерированный контекст, который просто повторяет очевидную информацию, на самом деле снижает эффективность агентов на 2-3%. Единственный полезный контекст — это неочевидная информация, которую агенты не могут выяснить, просто читая код.

sourcebook извлекает только то, что агенты постоянно упускают: соглашения, скрытые зависимости, хрупкие участки и доминирующие шаблоны, которые живут в головах вашей команды, а не в коде.

Что он находит

• Граф импортов + PageRank — ранжирует файлы по структурной важности, определяет ключевые файлы с наибольшим радиусом поражения

• Анализ истории Git — отмененные коммиты (сигналы «не делай так»), связанность изменений (невидимые зависимости), частые правки (код, который было сложно реализовать правильно), антипаттерны из заброшенных подходов

• Обнаружение соглашений — шаблоны именования, стиль экспорта, организация импортов, barrel-экспорты, псевдонимы путей, использование подсказок типов, стиль обработки ошибок

• Обнаружение фреймворков — Next.js, Expo, Supabase, Tailwind, Express, TypeScript, Django, FastAPI, Flask, Go (Gin, Echo, Fiber)

• Форматирование с учетом «затухания» контекста — критические ограничения в начале, справочная информация в середине, промпты для действий в конце (оптимизировано для паттернов внимания LLM)

• Умное управление бюджетом — когда контекст превышает лимит токенов, сначала удаляются разделы с низким приоритетом (критические ограничения сохраняются всегда)

Быстрый старт

# Generate CLAUDE.md + AGENTS.md for your project
npx sourcebook init

# Generate for a specific tool
npx sourcebook init --format claude,agents  # CLAUDE.md + AGENTS.md (default)
npx sourcebook init --format cursor         # .cursor/rules/sourcebook.mdc + .cursorrules
npx sourcebook init --format copilot        # .github/copilot-instructions.md
npx sourcebook init --format agents         # AGENTS.md only
npx sourcebook init --format all            # All of the above

# Re-analyze while preserving your manual edits
npx sourcebook update

# See what changed since last generation (exit code 1 = changes found)
npx sourcebook diff

# Limit output to a token budget (drops low-priority sections first)
npx sourcebook init --budget 1000

Команды

Опции