Превратить описание фичи в утверждённую стратегическую спекуTurn a feature description into an approved strategic specПеретворити опис фічі на затверджену стратегічну спеку

ШагиStepsКроки

1. Опишите фичу свободными словами: /spec add CSV export to the monthly report. Или назовите её сами: /spec csv-export --priority 70, где --priority N принимает значения 0..100. Агент выводит из вашей формулировки короткий слаг в kebab-case (префикс bugfix- для слов про исправление или падение, hotfix- для слов про срочное или блокирующее), выбирает один сам, не прося вас выбирать между вариантами, и подтверждает его в ответе.Describe the feature in free-form words: /spec add CSV export to the monthly report. Or name it yourself: /spec csv-export --priority 70, where --priority N takes 0..100. The agent derives a short kebab-case slug from your wording (prefix bugfix- for fix or crash wording, hotfix- for urgent or blocker wording), picks one without asking you to choose between candidates and confirms it in the output.Опишіть фічу вільними словами: /spec add CSV export to the monthly report. Або назвіть її самі: /spec csv-export --priority 70, де --priority N приймає значення 0..100. Агент виводить із вашого формулювання короткий слаг у kebab-case (префікс bugfix- для слів про виправлення чи падіння, hotfix- для слів про термінове чи блокувальне), обирає один сам, не просячи вас вибирати між варіантами, і підтверджує його у відповіді.
2. Чтобы развернуть уже существующий тикет, передайте его идентификатор: /spec T0042, где T0042 стоит на Draft, например однострочная заглушка от /park или черновик, выбранный /backlog. Агент сохраняет его идентификатор, слаг, приоритет и токены шапки, берёт однострочный симптом заглушки как формулировку проблемы и проходит шаги ниже начиная с чтения контекста, в том же файле. Второй идентификатор он не выдаёт никогда.To expand a ticket that already exists, pass its id: /spec T0042, where T0042 stands at Draft, such as a one-line /park stub or a rough draft that /backlog selected. The agent keeps its id, slug, priority and header tokens, reads the stub's one-line symptom as the problem statement and runs the steps below from reading the context, in the same file. It never allocates a second id.Щоб розгорнути вже наявний тікет, передайте його ідентифікатор: /spec T0042, де T0042 стоїть на Draft, наприклад однорядкова заглушка від /park або чернетка, яку вибрав /backlog. Агент зберігає його ідентифікатор, слаг, пріоритет і токени шапки, бере однорядковий симптом заглушки як формулювання проблеми й проходить кроки нижче, починаючи з читання контексту, в тому самому файлі. Другого ідентифікатора він не видає ніколи.
3. Он читает карту репозитория, документы об архитектуре и сборке и список фич, достаточно, чтобы точно описать проблему и не дублировать существующее. Затем оценивает задачу: не больше 3 существующих файлов и нет новых; нет новых классов, интерфейсов и публичных типов; нет изменения схемы или миграции; нет нового внедрения зависимостей или модуля; нет нового экрана, маршрута или пункта навигации; всё детерминировано; дельта меньше примерно 100 строк. Всё выполнено - PRIMITIVE, иначе COMPLEX.It reads the repo map, the architecture and build docs and the feature list, enough to state the problem accurately and not duplicate a capability. Then it scores the task: at most 3 existing files and none new; no new classes, interfaces or public types; no schema or migration change; no new dependency-injection wiring or module; no new screen, route or navigation destination; mechanically deterministic; delta under about 100 lines. All pass is PRIMITIVE, any failure is COMPLEX.Він читає мапу репозиторію, документи про архітектуру та збірку і список фіч, достатньо, щоб точно описати проблему й не дублювати наявне. Потім оцінює задачу: не більше 3 наявних файлів і немає нових; немає нових класів, інтерфейсів і публічних типів; немає зміни схеми чи міграції; немає нового впровадження залежностей чи модуля; немає нового екрана, маршруту чи пункту навігації; усе детерміновано; дельта менша за приблизно 100 рядків. Усе виконано - PRIMITIVE, інакше COMPLEX.
4. Путь PRIMITIVE: выдаётся идентификатор и пишется минимальная спека (шапка шаблона с Blocked-by и Carried-to, ## Problem, ## Approach с пунктом на файл, ## Done criteria с проверкой на файл) со Status: In Progress. Затем реализация и самая узкая осмысленная проверка из docs/VALIDATION.md; красная или незапущенная проверка Implemented не даёт. Если приёмка включает ручное тестирование, добавляются теги проверки и раздел ## Manual checks, и статус BlockNeedUserTest.PRIMITIVE path: it allocates the id and writes a minimal spec (the header with Blocked-by and Carried-to, ## Problem, ## Approach with a bullet per file, ## Done criteria with a check per file) at Status: In Progress. It implements, then runs the narrowest meaningful check from docs/VALIDATION.md; a red or unrun check never becomes Implemented. If acceptance needs manual testing it adds the verification tags and a ## Manual checks section, and sets BlockNeedUserTest.Шлях PRIMITIVE: видається ідентифікатор і пишеться мінімальна спека (шапка із шаблону з Blocked-by та Carried-to, ## Problem, ## Approach з пунктом на файл, ## Done criteria з перевіркою на файл) зі Status: In Progress. Далі йде реалізація й найвужча змістовна перевірка з docs/VALIDATION.md; червона чи незапущена перевірка Implemented не дає. Якщо приймання включає ручне тестування, додаються теги перевірки й розділ ## Manual checks, а статус стає BlockNeedUserTest.
5. Путь COMPLEX: выбирается примерная метка уровня (Quick Win, Easy, Moderate, Strategic, Security/Compliance (urgent)), только подсказка для сортировки, потому что /backlog выбирает по Priority. Перед записью любого файла выдаётся идентификатор по схеме вашего репозитория: найти в каталоге планов наибольший и прибавить единицу (T0041 в T0042) либо взять из трекера (JIRA-123) или дату со слагом.COMPLEX path: it picks a rough tier label (Quick Win, Easy, Moderate, Strategic, Security/Compliance (urgent)), a triage hint only, since /backlog selects by Priority. Before any file is written it allocates the id by your repo's scheme: scan the plan directory for the highest id and increment it (T0041 to T0042), or take the id from your tracker (JIRA-123) or a date-slug.Шлях COMPLEX: обирається приблизна мітка рівня (Quick Win, Easy, Moderate, Strategic, Security/Compliance (urgent)), лише підказка для сортування, бо /backlog обирає за Priority. Перед записом будь-якого файлу видається ідентифікатор за схемою вашого репозиторію: знайти в каталозі планів найбільший і додати одиницю (T0041 до T0042) або взяти з трекера (JIRA-123) чи дату зі слагом.
6. Он пишет файл тикета, PLAN_DIR/ID_slug.md, по шаблону из references/TEMPLATE.md навыка: шапка с Status: Draft, приоритетом, датой, уровнем, Blocked-by, Carried-to и ссылкой на план, затем 12 разделов от Problem до Next step. В §5 только архитектурные роли, в §11 только наблюдаемые результаты. §6, §7 и оба токена обязательны: вместо пропуска пишется явное «none», ведь отсутствующая строка значением не считается.It writes the ticket file, PLAN_DIR/ID_slug.md, from the template in the skill's references/TEMPLATE.md: a header with Status: Draft, priority, date, tier, Blocked-by, Carried-to and the plan link, then 12 sections from Problem to Next step. §5 names architectural roles only and §11 observable outcomes. §6, §7 and both tokens are mandatory: write an explicit 'none' rather than omit them, since an absent line is not a value.Він пише файл тікета, PLAN_DIR/ID_slug.md, за шаблоном із references/TEMPLATE.md навички: шапка зі Status: Draft, пріоритетом, датою, рівнем, Blocked-by, Carried-to і посиланням на план, потім 12 розділів від Problem до Next step. У §5 лише архітектурні ролі, у §11 лише спостережувані результати. §6, §7 і обидва токени обов'язкові: замість пропуску пишеться явне «none», адже відсутній рядок значенням не вважається.
7. Он заполняет §3.3, Owner inputs, только пунктами по реальному объёму, без заполнителей n/a. Обязателен один пункт, Related tickets: проза для человека. Зависимость, на которую реагирует навык, пишется ещё и в Blocked-by, а статус становится BlockByOtherTask, блокер назван после дефиса на строке статуса. Триггер (формулировки для пользователя, данные, производительность, платформа, локализация) добавляет свой пункт, а любое совпадение ещё Validation level и Owner sign-off.It fills §3.3, Owner inputs, with only the bullets that match the real scope, no n/a padding. Related tickets is the one required bullet, prose for a human. A dependency a skill must act on also goes in the Blocked-by token, and the status becomes BlockByOtherTask, with the blocker named after a hyphen on the status line. A trigger (user-facing wording, data, performance, platform, localization) adds its bullet; any match also adds Validation level and Owner sign-off.Він заповнює §3.3, Owner inputs, лише пунктами за реальним обсягом, без заповнювачів n/a. Обов'язковий один пункт, Related tickets, і це проза для людини. Залежність, на яку має реагувати навичка, пишеться ще й у токен Blocked-by, а статус стає BlockByOtherTask, із нотаткою про блокер після дефіса на рядку статусу. Тригер (формулювання для користувача, дані, продуктивність, платформа, локалізація) додає свій пункт, а будь-який збіг ще Validation level і Owner sign-off.
8. Он меняет Status: Draft на Approved. Стилевая проверка (списки вместо таблиц, одна мысль на пункт, без резюме разделов) выполняется именно здесь, при утверждении; черновик может оставаться сырым. Затем сразу запускается /spec-tech на этом тикете, если не сработала остановка из-за исследования, описанная выше.It flips Status: Draft to Approved. The style gate (lists over tables, one idea per bullet, no section summaries) is enforced here, at approval; a Draft may stay rough. Then it runs /spec-tech on the ticket at once, unless the research stop from the warning applies.Він міняє Status: Draft на Approved. Стильова перевірка (списки замість таблиць, одна думка на пункт, без резюме розділів) виконується саме тут, при затвердженні; чернетка може лишатися сирою. Потім одразу запускається /spec-tech на цьому тікеті, якщо не спрацювала зупинка через дослідження, описана вище.

Термины на этой страницеTerms on this pageТерміни на цій сторінці

• ТикетTicketТікет
• СпекаSpecСпека
• План (тактический план)Plan (tactical plan)План (тактичний план)
• СтатусStatusСтатус
• Статус блокировкиBlock statusСтатус блокування