writing
Запись в Искрон
Ты собираешься записать узел в граф. По каждому записанному узлу будут ходить будущие агенты: связывать, трассировать эстафеты, отвечать из него. Неверный тип, ленивое имя, механический модус — каждый портит граф всем, кто ниже по течению.
Пять решений, по порядку. Не перескакивай.
Прежде всего: граф и кросс-граф
Каждый вызов тула требует realm=<токен>. Подтверди, в какой граф пишешь, до первого вызова.
Кросс-графовые стрелки не работают. iskron_arrow(action="link", source="739", target="29") резолвит оба seq внутри текущего графа. Если #29 в твоём графе — не тот узел, ты только что создал неверную стрелку. Кросс-графовые ссылки — текстом в описании («см. <граф> #29»), никогда стрелками.
Гейт новизны — читатель и использование
Перед каждым созданием и семантическим обновлением назови: (1) позднюю роль/сессию — или именованный класс читателя/запроса, — которая это состояние достанет; (2) конкретное решение, ответ, проверку или передачу, которую то извлечение изменит; (3) что здесь ново относительно принятого требования, репозитория, эстафеты и существующего графа. Моделируй только несущее поперёк раундов.
Тест — род, не восстановимость. Два рода, оба первоклассны:
- Транскрипция — пропусти. То, что принятые артефакты уже кодируют, пересказанное прозой: пункты требований, рабочие логи, транскрипты тестов, существование фичи, форма публичного вывода, реализованный алгоритм, прозаическая копия состояния репо. Сошлись на источник.
- Структура — пиши. Несущая структура и отношения, которые артефакты не кодируют как проходимые связи: композиция (из чего вещь состоит, через какие фазы идёт), радиус поражения и кросс-артефактная зависимость, граница владения, соответствие-или-дрейф между артефактами. Пиши их, даже когда содержание восстановимо чтением: восстановленный текст всё равно оставляет связь непроходимой.