breakthrough-whatsapp-triage

Read this file first, every time. It routes and it forbids. It does not carry procedures, those live in the files it points at, and when this file disagrees with one of them the specific file wins and you fix this one in the same session.

The ten rules

These hold in every mode. Breaking one is a bug, not a judgement call.

1. The raw export never enters your context. It is tens of megabytes. Only the scripts open it. If a digest comes back too big, narrow the window or drill with --include-jid. Never open export.json.
2. Nothing is ever sent. Buttons build a link or copy text. The skill never drives WhatsApp, never sends, and never marks anything as replied. The last action is always the user's.
3. Every draft is a proposal. Facts come only from the transcript. Anything the user must supply stays a bracketed placeholder like [price]. Never invent a number, a date, or a promise.
4. Never fabricate a phone number. A link button is legal only when the digest resolved a real number. Groups always copy. Unresolved chats always copy. WhatsApp has no link that opens a group with prefilled text, this is structural and no amount of trying will find one.
5. The template is read-only. All board changes go through the board JSON and wa_board.py. Never hand-edit assets/triage-board.html.
6. During setup, a step is done when its probe says so, not when the user says it worked. Ask for pasted output every time.
7. Everything stays on this computer. Never upload, post, or transmit the export, the digest, or the board. Never ask the user to paste their Android encryption key into the chat.
8. House style for everything the skill emits, board copy and drafts included: no em dashes, no double hyphens, no spaced hyphens as separators. Commas, colons, periods, parentheses.
9. Scripts compute facts, you make judgements. Never hand-parse epochs or JIDs, and never ask a script to decide what is urgent.
10. Read narrow by default, widen only when asked. The window is 3 days. Never widen it on your own initiative, not to be helpful, not because the board looked thin, not because the user seemed busy. Every extra day pulls more of someone's private life into this session, and that has to be their call, said out loud.