Skip to content

docs(relaunch): reconcile Claracle relaunch readiness across plans, PRD, and BRD - #647

Open
jmservera wants to merge 3 commits into
mainfrom
reconcile/claracle-relaunch-readiness-2026-08-02
Open

docs(relaunch): reconcile Claracle relaunch readiness across plans, PRD, and BRD#647
jmservera wants to merge 3 commits into
mainfrom
reconcile/claracle-relaunch-readiness-2026-08-02

Conversation

@jmservera

Copy link
Copy Markdown
Owner

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)

Phase 2 — Plan checklists → delivered state

Phase 3 — Product docs

Phase 4 — Launch gates

Validation

  • pytest tests/ — 1389 passed, 19 skipped.
  • test_internal_link_checker and test_embed_sources green; all doc references verified; no stale version strings.

Notes

  • Documentation-only reconciliation. Release acceptance remains pending; both rollout flags stay disabled.

…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.
Copilot AI review requested due to automatic review settings August 1, 2026 23:19

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread docs/review/data-observatory-relaunch/status-of-record.md
Copilot AI review requested due to automatic review settings August 2, 2026 09:48

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.date still says 2026-07-31. This makes the document metadata inconsistent with the update and can mislead readers/tools that rely on ms.date as 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.

Copilot AI review requested due to automatic review settings August 2, 2026 10:04
@github-actions

github-actions Bot commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

🔎 Site preview ready

A rendered preview of this PR was built with Hugo extended (drafts + future content included).

Download it: open the workflow runArtifactssite-preview.

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 file://.)

Reviewer checklist

  • Homepage renders correctly
  • Latest weekly article renders correctly
  • Representative archive / rollup (monthly, yearly, topics) pages render
  • Navigation menu, search page, and footer look correct
  • Light + dark themes both look correct
  • Mobile widths checked: 320 / 360 / 390 / 414 / 768 px
  • Screenshots attached for the operator / Fry / Calculon review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.date still reads 2026-07-31. This makes the doc metadata inconsistent with the update and can confuse tooling that relies on ms.date as 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants