# Guidelines configuration template - docs/guidelines.yaml
kind: guidelines
version: "1"
updated_at: "{{ today }}"

# Prompt Engineering Best Practices
prompt_templates:
{% for role in roles[:4] %}
  {{ role.code | lower }}:
    role: "{{ role.name }}"
    template: "[{{ role.code }}] Please help me with {task description}"
{% endfor %}
  issue_diagnosis:
    role: "QA"
    template: |
      [QA] Encountered issue: {issue description}
      Reproduction steps: {steps}
      Expected behavior: {expected}
      Actual behavior: {actual}

# High-Value Prompt Phrases
high_value_phrases:
  deep_analysis:
    - "Please analyze from the {role} perspective"
    - "What have I not considered?"
  solution_comparison:
    - "Provide 2-3 solutions and compare pros and cons"
  risk_assessment:
    - "What is the biggest risk of this approach?"
  simplification:
    - "What is the minimum needed for an MVP version?"
  future_thinking:
    - "If we need to support {X} in the future, what should we prepare now?"
  vibe_alignment:
    - "Do you understand my intent?"
    - "Let's align our understanding first"

# Communication Tips
communication:
  avoid:
    - "Write me an XXX"  # too direct, skips thinking
    - "Just give me the code"  # skips design discussion
  recommended:
    - "I'd like to discuss the design of XXX with you"
    - "What issues do you see with this approach?"
    - "Let's align our understanding before we start"
    - "What's your take on this decision?"
    - "Walk me through your thought process"

# Vibe Check Questions
vibe_check_questions:
  - "Before continuing, let's confirm:"
  - "Are we aligned in understanding?"
  - "Is this the right direction?"
  - "Is there anything I haven't considered?"
