name: stemwijzer
version: 2
categories:
  - path: stack.yaml
    description: Project technology stack (languages, frameworks, runtime)
    group: stack
  - path: dependencies.yaml
    description: Declared and recommended dependencies grouped by purpose
    group: stack
  - path: system.md
    description: System overview and architecture high-level notes
    group: architecture
  - path: architecture.yaml
    description: Architectural layers, organization and confidence levels
    group: architecture
  - path: conventions.yaml
    description: Coding conventions cheat-sheet (naming, imports, types)
    group: style
  - path: domain-glossary.yaml
    description: Business domain glossary for the project
    group: domain
  - path: patterns/duckdb_access.yaml
    description: DuckDB access patterns, examples, and anti-patterns
    group: patterns
  - path: patterns/requests_http.yaml
    description: Requests/HTTP client usage and retry best-practices
    group: patterns
  - path: patterns/embeddings_similarity.yaml
    description: Embedding, SVD, fusion and similarity pipeline patterns
    group: patterns
  - path: patterns/error_handling.yaml
    description: Error handling patterns and rules
    group: patterns
  - path: patterns/validation.yaml
    description: Input/domain validation patterns and examples
    group: patterns
  - path: patterns/module_singletons.yaml
    description: Module-level singletons and lifecycle patterns
    group: patterns
  - path: anti-patterns.yaml
    description: Known anti-patterns and remediation steps
    group: patterns
  - path: examples/pattern-examples.md
    description: Consolidated extracted code examples across patterns
    group: patterns
  - path: constraints/naming.yaml
    description: Enforce naming rules (snake_case, PascalCase, constants)
    group: constraints
  - path: constraints/imports.yaml
    description: Enforce import grouping and ordering
    group: constraints
  - path: constraints/db_connection.yaml
    description: Rules for opening/closing DB connections and read-only usage
    group: constraints
  - path: constraints/error_handling.yaml
    description: Error handling style and allowed exception scopes
    group: constraints
  - path: constraints/testing.yaml
    description: Test conventions (pytest, test naming, fixtures)
    group: constraints