Added comprehensive documentation and planning artifacts for the platform productization readiness and roadmap reconciliation. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #417
4.6 KiB
4.6 KiB
Next Spec Recommendation — Spec 345
Branch: 345-platform-productization-readiness-roadmap-reconciliation-gate
Date: 2026-06-02
Recommended next spec
- Recommended next spec:
Governance Inbox Final Operator Workflow— a narrow follow-up overspecs/327-governance-inbox-decision-first-workbench-productization/,specs/265-decision-register-approval/,specs/306-decision-register-reconciliation/,specs/307-decision-register-evidence-operationrun-link-polish/, andspecs/308-decision-register-summary-review-pack/ - Reason: Repo truth shows that shell/scope, customer review, and evidence/review-pack foundations are already much stronger than the backlog wording suggests. The largest remaining operator-facing gap is the central decision queue itself:
/admin/governance/inboxstill needs one dominant queue-clearing posture, calmer evidence ordering, explicit next action, and stronger downstream customer-safe wording before the platform feels fully repeatable and sellable. - Why not the alternatives:
- Not Customer Review Workspace again: that lane is already materially closed by
specs/312-*,specs/342-*,specs/343-*, andspecs/344-*. - Not Evidence & Review Pack Output Contract first: core evidence/review-pack flow is already strong through
specs/329-*andspecs/337-*; the remaining evidence gap is mostly retained-artifact lifecycle clarity, not core output availability. - Not Provider Readiness first: provider surfaces still need calmer trust framing, but they are already scope-safe and usable after
specs/339-*andspecs/281-*; the governance queue is the more central daily-use blocker. - Not Localization & Customer-Safe Copy first: major localization/neutralization follow-through already exists in
specs/275-*andspecs/286-*; remaining work is QA/polish. - Not a new smoke-matrix-first spec: targeted Browser/Feature confidence is already strong through
specs/340-*and recent strategic Browser suites; workflow clarity is the bigger current productization issue. - Not Customer Portal: repo history repeatedly rejects sneaking external-consumption work into Filament
/platform, and the boundary still holds.
- Not Customer Review Workspace again: that lane is already materially closed by
- Preconditions:
- keep workspace/environment shell contracts from
specs/338-*tospecs/341-*untouched - treat Decision Register as the historical/proof ledger, not as the primary queue
- reuse existing finding, evidence, review, accepted-risk, and
OperationRunlinks rather than creating new truth - forbid new task-engine, Kanban, PSA, or customer-portal scope
- keep workspace/environment shell contracts from
- Risks:
- scope creep into a generic workboard or approval engine
- duplicating decision truth already present in Decision Register or finding/exception surfaces
- adding workflow mutation scope that should remain in existing owner surfaces
- Acceptance target:
/admin/governance/inboxreads as the central operator queue- one dominant next action is visible per decision item or section
- evidence basis, owner, age/SLA, and environment scope are explicit without overloading diagnostics
- links into findings, reviews, proof, runs, and historical decisions reuse current truth instead of inventing new persistence
- no portal, no new decision table, no new approval engine, and no shell rewrite are introduced
- Follow-up sequence (next 3–7 specs):
Governance Inbox Final Operator Workflow(new follow-up over current governance runtime)specs/267-artifact-lifecycle-retention/if retained-output trust remains the next strongest blocker after governance closureProvider Readiness / Onboarding Productizationas a narrow follow-up overspecs/339-*andspecs/281-*- runtime follow-through for
specs/278-cross-domain-indicator-audit/if indicator drift keeps reappearing on dashboards/ops/evidence surfaces - retained-artifact browse/report polish only if
StoredReportResourcestill feels insufficient after artifact-lifecycle work - later strategic work such as a first governed AI runtime consumer only after the operator platform is calmer
Deferred Lines (explicit)
- Customer portal line:
- defer external customer review history, evidence download center, branded document consumption, and any external portal guidance into a future
/customerportalroadmap - do not pull these into Filament
/platformas “just one more read-only page”
- defer external customer review history, evidence download center, branded document consumption, and any external portal guidance into a future
- Feature-expansion line:
- broader PSA/ITSM sync, first governed AI runtime consumer, cross-tenant portfolio expansion, and customer self-serve commercial flows stay behind the operator-platform productization sequence above