AI-native Collaboration Model

Status

This is a governance and collaboration model. It does not grant repo access, create legal agreements, or authorize uncontrolled AI changes on main.

Day-to-day branch, worktree, PR, merge, and quality-gate rules live in OS Collaborative Development Model. This governance document defines accountability and role posture; the development document defines execution mechanics.

AI Agent Responsibilities

Future AI agent roles should be scoped so they do not overlap uncontrolled:

Agent	Responsibility
Backend Schema Agent	Draft tables, relations, and migration notes for review.
API Contract Agent	Draft OpenAPI, Hono route boundaries, and client contract notes.
Migration Review Agent	Inspect migration safety, rollback posture, and production risk.
OS Session Agent	Review auth/session, active Space/Desktop restore, and user preference flows.
Surface Registry Agent	Check runtime route, surface metadata, owner path, and Store path consistency.
Window Session QA Agent	Verify restore behavior does not store app data in window state.
Security Checklist Agent	Review access boundaries, secrets, auth, permissions, and audit expectations.
Docs Sync Agent	Update architecture, database, roadmap, and AI-readable indexes after changes.
Release Verification Agent	Run required checks, summarize failures, and prepare release notes.

Human maintainers own product judgment, access, accountability, and merge decisions. Agents draft, inspect, summarize, and verify.

High-intensity Sprint Mode

Use this for short, review-heavy bursts:

Daily objective.
One backend task.
One frontend task.
One docs or cleanup task.
Small pull requests.
Mandatory validation.
Mutual review.

Early Cofounder Reality Mode

Use this when the team is small and asynchronous:

Meeting every 2-3 days.
Async issue or task board.
One owner per branch.
AI-generated summaries.
No uncontrolled AI changes on main.
Backend schema changes always reviewed.

File Ownership

Area	Ownership posture
`apps/os-shell/src/window-manager`	Founder / frontend owner
`apps/os-shell/src/apps`	Founder with backend review
`apps/api-worker`	Backend partner
`packages/data/db`	Backend partner with founder review
`packages/contracts/app-contract`	Shared ownership
`docs/platform/architecture`	Founder with shared review
`docs/platform/db`	Backend partner
`docs/business` and `docs/go-to-market/how-prox-os-grows`	Founder