llm-friendly-context

# 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. - Keep a prohibition only when it protects an irreversible boundary or shipped contract. Name the protected condition and the allowed action. - 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. 4. **Provide necessary context** - Include the purpose, source artifacts, hard constraints, accepted decisions, and unresolved conditions. - Prefer concrete file paths and section hints over broad module names. - Follow references while they can change an in-scope decision, action, or verificati...