37 lines
7.8 KiB
Markdown
37 lines
7.8 KiB
Markdown
## 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.
|