# Conditional Instruction Modules:
# ================================
#
# These file references are CONDITIONAL instructions and should ONLY be read when relevant to the
# task(s) you are performing.
#
# You SHOULD INFER their purpose and when to load them from the ID and `when` description.
#
# When multiple areas apply, load all relevant files.

conditional-instructions:
  - id: agent-communication-style
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/agent-communication-style.md
    when:
      - ALWAYS applies—READ NOW

  - id: agent-specs
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/agent-specs.md
    when:
      - whenever a "spec" is referenced

  - id: ask-opus
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/ask-opus.md
    when:
      - when instructed to interact with "Opus"
      - IGNORE if you are an Opus agent/model

  # Dev Tools
  - id: mise-uv
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/mise-uv.md
    when:
      - mise.toml or mise.local.toml is present
      - OR uv.lock is present

  # Python
  - id: python-cli
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/python/cli.md
    when:
      - ONLY when building python cli code
      - NOT when simply using python CLIs

  - id: python-style-IMPORTANT
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/python/style.md
    when:
      - Generating or modifying Python code
      - NOT when simply reading Python code or working in a Python repo

  - id: python-cli-click-logging-integration
    url: https://raw.githubusercontent.com/rsyring/code-examples/refs/heads/main/logs/mu-logs.py
    when:
      - when building CLIs from scratch
      - AND want to configure Python logging from cli options like --debug

  - id: python-pytest
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/python/pytest.md
    when:
      - WRITING python tests with pytest
      - NOT if only reading tests or working in a project with pytest

  - id: python-ruff
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/python/ruff.md
    when:
      - WRITING python code AND ruff.toml is present in the project

  - id: python-testing-freezegun
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/python/freezegun.md
    when:
      - freezegun module/package is present or used


  # Code Reviews
  - id: code-reviews
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/code-reviews.md
    when:
      - asked to do a code review

  # Writing
  - id: proofreading
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/writing/proofread.md
    when:
      - asked to "proofread"

  - id: writing-web-email
    url: https://raw.githubusercontent.com/rsyring/agent-configs/main/writing/web-email.md
    when:
      - drafting or revising website copy, web content, emails, or newsletters