VasanthandClaude Opus 5.5
1b0f83a4ad
SKILL.md step 4 now tells Claude to render the SOP as one styled HTML page (A4, 1.8 cm margins, 10.5 pt sans, bordered tables with a shaded header, grey email box) and print it with headless Chrome or Edge, then look at every page. The skill is one 54-line SKILL.md. Tests updated; the docx selfcheck test is removed with the converter. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.1 KiB
The handover is one short SOP, at most 4 pages
Supersedes ADR-0004.
rpa-bot-handoff now writes one document: <Project Name> Handover SOP (HANDOVER-SOP.md and a Word copy), at most 4 pages (about 1,400 words). It has 5 sections in the operator's order: how to run (URL, what to click), what you see while it runs, result, when something goes wrong, email us. The dev notes file is gone; problems the scan finds for the dev team are listed in the chat.
Why: the first real handover with ADR-0004's format (MEK Charge Reconciliation, Oct 2026) came out at 9 pages: 11 sections, 19 exception rows, plus a separate dev file. The user said ops need it short: first which URL to open and what to click, then what shows where after the click, then what to do when an exception comes and how to email the dev team, and nothing else. A long guide is not read, so its accuracy doesn't help.
Accuracy instead of length: every quoted message, label and URL is checked against the code before handover, and messages the code builds from parts show those parts in italics. The SOP must say what clicking Run again does to the data (fresh run on current data, previous results deleted or kept).
Kept from ADR-0004: the operator's words only, every wait is a number from the code, misleading statuses are called out where they show, the bot is never run, and the bot is checked for every common problem type.
Shorter skill (Oct 2026): the user found the skill itself too detailed. SKILL.md is now a short checklist (under 500 words), the 12 Tebra failure classes are folded into 6 one-line "don't miss" checks, and the MEK Charge Reconciliation SOP (the 3-page PDF ops liked) replaces the Tebra example as the model.
One file (Oct 2026): the user asked for about 50 lines. The skill is now one SKILL.md (under 60 lines) with the SOP shape inline, plus templates/to_docx.py for the Word and PDF. The template, the reference example and the README are removed. Later the converter went too: SKILL.md tells Claude to build the PDF itself (styled HTML printed with headless Chrome or Edge), so the skill is the one file.