docs: multi-session handover pack for the RAG improvement programme by BigSimmo · Pull Request #1908 · BigSimmo/Database

BigSimmo · 2026-08-13T08:49:30Z

Summary

Adds docs/rag-improvement/HANDOVER.md: the cross-session context file for executing the merged RAG improvement programme (docs/rag-improvement/README.md, PR docs: reviewed and updated Clinical RAG Improvement Programme guide #1895) across multiple cloud sessions. It carries the programme state snapshot (recognising PR feat(rag): record the structured generation-quality verdict on fallback (#231 phase 1) #1899 as A1 phase 1 already in flight), seven ordered work packets (S1 A1-mitigation → S2 A2+A3 composition/length → S3 A4 follow-ups; S4 B0 fixtures → S5 B1+B2 harness → S6 B3 Docling lab; S7+ owner-gated) each with scope boundaries, file lists, gates, and done-definitions, a status table each session updates, session start/end checklists, a standing-rules summary, and one paste-ready prompt per packet.
Links the handover from the guide's sequencing section and adds its docs/README.md catalogue entry.
Adds two planned-path allowlist entries to scripts/check-docs-links.mjs: the S4 deliverable data-flow-register.md, and scripts/probe-generation-quality.ts which lands with PR feat(rag): record the structured generation-quality verdict on fallback (#231 phase 1) #1899 (entry marked for removal after that merge).

RAG impact: no retrieval behaviour change — documentation and a docs-checker allowlist entry only; no protected RAG surface is modified.

Verification

npm run verify:pr-local — heavy scope ran (script file changed): completed: check:runtime, check:installed-lock-parity, format:changed, sitemap:check, docs:check-index, docs:check-inventory, docs:check-scripts, docs:check-links, check:branch-review-ledger, check:outstanding-issues, check:ledger-write-discipline, lint, typecheck, test, check:rag:fixtures, check:medication-interactions, check:medication-lexicon-report — failed: (none).
UI verification not run: no UI, routing, styling, or browser behaviour changed.
Provider-backed evaluation not run: no runtime retrieval or generation behaviour changed.

Risk and rollout

Risk: minimal — documentation plus two comment-tagged allowlist entries in the docs link checker. Stale-handover risk is mitigated by the status-table update rule each packet PR follows.
Rollback: revert the commit.
Provider or production effects: None

Notes

The handover grants no approvals: canary dispatches, provider-backed evals, Supabase reads, and merges remain per-action owner decisions inside each future session, as each paste-ready prompt states.

Generated by Claude Code

Adds docs/rag-improvement/HANDOVER.md — the cross-session context file: programme state snapshot (PR #1899 = A1 phase 1), per-session work packets S1-S7+ with scope boundaries and gates, a status table sessions update, start/end checklists, and paste-ready prompts per session. Links it from the guide's sequencing section and the docs catalogue; allowlists the two planned paths it references. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UfJeqoq59y5xKmgRGHjqyA

coderabbitai · 2026-08-13T08:49:37Z

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in:4 minutes

Your organization has reached its usage spending cap. Adjust your spending cap in the billing tab.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 51a9728d-3612-4c36-b1c4-141029e6e226

📥 Commits

Reviewing files that changed from the base of the PR and between 39c300d and 9128d11.

📒 Files selected for processing (5)

docs/README.md
docs/branch-review-records/63ae367983e2470bf1a1edf08d4eacfa00b9894fc26c6e12805adc7f39c2fa22.record.md
docs/rag-improvement/HANDOVER.md
docs/rag-improvement/README.md
scripts/check-docs-links.mjs

_{Comment @coderabbitai help to get the list of available commands.}

supabase · 2026-08-13T08:49:42Z

This pull request has been ignored for the connected project sjrfecxgysukkwxsowpy because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UfJeqoq59y5xKmgRGHjqyA

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:b3367d5b3d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

BigSimmo · 2026-08-13T09:50:40Z

@codex please review all issues and comments and the PR and logically resolve with smallest required fix for me please. Then resolve the comments and close them

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:050ca4502b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

github-actions · 2026-08-13T10:15:11Z

CI triage

CI failed on this PR. Automated classification of the 2 failed job(s):

Static PR checks — needs investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.
PR required — needs investigation: inspect the failing step and uploaded diagnostics; rerun only after classifying the cause.

Compared with main CI run #10460 (success).

Classification is evidence routing, not permission to ignore a failure. Exact quarantined Playwright identities remain governed by the flake ledger.

…2024) * docs: add coordination-chat handover for the RAG improvement programme Adds docs/rag-improvement/COORDINATION.md — the coordinator-side layer over the worker HANDOVER: programme history (PRs #1895/#1899/#1908), the coordinator role definition, the wave dispatch plan and per-packet model/effort/plan-mode settings, the chained worker-prompt handoff pattern, the babysit playbook learned driving #1899 to merge, the standing-approvals map, and a paste-ready coordination-chat bootstrap prompt. Links it from the docs catalogue and HANDOVER, and corrects HANDOVER's now-verifiable status rows (#1908 merged). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UfJeqoq59y5xKmgRGHjqyA * docs: record review ledger entry for coordination handover PR Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UfJeqoq59y5xKmgRGHjqyA * docs(ledger): record the PR #2024 coordination-handover sync review Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>

docs: record review ledger entry for handover pack PR
0815181
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UfJeqoq59y5xKmgRGHjqyA

chatgpt-codex-connectorBot reviewed Aug 13, 2026
View reviewed changes

Comment threaddocs/rag-improvement/HANDOVER.md Outdated
Comment threaddocs/rag-improvement/HANDOVER.md Outdated
Comment threaddocs/rag-improvement/HANDOVER.md Outdated
Comment threaddocs/rag-improvement/HANDOVER.md Outdated

Merge branch 'main' into claude/rag-plan-review-guide-vhrls9
050ca45

chatgpt-codex-connectorBot reviewed Aug 13, 2026
View reviewed changes

Comment threaddocs/rag-improvement/HANDOVER.md Outdated
Comment threaddocs/rag-improvement/HANDOVER.md Outdated
Comment threaddocs/rag-improvement/HANDOVER.md Outdated

docs: correct RAG handover safeguards
f17dd9b

BigSimmo enabled auto-merge August 13, 2026 10:13

BigSimmo added 2 commits August 13, 2026 18:45

docs(rag): format handover
ae3cb80

Merge branch 'main' into claude/rag-plan-review-guide-vhrls9
9128d11

BigSimmo merged commit 5ca83b7 into mainAug 13, 2026
24 checks passed

BigSimmo deleted the claude/rag-plan-review-guide-vhrls9 branch August 13, 2026 11:04

BigSimmo mentioned this pull request Aug 17, 2026
docs: coordination-chat handover for the RAG improvement programme #2024
Merged
1 task

Navigation Menu

docs: multi-session handover pack for the RAG improvement programme - #1908

docs: multi-session handover pack for the RAG improvement programme#1908
BigSimmo merged 6 commits into
mainfrom
claude/rag-plan-review-guide-vhrls9

BigSimmo commented Aug 13, 2026

Uh oh!

coderabbitaiBot commented Aug 13, 2026•
edited
Loading

Review limit reached

Uh oh!

supabaseBot commented Aug 13, 2026

Uh oh!

chatgpt-codex-connectorBot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BigSimmo commented Aug 13, 2026

Uh oh!

chatgpt-codex-connectorBot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actionsBot commented Aug 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

BigSimmo commented Aug 13, 2026

Summary

Verification

Risk and rollout

Notes

Uh oh!

coderabbitaiBot commented Aug 13, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review limit reached

Uh oh!

supabaseBot commented Aug 13, 2026

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BigSimmo commented Aug 13, 2026

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actionsBot commented Aug 13, 2026

CI triage

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

coderabbitaiBot commented Aug 13, 2026•
edited
Loading