feat: Refactor work item management and documentation for clarity and structure

ai/work-items/README.md

@@ -0,0 +1,25 @@
+# Work Items
+
+## Goal
+
+Keep active Jira-linked work in one canonical place so standups, manager updates, and memory syncs can reference each ticket precisely.
+
+---
+
+## Structure
+
+- `index.md`
+  Active index and quick status view.
+
+- `<jira-id>.md`
+  Canonical file for a specific ticket.
+
+---
+
+## Update Rules
+
+- Use one file per active or recently relevant Jira item.
+- Keep titles exact when approved or explicitly confirmed.
+- If the title is not confirmed, store the Jira ID and current framing without inventing a final title.
+- Update the ticket file when scope, sequencing, points, status, rollout implications, or reproducibility meaningfully change.
+- Keep `ai/state/work-items.md` as a short bridge summary, not the primary source of detailed ticket context.

ai/work-items/index.md

@@ -0,0 +1,31 @@
+# Work Item Index
+
+## Goal
+
+Provide a quick view of active and recently relevant Jira-linked work while keeping the full detail in one file per ticket.
+
+---
+
+## Active
+
+- [pdiap-14859.md](./pdiap-14859.md)
+  `PDIAP-14859` active spike/planning work around dual UIKit/SwiftUI support, dynamic `UIHostingController` removal, and consumer rollout planning.
+
+- [pdiap-15838.md](./pdiap-15838.md)
+  `PDIAP-15838` next story to work on; approved scope removes Apollo and GraphQL-specific iOS transport code while leaving REST.
+
+- [pdiap-15836.md](./pdiap-15836.md)
+  `PDIAP-15836` approved follow-up story for dismissal delegate lifecycle sequencing in pure SwiftUI; comes after `PDIAP-15838`.
+
+## Holding / Closure Pending
+
+- [pdiap-15765.md](./pdiap-15765.md)
+  `PDIAP-15765` authenticated-only TeenIdentityCheck DOB issue; root cause documented and waiting for the right closure timing.
+
+---
+
+## Usage
+
+- Read this file first for active ticket context.
+- Open the specific ticket file when you need exact scope, sequencing, or communication wording.
+- Update the per-ticket file first when ticket context changes materially.

ai/work-items/pdiap-14859.md

@@ -0,0 +1,40 @@
+# PDIAP-14859
+
+## Status
+
+- Active
+- Current focus on April 10, 2026
+
+---
+
+## Current Framing
+
+- This work is currently framed in the workspace as a dual UIKit/SwiftUI plan that removes `UIHostingController` dynamically while preserving both flows appropriately.
+- The remaining deliverable is process-oriented, not just technical implementation.
+
+---
+
+## Current Scope
+
+- Define a consumer-facing rollout plan for the broader UIKit-removal work.
+- Preserve both UIKit and SwiftUI paths appropriately while introducing the new path safely.
+- Cover risky entry points such as `FTTransfer`.
+- Include validation expectations in `XQ1`.
+- Include consumer communication expectations.
+- Include a 30-day production period with no reported bugs before final removal.
+- Include a follow-up release to remove the feature flag and old code after rollout confidence is achieved.
+
+---
+
+## Notes
+
+- The workspace does not currently hold an approved final title for this ticket beyond the Jira ID.
+- The feature-flag and rollout planning guidance applies to the broader UIKit-removal spike, not only to dismissal-sequencing work.
+- Jeff suggested sending the process-oriented rollout document to Quy for feedback when ready.
+
+---
+
+## Related Work
+
+- Related consumer rollout thinking should stay aligned with `PDIAP-15836`.
+- `PDIAP-15838` should not be framed as part of this UIKit-removal spike.

ai/work-items/pdiap-15765.md

@@ -0,0 +1,35 @@
+# PDIAP-15765 - AO DOB field error not showing investigation
+
+## Status
+
+- Holding
+- Ready for closure timing review
+
+---
+
+## Context
+
+- This ticket is tied to an AO DOB validation issue.
+- The issue was confirmed in the `TeenIdentityCheck` flow for authenticated users.
+
+---
+
+## Confirmed Findings
+
+- The issue reproduces only for authenticated users based on the currently stored evidence.
+- Root cause was documented.
+- The original external report was incomplete.
+
+---
+
+## Current Guidance
+
+- Treat the issue as scoped and understood unless new evidence appears.
+- Keep the authenticated-user qualifier whenever this ticket is mentioned.
+- Do not describe it as a generic validation issue without the `TeenIdentityCheck` and auth context.
+
+---
+
+## Next Step
+
+- Jeff approved moving the story to Done once the new sprint starts.

ai/work-items/pdiap-15836.md

@@ -0,0 +1,38 @@
+# PDIAP-15836 - Modernize dismissal delegate lifecycle sequencing for pure SwiftUI environment
+
+## Status
+
+- Approved
+- Sequenced after `PDIAP-15838`
+- Sized at `8` points
+
+---
+
+## Context
+
+- This story came out of the `AccountLink` root cause investigation.
+- It is tied to the dismissal sequencing problem found after UIKit removal in SwiftUI-only paths.
+- The root cause document was updated and the revised wording was approved.
+
+---
+
+## Approved Scope
+
+- Modernize dismissal delegate lifecycle sequencing for pure SwiftUI flows.
+- Cover the missing lifecycle contract where delegate callbacks can happen before the view is fully removed.
+- Validate the change across affected SwiftUI flows rather than only in one narrow reproduction.
+
+---
+
+## Sequencing And Dependencies
+
+- This story should come after `PDIAP-15838`.
+- It is aligned with epic `26Q2 - Updating XFlowSDK to Decouple and Fix ApexKit Dependencies (Split Part 2)`.
+- If possible, it should use the same consumer-impact feature flag strategy as the broader UIKit-removal rollout.
+
+---
+
+## Communication Notes
+
+- Keep the scope framed as lifecycle sequencing in a pure SwiftUI environment, not only as a symptom like multiple modal presentation.
+- If mentioned externally, keep it separate from `PDIAP-15838`.

ai/work-items/pdiap-15838.md

@@ -0,0 +1,37 @@
+# PDIAP-15838 - Remove Apollo for iOS
+
+## Status
+
+- Approved
+- Next story to work on
+- Sized at `8` points
+
+---
+
+## Context
+
+- This ticket covers the REST migration cleanup on iOS.
+- The approved title is `Remove Apollo for iOS`.
+
+---
+
+## Approved Scope
+
+- Remove Apollo from iOS.
+- Remove GraphQL-specific networking code.
+- Remove related tests and mocks.
+- Remove transport feature flags so REST remains.
+
+---
+
+## Current Guidance
+
+- Do not frame this ticket as directly tied to the UIKit-removal spike.
+- Do not imply it is dependent on or part of dismissal-sequencing work.
+- Keep the migration framing explicit: REST remains behind a feature flag until otherwise confirmed, and GraphQL fallback context still matters when describing the overall migration.
+
+---
+
+## Sequencing
+
+- This is the next story to work on before `PDIAP-15836`.