Решить, что увидит пользователь, до начала разработкиSettle what the user will see before you build itВирішити, що побачить користувач, до початку розробки

ШагиStepsКроки

1. Опишите задачу несколькими словами, например /ui-clarify add a --format flag to the export command.Describe the task in a few words, for example /ui-clarify add a --format flag to the export command.Опишіть завдання кількома словами, наприклад /ui-clarify add a --format flag to the export command.
2. Агент читает запрос или спеку, нужные экраны, обработчики, шаблоны и строки, документ об архитектуре, если затронуты канонические шаблоны, и вашу политику текстов и тона, если затронуты формулировки.The agent reads the request or spec, the relevant views, handlers, templates and strings, the architecture doc if canonical patterns are affected, and your copy and tone policy if the wording is affected.Агент читає запит або спеку, потрібні екрани, обробники, шаблони й рядки, документ про архітектуру, якщо зачеплено канонічні шаблони, і вашу політику текстів і тону, якщо зачеплено формулювання.
3. Он строит одну таблицу решений в пять проходов. Первые четыре: место и подача на разных форм-факторах; видимость и приоритет; взаимодействие и формулировки; состояния, поведение при сбое и доступность. Вместе они охватывают, где это появляется, когда показано, скрыто или отключено, точную подпись и подсказку, пустое состояние, загрузку и ошибку, повторные попытки и доступность.It builds one decision table across five passes. The first four: placement and presentation across form factors; visibility and priority; interaction and wording; state, failure UX and accessibility. Together they cover where it appears, when it is shown, hidden or disabled, the exact label and help text, empty, loading and error states, retry behaviour and accessibility.Він будує одну таблицю рішень у п'ять проходів. Перші чотири: місце й подача на різних форм-факторах; видимість і пріоритет; взаємодія та формулювання; стани, поведінка під час збою та доступність. Разом вони охоплюють, де це з'являється, коли показано, приховано чи вимкнено, точний підпис і підказку, порожній стан, завантаження й помилку, повторні спроби та доступність.
4. Каждое сообщение, которое изменение добавляет или правит, принимает форму своего вида, а его точный предлагаемый текст попадает в таблицу; сообщение не по форме остаётся нерешённым. Ошибка говорит, что случилось, и называет один следующий шаг, а сырой код в заголовке недопустим. Пустое состояние даёт причину и приглашение к действию. Подтверждение разрушительного действия говорит, что произойдёт и можно ли это отменить.Every message the change adds or edits takes the shape of its kind, and its exact proposed text goes in the table; a message off its shape stays unresolved. An error says what happened plus one next step, never a raw code as the headline. An empty state gives the reason and an invitation to act. A destructive confirmation says what will happen and whether it can be undone.Кожне повідомлення, яке зміна додає чи правит, набуває форми свого виду, а його точний запропонований текст потрапляє до таблиці; повідомлення не за формою лишається невирішеним. Помилка каже, що сталося, і називає один наступний крок, а сирий код у заголовку неприпустимий. Порожній стан дає причину й запрошення до дії. Підтвердження руйнівної дії каже, що станеться і чи можна це скасувати.
5. Пятый проход один раз проходит изменение глазами каждого вида читателя, которому оно служит: нового пользователя, вернувшегося, работающего со вспомогательными технологиями или на самом узком форм-факторе, скрипта или оператора без присмотра, какие применимы. Каждый должен дойти до результата без тупика. Для разрушительного действия условие переворачивается: читателя надо остановить или предупредить, а не провести, и флаг --force или -y пропускает запрос, но не проверки безопасности за ним.The fifth pass walks the change once as each kind of reader it serves: a first-time user, a returning one, someone on assistive tech or the narrowest form factor, a script or operator running it unattended, whichever apply. Each must reach the result with no dead end. For a destructive action it inverts: the reader must be stopped or warned, not helped through, and a force flag such as --force or -y skips the prompt, never the safety checks behind it.П'ятий прохід один раз проходить зміну очима кожного виду читача, якому вона служить: нового користувача, того, хто повернувся, того, хто працює з допоміжними технологіями чи на найвужчому форм-факторі, скрипта або оператора без нагляду, залежно від того, що застосовне. Кожен має дійти до результату без глухого кута. Для руйнівної дії умова перевертається: читача треба зупинити або попередити, а не провести, і прапорець --force чи -y пропускає запит, але не перевірки безпеки за ним.
6. Он отделяет решения, которые вы принимали явно, от неявных допущений и помечает каждый нерешённый пункт как блокирующий. Он задаёт только те вопросы, без которых нельзя двигаться дальше; если выбор можно передать агенту, он предлагает 2-3 конкретных варианта с компромиссами вместо открытого вопроса.It separates the decisions you made explicitly from implicit assumptions and marks every unresolved item as blocking. It asks only the questions needed to unblock; where a choice can be delegated, it offers 2 or 3 concrete options with trade-offs instead of an open question.Він відокремлює рішення, які ви ухвалили явно, від неявних припущень і позначає кожен невирішений пункт як блокувальний. Він ставить лише ті запитання, без яких не можна рухатися далі; якщо вибір можна передати агентові, він пропонує 2-3 конкретні варіанти з компромісами замість відкритого запитання.
7. Работа заканчивается одним из двух исходов. BLOCKED перечисляет, что Confirmed, вопросы Unresolved нумерованным списком и 1-3 предложения о том, почему реализация заблокирована. READY перечисляет Approved Decisions (место, видимость, формулировки, запасное поведение, поведение при ошибке), Delegated Assumptions (только то, что вы явно позволили выбрать агенту) и Persona pass, по строке на каждого читателя.It ends with one outcome. BLOCKED lists what is Confirmed, the Unresolved questions as a numbered list, and 1 to 3 sentences on why implementation is blocked. READY lists the Approved Decisions (placement, visibility, wording, fallback, error behaviour), the Delegated Assumptions (only items you explicitly let the agent choose) and the Persona pass, one line per reader.Робота завершується одним із двох наслідків. BLOCKED перелічує, що Confirmed, питання Unresolved нумерованим списком і 1-3 речення про те, чому реалізацію заблоковано. READY перелічує Approved Decisions (місце, видимість, формулювання, запасну поведінку, поведінку під час помилки), Delegated Assumptions (лише те, що ви явно дозволили обрати агентові) і Persona pass, по рядку на кожного читача.
8. Когда команда работает над тикетом, BLOCKED попадает и в сам тикет: его статус становится статусом блокировки BlockQuestions, а список нерешённого - его заметкой в одну строку. /spec-all на этом останавливается, а /backlog показывает тикет в разделе «Needs you» и не выбирает его снова. Если команда запущена отдельно, блок остаётся только в чате.When it runs for a ticket, BLOCKED also lands in the ticket: its status becomes the block status BlockQuestions, with the unresolved list as its one-line note. /spec-all stops there and /backlog reports the ticket under "Needs you" instead of selecting it again. Run standalone, the block lives in the chat only.Коли команда працює над тікетом, BLOCKED потрапляє й до самого тікета: його статус стає статусом блокування BlockQuestions, а перелік невирішеного - його нотаткою в один рядок. /spec-all на цьому зупиняється, а /backlog показує тікет у розділі «Needs you» і не обирає його знову. Якщо команду запущено окремо, блок лишається лише в чаті.

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

• Решение, видимое пользователюUser-facing decisionРішення, видиме користувачеві
• ТикетTicketТікет
• Статус блокировкиBlock statusСтатус блокування