# yaml-language-server: $schema=https://raw.githubusercontent.com/jackchuka/mdschema/main/schema.json

structure:
  - heading:
      expr: "slug(filename) == slug(heading)"
    children:
      # Brief context for authorization decisions - REQUIRED
      - heading: "## Overview"
        description: |
          1-2 sentences: who this actor is and their authority level.
          Not a job description — context for authorization decisions.

      # What flows this actor participates in - REQUIRED
      - heading: "## Authorized Business Flows"
        description: |
          Business flows this actor participates in.
          Format: [Flow Name](../business-flow/<flow>/README.md) — role
          Roles: initiator, approver, viewer
          Add conditions inline when needed, e.g. (< $1000)
        lists:
          - min: 1
            type: unordered
            min_items: 1

# Link validation
links:
  validate_internal: true
  validate_files: true

# Heading rules
heading_rules:
  no_skip_levels: true
  unique: true
  max_depth: 2