## Why Повторный аудит подтвердил, что отдельные технические улучшения уже работают, но правила разработки для AI-агентов остаются фрагментарными: агент может переусложнить решение, написать несоразмерные тесты, проигнорировать готовое проверенное решение или по-разному трактовать SDD, документацию и завершённость изменения. До продолжения продуктовой разработки WealthLedger нужен единый локально проверяемый контур, который сохраняет стиль проекта, ясный Single Source of Truth и соразмерность инженерных решений без зависимости от CI. ## What Changes - Установить единый жизненный цикл изменения: согласованное намерение, описание наблюдаемого поведения, архитектурное решение, implementation checklist, реализация и проверяемое подтверждение результата. - Разделить ответственность за артефакты: Change Owner утверждает намерение; продуктовые изменения утверждает Product Owner, а технические и процессные — Engineering Owner. AI-агент может подготовить черновик, но не может считать его утверждённым самостоятельно. - Закрепить назначение SDD-артефактов: Proposal описывает только намерение и причину; Delta Specs — изменение поведения системы; Design — архитектурный способ реализации крупными частями; Tasks — конкретный checklist реализации. - Обязать сначала оценивать существующие проверенные решения для областей с высокой стоимостью самописной реализации и создавать собственное решение только при зафиксированной несовместимости подходящих альтернатив. - Ввести риск-ориентированную политику тестирования: тесты обязательны для поведения с существенным риском, публичных контрактов и регрессий, но не создаются автоматически для простых обёрток, декларативных структур, служебных скриптов и поведения внешних библиотек. - Сделать локальные инженерные ограничения обязательными и воспроизводимыми, чтобы несоответствие стилю проекта, архитектурным границам, контрактам и критическим инвариантам блокировало завершение работы AI-агента. - Требовать для каждого versioned change явной оценки четырёх delivery areas — frontend, backend, specs и docs — с обоснованием `N/A` для незатронутых областей и единым доказательством завершения затронутых областей. - Уточнить границы Single Source of Truth: OpenSpec задаёт нормативные требования и изменения; executable contracts и код отражают исполняемое состояние; docs описывает только фактическое текущее состояние; ADR сохраняет причины устойчивых решений; AGENTS служит краткой навигацией и набором исполнимых ограничений. - Зафиксировать результаты повторного аудита как неизменяемый снимок и продолжать remediation через единый актуальный реестр с однозначными статусами, следующими действиями и evidence. - Сделать локальный SDD-процесс воспроизводимым и не допускающим незаметного выбора другого OpenSpec authority или завершения изменения без требуемой семантической проверки. ## Capabilities ### New Capabilities - `engineering-change-governance`: правила выбора готового решения или собственной реализации, соразмерного тестирования, инженерной простоты и обязательных локальных guardrails для AI-агентов. - `multi-repository-delivery`: оценка frontend, backend, specs и docs для каждого change, правила `N/A` и проверяемое подтверждение полной поставки по всем затронутым областям. ### Modified Capabilities - `openspec-authority-and-lifecycle`: уточнить роли, назначение и порядок SDD-артефактов, обязательность согласования намерения, каскадную проверку зависимых артефактов и семантическую верификацию перед завершением. - `project-documentation`: закрепить docs как описание текущего реализованного состояния без дублирования планируемых OpenSpec-требований и связать завершение изменения с durable completion evidence. - `project-foundation`: усилить единообразные локальные инструкции AI-агентов, навигацию по источникам истины и обязательность проверок стиля и границ каждого репозитория. - `audit-remediation-workflow`: добавить новый неизменяемый audit snapshot, объединить историю remediation в одном актуальном реестре и нормализовать статусы ранее найденных отклонений. ## Impact Изменение затрагивает инженерный процесс всех четырёх delivery areas WealthLedger и делает правила обязательными одинаково для людей и AI-агентов. После его принятия изменение не считается готовым, пока не соблюдены SDD lifecycle, правила выбора решения и тестов, локальные guardrails, документация фактического состояния и completion evidence для каждой затронутой области. Это изменение не вводит CI, не заменяет автоматически существующую авторизацию, не удаляет массово текущие тесты и не меняет пользовательское поведение WealthLedger. Отдельная ретроспективная оценка готовых auth-платформ выполняется последующим change.