CLAUDE.md

Правила работы с документацией проекта КТМ-ДАС.

Навигация

  • Структура и описания — в INDEX.json. Читать точечными jq-запросами; полное чтение запрещено (исключение — index-maintainer).

  • Примеры:

    • jq -r '.tree[] | select(.doc_type=="registry") | "\(.path): \(.covers)"' INDEX.json

    • jq -r '.tree[] | select(.path|startswith("02-arch")) | .path' INDEX.json

  • Последний номер OQ/PD — из поля covers, не grep по реестру.

  • Форматы документов — 01-master-data/formats/; журналы — 01-master-data/journals/.

Правила взаимодействия

  1. Не додумывать. При недостатке данных — спросить, указав, чего не хватает и какие варианты есть.

  2. Гипотезы помечать !ai.

  3. Работать только в этом каталоге; внешние каталоги — по явному запросу.

  4. Формулировки пользователя в кавычках исправлять дословно, без литературной обработки.

  5. Единственный источник истины: определение или решение — в одном месте, в остальных — краткая ссылка.

Документы

  • Каждый документ (кроме реестров) заканчивается разделом ## Журнал изменений.

  • Текст документа — без истории изменений и обстоятельств принятия; история — в журнале.

  • Диаграммы — Mermaid.

  • Ссылки на реестры — по ID (OQ-NN, PD-NN), когда реестры появятся.

Git

  • Агент пишет результаты в рабочий каталог и готовит commit. push выполняет sander.

  • temp/ в git не попадает.