name: github
description: GitHub Issues + Markdown docs + GitHub Actions + Pull Requests

artifacts:
  idea:
    content_owner: github_issue
    state_owner: github_issue
    canonical_id: issue_number
  prd:
    content_owner: markdown
    state_owner: github_issue
    canonical_id: docs_path_or_issue_comment_url
  techspec:
    content_owner: markdown
    state_owner: github_issue
    canonical_id: docs_path_or_issue_comment_url
  tasks:
    content_owner: github_issues
    state_owner: github_issues
    canonical_id: issue_number
  refinement:
    content_owner: markdown
    state_owner: github_issue
    canonical_id: docs_path
  execution:
    content_owner: git_branch
    state_owner: pull_request
    canonical_id: branch
  review:
    content_owner: pull_request
    state_owner: pull_request
    canonical_id: pull_request_number
  memory:
    content_owner: markdown
    state_owner: traceability_map
    canonical_id: docs_path

events:
  idea_created: issues.opened
  prd_approved: issue_labeled_or_comment_command
  techspec_approved: issue_labeled_or_comment_command
  refinement_approved: issue_labeled_or_comment_command
  pr_opened: pull_request.opened
  ci_green: check_suite.completed
  review_approved: pull_request_review.submitted
  deploy_done: deployment_status.success

fallbacks:
  approval: issue_comment_with_explicit_decision
  polling: scheduled_task_for_check_runs
  docs: repo_markdown
