← the whole session

Fulcrum 14 of 18

Reporting back to the person

At the end of a turn that produced something, when the agent tells the person what happened.

What goes wrong here

The person gets pages of narration, internal names and undefined terms, or an account of effort instead of what changed for them. Guesses are presented as facts. The person has to reconstruct what happened, ask what a term means, or go looking for where to see the result.

How it compounds if nothing catches it

A report the person can't read quickly is a report they don't check, so errors get through. Every round of clarification costs their attention, and they start to skim, which is when misalignment slips past unnoticed.

What the harness does here

on-turn-end picks the right closing move. It can show finished work where the person can see it working (consume). It can narrow the remaining scope and file a proposal (gap, propose). It can give a status of one to seven sentences the person can scan in seconds (update-the-founder). It can ask a question (ask), or reset if the person complained about how the agent communicates (calibrate). A hook that never blocks reminds the agent to run it when the turn's rigor score was above 40. how-to-talk-like-the-founder and speak-human govern every word a person reads. That means plain language, every term defined where it is used, and the exact condition stated whenever code is mentioned (on-talking-about-code). It also means keeping what the person said separate from what the agent thinks it means. show-proof-to-human turns final approval into a short click-through. jonathan-check2 predicts the person's reaction before the report goes out, so predictable objections can be fixed first.

The pieces that act here

  • /on-turn-end

    Run at the end of any substantive turn that produced a work product with a governer score above your configured threshold. Routes you to the right consumption skill so the person you're working with can see, understand, and act on what you did in seconds — never reading pages of output to figure out what you were working on, which part you just touched, or where to look at it. Skip for pure conversation/brainstorm with no work product.

  • stop-on-turn-end-reminder.sh

    A hook: a script Claude Code runs on its own at a set moment.

  • /consume

    Present finished work with clickable URLs and UX stories. Use when handing off completed work for the human to consume.

  • /update-the-founder

    Status check-in after every substantive turn — 1-7 sentences that instantly clarify what you're working on, what just happened, what the intent was, what's predicted next, with quick single-letter commands attached. Replaces verbose agent narration with synthesized signal the person can scan in 5 seconds instead of reading paragraphs. Use after finishing any substantive task, when the person says START, when handing off mid-work, when you sense the person needs to observe state for human-in-the-loop review, or when about to ask a clarifying question and want to surface state first. Triggers: status update, what are you working on, where are you, check in, update me, what's the status, surface state, START, observability, human in the loop, what just happened, where do things stand.

  • /speak-human

    Translate agent-speak into plain human language. Use when writing explanations, status updates, proposals, or any communication

  • /how-to-talk-like-the-founder

    ALWAYS ON for every communication a human will read — every chat reply, status update, report, proposal, plan, commit message, comment, or doc, with no exempt category. Holds general, load-bearing directives for how to communicate to any human (conversational synthesis grounded in a real person's intended vs actual experience, no undefined terms, exact conditions when referencing code, broken is scope not "how it works"). Also governs writing in the first person as the specific person you're working with, which additionally requires selecting from their own verbatim material — the skill's name comes from its original build, which preserved one person's own voice; the mechanism generalizes to whoever you're working with.

  • /on-talking-about-code

    MANDATORY discipline for any communication that references code — to the person you're working with, in comments, in docs, in proposals, in reports. A code reference is worthless-to-negative unless it is fused with the exact literal conditions (numbers, states, inputs the system actually checks) AND the precise user journey that makes the statement true. Force-read whenever you reference code, and especially on triggers like "what exact ux", "i don't understand", "what are the conditions". Read this BEFORE writing the code reference, not after.

  • /communication-pattern-validated

    HOW to communicate with the person you're working with. This is not a checker or validator — it is the way you talk. When invoked, immediately apply this pattern to your NEXT response about your actual work. Do not use this to analyze your own communication.

  • /show-proof-to-human

    The final 30-second sanity check before going live. Produces a tiny guide the person you're working with walks through to confirm the work actually does what it was supposed to do. Use after ALL agent testing is complete — that person is NOT the tester, they are the final stamp of approval. Also use when they say 'prove it', 'show me', 'is this actually working'.

  • /agent-outcome-summary

    Generate a trustworthy, human-legible outcome report after completing dispatched work. Each item translates code changes into UX-testable statements with verification evidence grounding. The person you're working with reads this in 30 seconds and knows what happened.

  • /whats-left

    Summarize unfinished assigned work for the person you're working with, in UX-first language. Use when asked what is left, what is in progress, or to communicate incomplete work without technical jargon; translate into user-facing flows and call out what remains with concrete blockers.

  • /jonathan-check2

    Response predictor v2 — queries an oracle built from real agent-conversation history to predict what the person you're working with would say to your output. Replaces a local keyword-matching predictor with semantic retrieval and synthesis over that history. Use before declaring work done, before presenting work, or when you need to anticipate their reaction.

  • /complete-agentic-task

    Run the mandatory completion protocol before returning control. Use when finishing any substantive piece of work.

  • stop-complete-agentic-task.sh

    A hook: a script Claude Code runs on its own at a set moment.

Loops that pass through here