init-code

Статически исследует существующий репозиторий и создаёт evidence-based PROJECT_DESCRIPTION.md: назначение, запуск, стек, структуру, runtime/data flow, тестирование, конфигурацию, интеграции и явно неи

SKILL.md

GitHub

Init Code

Создавай короткое описание фактического кода, а не инструкции агенту и не roadmap.

Workflow

  1. Определи root из аргумента, иначе используй текущий каталог. Не запускай package scripts, build, tests, hooks или код целевого проекта.

  2. Запусти детерминированный inventory:

    node <skill-root>/scripts/inspect.mjs --root <repo> --format json
    
  3. Проверь ключевые manifests, entrypoints, routes, schemas/migrations, CI, контейнеры и test configs, найденные inventory. Не считай имя каталога или README достаточным доказательством поведения.

  4. Создай PROJECT_DESCRIPTION.md. Если он уже существует, без --update создай PROJECT_DESCRIPTION-YYYYMMDD-HHMM.md; никогда не затирай молча. С --output <file> используй явно заданный путь внутри scope.

  5. Используй разделы строго в этом порядке:

    • Purpose
    • How to Run
    • Technology
    • Structure
    • Runtime and Data Flow
    • Testing
    • Configuration and Integrations
    • Evidence and Unknowns
  6. Каждый фактический абзац или строку таблицы подкрепляй относительным путём в бэктиках. Если связь не подтверждена статически, пиши Inference с основанием; отсутствие доказательств переноси в unknowns.

  7. Не копируй секреты и значения .env: разрешены только имена переменных из .env.example или кода. Не включай большие деревья файлов, полный dependency dump, рекламные формулировки, roadmap или советы по переписыванию.

  8. Проверь результат:

    node <skill-root>/scripts/validate-description.mjs <description.md>
    

Output contract

  • Лид отвечает «что делает проект и для кого» в 2–4 предложениях.
  • Команды приводятся только из manifest/Makefile/task config; если безопасная команда не найдена — Not detected.
  • Data flow начинается с реального entrypoint/route и заканчивается подтверждённой границей; неподтверждённые звенья не дорисовываются.
  • Unknowns включают coverage gaps, malformed manifests, symlinks и вопросы, которые нельзя решить чтением кода.
  • Итог сообщает output path, detected systems, validator result и какие части остались inference.

Maintenance contract

После создания файл становится частью Definition of Done $workflow для всех изменяющих ролей. Перед изменением агент читает существующий PROJECT_DESCRIPTION.md; после изменения запускает scripts/check-impact.mjs по changed paths и семантически сравнивает diff с документом. Обновляй только реально затронутые разделы и снова запускай validate-description.mjs. Не обновляй файл из-за форматирования, внутреннего рефакторинга без изменения описанного контекста или чужих изменений вне текущей задачи.