mirror of
https://github.com/blackboxprogramming/BlackRoad-Operating-System.git
synced 2026-03-17 04:57:15 -05:00
Add OS spec, unification guide, and meta tooling
This commit is contained in:
Alexa Amundson
324
.github/CODEOWNERS
vendored
324
.github/CODEOWNERS
vendored
@@ -1,320 +1,8 @@
|
||||
# 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
|
||||
# Canonical code ownership for BlackRoad OS meta repository
|
||||
# Keep ownership broad and predictable; satellite repos may define finer rules.
|
||||
|
||||
# ==============================================================================
|
||||
# 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
|
||||
/docs/ @docs-team @alexa-amundson
|
||||
/os-spec/ @infra-team @alexa-amundson
|
||||
/tools/ @infra-team @alexa-amundson
|
||||
/.github/ @infra-team @alexa-amundson
|
||||
|
||||
Reference in New Issue
Block a user