АРХ - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: канон карточек Codex

AGENTS.md

@@ -83,6 +83,13 @@ UI - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: переименован
 
 Карточка задачи должна разделять постановку, план этапов и фактическую реализацию.
 
+Каноническая структура карточки:
+- заголовок карточки
+- основное описание карточки
+- при необходимости текстовый блок `Текущая архитектура`
+- для каждого этапа: текстовый блок этапа, затем чекер этапа
+- после реализации этапа: текстовый блок `Реализация этапа N`
+
 Заголовок карточки:
 - передает основную суть задачи
 - должен быть коротким, читаемым в списке и без служебного шума
@@ -93,20 +100,39 @@ UI - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: переименован
 - не превращается в журнал работ и не дублирует чекеры
 - остается читаемым входом в задачу после нескольких итераций
 
-Подэлементы-чекеры:
+Текстовый блок `Текущая архитектура`:
-- создаются через `Добавить подэлемент` как отдельный чекер на каждый смысловой этап
+- создается через `Добавить подэлемент`, если задача опирается на уже существующее поведение
-- заголовок чекера должен называться как этап, например `Этап 1. Backend enforcement лимитов`
+- фиксирует, что уже реализовано, что частично реализовано, а чего в системе еще нет
+- отделяет существующий baseline от будущего плана, чтобы не планировать повторную реализацию уже готовых частей
+- не должен содержать рабочие чекеры или журнал выполнения
+
+Текстовый блок этапа:
+- создается через `Добавить подэлемент` перед чекером соответствующего этапа
+- заголовок должен называться как этап, например `Этап 1. Backend enforcement лимитов`
+- тело блока описывает цель этапа, текущий статус, границы scope, зависимости и важные ограничения
+- если этап пока только планируется, в теле явно указывается `Статус: не реализовано`, `Статус: частично реализовано` или `Статус: backlog`
+- длинные архитектурные пояснения живут здесь, а не внутри пунктов чекера
+
+Чекер этапа:
+- создается через `Добавить подэлемент` сразу после текстового блока этапа
+- заголовок чекера должен называться `Чекер этапа N. <название этапа>`
 - пункты внутри чекера должны быть короткими проверяемыми действиями по этапу
 - пункт закрывается только после реализации и проверки, а не по намерению
 - чекеры используются как рабочий план, а не как место для длинных объяснений
 
 Текстовые блоки фактической реализации:
-- создаются через `Добавить подэлемент` под соответствующим чекером этапа
+- создаются через `Добавить подэлемент` под соответствующим чекером этапа только после фактической реализации
 - заголовок текстового блока должен явно связывать его с этапом, например `Реализация этапа 1`
 - блок фиксирует, что реально сделано, какие файлы/модули затронуты, какие проверки прошли и какие ограничения остались
 - важные нюансы для дальнейшего масштабирования записываются именно сюда, а не теряются в чате
 - после каждого осмысленного этапа соответствующий текстовый блок обновляется
 
+Декомпозиция задач:
+- одна продуктовая или архитектурная тема должна жить в одной карточке, если этапы не имеют самостоятельного независимого scope
+- не создавать пачку top-level карточек для этапов одной большой задачи; этапы ведутся текстовыми блоками и чекерами внутри основной карточки
+- отдельная top-level карточка допустима только когда задача имеет отдельный результат, владельца, проверку и может выполняться независимо от родительского контекста
+- если несколько старых карточек описывают один контекст, их нужно объединить в одну актуальную карточку и удалить или закрыть дубли
+
 Статус карточки:
 - `В работе` ставится только когда задача реально взята в исполнение
 - `Готово` ставится после проверки результата и закрытия рабочих чекеров