2026-05-19 AI-readable Product System

Prox OS should not be only a codebase. It should be an AI-readable product system.

That means an agent can inspect the repo and understand:

• What the product is.
• Which features exist today.
• Which ideas are planned or future concepts.
• Which package owns which boundary.
• Which task needs RFC or ADR.
• Which files an agent may edit.
• Which quality gates prove the work.

The Practical Impact

Docs are not a side quest. They are the context substrate for AI-assisted development.

In Prox OS, the core product system includes:

• AGENTS.md.
• Roadmaps.
• Architecture docs.
• App contract and app registry docs.
• ADRs and RFCs.
• Task graphs.
• Agent scopes.
• Run logs.
• Integration reports.
• Release plans.

Code remains the implementation artifact. The system around the code is what lets humans and agents keep understanding it.