Shiplog
aadivar/shiplogClaude Code плагин для разработчиков, которым надоело каждый раз заново объяснять проект AI. Автоматически отслеживает фичи из коммитов, логирует архитектурные решения, запускает фоновые агенты безопасности и ведёт прогресс между сессиями.
Установка
git clone https://github.com/aadivar/shiplog.gitREADME
Shiplog
Судовой журнал фиксирует каждый рейс. Shiplog фиксирует каждую dev-сессию.
Shiplog — плагин для Claude Code, который даёт каждому проекту постоянную память, автоматическое отслеживание прогресса и фоновые агенты качества — чтобы ни одна сессия не начиналась с нуля и ни одно решение не было забыто.
Никакого планирования не требуется. Просто пишите код. Shiplog следит за вашими коммитами и автоматически обнаруживает фичи, логирует архитектурные решения, проверяет безопасность и отслеживает паттерны — всё в фоне.
Проблема
Сессии Claude Code не сохраняют состояние. После 50+ сессий теряется контекст: что было сделано, какие решения приняты, что осталось, какие проблемы безопасности существуют. Вы каждый раз заново объясняете проект, тратите токены и забываете прошлые решения.
Решение
Shiplog автоматически:
- Обнаруживает фичи из ваших коммитов — никакого PRD заранее не нужно (vibe mode)
- Читает прогресс в начале сессии, чтобы Claude продолжил с того места, где остановился
- Запускает фоновые агенты после каждого коммита для обновления спецификаций, статуса PRD, проверок безопасности и памяти
- Поддерживает документацию по паттернам кода, чтобы Claude писал согласованный код между сессиями
Установка
Выполните внутри сессии Claude Code:
/plugin marketplace add aadivar/shiplog
/plugin install shiplog@shiplog
Быстрый старт
# Инициализация на вашем проекте (выберите vibe mode — планирование не нужно)
/shiplog init
# Просто начните писать код. Фичи автоматически обнаруживаются из коммитов.
# Или определите фичу вручную:
/shiplog feature "user authentication"
# Проверьте статус проекта в любой момент
/shiplog statusКак выглядит типичная сессия
Пользователь: Давай добавим фичу генерации PDF для счетов
Claude: [автоматически читает PROGRESS.md]
Вижу, что мы на Спринте 2, работаем над модулем биллинга.
В прошлой сессии мы закончили список счетов (F008).
Создаю файл фичи и начинаю разработку...
[создаёт docs/features/F009-invoice-pdf.md]
[разрабатывает фичу]
[после коммита фоновые агенты запускаются тихо]
Пользователь: /shiplog status
Shiplog Status — Acme SaaS
━━━━━━━━━━━━━━━━━━━━━━━━━━
Спринт: 2 | Активна: F009 (in-progress) | 12/24 фич готово
Фаза 1 (Основа): ████████████ 100%
Фаза 2 (Ядро): ████████░░░░ 67%
Фаза 3 (Расширенная): ░░░░░░░░░░░░ 0%
Последняя проверка безопасности: clean (2026-03-03)
Режимы отслеживания
Выбирается при /shiplog init:
| Режим | Как работает | Лучше всего для |
|---|---|---|
| Vibe mode (по умолчанию) | Просто пишите код. PRD-агент автоматически обнаруживает фичи из коммитов. Никакого планирования заранее. | Соло-разработчики, прототипирование, хакатоны, исследование |
| Planned mode | Сначала определите фичи в PRD, затем разрабатывайте. Агент отслеживает статус по ходу. | Команды, клиентские проекты, структурированные спринты |
Оба режима получают одинаковые фоновые агенты. В любом режиме всегда можно добавить фичи вручную через /shiplog feature.
Фоновые агенты
После каждого git-коммита Shiplog тихо запускает 4 фоновых агента:
| Агент | Что делает | Вывод |
|---|---|---|
| Specs | Автоматически логирует архитектурные решения | docs/SPECS.md |
| PRD | Автоматически обнаруживает фичи из диффов и обновляет статусы | docs/PRD.md |
| Security | Проверяет OWASP Top 10, захардкоженные секреты, риски инъекций | docs/SECURITY.md |
| Memory | Поддерживает паттерны кода и память проекта | Файлы памяти Claude |
Агенты работают в фоне с run_in_background: true — они никогда не прерывают вашу работу.
Команды
| Команда | Описание |
|---|---|
/shiplog init | Инициализировать Shiplog на текущем проекте |
/shiplog status | Показать дашборд проекта (спринт, фичи, % завершения) |
/shiplog feature <name> | Создать новую фичу из шаблона |
/shiplog sprint <n> | Начать новый спринт с архивированием |
/shiplog review | Вручную запустить все фоновые агенты |
/shiplog config | Просмотреть/изменить конфигурацию Shiplog |
/shiplog agent <name> | Создать кастомный фоновый агент |
/shiplog agent list | Список всех агентов (встроенных и кастомных) |
/shiplog upgrade | Получить последнюю версию с GitHub |
Структура проекта
При запуске /shiplog init создаётся следующая структура:
docs/
├── PRD.md # Роадмап фич с отслеживанием статуса
├── SPECS.md # Лог архитектурных решений
├── SECURITY.md # Журнал аудита безопасности
├── PROGRESS.md # Лог сессий + текущий фокус
├── features/ # Детальные файлы по каждой фиче
└── archive/ # Архив логов спринтов
.shiplog/
├── config.json # Настройки плагина
└── agents/ # Определения кастомных агентов
Также добавляет секцию оркестрации в ваш CLAUDE.md (никогда не перезаписывает существующее содержимое).
Конфигурация
Хранится в .shiplog/config.json:
{
"agents": {
"model": "haiku",
"specs": { "enabled": true },
"prd": { "enabled": true },
"security": { "enabled": true },
"memory": { "enabled": true },
"custom": []
},
"orchestration": {
"readProgressOnStart": true,
"launchAgentsAfterTask": true,
"triggerMethod": "hooks+claude.md",
"maxParallelAgents": 3
}
}Модели агентов
Выбирается при /shiplog init или меняется через /shiplog config:
- haiku (по умолчанию) — Самый быстрый и дешёвый, отлично подходит для фоновых агентов
- sonnet — Более глубокий анализ
- opus — Максимальные возможности, наибольшая стоимость
Кастомные агенты
Создавайте собственные фоновые агенты, которые работают вместе со встроенными:
/shiplog agent "a11y-reviewer"
Это создаёт .shiplog/agents/a11y-reviewer-agent.md с редактируемым промптом. Ваш агент запускается автоматически после каждого коммита, как и встроенные.
Примеры: ревьюер доступности, аудитор производительности, проверка зависимостей, трекер покрытия тестами.
Как это работает
Shiplog использует гибридный подход к запуску:
- Hooks (надёжная основа) — хуки
PostToolUseсрабатывают после git-коммитов и автоматически запускают фоновые агенты - CLAUDE.md (гибкий слой) — инструкции в CLAUDE.md управляют загрузкой контекста в начале сессии (чтение PROGRESS.md и отображение статуса)