version: 1

roles:
  leader:
    emoji: "🧭"
    can_edit: ["work/", "backlog/", "spec/", "harness/", "AGENTS.md", "CHECKPOINTS.md"]
    cannot_edit: ["project/", "tests/"]
    responsibilities:
      - plan
      - orchestrate
      - enforce_gates
      - publish_ticket_changes
      - close_feature
      - issue_orders_in_english_caveman

  triager:
    emoji: "🧩"
    can_edit: ["backlog/", "work/artifacts/", "spec/"]
    cannot_edit: ["project/", "tests/", "backlog/features.json:status=done"]
    responsibilities:
      - normalize_requests
      - create_tickets_in_english_caveman
      - define_scope_acceptance

  architect:
    emoji: "🏗️"
    can_edit: ["spec/", "harness/contracts/", "docs/"]
    cannot_edit: ["project/", "tests/", "backlog/features.json:status"]
    responsibilities:
      - design
      - update_contracts

  implementer:
    emoji: "🛠️"
    can_edit: ["project/", "tests/", "work/artifacts/"]
    cannot_edit:
      - "backlog/features.json:done"
      - "work/history.md"
      - "work/artifacts/*/reviewer.json"
      - "work/artifacts/*/security.json"
      - "work/artifacts/*/qa.json"
      - "work/artifacts/*/publish.json"
      - "work/artifacts/*/leader-close.json"
    responsibilities:
      - implement_feature
      - write_tests
      - produce_implementer_evidence

  reviewer:
    emoji: "🔍"
    can_edit: ["work/artifacts/"]
    cannot_edit: ["project/", "tests/", "backlog/"]
    responsibilities:
      - technical_review
      - emit_reviewer_verdict

  security:
    emoji: "🔒"
    can_edit: ["work/artifacts/"]
    cannot_edit: ["project/", "tests/", "backlog/"]
    responsibilities:
      - sast
      - dependency_review
      - secret_scan
      - emit_security_verdict

  qa:
    emoji: "🧪"
    can_edit: ["work/artifacts/"]
    cannot_edit: ["project/", "tests/", "backlog/"]
    responsibilities:
      - acceptance_traceability
      - integration_e2e_checks
      - regression_checks
      - emit_qa_verdict

  documenter:
    emoji: "📚"
    can_edit: ["docs/", "spec/", "README.md", "HOWTO.md", "work/artifacts/"]
    cannot_edit: ["project/", "tests/", "backlog/features.json:status"]
    responsibilities:
      - document_feature_changes
      - update_user_docs
      - emit_documenter_summary

anti_cheat:
  - "Implementer cannot promote feature to done"
  - "Done requires reviewer/security/qa approved artifacts"
  - "Done requires documenter evidence"
  - "Leader close requires verify.sh success"
  - "Evidence must be on disk; chat-only claims are invalid"