AI Project Context

One-line Architecture

Próx OS is an edge-first, Postgres-centered, AI-readable personal data sovereignty OS.

Product Identity

The project is not a traditional website.

It is a browser-based OS Shell that will eventually host personal apps, data views, dashboards, documents, automation surfaces, and community-provided apps.

Current Technical Direction

• Runtime and tool management: mise
• Package manager: pnpm
• Monorepo task runner: Turborepo
• Frontend shell: React + Rsbuild + Tailwind CSS
• UI primitives: packages/os-ui
• API: Hono + Cloudflare Workers
• Database: Neon PostgreSQL
• Schema management: Drizzle
• Human data admin: NocoDB or PostgreSQL-native alternatives
• Object storage target: Cloudflare R2 through S3-compatible abstraction
• Future AI integration: MCP server and AI-readable repo docs

Development Philosophy

This repository should evolve through small, reviewable, AI-assisted changes.

Language policy: Use English for all committed source and documentation except translation resources under apps/os-shell/src/i18n/languages/ (see AGENTS.md). Conversation with AI tools may be in any language.

The project should avoid both extremes:

• No waterfall-style overdesign before any product exists.
• No random AI-generated code without architecture boundaries.

Preferred workflow:

Document boundary
  -> generate small patch
  -> review diff
  -> run checks
  -> commit
  -> update docs when architecture changes

AI Collaboration Style

Agents should behave like careful maintainers, not autonomous product owners.

Agents may:

• Propose structure
• Generate small patches
• Explain tradeoffs
• Update documentation
• Refactor within clear boundaries

Agents must not:

• Add secrets
• Change production infrastructure
• Run destructive database operations
• Add unnecessary frameworks
• Collapse package boundaries
• Rewrite broad areas without explicit scope