Skip to content

docs: rename CONTEXT.md to GLOSSARY.md - #40

Merged
adinvadim merged 1 commit into
mainfrom
chore/glossary-rename
Oct 5, 2026
Merged

adinvadim merged 1 commit into
mainfrom
chore/glossary-rename

Conversation

@adinvadim

Copy link
Copy Markdown
Owner

Проблема и причина

mattpocock/skills v1.3.0 переименовал конвенцию доменной документации: CONTEXT.md / CONTEXT-MAP.md → GLOSSARY.md / GLOSSARY-MAP.md. Обновлённые скиллы (domain-modeling, grill-with-docs, improve-codebase-architecture, tdd, diagnosing-bugs, triage, setup-matt-pocock-skills) ищут только новые имена, поэтому в этом репо агенты переставали видеть глоссарий, а domain-modeling мог завести рядом второй, пустой GLOSSARY.md.

Изменение

Файлы переименованы через git mv, все ссылки на них переписаны (5 вхождений в 4 файлах, включая docs/agents/domain.md и блок ## Agent skills, если они есть):

-CONTEXT.md
+GLOSSARY.md

Содержимое глоссариев не менялось, только пути в ссылках.

Проверка

  • До: git grep -E '(^|[^A-Za-z0-9_-])CONTEXT(-MAP)?\.md' → 4 файлов / 5 вхождений
    После: тот же поиск → 0; все ссылки из GLOSSARY-MAP.md указывают на существующие файлы; симлинки и режимы файлов не тронуты.

Изменены только Markdown-документы; ни один тест, скрипт или конфиг не ссылается на имя файла (поиск по слову CONTEXT во всех *.ts/js/vue/py/sh/yml/json пуст), поэтому typecheck/lint/test эту правку наблюдать не могут и не запускались.

UI не затронут, скриншоты не нужны.

Решения и компромиссы

Исторические записи (.audit, research-снимки, закрытые спеки) тоже обновлены: иначе их ссылки вели бы на несуществующий файл.

Merge safety

Дверь: двусторонняя
Радиус: документация

Ветки, которые сейчас правят CONTEXT.md, при мерже main получат rename-конфликт; git обычно сводит его автоматически по детекции переименований. Локальные чекауты увидят новые имена после git pull.

Вердикт: safe to merge — ветка от свежего origin, конфликтов нет, гейты выше зелёные или неприменимы.

Follow mattpocock/skills v1.3.0, which renamed the domain-doc convention to GLOSSARY.md and GLOSSARY-MAP.md. Skills now look only for the new names.
@adinvadim
adinvadim merged commit 817e254 into main Oct 5, 2026
8 checks passed
@adinvadim
adinvadim deleted the chore/glossary-rename branch October 5, 2026 04:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant