Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Changed — decision epoch + epic restructure (2026-06-18)

This is the "next changelog entry" anticipated by the 2026-06-17 re-scope note below. It records the decisions and ADO restructure completed 2026-06-18.

• All ADRs 0001-0024 Accepted. Per-feature ADRs 0009-0020 and admin/portal & portability ADRs 0021-0024 authored and accepted; ADR Epic AB#3154 Closed. Decision layer locked; no ADR Proposed.
• Stack superseded (ADR 0024): compute → Azure Container Apps; database → PostgreSQL (portable). Replaces the ADR 0004 Azure Functions + Azure SQL choice.
• RBAC = six roles (added comms_author, drafts-only — ADR 0023, extends ADR 0006).
• Notifications decided (S4 closed): Twilio SMS (provider-neutral adapter) + SendGrid email — ADR 0013.
• Revised delivery order (the re-scope below): Platform (AB#3074) → iOS (AB#3077) → Sermons & Music Hub (AB#3137) → Calendar & Announcements (AB#3075) → Messaging & Notifications (AB#3138) → Android (AB#3139) → Additional Features (AB#3076) → Signature Features (AB#3078). "Deliver MVP" and "Deliver Core/Mobile Apps" no longer exist as Epics; AB#3075/3076/3077 were retitled. "Media Hub" → Sermons & Music Hub; Homeschool split into two tiers (ADR 0015).
• ADO board reconciled to everything above (six roles, Postgres, Container Apps); added provider-abstraction, Admin & Ministry Portal, comms_author, Twilio/SendGrid, Calendar ICS, and Homeschool tier stories.
• Foundation documentation pipeline tracked + authored: Epic AB#3177 with a Feature per layer (design AB#3178, architecture AB#3179, build AB#3180, implementation AB#3181, operations AB#3182) and 14 Stories (AB#3183-3196) across sprints 2026-Q3-S1..S4. All six doc layers authored.
• Documentation maintenance Epic AB#3197 established (rolling accuracy/maintenance).
• Area paths (as provisioned): \Platform, \Web, \Mobile, \Homeschool, \Marketplace, \Media (six; depth ≤ 2). The earlier eight-verbose-name set was never created.
• pmo/ docs reconciled (2026-06-18): project_roadmap.md, epic-priority-action-plan.md, project-management-guide.md, project-setup.md, quick-reference-guide.md, vscode-workflow.md, board-setup-action-plan.md, future-epics-batch.md, project-mgmt-epic-content.md, and technical-architecture-epic-content.md updated to the revised delivery order, ADRs 0001-0024, Container Apps + Postgres, six roles, Twilio/SendGrid, correct Epic AB# map, six area paths, and Clerk auth (removed stale Supabase, Azure Functions/SQL, "Media Hub", five-role, and old Phase 0–5 references).

Added

• pmo/platform-strategy.md — canonical platform strategy, phased roadmap, feature inventory, locked and open decisions.
• Reconciled all pmo/ planning documents to ADO work-item standard and the (now revised) delivery roadmap.

Changed — planning-only realignment (2026-06-17)

• pmo/platform-strategy.md — added a "planning & foundation document, no code/infra/pipelines built here" scope banner; removed the throwaway-POC guiding principle (replaced with documentary de-risking); reframed the Phase 1–5 roadmap as forward-looking vision owned by ADO Epics, not now-actions.
• pmo/project_roadmap.md — added the same ADO-Epic framing to each phase; deliverables labelled as Features tracked in ADO.
• pmo/epic-priority-action-plan.md — replaced "resolve in Phase 0" open-decisions list with locked decisions + ADR links; rewrote near-term actions as "create the ADO backlog"; unified Epic names.
• pmo/sprints/sprint-001-foundation.md — replaced the coding-task sprint backlog with an ADO pointer (work items live in ADO, not this file).
• pmo/technical-architecture-epic-content.md — removed the thin-slice POC deliverable; de-risking is documentary (ADRs/design notes), not implementation.

Added — ADO delivery backlog (2026-06-17)

• Created the ADO work-item hierarchy in project Heritage Community Hub per the work-items standard: 5 delivery Epics (Build Platform Foundation AB#3074, Deliver MVP AB#3075, Deliver Core Features AB#3076, Deliver Mobile Apps AB#3077, Deliver Signature Features AB#3078), 24 Features, 10 Phase-1 User Stories, and 24 Tasks.
• Created product area paths (\Platform, \Web, \Mobile, \Homeschool, \Marketplace) and the 2026-Q3-S1 … S6 (2-week) iterations. Phase-1 Features/Stories assigned to 2026-Q3-S1/S2; Phase 2+ left at the project-root backlog until scheduled.
• Wrote the Epic AB# ids back into the pmo roadmap/index docs.

Note: this backlog is being re-scoped per new requirements (media/sermons service; expanded platform scope including RBAC/members/signups/family portal; revised phase priority). See the next changelog entry once the restructure is agreed.

Changed

• pmo/README.md — replaced GitHub Projects/Issues/Milestones model with ADO Boards (master) and GitHub Issues as intake mirror only.
• pmo/epic-priority-action-plan.md — rewritten to Phase 0–5 sequence; removed GitHub epic numbers and stale sprint timeline.
• pmo/project_roadmap.md — rewritten to canonical Phase 0–5 roadmap; removed all-Azure-as-decided assumptions; open decisions flagged.
• pmo/future-epics-batch.md — aligned to feature inventory and phase assignments; removed transaction/payment scope from Marketplace; clarified Homeschool COPPA model.
• pmo/project-mgmt-epic-content.md — rewritten as ADO epic draft for Phase 0 PM setup; removed GitHub Projects framing.
• pmo/technical-architecture-epic-content.md — rewritten as ADO epic draft for Phase 0 architecture decisions; replaced all-Azure-as-decided with open/locked decision framing.
• pmo/sprints/sprint-001-foundation.md — iteration renamed to 2026-Q3-S1; removed June-2025 dates and Azure AD B2C as decided; added phase-gate note.
• pmo/planning/sprint-planning-template.md — aligned to YYYY-Q<n>-S<m> iterations, ADO item hierarchy, and AB# linking.
• pmo/releases/release-planning-template.md — aligned to YYYY-Q<n>-S<m> sprints, ADO Priority 1–4, and AB# linking.
• pmo/retrospectives/retrospective-template.md — aligned to YYYY-Q<n>-S<m> iterations; action items linked to ADO Tasks.

Removed

• Stale June-2025 sprint dates from sprint-001-foundation.md.
• GitHub epic number references (#1, #2, #6, #7, #8, #9, #18) from planning documents.
• GitHub Projects board links used for sprint tracking (replaced by ADO Boards links).
• Broken ../PROJECT_ROADMAP.md link and removed user_story.md template reference from pmo/README.md.

[0.1.0] — Planning baseline

Initial additions

• Initial project setup and repository structure.
• GitHub templates and workflows.
• Project management infrastructure — initial sprint, release, and retrospective templates.
• database/schema.sql design document.
• docs/ planning and executive summary documents.