Imported from khupolina-cmd/typographic (typography-specialist-review-bundle-2026-05-09/01_specialist/специалист_по_типографике/AGENTS.md). Install upstream with npx skills add khupolina-cmd/typographic --skill специалист_по_типографике. Copyright stays with the author.

AGENTS.md

Задача этого проекта

Собирать максимально надежную базу для будущего типографического специалиста / типографического дизайнера.

Из материалов проекта затем будут строиться:

mindsets;
rules;
tools;
рабочие проверки;
опоры для принятия решений.

Поэтому главная установка: ничего важного не пропустить и ничего не додумывать из головы там, где можно опереться на материалы пользователя.

Главный принцип работы

Нужно собирать:

все технические данные;
все важные тезисы;
все наблюдения, которые могут пригодиться специалисту;
все, что затем может лечь в майндсет, правило, инструмент или процедуру проверки.

Если пользователь отдельно говорит, что какая-то часть не нужна, это имеет приоритет.

Три слоя приоритета материала

Вся работа идет в трех слоях:

Особо важное
- то, что пользователь отдельно подсветил как особенно ценное;
- это нужно прорабатывать глубже и тщательнее;
- здесь нужно особенно внимательно смотреть, достаточно ли подробно все раскрыто;
- здесь особенно важно тянуть дополнительные детали из смежных файлов пользователя.
Берем по умолчанию
- все, что пользователь не исключил;
- если тема не была отдельно подсвечена, это не значит, что она второстепенна или не нужна;
- это все равно нужно забирать и фиксировать;
- просто уровень дополнительной проработки по умолчанию ниже, чем у специально подсвеченных тем.
Не берем
- все, что пользователь явно сказал убрать;
- такой материал не переносится в черновики и не получает иллюстрации.

Следствие:

все, что пользователь не сказал выкинуть, мы так или иначе берем;
все, что пользователь подсветил отдельно, мы берем с повышенным вниманием и большей детализацией.

Как устроена работа с пользователем

Пользователь проходит свои учебные лекции вместе с агентом и по ходу проговаривает:

что точно нужно забрать;
что можно не брать;
что особенно важно для будущего специалиста;
где материал стоит усилить и разжевать подробнее.

Роль агента:

внимательно читать и структурировать;
извлекать технические и смысловые опоры;
углублять сухие тезисы материалом из пользовательских файлов;
не заменять материалы пользователя собственной фантазией;
не пропускать потенциально полезные фрагменты.

Приоритет источников

Если в учебной папке есть несколько версий одного и того же материала, использовать их так:

Основной источник: учебный текст без модификаторов.
Второй по важности источник: learning structure.
Визуальная привязка и дополнительная проверка соответствия текста и картинок: learning.html.
Лекция с модификаторами: использовать как дополнительный художественно окрашенный вариант, когда нужно лучше понять интонацию или расширенную подачу.
Транскрипты: использовать минимально и только если нужно уточнить техническую деталь.

Что именно значат типы файлов

Лекция без модификаторов

Это максимально техническая, сжатая версия материала.

На нее нужно опираться сильнее всего.

Лекция с модификаторами

Это художественно окрашенная версия, сделанная так, чтобы пользователю было приятнее и удобнее читать.

Она полезна, но вторична по отношению к технической версии.

Learning structure

Это очень важный файл.

По сути, в нем уже собраны:

логика лекции;
роли блоков;
опорные тезисы;
структура учебного материала.

Это один из главных источников для извлечения полезного материала.

Learning HTML

Использовать как удобную презентационную сборку лекции:

там видно ход материала;
там видно, какой текст к какой картинке относится;
там удобно проверять, где изображение действительно поддерживает тезис.

Транскрипты

Не использовать как основной источник.

Нужны только если необходимо:

уточнить техническую формулировку;
проверить деталь;
восстановить спорный фрагмент.

BLF

BLF не использовать вообще.

Работа с картинками

Картинки по умолчанию нужно прикреплять ссылками.

Логика такая:

агент прикладывает ссылку на картинку там, где она поддерживает тезис;
если пользователь отдельно говорит не прикреплять картинку, значит ее не прикреплять.
если пользователь отдельно не сказал картинку не брать, значит картинку берем.

Изображения брать только из:

learning-html-assets

Не нужно ждать, пока пользователь отдельно пришлет изображения, если они уже лежат в учебной папке.

Как использовать картинки в черновиках

Картинка не должна лежать сама по себе.

Она должна быть привязана:

к тезису;
к правилу;
к майндсету;
к приему;
к композиционному примеру;
к наблюдению, которое специалист потом сможет перепроверить.

Картинки нужны не везде.

Прикладывать их стоит там, где они:

реально помогают понять механизм;
подтверждают тезис;
показывают композиционную разницу;
служат опорным примером.

В дальнейшей логике использования специалист сначала читает подробное описание картинки, и только потом при необходимости идет смотреть саму картинку.

Из этого следуют два правила:

описание должно быть достаточно подробным;
ссылка на картинку должна стоять рядом с относящимся к ней фрагментом.

Как писать черновики

Каждая тема должна жить в отдельном черновике.

Нельзя снова собирать один гигантский монолит на десятки страниц.

Правило:

одна базовая лекция или одна отдельная тема = один отдельный черновик.

Внутри черновика нужно собирать:

тезисы;
технические следствия;
прикладные выводы;
потенциальные будущие правила;
потенциальные будущие проверки;
места, где знание потом может быть переиспользовано шире типографики.

Черновик должен быть не просто конспектом лекции, а рабочей опорой для будущего специалиста.

Что особенно важно при извлечении материала

Если сухой тезис можно развернуть дополнительной конкретикой из материалов пользователя, это нужно делать.

Как определять, что материал описан слишком сухо

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

Материал считается слишком сухим, если по нему:

неясно, что именно отличать от чего;
неясно, как это применять на практике;
неясно, почему тезис важен;
неясно, как это превратить в рабочую инструкцию;
неясно, какие признаки или действия должен увидеть будущий специалист;
неясно, куда это потом ляжет: в rule, mindset, tool или check.

Если структура или learning.html дают только сжатый каркас, агент обязан:

идти в учебный текст без модификаторов;
смотреть соседние фрагменты той же лекции;
смотреть смежные файлы этой же учебной папки;
при необходимости точечно сверяться с транскриптом ради технической детали.

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

Задача в том, чтобы сделать его:

понятнее;
плотнее;
прикладнее;
пригодным для будущей рабочей инструкции.

Но нельзя:

домысливать материал без опоры;
добавлять собственные теории как факт;
подменять пользовательскую лекцию своей методологией.

Расширение допустимо только тогда, когда оно:

опирается на соседние фрагменты той же лекции;
опирается на learning structure;
опирается на learning.html;
опирается на уже проговоренные пользователем критерии.

Поведение по умолчанию

считать материал полезным по умолчанию, если пользователь явно не сказал его убрать;
извлекать больше, а не меньше;
с особым вниманием сохранять базовые, несущие идеи;
для отдельно подсвеченных пользователем тем делать более тщательную и глубокую проработку;
заранее не обрезать тему;
отдельно отмечать, что может потом стать правилом, инструментом, майндсетом или проверкой;
автоматически прикладывать картинки ссылками там, где это уместно.

Когда нужно остановиться и уточнить

Нужно задавать вопрос пользователю, если:

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

Если ясность есть, лучше действовать без лишней паузы.

Цель качества

Итоговый материал должен быть таким, чтобы будущий специалист:

получал не абстрактные красивые фразы;
а плотную рабочую опору;
понимал, что именно он должен различать;
понимал, по каким признакам принимать решения;
мог при необходимости посмотреть пример по ссылке;
и не терял важные нюансы, уже найденные в лекциях пользователя.

специалист_по_типографике

About