Skip to content

v2.4.4 - Hotfix: Subdirectory Scanning

Choose a tag to compare

View all tags
@alexeykrol alexeykrol released this 17 Jan 08:44
· 248 commits to main since this release
v2.4.4
5d7b0a8

🐛 Hotfix: Subdirectory Scanning Fix

Issue #7 - CRITICAL: /migrate пропускает docs/ с мета-документацией

Проблема

  • /migrate-legacy находил только файлы в корне проекта
  • Пропускал subdirectories: docs/BACKLOG.md (491 строка!), docs/STATUS.md
  • Результат: .claude/BACKLOG.md оставался пустым template после "успешной" миграции
  • Нарушение обещания: "Single source of truth" - создавал два источника истины
  • AI вынужден был спрашивать пользователя: "У вас два BACKLOG файла, что делать?"

Реальный кейс

supabase-bridge/
├── README.md           ← ✅ Найден и мигрирован
└── docs/
    ├── BACKLOG.md      ← ❌ НЕ найден! (491 строка roadmap)
    └── STATUS.md       ← ❌ НЕ найден! (статус v0.3.3)

Результат миграции:
✅ Миграция завершена!
.claude/BACKLOG.md: [ПУСТОЙ TEMPLATE] ← Проблема!
docs/BACKLOG.md: [АКТУАЛЬНЫЙ ROADMAP 491 строка]

Решение

  • Переписан Step 2.1, 2.3, 3, 5, 6, 9 в .claude/commands/migrate-legacy.md
  • Сканирование subdirectories: docs/, documentation/, notes/, wiki/, .github/
  • Классификация по содержимому:
    • Meta-documentation → мигрировать в .claude/
    • Code documentation → оставить в docs/
  • Интерактивное подтверждение для ambiguous файлов
  • Правильный mapping: docs/BACKLOG.md → .claude/BACKLOG.md
  • Архивирование docs/ после миграции (single source of truth)
  • Приоритизация источников: docs/BACKLOG.md > TODO.md > GitHub Issues

Impact

✅ Migration теперь находит ВСЮ мета-документацию, не только в корне
✅ .claude/BACKLOG.md заполнен реальным контентом после миграции
✅ Single source of truth - .claude/ действительно единственный источник
✅ Token economy - AI не тратит токены на поиск docs/BACKLOG.md
✅ User experience - нет путаницы "два источника истины"

Installation

curl -O https://github.com/alexeykrol/claude-code-starter/releases/download/v2.4.4/init-project.sh
chmod +x init-project.sh
./init-project.sh

Files

  • init-project.sh — Framework installer
  • framework.tar.gz — Complete framework archive
  • framework-commands.tar.gz — Commands only (for auto-update)
  • quick-update.sh — Quick updater utility
  • CLAUDE.md — AI agent instructions (for auto-update)

Full Changelog: https://github.com/alexeykrol/claude-code-starter/blob/main/CHANGELOG.md

Assets 7
Loading