Obsidian Project Documentation Manager

Скилл для Claude Code, который автоматически запускает агента для документирования ваших технических проектов в Obsidian в процессе работы.

Что это такое?

Пока вы работаете над проектами с Claude Code, этот скилл и агент фиксируют ваш прогресс и наблюдения в структурированном хранилище Obsidian. Больше не нужно вспоминать, что вы пробовали, почему приняли те или иные решения и что сработало, а что нет.

Идеально подходит для мейкеров, инженеров и энтузиастов, работающих в нескольких технических областях.

Возможности

• 🤖 Автодокументирование — фиксирует прогресс в процессе работы с Claude Code
• 📁 Организация по областям — классифицирует проекты: Hardware, Software, Woodworking, Music Synthesis
• 🔗 Анализ связей — оценивает и связывает родственные проекты по общим технологиям и контекстным сигналам
• 📝 Шаблоны — использует единообразные настраиваемые шаблоны
• 🎯 Контекстная осведомлённость — определяет детали проекта из рабочей директории
• 🔄 Git-интеграция — опционально коммитит и пушит изменения в репозиторий хранилища
• 🚀 Автобэкап — автоматически отправляет данные в удалённый репозиторий GitHub
• 🌍 Кросс-проектность — работает из любой директории, обновляет центральное хранилище

Установка

Установка через систему плагинов Claude Code — клонирование и bash-скрипты не нужны.

Выполните две команды внутри Claude Code:

/plugin marketplace add ali5ter/claude-plugins
/plugin install obsidian-project-documentation@ali5ter

При первом запуске скилл запросит путь к хранилищу Obsidian. Отдельный шаг настройки не требуется.

Обновление с v2.x

Если ранее использовался bash-установщик, запустите скрипт миграции один раз, чтобы сохранить конфигурацию и удалить старые файлы:

git clone https://github.com/ali5ter/obsidian-project-assistant.git
cd obsidian-project-assistant
./migrate

Затем выполните две команды /plugin, указанные выше.

Удаление

Использование

Просто работайте над проектом с Claude Code и упомяните документирование:

cd ~/projects/arduino-temperature-sensor
claude

Затем в диалоге запустите скилл с помощью такого промпта:

Скилл выполнит следующее:

1. Определит, что это hardware-проект (по файлам .ino)
2. Извлечёт название проекта («Arduino Time Machine»)
3. Создаст заметку о проекте в хранилище Obsidian
4. Будет отслеживать прогресс в процессе работы

Примеры других промптов

Обновление существующего проекта:

Завершение рабочей сессии с Claude Code:

Запрос информации о хранилище:

"Show me my recent projects"
or 
"What's in my Hardware area?"

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

Скилл имеет два пути выполнения:

Начало сессии (только чтение): При открытии проекта скилл читает заметку из хранилища и CLAUDE.md, затем кратко ориентирует вас — текущая фаза, статус и следующие шаги с прошлого раза. Без записи, без агента.

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

Агент также выполняет анализ связей между проектами в каждой сессии: сканирует хранилище для поиска действительно связанных проектов на основе общих технологий и явных контекстных сигналов, автоматически записывая оценённые wiki-ссылки в frontmatter и тело каждой заметки.

Определение контекста

Скилл интеллектуально определяет контекст проекта:

1. Название проекта — из git-репозитория, имени директории или по запросу
2. Классификация области — на основе расширений файлов и паттернов (все области подсчитываются параллельно; явный победитель выигрывает, при равенстве задаётся вопрос):
   • Hardware: .ino, .pcb, .sch, platformio.ini (Arduino, embedded)
   • Software: .js, .ts, .py, .go, .rs, package.json, Cargo.toml, go.mod (веб, скрипты, системы)
   • Woodworking: .stl, .blend, .f3d, .skp, cut-list.md (CAD, файлы мастерской)
   • Music Synthesis: .pd, .maxpat, .syx, .amxd, patch-notes.md (Pure Data, Max/MSP, Ableton)
3. Описание — извлекается из диалога или README.md

Структура хранилища

Заметки о проектах размещаются в директории Projects вашего хранилища Obsidian. Другие папки не затрагиваются. Если папка Projects уже существует, изменяются только файлы, управляемые этим скиллом. Если заметка с таким же именем уже существует, обновления проекта добавляются к ней, а не перезаписывают существующее содержимое.

Конфигурация

Скилл настраивается через ~/.claude/obsidian-project-assistant-config.json (создаётся автоматически при первом использовании):

{
  "vault_path": "/Users/you/Documents/ObsidianVault",
  "areas": ["Hardware", "Software", "Woodworking", "Music Synthesis"],
  "auto_commit": false,
  "auto_push": false,
  "git_enabled": true
}

Параметры:

• vault_path — абсолютный путь к хранилищу Obsidian
• areas — список областей проектов (настраивается по необходимости)
• auto_commit — автоматически коммитить изменения без подтверждения (по умолчанию: false)
• auto_push — автоматически пушить коммиты в удалённый репозиторий (по умолчанию: false)
• git_enabled — включить git-интеграцию (по умолчанию: true)

Требования

• Claude Code — официальный Claude CLI
• Obsidian — для просмотра заметок (markdown-файлы можно просматривать и без Obsidian)
• Git — если вы версионируете содержимое хранилища в приватном удалённом git-репозитории (рекомендуется)

Кастомизация

Пользовательские области

Отредактируйте ~/.claude/obsidian-project-assistant-config.json:

{
  "areas": [
    "Hardware",
    "Software",
    "3D Printing",
    "Photography",
    "Custom Area"
  ]
}

Обновите файлы area-mapping.md и context-detection.md в кэше плагина по пути ~/.claude/plugins/cache/ali5ter/obsidian-project-documentation/, чтобы добавить паттерны определения для новых областей.