From d9a63f5f743473741d745dab4f8a8b7a4feacc83 Mon Sep 17 00:00:00 2001 From: DCCONSTRUCTIONS Date: Wed, 29 Apr 2026 20:34:02 +0300 Subject: [PATCH] =?UTF-8?q?=D0=90=D0=A0=D0=A5=20-=20=D0=9C=D0=95=D0=96?= =?UTF-8?q?=D0=9F=D0=A0=D0=9E=D0=95=D0=9A=D0=A2=D0=9D=D0=90=D0=AF=20=D0=9A?= =?UTF-8?q?=D0=9E=D0=9C=D0=9C=D0=A3=D0=9D=D0=98=D0=9A=D0=90=D0=A6=D0=98?= =?UTF-8?q?=D0=AF:=20=D0=BA=D0=B0=D0=BD=D0=BE=D0=BD=20=D0=BA=D0=B0=D1=80?= =?UTF-8?q?=D1=82=D0=BE=D1=87=D0=B5=D0=BA=20Codex?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 34 ++++++++++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 235a664..0f9b09c 100644 --- a/AGENTS.md +++ b/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 карточка допустима только когда задача имеет отдельный результат, владельца, проверку и может выполняться независимо от родительского контекста +- если несколько старых карточек описывают один контекст, их нужно объединить в одну актуальную карточку и удалить или закрыть дубли + Статус карточки: - `В работе` ставится только когда задача реально взята в исполнение - `Готово` ставится после проверки результата и закрытия рабочих чекеров