specs/openspec/changes/archive/2026-08-25-codify-frontend-component-style/specs/frontend-quality-guardrails/spec.md

ADDED Requirements

Requirement: Frontend проверяет автоматически проверяемый стиль React components

Authored frontend source MUST сохранять автоматически проверяемую часть документированного стиля React components внутри документированного frontend verification gate. Gate MUST отклонять default exports в authored frontend source, named React components, объявленные вне документированной const-valued component form, и module exports, размещённые перед declarations тела module. Style preferences, для которых нет детерминированной локальной проверки, MUST оставаться review conventions и MUST NOT описываться как gate-blocking hard guardrails.

Scenario: Authored source соблюдает проверяемый component style

• WHEN authored frontend source объявляет named React components через документированную const-valued component form, не использует default exports и держит exports после declarations тела module
• THEN документированный frontend verification gate не падает из-за React component style

Scenario: Named component использует запрещённую форму объявления

• WHEN authored frontend source объявляет named React component вне документированной const-valued component form
• THEN документированный frontend verification gate падает и сообщает нарушение React component style

Scenario: Authored source использует default export

• WHEN authored frontend source открывает module API через default export
• THEN документированный frontend verification gate падает и сообщает нарушение module export style

Scenario: Authored source экспортирует до declarations тела module

• WHEN authored frontend source размещает module export перед non-exported declarations тела module
• THEN документированный frontend verification gate падает и сообщает нарушение module export ordering

Scenario: Convention не имеет детерминированной проверки

• WHEN documented frontend style convention нельзя проверить existing deterministic local tooling
• THEN frontend documentation трактует её как mandatory review convention, а не как gate-blocking hard guardrail