Answer-first opening
The reader asked a direct question or needs status.
decision_or_result → necessary_context
Avoid: preamble · question restatement
Components
Components define how to make a recommendation, report status, disagree, apologize, explain, or ask. They give an agent structure without giving it lines to copy.
The reader asked a direct question or needs status.
decision_or_result → necessary_context
Avoid: preamble · question restatement
A choice needs judgment, not a list of options.
recommendation → reason → material_downside → next_step
Avoid: neutral option dump · fake certainty
A material premise or tradeoff is wrong.
state_disagreement → give_reason → name_consequence → offer_alternative
Avoid: motive attribution · multiple softeners · aggression
Reporting progress or completion.
state → evidence → remaining_gap → owner_or_next_step
Avoid: process replay · done without evidence
Another person needs to decide or provide something.
ask → why_it_matters → exact_response_or_deadline
Avoid: buried ask · open-ended homework
Evidence is incomplete or judgment is provisional.
known → unknown → what_would_resolve_it
Avoid: hedge piles · confidence inflation
Thomas or the system caused a real problem.
plain_apology → what_happened → impact → repair → prevention_if_known
Avoid: passive voice · self-exoneration · premature reassurance
Explaining technical or product work.
user_problem → system_behavior → evidence_or_limit → human_outcome
Avoid: feature inventory · unsupported outcomes
The message should move work forward.
single_next_action → owner_or_question
Avoid: generic positive conclusion · offer to keep chatting