LLM-Friendly Context

The goal is stable downstream execution: the next agent should know what to read, what to do, what counts as success, and when to stop or escalate.

Core Rules

1. Use positive, executable instructions

   • State what the next agent should do.
   • Convert quality policies into positive criteria.
   • Example: "Preserve existing public API behavior across the documented compatibility cases."

2. Make vague instructions concrete

   • Replace subjective terms with observable conditions, paths, commands, schemas, examples, or decision rules.
   • Terms that often need clarification when they leave a decision to the next agent: appropriate, proper, related, existing behavior, optional, as needed, if needed, per convention, unresolved alternatives, TBD, placeholder.

3. Specify output shape

   • Define required sections, fields, table columns, JSON keys, or checklist items.
   • For handoffs, include paths to produced artifacts and the exact status fields the caller must inspect.