7.8 KiB
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.