role-os 1.0.0

package/README.it.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+# Role OS
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/role-os"><img src="https://img.shields.io/npm/v/@mcptoolshop/role-os" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
+</p>
+
+Un livello operativo portatile e integrato che indirizza il lavoro attraverso contratti di ruolo, pacchetti strutturati, revisioni e escalation, in modo che i team possano svolgere attività di sviluppo funzionalità, integrazione, correzione di identità e gestione completa del repository, senza deviazioni, completamenti errati o affermazioni di avanzamento basate su impressioni.
+
+## Cosa fa
+
+Role OS previene i specifici errori che i flussi di lavoro AI generici producono:
+
+- **Deviazioni (Drift)**: i ruoli rimangono nel loro ambito. Il prodotto non viene ridisegnato. L'interfaccia utente non ridefinisce l'ambito. Il backend non inventa la direzione del prodotto.
+- **Completamenti errati (False completion)**: la definizione di "completato" è concreta. Il lavoro che nasconde lacune, omette verifiche o risolve un problema diverso viene rifiutato.
+- **Contaminazione (Contamination)**: i progetti derivati o ereditati contengono residui di identità. Role OS rileva e rifiuta le deviazioni cross-progetto in termini, elementi visivi e modelli mentali.
+- **Avanzamento basato su impressioni (Vibes-based progress)**: ogni passaggio è strutturato. Ogni decisione si basa su prove. "Sembra fatto" non è uno stato valido.
+
+## Come funziona
+
+1. **Crea un pacchetto**: definisci cosa deve esistere quando il lavoro è completato.
+2. **Indirizza attraverso una catena**: il più piccolo insieme di ruoli specializzati necessari.
+3. **Ogni ruolo produce un passaggio (handoff)**: un output strutturato che riduce l'ambiguità per il ruolo successivo.
+4. **Il revisore valuta rispetto al contratto**: accetta, rifiuta o blocca in base alle prove, non alle impressioni.
+
+## Memoria e continuità
+
+Role OS non possiede né duplica il livello di memoria. Quando esiste la memoria del progetto Claude, questa è il sistema di continuità canonico: i fatti del repository, le decisioni, i problemi aperti e la cronologia delle modifiche sono memorizzati lì.
+
+Role OS si integra con la memoria del progetto Claude. Non la sostituisce.
+
+## Elaborazione completa e controllo di qualità
+
+L'elaborazione completa è un protocollo canonico di 7 fasi definito nella memoria del progetto Claude (`memory/full-treatment.md`). Role OS indirizza e valuta le elaborazioni utilizzando contratti di ruolo, passaggi e controlli, ma non ridefinisce il protocollo.
+
+Il **controllo di qualità (shipcheck)** è il sistema di controllo di 31 elementi che viene eseguito prima dell'elaborazione completa. I controlli obbligatori A-D devono essere superati prima che qualsiasi elaborazione possa iniziare. Riferimento canonico: `memory/shipcheck.md`.
+
+Ordine: controllo di qualità, quindi elaborazione completa. Nessuna versione 1.0.0 senza aver superato i controlli obbligatori.
+
+## 32 ruoli in 8 pacchetti
+
+| Pacchetto | Ruoli |
+|------|-------|
+| **Core** (3) | Orchestratore, Product Strategist, Recensore |
+| **Engineering** (7) | Sviluppatore Frontend, Ingegnere Backend, Ingegnere di Test, Ingegnere di Refactoring, Ingegnere delle Prestazioni, Revisore delle Dipendenze, Revisore di Sicurezza |
+| **Design** (2) | UI Designer, Responsabile del Brand |
+| **Marketing** (1) | Copywriter per il lancio |
+| **Treatment** (7) | Ricercatore di Repository, Traduttore di Repository, Architetto della Documentazione, Curatore dei Metadati, Revisore della Copertura, Verificatore del Deployment, Ingegnere del Rilascio |
+| **Product** (4) | Sintetizzatore di Feedback, Prioritizzatore della Roadmap, Redattore di Specifiche, Architetto dell'Informazione |
+| **Research** (4) | Ricercatore UX, Analista della Concorrenza, Ricercatore di Tendenze, Sintetizzatore di Interviste con gli Utenti |
+| **Growth** (4) | Strategista per il lancio, Strategista dei Contenuti, Community Manager, Responsabile del Supporto |
+
+Ogni ruolo ha un contratto completo: missione, quando utilizzare, quando non utilizzare, input previsti, output richiesti, standard di qualità e trigger di escalation.
+
+## Guida rapida
+
+```bash
+npx @mcptoolshop/role-os init
+
+# Fill context/ files for your project, then:
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+roleos status
+```
+
+## Quando non utilizzare Role OS
+
+- Correzioni di una sola riga, errori di battitura o bug evidenti
+- Ricerche esplorative senza un output definito
+- Lavori che possono essere completati nella mente di una persona in 5 minuti
+- Correzioni urgenti che devono essere rilasciate prima che la catena di revisione sia completa
+- Progetti in cui si privilegia la velocità rispetto alla struttura
+
+## Prove
+
+Role OS è stato testato in tre scenari diversi in due repository strutturalmente diversi:
+
+**Test 001 — Sviluppo funzionalità** (Schermata Crew, Star Freight)
+- Catena di 7 ruoli, 45 scenari di test, 0 conflitti di ruolo.
+- Ha prevenuto la contaminazione da un progetto antenato, ha rilevato modifiche non autorizzate e ha evidenziato i blocchi reali.
+
+**Test 002 — Integrazione** (Collegamento CampaignState, Star Freight)
+- Catena di 5 ruoli, ha risolto la connessione architetturale senza soluzioni di ripiego.
+- I test anti-fallback hanno dimostrato che il percorso attivo è reale, non un segnaposto.
+
+**Test 003 — Correzione di identità** (Pulizia della contaminazione, Star Freight)
+- Catena di 6 ruoli, 51 scenari di test, inclusa la difesa duratura contro la contaminazione del sistema di integrazione continua.
+- Ha corretto le incongruenze ereditate senza dover rifare completamente il progetto.
+
+**Prova di portabilità** (Coerenza della persona, sensibilità al contesto)
+- Stessa struttura di base, ma con linguaggio/ambito/stack diversi.
+- Adattamento solo al contesto, senza modifiche al contratto principale.
+
+**Trattamento completo FT-001** (portlight-desktop)
+- Trattamento con personale dedicato in 7 fasi, con ruoli del pacchetto di trattamento
+- Controllo di spedizione dimostrato, zero conflitti tra ruoli
+
+**Trattamento completo FT-002** (studioflow)
+- Stesso pacchetto di trattamento, repository strutturalmente diverso (spazio di lavoro creativo vs gioco)
+- Pacchetto di trattamento portatile: non sono necessarie modifiche al contratto
+
+## Proprietà fondamentali
+
+Queste sono non negoziabili. Se una modifica ne indebolisce una, rifiutarla.
+
+- I confini dei ruoli rimangono validi.
+- La revisione è efficace.
+- L'escalation rimane trasparente.
+- I pacchetti rimangono testabili.
+- La portabilità richiede adattamento al contesto, non modifiche radicali.
+
+## Struttura del progetto
+
+```
+role-os/
+  README.md                    ← You are here
+  bin/roleos.mjs               ← CLI entrypoint
+  src/                         ← CLI implementation
+  starter-pack/
+    handbook.md                ← How Role OS works
+    context/                   ← Fill these for your repo
+    examples/                  ← Feature, integration, identity packets
+    agents/                    ← 32 role contracts across 8 packs
+    schemas/                   ← Packet, handoff, verdict formats
+    policy/                    ← Routing, permissions, escalation, done
+    workflows/                 ← Ship feature, fix bug, launch update, full treatment
+```
+
+## Sicurezza
+
+Il sistema operativo del ruolo opera **solo localmente**. Copia i modelli Markdown e scrive i file dei pacchetti/verdetto nella directory `.claude/` del tuo repository. Non accede alla rete, non gestisce segreti e non raccoglie dati di telemetria. Nessuna operazione pericolosa: tutte le scritture di file utilizzano la funzione "skip-if-exists" per impostazione predefinita. Consultare il file [SECURITY.md](SECURITY.md) per la politica completa.
+
+## Stato
+
+**v1.0.0 — Superficie ampia, stesse regole**
+
+- v0.1: Operativo — 3 prove, 3 accettazioni, 0 conflitti tra ruoli
+- v0.2: Adozione — flusso di lavoro predefinito nel repository principale, portabile in un secondo repository
+- v0.3: Prodotto — pacchetto di avvio, CLI di bootstrap, superficie di prova
+- v0.4: Pacchetto di trattamento — 8 ruoli di trattamento/identità, trattamento completo con personale dedicato, portabile tra 2 repository
+- v1.0.0: 32 ruoli in 8 pacchetti, CLI completa, trattamento dimostrato, portabilità multi-repository
+
+## Licenza
+
+MIT
+
+---
+
+Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a

package/README.ja.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+# Role OS
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/role-os"><img src="https://img.shields.io/npm/v/@mcptoolshop/role-os" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
+</p>
+
+Role OSは、役割契約、構造化されたデータパケット、レビュー、エスカレーションを通じて作業を管理する、移植可能でリポジトリに統合されたオペレーティングレイヤーです。これにより、チームは、ドリフト、誤った完了、または主観的な進捗報告なしに、機能開発、統合、ID修正、およびリポジトリ全体の管理を行うことができます。
+
+## Role OSの機能
+
+Role OSは、一般的なAIワークフローで発生する特定の課題を解決します。
+
+- **ドリフト（逸脱）**: 各役割は、自身の担当範囲にとどまります。製品の再設計、フロントエンドのスコープ変更、バックエンドの製品方向性の変更を防ぎます。
+- **誤った完了**: 完了の定義は明確です。不備を隠したり、検証を省略したり、別の問題を解決したりする作業は却下されます。
+- **汚染**: 分岐または継承されたプロジェクトには、元のプロジェクトの要素が残存する可能性があります。Role OSは、用語、ビジュアル、および思考モデルにおけるプロジェクト間の逸脱を検出し、却下します。
+- **主観的な進捗**: すべての手渡し作業は構造化されています。すべての判断は、証拠に基づいています。「完了したように感じる」という主観的な判断は認められません。
+
+## Role OSの仕組み
+
+1. **データパケットの作成**: 作業が完了したときに必要な要素を定義します。
+2. **役割チェーンによるルーティング**: 必要な専門的な役割の最小限のセットで作業をルーティングします。
+3. **各役割による手渡し**: 次の役割が理解しやすいように、構造化された出力を提供します。
+4. **レビュー担当者による契約との照合**: 証拠に基づいて、作業を承認、却下、または保留とします。主観的な判断は行いません。
+
+## メモリと継続性
+
+Role OSは、メモリレイヤーを所有または複製しません。Claudeプロジェクトのメモリが存在する場合、それが標準的な継続性システムです。リポジトリの情報、決定事項、未解決の問題、および処理履歴は、そこに保存されます。
+
+Role OSは、Claudeプロジェクトのメモリと連携します。置き換えるものではありません。
+
+## 完全な処理と品質チェック
+
+完全な処理は、Claudeプロジェクトのメモリ (`memory/full-treatment.md`) に定義された、7段階の標準的なプロセスです。Role OSは、役割契約、手渡し、およびレビューゲートを使用して、処理をルーティングおよびレビューします。このプロセスを再定義するものではありません。
+
+**品質チェック**は、完全な処理の前に実行される、31項目の品質ゲートです。完全な処理を開始する前に、AからDまでの必須ゲートをすべて通過する必要があります。参照先: `memory/shipcheck.md`.
+
+順序: 品質チェックを最初に実行し、次に完全な処理を行います。必須ゲートをすべて通過しない限り、バージョン1.0.0をリリースできません。
+
+## 32の役割、8つのパッケージに分類
+
+| パッケージ | 役割 |
+|------|-------|
+| **Core** (3) | オーケストレーター、プロダクトストラテジスト、レビュー担当者 |
+| **Engineering** (7) | フロントエンド開発者、バックエンドエンジニア、テストエンジニア、リファクタリングエンジニア、パフォーマンスエンジニア、依存関係監査担当者、セキュリティレビュー担当者 |
+| **Design** (2) | UIデザイナー、ブランド担当者 |
+| **Marketing** (1) | ローンチコピーライター |
+| **Treatment** (7) | リポジトリ研究者、リポジトリ翻訳者、ドキュメントアーキテクト、メタデータキュレーター、カバレッジ監査担当者、デプロイ検証担当者、リリースエンジニア |
+| **Product** (4) | フィードバック合成担当者、ロードマップ優先順位担当者、仕様書作成者、情報アーキテクト |
+| **Research** (4) | UXリサーチャー、競合分析担当者、トレンドリサーチャー、ユーザーインタビュー合成担当者 |
+| **Growth** (4) | ローンチストラテジスト、コンテンツストラテジスト、コミュニティマネージャー、サポートトリアージリーダー |
+
+各役割には、ミッション、使用するタイミング、使用しないタイミング、期待される入力、必要な出力、品質基準、およびエスカレーション条件が詳細に記載されています。
+
+## クイックスタート
+
+```bash
+npx @mcptoolshop/role-os init
+
+# Fill context/ files for your project, then:
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+roleos status
+```
+
+## Role OSを使用しない場合
+
+- 単一行の修正、タイプミス、または明白なバグ
+- 明確な出力がない探索的な調査
+- 5分で1人の担当者が完了できる作業
+- レビュープロセスが完了する前にリリースする必要がある緊急の修正
+- 速度を重視し、構造を後回しにしたいプロジェクト
+
+## 検証
+
+Role OSは、構造が異なる2つのリポジトリで、3つの異なるテストケースで検証されました。
+
+**テストケース001 — 機能開発** (Crew Screen, Star Freight)
+- 7つの役割チェーン、45のテストシナリオ、役割の衝突は0件。
+- 分岐元のプロジェクトからの汚染を防ぎ、意図しない変更を検出し、問題点を明確にしました。
+
+**テストケース002 — 統合** (CampaignState wiring, Star Freight)
+- 5つの役割チェーン、フォールバックによる問題を解決しました。
+- フォールバックテストにより、実際に動作するパスが存在することを確認しました。
+
+**テストケース003 — ID管理** (Contamination purge, Star Freight)
+- 6つの役割チェーン、耐久性のあるCIによる汚染防御を含む、51のテストシナリオ。
+- 継承された不整合を修正し、大規模な再設計を回避しました。
+
+**移植性テスト** (Personaの一貫性、センサーの挙動)
+- 同じ基本構造を持ちながら、異なる言語、ドメイン、技術スタックを使用
+- コンテキストの変更のみで導入可能。コアとなる契約の変更は行わない。
+
+**フルトリートメント FT-001** (portlight-desktop)
+- 7段階の担当者配置によるトリートメント。トリートメントパッケージの役割を使用。
+- 品質チェックが確立されており、役割の競合はゼロ。
+
+**フルトリートメント FT-002** (studioflow)
+- 同じトリートメントパッケージを使用。構造は異なり、リポジトリの内容も異なる（クリエイティブワークスペース vs ゲーム）。
+- トリートメントパッケージは移植可能。契約の変更は不要。
+
+## 主要な特性
+
+これらは変更できません。変更によってこれらのいずれかが弱体化する場合は、却下してください。
+
+- ロールの境界が維持される
+- レビューは厳格である
+- エスカレーションは誠実に行われる
+- テスト可能な状態が維持される
+- 移植性は、コア部分の変更ではなく、コンテキストへの適応が必要
+
+## プロジェクト構造
+
+```
+role-os/
+  README.md                    ← You are here
+  bin/roleos.mjs               ← CLI entrypoint
+  src/                         ← CLI implementation
+  starter-pack/
+    handbook.md                ← How Role OS works
+    context/                   ← Fill these for your repo
+    examples/                  ← Feature, integration, identity packets
+    agents/                    ← 32 role contracts across 8 packs
+    schemas/                   ← Packet, handoff, verdict formats
+    policy/                    ← Routing, permissions, escalation, done
+    workflows/                 ← Ship feature, fix bug, launch update, full treatment
+```
+
+## セキュリティ
+
+Role OSは、**ローカルでのみ**動作します。Markdownテンプレートをコピーし、パケット/判定ファイルを、あなたのリポジトリの`.claude/`ディレクトリに書き込みます。ネットワークへのアクセス、機密情報の取り扱い、テレメトリーの収集は行いません。危険な操作は一切行いません。すべてのファイル書き込みは、デフォルトでファイルが存在する場合はスキップします。詳細については、[SECURITY.md](SECURITY.md) を参照してください。
+
+## ステータス
+
+**v1.0.0 — 基本構造は同じ**
+
+- v0.1: 運用開始 — 3回のトライアル、3回の承認、役割の競合はゼロ。
+- v0.2: 導入 — メインリポジトリでのデフォルトワークフロー。別のリポジトリへの移植も可能。
+- v0.3: 製品化 — スターターパック、ブートストラップCLI、検証可能な成果物。
+- v0.4: トリートメントパッケージ — 8つのトリートメント/アイデンティティの役割。担当者配置によるフルトリートメント。2つのリポジトリ間で移植可能。
+- v1.0.0: 32の役割、8つのパッケージ。フルCLI、実績のあるトリートメント、マルチリポジトリでの移植性。
+
+## ライセンス
+
+MIT
+
+---
+
+作成者: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+# Role OS
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/role-os"><img src="https://img.shields.io/npm/v/role-os" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
+</p>
+
+A portable, repo-native operating layer that routes work through role contracts, structured packets, review, and escalation so teams can do feature work, integration work, identity repair, and full repo treatment without drift, false completion, or vibes-based progress claims.
+
+## What it does
+
+Role OS prevents the specific failures that generic AI workflows produce:
+
+- **Drift** — roles stay in lane. Product doesn't redesign. Frontend doesn't redefine scope. Backend doesn't invent product direction.
+- **False completion** — the done definition is concrete. Work that hides gaps, skips verification, or solves a different problem gets rejected.
+- **Contamination** — forked or inherited projects carry identity residue. Role OS detects and rejects cross-project drift in terminology, visuals, and mental models.
+- **Vibes-based progress** — every handoff is structured. Every verdict ties to evidence. "It feels done" is not a valid state.
+
+## How it works
+
+1. **Create a packet** — define what needs to exist when the work is done
+2. **Route through a chain** — the smallest set of specialized roles needed
+3. **Each role produces a handoff** — structured output that reduces ambiguity for the next role
+4. **Critic reviews against contract** — accepts, rejects, or blocks based on evidence, not impression
+
+## Memory and continuity
+
+Role OS does not own or duplicate the memory layer. Where Claude project memory exists, it is the canonical continuity system — repo facts, decisions, open loops, and treatment history live there.
+
+Role OS integrates with Claude project memory. It does not replace it.
+
+## Full treatment and shipcheck
+
+Full treatment is a canonical 7-phase protocol defined in Claude project memory (`memory/full-treatment.md`). Role OS routes and reviews treatments using role contracts, handoffs, and critic gates — it does not redefine the protocol.
+
+**Shipcheck** is the 31-item quality gate that runs before full treatment. Hard gates A-D must pass before any treatment begins. Canonical reference: `memory/shipcheck.md`.
+
+Order: Shipcheck first, then full treatment. No v1.0.0 without passing hard gates.
+
+## 32 roles across 8 packs
+
+| Pack | Roles |
+|------|-------|
+| **Core** (3) | Orchestrator, Product Strategist, Critic Reviewer |
+| **Engineering** (7) | Frontend Developer, Backend Engineer, Test Engineer, Refactor Engineer, Performance Engineer, Dependency Auditor, Security Reviewer |
+| **Design** (2) | UI Designer, Brand Guardian |
+| **Marketing** (1) | Launch Copywriter |
+| **Treatment** (7) | Repo Researcher, Repo Translator, Docs Architect, Metadata Curator, Coverage Auditor, Deployment Verifier, Release Engineer |
+| **Product** (4) | Feedback Synthesizer, Roadmap Prioritizer, Spec Writer, Information Architect |
+| **Research** (4) | UX Researcher, Competitive Analyst, Trend Researcher, User Interview Synthesizer |
+| **Growth** (4) | Launch Strategist, Content Strategist, Community Manager, Support Triage Lead |
+
+Every role has a full contract: mission, use when, do not use when, expected inputs, required outputs, quality bar, and escalation triggers.
+
+## Quick start
+
+```bash
+npx role-os init
+
+# Fill context/ files for your project, then:
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+roleos status
+```
+
+## When not to use Role OS
+
+- Single-line fixes, typos, or obvious bugs
+- Exploratory research with no defined output
+- Work that fits in one person's head in 5 minutes
+- Emergency hotfixes that need to ship before a review chain completes
+- Projects where you want speed over structure
+
+## Evidence
+
+Role OS was proven across three trial shapes in two structurally different repos:
+
+**Trial 001 — Feature work** (Crew Screen, Star Freight)
+- 7-role chain, 45 test scenarios, 0 role collisions
+- Prevented contamination from fork ancestor, caught inline invention, surfaced honest blockers
+
+**Trial 002 — Integration work** (CampaignState wiring, Star Freight)
+- 5-role chain, resolved architectural seam without fallback lies
+- Anti-fallback tests proved the live path is real, not placeholder
+
+**Trial 003 — Identity work** (Contamination purge, Star Freight)
+- 6-role chain, 51 test scenarios including durable CI contamination defense
+- Repaired inherited fiction drift without collapsing into broad redesign
+
+**Portability trial** (Persona consistency, sensor-humor)
+- Same spine, different language/domain/stack
+- Adopted with context changes only — no core contract modifications
+
+**Full treatment FT-001** (portlight-desktop)
+- 7-phase staffed treatment with Treatment Pack roles
+- Shipcheck gating proven, zero role collisions
+
+**Full treatment FT-002** (studioflow)
+- Same treatment pack, structurally different repo (creative workspace vs game)
+- Treatment Pack portable — no contract modifications needed
+
+## Core properties
+
+These are non-negotiable. If a change weakens any of them, reject it.
+
+- Role boundaries hold
+- Review has teeth
+- Escalation stays honest
+- Packets stay testable
+- Portability requires context adaptation, not core surgery
+
+## Project structure
+
+```
+role-os/
+  README.md                    ← You are here
+  bin/roleos.mjs               ← CLI entrypoint
+  src/                         ← CLI implementation
+  starter-pack/
+    handbook.md                ← How Role OS works
+    context/                   ← Fill these for your repo
+    examples/                  ← Feature, integration, identity packets
+    agents/                    ← 32 role contracts across 8 packs
+    schemas/                   ← Packet, handoff, verdict formats
+    policy/                    ← Routing, permissions, escalation, done
+    workflows/                 ← Ship feature, fix bug, launch update, full treatment
+```
+
+## Security
+
+Role OS operates **locally only**. It copies markdown templates and writes packet/verdict files to your repository's `.claude/` directory. It does not access the network, handle secrets, or collect telemetry. No dangerous operations — all file writes use skip-if-exists by default. See [SECURITY.md](SECURITY.md) for the full policy.
+
+## Status
+
+**v1.0.0 — Broad Surface, Same Laws**
+
+- v0.1: Operational — 3 trials, 3 accepts, 0 role collisions
+- v0.2: Adoption — default workflow in anchor repo, portable to second repo
+- v0.3: Productization — starter pack, bootstrap CLI, evidence surface
+- v0.4: Treatment Pack — 8 treatment/identity roles, full treatment staffed, portable across 2 repos
+- v1.0.0: 32 roles across 8 packs, full CLI, proven treatment, multi-repo portability
+
+## License
+
+MIT
+
+---
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.pt-BR.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.md">English</a>
+</p>
+
+# Role OS
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/role-os"><img src="https://img.shields.io/npm/v/@mcptoolshop/role-os" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
+</p>
+
+Uma camada de sistema operacional portátil e nativa do repositório que direciona o trabalho através de contratos de função, pacotes estruturados, revisões e escalonamento, para que as equipes possam realizar trabalhos de funcionalidade, integração, correção de identidade e tratamento completo do repositório, sem desvios, conclusão falsa ou alegações de progresso baseadas em impressões.
+
+## O que ele faz
+
+O Role OS previne as falhas específicas que os fluxos de trabalho de IA genéricos produzem:
+
+- **Desvio (Drift)** — as funções permanecem em seu domínio. O produto não é redesenhado. A interface não redefine o escopo. O backend não inventa a direção do produto.
+- **Conclusão falsa** — a definição de "concluído" é concreta. O trabalho que esconde lacunas, ignora a verificação ou resolve um problema diferente é rejeitado.
+- **Contaminação** — projetos bifurcados ou herdados carregam resíduos de identidade. O Role OS detecta e rejeita desvios entre projetos em termos, visuais e modelos mentais.
+- **Progresso baseado em impressões** — cada transferência é estruturada. Cada veredicto está vinculado a evidências. "Parece pronto" não é um estado válido.
+
+## Como funciona
+
+1. **Crie um pacote** — defina o que deve existir quando o trabalho estiver concluído.
+2. **Direcione através de uma cadeia** — o menor conjunto de funções especializadas necessárias.
+3. **Cada função produz uma transferência** — uma saída estruturada que reduz a ambiguidade para a próxima função.
+4. **O revisor avalia em relação ao contrato** — aceita, rejeita ou bloqueia com base em evidências, não em impressões.
+
+## Memória e continuidade
+
+O Role OS não possui nem duplica a camada de memória. Onde a memória do projeto Claude existe, ela é o sistema de continuidade canônico — os fatos do repositório, decisões, lacunas abertas e histórico de tratamento residem lá.
+
+O Role OS se integra com a memória do projeto Claude. Ele não a substitui.
+
+## Tratamento completo e verificação de envio
+
+O tratamento completo é um protocolo canônico de 7 fases definido na memória do projeto Claude (`memory/full-treatment.md`). O Role OS direciona e revisa os tratamentos usando contratos de função, transferências e portas de revisão — ele não redefine o protocolo.
+
+A **verificação de envio (Shipcheck)** é a porta de qualidade de 31 itens que é executada antes do tratamento completo. As portas rígidas A a D devem ser aprovadas antes que qualquer tratamento comece. Referência canônica: `memory/shipcheck.md`.
+
+Ordem: Verificação de envio primeiro, depois tratamento completo. Não há v1.0.0 sem a aprovação das portas rígidas.
+
+## 32 funções em 8 pacotes
+
+| Pacote | Funções |
+|------|-------|
+| **Core** (3) | Coordenador, Estrategista de Produto, Avaliador Crítico |
+| **Engineering** (7) | Desenvolvedor Front-end, Engenheiro Back-end, Engenheiro de Testes, Engenheiro de Refatoração, Engenheiro de Desempenho, Auditor de Dependências, Avaliador de Segurança |
+| **Design** (2) | Designer de Interface, Guardião da Marca |
+| **Marketing** (1) | Redator para Lançamento |
+| **Treatment** (7) | Pesquisador de Repositórios, Tradutor de Repositórios, Arquiteto de Documentação, Curador de Metadados, Auditor de Cobertura, Verificador de Implantação, Engenheiro de Lançamento |
+| **Product** (4) | Sintetizador de Feedback, Priorizador de Roteiro, Redator de Especificações, Arquiteto de Informação |
+| **Research** (4) | Pesquisador de Experiência do Usuário, Analista da Concorrência, Pesquisador de Tendências, Sintetizador de Entrevistas com Usuários |
+| **Growth** (4) | Estrategista de Lançamento, Estrategista de Conteúdo, Gerente de Comunidade, Líder de Triagem de Suporte |
+
+Cada função possui um contrato completo: missão, quando usar, quando não usar, entradas esperadas, saídas necessárias, padrão de qualidade e gatilhos de escalonamento.
+
+## Como começar
+
+```bash
+npx @mcptoolshop/role-os init
+
+# Fill context/ files for your project, then:
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+roleos status
+```
+
+## Quando não usar o Role OS
+
+- Correções simples, erros de digitação ou bugs óbvios
+- Pesquisa exploratória sem saída definida
+- Trabalho que cabe na cabeça de uma pessoa em 5 minutos
+- Correções emergenciais que precisam ser lançadas antes que a cadeia de revisão seja concluída
+- Projetos onde a velocidade é mais importante que a estrutura
+
+## Evidências
+
+O Role OS foi comprovado em três modelos de teste em dois repositórios estruturalmente diferentes:
+
+**Teste 001 — Trabalho de funcionalidade** (Tela da Equipe, Star Freight)
+- Cadeia de 7 funções, 45 cenários de teste, 0 conflito de funções.
+- Preveniu a contaminação de um ancestral bifurcado, detectou invenções inline e revelou bloqueios reais.
+
+**Teste 002 — Trabalho de integração** (Conexão do Estado da Campanha, Star Freight)
+- Cadeia de 5 funções, resolveu a junção arquitetural sem mentiras de fallback.
+- Testes anti-fallback provaram que o caminho ativo é real, não um espaço reservado.
+
+**Teste 003 — Trabalho de identidade** (Remoção de contaminação, Star Freight)
+- Cadeia de 6 funções, 51 cenários de teste, incluindo defesa durável contra contaminação do CI.
+- Corrigiu a derivação de ficção herdada sem reverter para uma grande reformulação.
+
+**Teste de portabilidade** (Consistência da persona, sensibilidade aos sensores)
+- Mesma estrutura básica, diferentes idiomas/domínios/pilhas de tecnologias.
+- Adaptado apenas com mudanças de contexto — sem modificações no contrato principal.
+
+**Tratamento Completo FT-001** (portlight-desktop)
+- Tratamento completo em 7 fases, com funções do Pacote de Tratamento
+- Verificação de lançamento comprovada, sem colisões de funções
+
+**Tratamento Completo FT-002** (studioflow)
+- Mesmo pacote de tratamento, repositório estruturalmente diferente (ambiente de criação vs. jogo)
+- Pacote de tratamento portátil — nenhuma modificação no contrato é necessária
+
+## Propriedades essenciais
+
+Estas são inegociáveis. Se uma alteração enfraquecer qualquer uma delas, rejeite-a.
+
+- Os limites de função são mantidos.
+- A revisão é rigorosa.
+- A escalação permanece transparente.
+- Os pacotes permanecem testáveis.
+- A portabilidade requer adaptação ao contexto, não alterações profundas na estrutura.
+
+## Estrutura do projeto
+
+```
+role-os/
+  README.md                    ← You are here
+  bin/roleos.mjs               ← CLI entrypoint
+  src/                         ← CLI implementation
+  starter-pack/
+    handbook.md                ← How Role OS works
+    context/                   ← Fill these for your repo
+    examples/                  ← Feature, integration, identity packets
+    agents/                    ← 32 role contracts across 8 packs
+    schemas/                   ← Packet, handoff, verdict formats
+    policy/                    ← Routing, permissions, escalation, done
+    workflows/                 ← Ship feature, fix bug, launch update, full treatment
+```
+
+## Segurança
+
+O sistema "Role OS" opera **apenas localmente**. Ele copia modelos em formato Markdown e escreve arquivos de pacotes/resultados no diretório `.claude/` do seu repositório. Ele não acessa a rede, não lida com informações confidenciais e não coleta dados de telemetria. Não há operações perigosas — todas as operações de escrita de arquivos usam a opção "skip-if-exists" por padrão. Consulte o arquivo [SECURITY.md](SECURITY.md) para a política completa.
+
+## Status
+
+**v1.0.0 — Superfície Ampla, Mesmas Regras**
+
+- v0.1: Operacional — 3 testes, 3 aprovações, 0 colisões de funções
+- v0.2: Adoção — fluxo de trabalho padrão no repositório principal, portátil para o segundo repositório
+- v0.3: Produto — pacote inicial, CLI de inicialização, superfície de evidências
+- v0.4: Pacote de Tratamento — 8 funções de tratamento/identidade, tratamento completo com equipe, portátil entre 2 repositórios
+- v1.0.0: 32 funções em 8 pacotes, CLI completa, tratamento comprovado, portabilidade multi-repositório
+
+## Licença
+
+MIT
+
+---
+
+Desenvolvido por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a