TenantAtlas/specs/345-platform-productization-readiness-roadmap-reconciliation-gate/tasks.md
ahmido 1f3a8b5ed9 docs: platform productization readiness and roadmap reconciliation (spec 345) (#417)
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
2026-06-02 10:47:29 +00:00

3.2 KiB
Raw Permalink Blame History

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 --branch and record in repo-truth-map.md.
  • T011 Run git diff --stat and record in repo-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 (338344) 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 AG 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 (16) and record evidence + blockers.
  • T052 Produce platform-readiness-report.md.

Phase 5 — App Boundary Map + Blockers

  • T060 Produce app-boundary-map.md separating /platform, /customerportal, /website, /system, and explicit defers.
  • T061 Identify sellable-platform blockers P0P3 and list them in platform-readiness-report.md.

Phase 6 — Next Spec Recommendation

  • T070 Recommend next 37 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 bounded docs/product/*).
  • T082 Update checklists/requirements.md to 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 /customerportal work; only classify and explicitly defer.