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
3.2 KiB
3.2 KiB
Tasks: Spec 345 - Platform Productization Readiness & Roadmap Reconciliation Gate
Branch: 345-platform-productization-readiness-roadmap-reconciliation-gate | Date: 2026-06-02
Spec: specs/345-platform-productization-readiness-roadmap-reconciliation-gate/spec.md
Plan: specs/345-platform-productization-readiness-roadmap-reconciliation-gate/plan.md
Test Governance (TEST-GOV-001)
- Test purpose / classification: N/A (docs-only readiness gate)
- Validation lanes: N/A
- Why sufficient: This spec produces documentation only and must not touch runtime code or tests.
Phase 0 — Repo Baseline (read-only)
- T010 Run
git status --short --branchand record inrepo-truth-map.md. - T011 Run
git diff --statand record inrepo-truth-map.md. - T012 Identify candidate/roadmap sources to inspect (repo-truth; no assumptions).
Phase 1 — Source Discovery (repo-truth)
- T020 Locate spec candidates sources (at minimum
docs/product/spec-candidates.md). - T021 Locate roadmap sources (at minimum
docs/product/roadmap.md). - T022 Locate recent relevant specs (338–344) and any adjacent specs that overlap platform readiness areas.
- T023 Locate UI audit registries and page reports under
docs/ui-ux-enterprise-audit/.
Phase 2 — Candidate Reconciliation
- T030 Inventory all candidates (no candidate left unclassified).
- T031 Classify each candidate into buckets A–G with rationale and target app (
/platform,/customerportal,/website,/system). - T032 Mark duplicates/covered items with “covered/obsolete/duplicate” reason (do not delete; document).
- T033 Produce
candidate-reconciliation.md.
Phase 3 — Roadmap Reconciliation (repo truth vs plan)
- T040 Map roadmap themes to repo truth (implemented/productized/partial/candidate-only/roadmap-only/deferred).
- T041 Produce
roadmap-reconciliation.md.
Phase 4 — Platform Readiness Audit (read-only)
- T050 Inspect runtime surfaces (read-only): Filament pages/resources, support code, tests, UI audits.
- T051 Score each platform area (1–6) and record evidence + blockers.
- T052 Produce
platform-readiness-report.md.
Phase 5 — App Boundary Map + Blockers
- T060 Produce
app-boundary-map.mdseparating/platform,/customerportal,/website,/system, and explicit defers. - T061 Identify sellable-platform blockers P0–P3 and list them in
platform-readiness-report.md.
Phase 6 — Next Spec Recommendation
- T070 Recommend next 3–7 specs with one primary “next spec” and explicit defer lines.
- T071 Produce
next-spec-recommendation.md.
Phase 7 — Validation (docs-only)
- T080 Run
git diff --check. - T081 Confirm no runtime files changed (no changes outside
specs/345-*and optionally boundeddocs/product/*). - T082 Update
checklists/requirements.mdto reflect completion and any remaining open questions.
Explicit Non-Goals
- NT001 Do not change runtime application code under
apps/. - NT002 Do not add routes, migrations, models, services, Filament pages/resources, views, or tests.
- NT003 Do not implement or start
/customerportalwork; only classify and explicitly defer.