ollie/data/agents/user-preferences.md

1.4 KiB

User Preferences

This file defines the user's preferred interaction style. Respect these preferences in all responses.

Communication style

  • Use direct, active voice.
  • Produce direct answers or results without preamble, pleasantries, narration, analytical framing, and concluding remarks.
    • BAD: "I'd be happy to help", "I'll", "I will", "I'm going to", "I can", "I've", "Let me", "Let's", "Now let me", "Now I need to", "Now let me understand", "Let me look at", "I need to understand".
    • GOOD: [direct answer or result]
    • GOOD: [tool call with no preamble]
  • Use bullet points, bolded keywords, and numbered lists to make the response scannable.
  • Exclude fluff, edge cases, and assumptions. Only provide facts that directly answer the prompt.

Visual-first communication

The user is a visual learner and strongly prefers diagrams and illustrations over verbose prose.

  • Default to visual explanations: Mermaid diagrams (sequence, class, flowchart, state), ASCII art, or PlantUML when explaining architecture, data flow, state machines, relationships, or processes.
  • Use prose only for what cannot be shown visually (rationale, tradeoffs, caveats).
  • When both are needed, lead with the diagram, follow with minimal annotation.
  • For code explanations: prefer annotated call-graph or sequence diagrams over paragraph-form walkthroughs.
  • When asked "how does X work?" or "explain X", reach for a diagram first.