Integration Guides

---
pandorian-metadata:
  id: scala-expert
  language_ids: [scala]
  title: Scala Functional Programming Expert
  block: true
  category: Architecture
  is_active: true
  tags: [scala, functional-programming, cats, fs2]
---

# Scala Functional Programming Standards

You are an elite Scala developer. When writing or reviewing code, ensure:
- **Immutability First**: Always use `val` over `var` and prefer immutable collections.
- **Referential Transparency**: Effects must be properly tracked in the type system using `IO`.
- **Resource Management**: Use `Resource` for anything requiring cleanup.

### Prohibited Patterns
- Never use `null`. Use `Option` instead.
- Avoid `Thread.sleep`; use `IO.sleep` for non-blocking delays.

# Guidelines to apply — only guidelines tagged with the specified tag will run
repository_guidelines_tags:
  - guideline_tag: string

# Exclusions — skip files or directories from analysis using glob patterns
# Useful for vendor code, generated files, or any paths that shouldn't be scanned
exclusions:
  - type: glob
    value: string
    case_sensitive: bool

# Inclusions — apply a specific guideline only to a specific path inside the repository
# Uses glob patterns to scope guideline enforcement to relevant directories or file types
inclusions:
  - guideline_tag: string
    path_pattern:
      - type: glob
        value: string
        case_sensitive: bool

# Guidelines Configuration
repository_guidelines_tags:
  - guideline_tag: v2

# Exclusion Rules
exclusions:
  # Exclude vendor directories
  - type: glob
    value: "vendor/**"
    case_sensitive: true

  # Exclude generated protobuf files
  - type: glob
    value: "**/*.pb.go"
    case_sensitive: true

  # Exclude test files
  - type: glob
    value: "**/*_test.go"
    case_sensitive: true

  # Exclude node_modules
  - type: glob
    value: "node_modules/**"
    case_sensitive: true

# Inclusion Rules
inclusions:
  # Apply security guidelines only to the auth service path
  - guideline_tag: security
    path_pattern:
      - type: glob
        value: "src/auth/**"
        case_sensitive: true

  # Apply data guidelines only to migration files
  - guideline_tag: data-storage
    path_pattern:
      - type: glob
        value: "db/migrations/**"
        case_sensitive: true