2026-05-19 From Vibe Coding To Spec-driven Development

Vibe coding is valuable because it lowers the cost of trying ideas.

But Prox OS cannot rely on raw vibes alone. It is a browser OS shell, app runtime, future platform control plane, and AI-readable product system. That means each serious change needs a spec-shaped path:

Idea
-> mission brief
-> task graph
-> RFC or ADR when needed
-> scoped worker task
-> validation
-> integration report
-> release plan

What Should Start With Docs

• New app types.
• App contract changes.
• API or DB work.
• Auth, billing, permissions, or deployment.
• Shell/window manager behavior.
• Cross-package refactors.
• Growth or pricing experiments that could affect product claims.

Spec-driven development does not remove creativity. It gives creativity a way to survive contact with the repo.