docs(relaunch): reconcile Claracle relaunch readiness across plans, PRD, and BRD - #647
docs(relaunch): reconcile Claracle relaunch readiness across plans, PRD, and BRD#647jmservera wants to merge 3 commits into
Conversation
…RD, and BRD Triage the live deploy failure and reconcile the three relaunch plans, the PRD, and the BRD with the delivered repository state, producing a single sequenced launch-gate register. - Confirm #644 root cause (dangling source_manifest.path breaking the Podcaster smoke) resolved by #645/#646; deploy-site green since 2026-08-01 - Update 2026-07-31 deploy-hydration plan (Phases 2-4 delivered via #634/#637/#641) and 2026-07-29 Phase 8 (smoke gate hardened) - Add docs/review/.../status-of-record.md: delivered-vs-pending view plus a launch-gate register with owner, dependency, and evidence path - BRD v1.2: add Change History, align the PRD cross-reference, link the status of record - PRD v1.3: record the #627-#646 workstream, restore-consistency under NFR-002, FR-041 partial status, resolve Q-03, link the register (REF-10) Validation: pytest tests/ (1389 passed), internal link + embed-source checks green.
There was a problem hiding this comment.
Pull request overview
This PR reconciles Claracle Data Observatory relaunch documentation and planning artifacts so the repo has a single, current “status of record” across remediation plans, PRD, and BRD, plus a consolidated launch-gate register (owners/dependencies/evidence).
Changes:
- Adds a new relaunch “status of record” document consolidating delivered vs. pending workstreams and a launch-gate register.
- Updates the PRD (v1.3) and BRD (v1.2) to align cross-references, changelogs, and readiness status.
- Adds reconciliation research/plan/log/detail artifacts under
.copilot-tracking/, and updates prior plan checklists to reflect delivered work.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/review/data-observatory-relaunch/status-of-record.md | New consolidated delivered/pending view and launch-gate register |
| docs/prds/claracle-data-observatory-relaunch.md | PRD bumped to v1.3; reconciles #627–#646 workstream notes and links to status-of-record |
| docs/brds/claracle-data-observatory-relaunch-brd.md | BRD bumped to v1.2; adds change history and aligns PRD cross-reference |
| .copilot-tracking/research/2026-08-02/claracle-relaunch-readiness-reconciliation-research.md | New gap-analysis/research writeup backing the reconciliation |
| .copilot-tracking/research/2026-08-01/restore-consistency-640-research.md | New research artifact documenting restore-consistency rationale/approach |
| .copilot-tracking/plans/logs/2026-08-02/claracle-relaunch-readiness-reconciliation-log.md | New reconciliation planning log (discrepancies, follow-ons) |
| .copilot-tracking/plans/2026-08-02/claracle-relaunch-readiness-reconciliation-plan.instructions.md | New implementation plan for the reconciliation work |
| .copilot-tracking/plans/2026-07-31/claracle-deploy-hydration-remediation-plan.instructions.md | Marks phases/steps delivered with references to merged PRs |
| .copilot-tracking/plans/2026-07-29/claracle-data-observatory-relaunch-remediation-plan.instructions.md | Marks Podcaster release smoke phase delivered with evidence pointers |
| .copilot-tracking/details/2026-08-02/claracle-relaunch-readiness-reconciliation-details.md | New detailed step-by-step execution notes for the reconciliation plan |
📝 - Generated by Copilot
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.
Suppressed comments (2)
docs/prds/claracle-data-observatory-relaunch.md:10
- The PRD version is bumped to 1.3 (and the changelog is dated 2026-08-02), but the frontmatter
ms.datestill says 2026-07-31. This makes the document metadata inconsistent with the update and can mislead readers/tools that rely onms.dateas the last-updated date.
Version 1.3 | Status Acceptance pending | Owner jmservera | Team SquadScope Squad | Target Wave 1 (foundation) | Lifecycle Definition
.copilot-tracking/reviews/2026-08-02/claracle-relaunch-readiness-reconciliation-plan-review.md:40
- This review note says “Committing and pushing the review corrections is the only remaining delivery action,” but those corrections are already part of this PR. Keeping that sentence makes the record stale/confusing for future readers.
Complete. The implementation fulfills the recorded user requests and local validation passes. Committing and pushing the review corrections is the only remaining delivery action.
📝 - Generated by Copilot
🔎 Site preview readyA rendered preview of this PR was built with Hugo extended (drafts + future content included). Download it: open the workflow run → Artifacts → Then serve and open it locally: unzip site-preview.zip -d site-preview && cd site-preview
python3 -m http.server 8080 # then open http://localhost:8080/(Links are root-relative, so open it via a local web server rather than Reviewer checklist
|
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 28 out of 28 changed files in this pull request and generated no new comments.
Suppressed comments (1)
docs/prds/claracle-data-observatory-relaunch.md:11
- The document version was bumped to 1.3 (and the changelog later records 2026-08-02), but the frontmatter
ms.datestill reads2026-07-31. This makes the doc metadata inconsistent with the update and can confuse tooling that relies onms.dateas the last-updated marker.
<!-- markdown-table-prettify-ignore-start -->
Version 1.3 | Status Acceptance pending | Owner jmservera | Team SquadScope Squad | Target Wave 1 (foundation) | Lifecycle Definition
Summary
Reconciles the Claracle Data Observatory relaunch record: triages the live deploy failure, brings the three overlapping remediation plans to their true delivered state, aligns the PRD and BRD, and consolidates the remaining launch gates into one owner/evidence register.
Epic: #594
What changed
Phase 1 — Live deploy failure (#644)
30718600607: a danglingsource_manifest.path(data/candidates/2026-W31/30669054860/publish-manifest.json) broke the Podcaster smoke gate.Phase 2 — Plan checklists → delivered state
docs/review/data-observatory-relaunch/status-of-record.md: single delivered-vs-pending view + launch-gate register.Phase 3 — Product docs
Phase 4 — Launch gates
Validation
pytest tests/— 1389 passed, 19 skipped.test_internal_link_checkerandtest_embed_sourcesgreen; all doc references verified; no stale version strings.Notes