ai-kod-wf-project-analyse

name: ai-kod-wf-project-analyse description: "Навык запуска и сопровождения workflow bundle project-analyse (ADR-015) в системе AI-KOD: установка bundle из git/локального пути, запуск (project-analyse)/research-structure и (project-analyse)/research-analyse, требования окружения (AI_KOD_ROOT, AI_KOD_PROJECT_ROOT), контрольные точки стадий, артефакты и расследование отклонений." index_type: deep coverage_depth: 2

🧩 Навык: project-analyse (ADR‑015)

Цель: быстро и надёжно запускать внешний bundle project-analyse и понимать, что именно должно получиться на каждом этапе, где искать артефакты и как чинить типовые проблемы.

🔗 Навигация (аннотированные ссылки)

• RUN: установка bundle (link/copy), запуск Stage 1/2, правила “переустановки”, базовый цикл запуска.
• CHECKPOINTS: контрольные точки стадий research-structure (и skeleton research-analyse), что считать отклонением.
• ENV: обязательные env переменные (AI_KOD_ROOT, AI_KOD_PROJECT_ROOT), требования к pnpm/tsx/sqlite3, заметки про токены.
• TOOLS: команды наблюдения (status/steps/logs/files) без лишнего шума.
• ARTIFACTS: где лежат результаты (DB/exports/report), какие файлы ключевые.
• TROUBLESHOOT: типовые сбои (pnpm/tsx, sqlite3, ambiguous workflow, db locked) и быстрые проверки.
• COMMANDS: готовые команды (install/run/monitor) + подсказки по путям.

⚡ Кратко (для агента)

• Рабочий workflow id запускать строго с namespace: (project-analyse)/research-structure (иначе возможна “ambiguous” ошибка).
• Stage 1 (research-structure) — основной и наиболее детерминированный; Stage 2 (research-analyse) сейчас skeleton и может требовать LLM (зависит от профиля движка).
• Для Stage 1 обязателен AI_KOD_PROJECT_ROOT (нужен, чтобы pnpm exec tsx … работал в доступном pnpm workspace).