docs: add current-state context pack and actionable sequence-b prompts

2026-03-25 13:08:05 +00:00
parent e238ec079f
commit 30fad8e954
10 changed files with 568 additions and 10 deletions
@@ -0,0 +1,57 @@
+# Refactor Session Handoff (Usable Prompt)
+
+## Purpose
+
+Copy/paste this directly into a new chat session to continue the current PEDW refactor stream with the right context and next-step planning.
+
+## Copy/Paste Prompt
+
+```
+You are continuing an in-flight refactor stream in the PEDW FrontEnd repository.
+
+Before any analysis or code changes:
+1) Ask for the Azure DevOps work item ID (required).
+2) Create a new branch from `origin/SIPS-Development` prefixed with that ID (e.g. `US12345-progress-update` or `TASK67890-progress-update`).
+3) Confirm branch name, then continue.
+
+Follow this order before implementing:
+1) Read `.clinerules/default-rules.md` and `.clinerules/CONTRIBUTING_AI.md`
+2) Read `GUARDRAILS.md`
+3) Read current-state docs:
+   - `context/architecture.md`
+   - `context/current-state-scorecard.md`
+   - `context/next-work-plan-sequence-b.md`
+   - `context/test-coverage-map.md`
+4) Read memory context:
+   - `memory-bank/change-log.md` (latest entries)
+   - `memory-bank/debt-list.md`
+   - `memory-bank/architect-review.md`
+   - `memory-bank/decisions.md`
+   - `memory-bank/open-questions.md`
+
+Then provide (based on what you read):
+1. Current state summary (what is done, what remains)
+2. Recommended next slice from this exact shortlist (pick one):
+   - Slice B1.1: create shared signed-request helper(s) in `actions/clients/` and migrate one pilot path in `actions/services/portalDirectService.js`
+   - Slice B1.2: migrate remaining signed flows in `actions/services/documentDirectService.js` to the shared signed helper(s)
+   - Slice B2.1: auth logging hardening in `pages/api/auth/[...nextauth].js` (redacted structured logs, no behavior change)
+   - Slice B2.2: file/email logging hardening in selected `pages/api/file/**` and `pages/api/email/**`
+3. Exact files to change
+4. Validation plan (lint + targeted tests + EN/CY parity + negative-path checks)
+5. Rollback plan
+
+Constraints:
+- Preserve behavior unless explicitly requested otherwise
+- Do not weaken auth/session/CSP/security flows
+- Keep EN/CY parity
+- Keep scope to one bounded slice per commit
+- Update `memory-bank/change-log.md` for non-trivial changes
+
+After proposing the slice, wait for approval before editing files.
+```
+
+## Best use
+
+- Start-of-day continuation
+- Branch handover between engineers/agents
+- Recovery after interrupted context window