mirror of
https://github.com/blackboxprogramming/BlackRoad-Operating-System.git
synced 2026-03-17 07:57:19 -05:00
321 lines
12 KiB
Plaintext
321 lines
12 KiB
Plaintext
# BlackRoad OS Code Owners — Phase Q Edition
|
|
# This file defines module-based ownership with automation awareness.
|
|
# Each line is a file pattern followed by one or more owners.
|
|
#
|
|
# Related docs: MERGE_QUEUE_PLAN.md, AUTO_MERGE_POLICY.md, GITHUB_AUTOMATION_RULES.md
|
|
|
|
# ==============================================================================
|
|
# GLOBAL OWNERSHIP
|
|
# ==============================================================================
|
|
|
|
# Default owner for all files (fallback)
|
|
* @alexa-amundson
|
|
|
|
# ==============================================================================
|
|
# BACKEND (High Scrutiny)
|
|
# ==============================================================================
|
|
|
|
# Core backend application
|
|
/backend/ @alexa-amundson @backend-team
|
|
/backend/app/ @alexa-amundson @backend-team
|
|
|
|
# Backend modules (fine-grained ownership)
|
|
/backend/app/routers/ @backend-team @alexa-amundson
|
|
/backend/app/models/ @backend-team @data-team @alexa-amundson
|
|
/backend/app/services/ @backend-team @alexa-amundson
|
|
/backend/app/utils/ @backend-team
|
|
|
|
# Backend configuration (high scrutiny)
|
|
/backend/requirements.txt @alexa-amundson @backend-team
|
|
/backend/Dockerfile @alexa-amundson @infra-team
|
|
/backend/docker-compose.yml @alexa-amundson @infra-team
|
|
/backend/.env.example @alexa-amundson
|
|
|
|
# Backend tests (low scrutiny, can auto-approve)
|
|
/backend/tests/ @backend-team @test-bot
|
|
|
|
# ==============================================================================
|
|
# FRONTEND / OS (Medium Scrutiny)
|
|
# ==============================================================================
|
|
|
|
# Main OS interface (canonical frontend)
|
|
/backend/static/ @alexa-amundson @frontend-team
|
|
/backend/static/js/ @frontend-team
|
|
/backend/static/index.html @alexa-amundson @frontend-team
|
|
|
|
# Legacy OS interface (being deprecated)
|
|
/blackroad-os/ @alexa-amundson @frontend-team
|
|
|
|
# ==============================================================================
|
|
# AGENTS & AUTOMATION (AI-Aware)
|
|
# ==============================================================================
|
|
|
|
# Agent framework
|
|
/agents/ @alexa-amundson @agent-team
|
|
/agents/base/ @alexa-amundson @agent-team
|
|
/agents/categories/ @agent-team
|
|
|
|
# Agent tests (can auto-approve)
|
|
/agents/tests/ @agent-team @test-bot
|
|
|
|
# ==============================================================================
|
|
# INFRASTRUCTURE (Highest Scrutiny — Never Auto-Merge)
|
|
# ==============================================================================
|
|
|
|
# GitHub workflows (manual review required)
|
|
/.github/ @alexa-amundson
|
|
/.github/workflows/ @alexa-amundson @infra-team
|
|
/.github/CODEOWNERS @alexa-amundson
|
|
|
|
# Infrastructure as code
|
|
/infra/ @alexa-amundson @infra-team
|
|
/ops/ @alexa-amundson @ops-team @infra-team
|
|
|
|
# Deployment configuration
|
|
railway.toml @alexa-amundson @infra-team
|
|
railway.json @alexa-amundson @infra-team
|
|
docker-compose.yml @alexa-amundson @infra-team
|
|
|
|
# CI/CD scripts
|
|
/scripts/ @alexa-amundson @ops-team
|
|
/scripts/railway/ @alexa-amundson @infra-team
|
|
|
|
# ==============================================================================
|
|
# DOCUMENTATION (Lowest Scrutiny — Can Auto-Merge)
|
|
# ==============================================================================
|
|
|
|
# General documentation (auto-merge eligible)
|
|
/docs/ @docs-team
|
|
/docs/architecture/ @alexa-amundson @docs-team
|
|
|
|
# Root-level docs (auto-merge eligible)
|
|
/*.md @docs-team
|
|
/README.md @alexa-amundson @docs-team
|
|
|
|
# Security documentation (manual review required)
|
|
/SECURITY.md @alexa-amundson
|
|
|
|
# Phase Q documentation (automation policies)
|
|
/MERGE_QUEUE_PLAN.md @alexa-amundson
|
|
/AUTO_MERGE_POLICY.md @alexa-amundson
|
|
/GITHUB_AUTOMATION_RULES.md @alexa-amundson
|
|
/WORKFLOW_BUCKETING_EXPLAINED.md @alexa-amundson
|
|
/OPERATOR_PR_EVENT_HANDLERS.md @alexa-amundson
|
|
|
|
# ==============================================================================
|
|
# SDKs (Medium Scrutiny)
|
|
# ==============================================================================
|
|
|
|
# Python SDK
|
|
/sdk/python/ @alexa-amundson @sdk-team
|
|
/sdk/python/tests/ @sdk-team @test-bot
|
|
|
|
# TypeScript SDK
|
|
/sdk/typescript/ @alexa-amundson @sdk-team
|
|
/sdk/typescript/tests/ @sdk-team @test-bot
|
|
|
|
# ==============================================================================
|
|
# OPERATOR & PRISM (Automation Engine)
|
|
# ==============================================================================
|
|
|
|
# GitHub event handlers (critical automation logic)
|
|
/backend/app/services/github_events.py @alexa-amundson @operator-team
|
|
/backend/app/routers/webhooks.py @alexa-amundson @operator-team
|
|
|
|
# Prism Console (merge dashboard)
|
|
/blackroad-os/js/apps/prism.js @alexa-amundson @prism-team
|
|
/blackroad-os/js/apps/prism-merge-dashboard.js @alexa-amundson @prism-team
|
|
|
|
# ==============================================================================
|
|
# RESEARCH & COGNITIVE (Low Scrutiny)
|
|
# ==============================================================================
|
|
|
|
/cognitive/ @alexa-amundson @research-team
|
|
/blackroad-universe/ @alexa-amundson @brand-team
|
|
/blackroad-universe/prompts/ @alexa-amundson @prompt-team
|
|
|
|
# ==============================================================================
|
|
# STANDARD OPERATING PROCEDURES
|
|
# ==============================================================================
|
|
|
|
/sop/ @alexa-amundson @ops-team
|
|
|
|
# ==============================================================================
|
|
# IMPLEMENTATION PLANS
|
|
# ==============================================================================
|
|
|
|
/implementation-plans/ @alexa-amundson
|
|
|
|
# ==============================================================================
|
|
# TEAM ALIASES (for reference — not enforced by GitHub unless org teams exist)
|
|
# ==============================================================================
|
|
#
|
|
# @alexa-amundson — Primary operator, final authority on all changes
|
|
# @backend-team — Backend engineers (alias for automation)
|
|
# @frontend-team — Frontend engineers (alias for automation)
|
|
# @agent-team — AI agent developers (alias for automation)
|
|
# @infra-team — Infrastructure engineers (alias for automation)
|
|
# @ops-team — Operations team (alias for automation)
|
|
# @sdk-team — SDK developers (alias for automation)
|
|
# @docs-team — Documentation writers (alias for automation)
|
|
# @prism-team — Prism Console developers (alias for automation)
|
|
# @operator-team — Operator Engine developers (alias for automation)
|
|
# @research-team — Research team (alias for automation)
|
|
# @brand-team — Brand and marketing (alias for automation)
|
|
# @prompt-team — Prompt engineers (alias for automation)
|
|
# @test-bot — Auto-approval bot for test-only PRs
|
|
# @docs-bot — Auto-approval bot for docs-only PRs
|
|
#
|
|
# NOTE: Some team aliases may not be real GitHub teams. They serve as semantic
|
|
# indicators for ownership and automation rules. Auto-approval bots are
|
|
# implemented via GitHub Actions, not actual bot accounts.
|
|
#
|
|
# ==============================================================================
|
|
# BlackRoad OS Code Owners
|
|
#
|
|
# This file defines who is responsible for code in this repository.
|
|
# Each line is a file pattern followed by one or more owners.
|
|
#
|
|
# Ownership hierarchy:
|
|
# 1. Human maintainers (primary approval authority)
|
|
# 2. AI automation teams (can auto-approve safe changes)
|
|
# 3. Specialized reviewers (domain experts)
|
|
#
|
|
# AI teams are GitHub teams that can auto-merge specific types of PRs:
|
|
# - @blackboxprogramming/claude-auto - Claude AI automated changes
|
|
# - @blackboxprogramming/atlas-auto - Atlas AI automated changes
|
|
# - @blackboxprogramming/docs-auto - Documentation-only changes
|
|
# - @blackboxprogramming/test-auto - Test-only changes
|
|
|
|
# ============================================================================
|
|
# GLOBAL OWNERSHIP
|
|
# ============================================================================
|
|
|
|
# All files require approval from primary maintainer
|
|
* @alexa-amundson
|
|
|
|
# ============================================================================
|
|
# BACKEND & API
|
|
# ============================================================================
|
|
|
|
# FastAPI Backend
|
|
/backend/ @alexa-amundson
|
|
/backend/app/ @alexa-amundson
|
|
/backend/requirements.txt @alexa-amundson
|
|
/backend/Dockerfile @alexa-amundson
|
|
|
|
# Backend tests can be auto-merged by AI
|
|
/backend/tests/ @alexa-amundson @blackboxprogramming/test-auto
|
|
/backend/pytest.ini @alexa-amundson @blackboxprogramming/test-auto
|
|
|
|
# ============================================================================
|
|
# FRONTEND & OS
|
|
# ============================================================================
|
|
|
|
# OS Interface (canonical)
|
|
/backend/static/ @alexa-amundson
|
|
|
|
# Legacy standalone UI (deprecated, needs migration)
|
|
/blackroad-os/ @alexa-amundson
|
|
|
|
# ============================================================================
|
|
# OPERATOR ENGINE & AUTOMATION
|
|
# ============================================================================
|
|
|
|
# Operator Engine (PR automation, merge queue)
|
|
/operator_engine/ @alexa-amundson
|
|
/operator_engine/**/*.py @alexa-amundson
|
|
|
|
# Prism Console (merge dashboard)
|
|
/prism-console/ @alexa-amundson
|
|
|
|
# ============================================================================
|
|
# INFRASTRUCTURE & DEVOPS
|
|
# ============================================================================
|
|
|
|
# GitHub Actions & Workflows (critical - no auto-merge)
|
|
/.github/workflows/ @alexa-amundson
|
|
|
|
# GitHub Configuration
|
|
/.github/ @alexa-amundson
|
|
/.github/CODEOWNERS @alexa-amundson
|
|
/.github/dependabot.yml @alexa-amundson @blackboxprogramming/claude-auto
|
|
/.github/labeler.yml @alexa-amundson @blackboxprogramming/claude-auto
|
|
/.github/merge_queue.yml @alexa-amundson
|
|
|
|
# Infrastructure scripts
|
|
/scripts/ @alexa-amundson
|
|
/ops/ @alexa-amundson
|
|
/infra/ @alexa-amundson
|
|
|
|
# Railway deployment (critical - no auto-merge)
|
|
railway.toml @alexa-amundson
|
|
railway.json @alexa-amundson
|
|
|
|
# Docker
|
|
docker-compose.yml @alexa-amundson
|
|
/backend/docker-compose.yml @alexa-amundson
|
|
|
|
# ============================================================================
|
|
# DOCUMENTATION
|
|
# ============================================================================
|
|
|
|
# Core documentation (safe for auto-merge)
|
|
/docs/ @alexa-amundson @blackboxprogramming/docs-auto
|
|
/README.md @alexa-amundson @blackboxprogramming/docs-auto
|
|
/*.md @alexa-amundson @blackboxprogramming/docs-auto
|
|
|
|
# Implementation plans (AI-generated, can auto-merge)
|
|
/implementation-plans/ @alexa-amundson @blackboxprogramming/claude-auto
|
|
|
|
# ============================================================================
|
|
# SDKs
|
|
# ============================================================================
|
|
|
|
# Python SDK
|
|
/sdk/python/ @alexa-amundson
|
|
/sdk/python/tests/ @alexa-amundson @blackboxprogramming/test-auto
|
|
|
|
# TypeScript SDK
|
|
/sdk/typescript/ @alexa-amundson
|
|
/sdk/typescript/tests/ @alexa-amundson @blackboxprogramming/test-auto
|
|
|
|
# ============================================================================
|
|
# AGENTS & AI
|
|
# ============================================================================
|
|
|
|
# AI Agents (can be auto-merged by Claude)
|
|
/agents/ @alexa-amundson @blackboxprogramming/claude-auto
|
|
/agents/tests/ @alexa-amundson @blackboxprogramming/test-auto
|
|
|
|
# Prompts & Templates
|
|
/blackroad-universe/prompts/ @alexa-amundson @blackboxprogramming/claude-auto
|
|
|
|
# Cognitive Research
|
|
/cognitive/ @alexa-amundson
|
|
|
|
# ============================================================================
|
|
# BRANDING & BUSINESS
|
|
# ============================================================================
|
|
|
|
# BlackRoad Universe (brand, GTM, domains)
|
|
/blackroad-universe/ @alexa-amundson
|
|
|
|
# SOP (Standard Operating Procedures)
|
|
/sop/ @alexa-amundson @blackboxprogramming/docs-auto
|
|
|
|
# ============================================================================
|
|
# SPECIAL FILES
|
|
# ============================================================================
|
|
|
|
# Security-sensitive files (no auto-merge ever)
|
|
.env.example @alexa-amundson
|
|
backend/.env.example @alexa-amundson
|
|
SECURITY.md @alexa-amundson
|
|
|
|
# License
|
|
LICENSE @alexa-amundson
|
|
|
|
# Git configuration
|
|
.gitignore @alexa-amundson @blackboxprogramming/claude-auto
|