# Tier-1 P0: governance + docs integrity (fast, no salesflow-saas backend deps)
name: Docs governance

on:
  push:
    branches: [main]
    paths:
      - "docs/**"
      - "scripts/architecture_brief.py"
      - "scripts/check_docs_links.py"
      - ".github/workflows/docs-governance.yml"
      - "MASTER_OPERATING_PROMPT.md"
      - "AGENTS.md"
      - "CLAUDE.md"
      - "Execution_Matrix.md"
      - "Execution_Matrix_v2.md"
      - "Architecture_Pack.md"
  pull_request:
    branches: [main]
    paths:
      - "docs/**"
      - "scripts/architecture_brief.py"
      - "scripts/check_docs_links.py"
      - ".github/workflows/docs-governance.yml"
      - "MASTER_OPERATING_PROMPT.md"
      - "AGENTS.md"
      - "CLAUDE.md"
      - "Execution_Matrix.md"
      - "Execution_Matrix_v2.md"
      - "Architecture_Pack.md"

jobs:
  architecture_brief:
    name: Constitution path check
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: python scripts/architecture_brief.py

  docs_links:
    name: Markdown internal links
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: python scripts/check_docs_links.py