ahmido
ba0b6ec07e
## Summary - add the Spec 306 docs-only reconciliation package under `specs/306-decision-register-reconciliation/` - reconcile existing Spec 265, runtime pages/builders/tests, and product docs so Decision Register is treated as repo-verified rather than a missing greenfield feature - minimally sync `docs/product/implementation-ledger.md`, `docs/product/roadmap.md`, and `docs/product/spec-candidates.md` to reflect current repo truth - classify Decision Register as `partial productization`, not `not implemented` - recommend one narrow next step instead of a broad restart: `307-decision-register-evidence-operationrun-link-polish` ## Scope - docs-only reconciliation and product-doc truth sync - no application runtime changes - no migrations - no routes, policies, providers, or UI asset changes - no test edits ## Key Conclusions Recorded - a broad new `Decision Register v1` or `Decision Register & Approval Workflow v1` spec should not be created - Spec 265 runtime is repo-verified and usable on `/admin/governance/decisions` - the remaining gap is narrow productization around direct evidence/report links, OperationRun links, and adjacent customer-safe consumption polish - product docs previously understated repo truth and were corrected minimally in this branch ## Filament / Runtime Notes - remains compliant with Filament v5 on Livewire v4 - no provider registration changes; provider registration location remains `apps/platform/bootstrap/providers.php` - no globally searchable resources were added or changed in this docs-only PR - no destructive actions were added or changed - no asset registration changes; existing deploy posture for `cd apps/platform && php artisan filament:assets` is unchanged ## Validation Notes - the reconciliation artifact records the focused existing test evidence used to support the product-truth claims - no new runtime validation was executed in this turn beyond committing and pushing the docs-only package Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #361
54 lines
2.7 KiB
Markdown
54 lines
2.7 KiB
Markdown
# Requirements Checklist: Decision Register Reconciliation & Productization Follow-up
|
|
|
|
**Purpose**: Validate that Spec 306 is ready for a docs-only reconciliation implementation and does not duplicate Spec 265.
|
|
**Created**: 2026-05-15
|
|
**Feature**: `specs/306-decision-register-reconciliation/spec.md`
|
|
|
|
## Preparation Quality
|
|
|
|
- [x] The selected candidate was directly provided by the user.
|
|
- [x] The spec is docs-first and reconciliation-only.
|
|
- [x] Spec 265 is treated as existing repo truth context, not rewritten.
|
|
- [x] Spec 305's no-Greenfield Decision Register condition is carried forward.
|
|
- [x] No application runtime implementation is planned in 306.
|
|
- [x] No tests are planned to be created or edited.
|
|
- [x] Product-doc edits are conditional, minimal, and limited to proven Decision Register drift.
|
|
|
|
## Required Artifact
|
|
|
|
- [x] The spec requires `specs/306-decision-register-reconciliation/decision-register-reconciliation.md`.
|
|
- [x] The required artifact structure is listed in `spec.md`.
|
|
- [x] The artifact must include Spec 265 summary, runtime evidence, test evidence, product-doc drift, capability matrix, sellability classification, gaps, recommendation, validation evidence, and close-out notes.
|
|
- [x] Required status vocabulary is explicit.
|
|
- [x] Unsupported implementation claims are forbidden.
|
|
|
|
## Scope Safety
|
|
|
|
- [x] No migrations, models, services, Filament pages/resources, tests, routes, providers, UI assets, policies, jobs, queues, notifications, or runtime behavior are in scope.
|
|
- [x] No broad roadmap rewrite is in scope.
|
|
- [x] No Greenfield Decision Register v1 rebuild is in scope.
|
|
- [x] Any required runtime work must become a future follow-up spec rather than hidden 306 scope.
|
|
|
|
## Evidence Requirements
|
|
|
|
- [x] Spec 265 evaluation is required.
|
|
- [x] Runtime inventory is required.
|
|
- [x] Focused test inspection and execution are required where paths exist.
|
|
- [x] Product docs drift assessment is required.
|
|
- [x] Missing test paths must be recorded as `not applicable`.
|
|
- [x] Validation outcomes must be copied into the reconciliation artifact.
|
|
|
|
## Next-Step Decision
|
|
|
|
- [x] Sellability classification must be exactly one of `foundation-only`, `partial productization`, `near sellable`, `sellable`, or `not implemented`.
|
|
- [x] Recommended next action must be exactly one of the allowed categories.
|
|
- [x] Any 307 Decision Register follow-up must be narrow and must not duplicate Spec 265.
|
|
- [x] If Decision Register is done enough, the artifact must allow 307 to become a different productization feature.
|
|
|
|
## Validation Requirements
|
|
|
|
- [x] `git diff --check` is required.
|
|
- [x] `git status --short --branch` scope check is required.
|
|
- [x] Final close-out must state runtime files changed: none.
|
|
|