v1.0.0

Role OS contracts over vibes.

A repo-native operating layer that prevents drift, false completion, and contamination through role contracts, structured handoffs, and truthful review.

Get started Read the Handbook

Install

npx @mcptoolshop/role-os init

Create

roleos packet new feature

Review

roleos review packet.md accept

What it prevents

The specific failures that generic AI workflows produce.

No drift

Roles stay in lane. Product does not redesign. Frontend does not redefine scope. Backend does not invent product direction.

No false completion

The done definition is concrete. Work that hides gaps, skips verification, or solves a different problem gets rejected.

No contamination

Forked or inherited projects carry identity residue. Role OS detects and rejects cross-project drift in terminology, visuals, and mental models.

Quick start

Bootstrap

npx @mcptoolshop/role-os init

# Fill context/ files for your project
# Then create your first packet

Feature packet

roleos packet new feature
roleos route packets/my-feature.md
# Work through the chain
roleos review packets/my-feature.md accept