role-os 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.0.0
+
+### Added
+- `roleos init` — scaffold Role OS starter pack into `.claude/`
+- `roleos packet new <type>` — create feature, integration, or identity packets
+- `roleos route <packet-file>` — recommend smallest valid role chain with dependency verification
+- `roleos review <packet-file> <verdict>` — record accept/reject/blocked verdicts
+- Full starter pack: 8 role contracts, 3 schemas, 4 policies, 3 workflows
+- Guided context templates with inline prompts
+- 3 canonical example packets (feature, integration, identity)
+- Adoption handbook

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</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>
+
+Una capa de sistema operativo portátil y nativa del repositorio que dirige el trabajo a través de contratos de roles, paquetes estructurados, revisiones y escalamientos, para que los equipos puedan realizar tareas de desarrollo de funciones, integración, corrección de identidad y tratamiento completo del repositorio, sin desviaciones, finalizaciones falsas ni afirmaciones de progreso basadas en impresiones subjetivas.
+
+## ¿Qué hace?
+
+Role OS previene las fallas específicas que producen los flujos de trabajo de IA genéricos:
+
+- **Desviación (Drift)**: Los roles se mantienen dentro de su ámbito. El producto no se rediseña. La interfaz de usuario no redefine el alcance. El backend no inventa la dirección del producto.
+- **Finalización falsa**: La definición de "hecho" es concreta. El trabajo que oculta deficiencias, omite la verificación o resuelve un problema diferente es rechazado.
+- **Contaminación**: Los proyectos bifurcados o heredados conservan residuos de identidad. Role OS detecta y rechaza las desviaciones entre proyectos en terminología, elementos visuales y modelos mentales.
+- **Progreso basado en impresiones**: Cada transferencia es estructurada. Cada decisión se basa en evidencia. "Parece que está terminado" no es un estado válido.
+
+## ¿Cómo funciona?
+
+1. **Crear un paquete**: Definir qué elementos deben existir cuando se complete el trabajo.
+2. **Dirigir a través de una cadena**: El conjunto más pequeño de roles especializados necesarios.
+3. **Cada rol produce una transferencia**: Una salida estructurada que reduce la ambigüedad para el siguiente rol.
+4. **El revisor evalúa según el contrato**: Acepta, rechaza o bloquea basándose en evidencia, no en impresiones.
+
+## Memoria y continuidad
+
+Role OS no posee ni duplica la capa de memoria. Cuando existe la memoria del proyecto Claude, esta es el sistema de continuidad canónico: los hechos del repositorio, las decisiones, los problemas pendientes y el historial de tratamiento se almacenan allí.
+
+Role OS se integra con la memoria del proyecto Claude. No la reemplaza.
+
+## Tratamiento completo y verificación de entrega
+
+El tratamiento completo es un protocolo canónico de 7 fases definido en la memoria del proyecto Claude (`memory/full-treatment.md`). Role OS dirige y revisa los tratamientos utilizando contratos de roles, transferencias y puertas de revisión, y no redefine el protocolo.
+
+La **verificación de entrega (Shipcheck)** es la puerta de calidad de 31 elementos que se ejecuta antes del tratamiento completo. Las puertas A, B, C y D deben superarse antes de que comience cualquier tratamiento. Referencia canónica: `memory/shipcheck.md`.
+
+Orden: Verificación de entrega primero, luego tratamiento completo. No hay versión 1.0.0 sin superar las puertas obligatorias.
+
+## 32 roles en 8 paquetes
+
+| Paquete | Roles |
+|------|-------|
+| **Core** (3) | Orquestador, Estratega de Producto, Evaluador Crítico. |
+| **Engineering** (7) | Desarrollador Frontend, Ingeniero Backend, Ingeniero de Pruebas, Ingeniero de Refactorización, Ingeniero de Rendimiento, Auditor de Dependencias, Evaluador de Seguridad. |
+| **Design** (2) | Diseñador de Interfaz de Usuario, Guardián de la Marca. |
+| **Marketing** (1) | Redactor para Lanzamiento. |
+| **Treatment** (7) | Investigador de Repositorios, Traductor de Repositorios, Arquitecto de Documentación, Curador de Metadatos, Auditor de Cobertura, Verificador de Despliegue, Ingeniero de Lanzamiento. |
+| **Product** (4) | Sintetizador de Retroalimentación, Priorizador de la Hoja de Ruta, Redactor de Especificaciones, Arquitecto de la Información. |
+| **Research** (4) | Investigador de Experiencia de Usuario, Analista de la Competencia, Investigador de Tendencias, Sintetizador de Entrevistas con Usuarios. |
+| **Growth** (4) | Estratega de Lanzamiento, Estratega de Contenido, Community Manager, Líder de Soporte. |
+
+Cada rol tiene un contrato completo: misión, cuándo usar, cuándo no usar, entradas esperadas, salidas requeridas, estándares de calidad y desencadenantes de escalamiento.
+
+## Cómo empezar
+
+```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
+```
+
+## Cuándo no usar Role OS
+
+- Correcciones de una sola línea, errores tipográficos o errores obvios.
+- Investigación exploratoria sin una salida definida.
+- Trabajo que se puede realizar en la mente de una persona en 5 minutos.
+- Correcciones urgentes que deben enviarse antes de que se complete una cadena de revisión.
+- Proyectos donde se prioriza la velocidad sobre la estructura.
+
+## Evidencia
+
+Role OS se ha probado en tres tipos de tareas diferentes en dos repositorios con estructuras diferentes:
+
+**Prueba 001: Trabajo de funciones** (Pantalla de la tripulación, Star Freight)
+- Cadena de 7 roles, 45 escenarios de prueba, 0 conflictos de roles.
+- Evitó la contaminación de un proyecto derivado, detectó invenciones realizadas directamente y reveló bloqueos reales.
+
+**Prueba 002: Trabajo de integración** (Conexión de CampaignState, Star Freight)
+- Cadena de 5 roles, resolvió la interfaz arquitectónica sin soluciones alternativas falsas.
+- Las pruebas anti-fallback demostraron que la ruta activa es real, no un marcador de posición.
+
+**Prueba 003: Trabajo de identidad** (Eliminación de contaminación, Star Freight)
+- Cadena de 6 roles, 51 escenarios de prueba, incluyendo una defensa duradera contra la contaminación en el sistema de integración continua.
+- Corrigió la desviación de la ficción heredada sin provocar una reestructuración general.
+
+**Prueba de portabilidad** (Consistencia de la persona, sensor-humor)
+- Misma estructura base, diferentes idioma/dominio/entorno.
+- Se adapta solo con cambios de contexto; no se realizan modificaciones en el contrato principal.
+
+**Tratamiento completo FT-001** (portlight-desktop)
+- Tratamiento con personal en 7 fases con roles del paquete de tratamiento.
+- Verificación de envío probada, sin colisiones de roles.
+
+**Tratamiento completo FT-002** (studioflow)
+- Mismo paquete de tratamiento, repositorio estructuralmente diferente (espacio de trabajo creativo vs. juego).
+- Paquete de tratamiento portátil: no se requieren modificaciones en el contrato.
+
+## Propiedades fundamentales
+
+Estas son innegociables. Si un cambio debilita alguna de ellas, recházalo.
+
+- Los límites de los roles se mantienen.
+- La revisión es rigurosa.
+- La escalación se mantiene transparente.
+- Los paquetes siguen siendo verificables.
+- La portabilidad requiere adaptación al contexto, no una modificación profunda.
+
+## Estructura del proyecto
+
+```
+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
+```
+
+## Seguridad
+
+El sistema operativo del rol opera **únicamente de forma local**. Copia las plantillas de Markdown y escribe archivos de paquetes/verdictos en el directorio `.claude/` de su repositorio. No accede a la red, no maneja secretos ni recopila datos de telemetría. No se realizan operaciones peligrosas; todas las escrituras de archivos utilizan la opción "omitir si existe" de forma predeterminada. Consulte [SECURITY.md](SECURITY.md) para obtener la política completa.
+
+## Estado
+
+**v1.0.0 — Superficie Amplia, Mismas Reglas**
+
+- v0.1: Operacional — 3 pruebas, 3 aprobaciones, 0 colisiones de roles.
+- v0.2: Adopción — flujo de trabajo predeterminado en el repositorio principal, portátil a un segundo repositorio.
+- v0.3: Productización — paquete de inicio, CLI de inicio, superficie de pruebas.
+- v0.4: Paquete de tratamiento — 8 roles de tratamiento/identidad, tratamiento completo con personal, portátil entre 2 repositorios.
+- v1.0.0: 32 roles en 8 paquetes, CLI completa, tratamiento probado, portabilidad multi-repositorio.
+
+## Licencia
+
+MIT
+
+---
+
+Creado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a

package/README.fr.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.md">English</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>
+
+Une couche d'abstraction portable et native du référentiel qui dirige le travail à travers des contrats de rôle, des paquets structurés, des revues et des escalades, afin que les équipes puissent réaliser des fonctionnalités, des intégrations, des corrections d'identité et des traitements complets du référentiel, sans dérive, sans fausses déclarations de complétion, ni progrès basés sur des impressions subjectives.
+
+## Ce que cela fait
+
+Role OS empêche les échecs spécifiques que produisent les flux de travail d'IA génériques :
+
+- **Dérive** : les rôles restent dans leur domaine. Le produit ne subit pas de refonte. L'interface utilisateur ne redéfinit pas la portée. Le backend n'invente pas la direction du produit.
+- **Fausse complétion** : la définition de "terminé" est concrète. Le travail qui masque des lacunes, saute des vérifications ou résout un problème différent est rejeté.
+- **Contamination** : les projets divisés ou hérités conservent des résidus d'identité. Role OS détecte et rejette les dérives inter-projets en termes de terminologie, de visuels et de modèles mentaux.
+- **Progrès basé sur des impressions** : chaque transmission est structurée. Chaque verdict est étayé par des preuves. "Cela semble terminé" n'est pas un état valide.
+
+## Comment cela fonctionne
+
+1. **Créer un paquet** : définir ce qui doit exister lorsque le travail est terminé.
+2. **Diriger à travers une chaîne** : l'ensemble le plus petit de rôles spécialisés nécessaires.
+3. **Chaque rôle produit une transmission** : une sortie structurée qui réduit l'ambiguïté pour le rôle suivant.
+4. **Le critique examine par rapport au contrat** : accepte, rejette ou bloque en fonction des preuves, et non des impressions.
+
+## Mémoire et continuité
+
+Role OS ne possède ni ne duplique la couche de mémoire. Lorsqu'une mémoire de projet Claude existe, elle constitue le système de continuité canonique : les faits du référentiel, les décisions, les boucles ouvertes et l'historique des traitements y sont stockés.
+
+Role OS s'intègre à la mémoire du projet Claude. Il ne la remplace pas.
+
+## Traitement complet et vérification de la livraison
+
+Le traitement complet est un protocole canonique en 7 phases défini dans la mémoire du projet Claude (`memory/full-treatment.md`). Role OS dirige et examine les traitements à l'aide de contrats de rôle, de transmissions et de passerelles de critique ; il ne redéfinit pas le protocole.
+
+La **vérification de la livraison** est la porte de qualité de 31 éléments qui s'exécute avant le traitement complet. Les portes obligatoires A à D doivent être validées avant que tout traitement ne commence. Référence canonique : `memory/shipcheck.md`.
+
+Ordre : Vérification de la livraison, puis traitement complet. Aucune version 1.0.0 sans validation des portes obligatoires.
+
+## 32 rôles répartis dans 8 ensembles
+
+| Ensemble | Rôles |
+|------|-------|
+| **Core** (3) | Orchestrateur, Stratège produit, Rédacteur de critiques |
+| **Engineering** (7) | Développeur frontend, Ingénieur backend, Ingénieur de tests, Ingénieur de refactoring, Ingénieur des performances, Auditeur de dépendances, Rédacteur de revues de sécurité |
+| **Design** (2) | Concepteur d'interface utilisateur, Gardien de la marque |
+| **Marketing** (1) | Rédacteur de contenu pour le lancement |
+| **Treatment** (7) | Chercheur de référentiels, Traducteur de référentiels, Architecte de documentation, Conservateur de métadonnées, Auditeur de couverture, Vérificateur de déploiement, Ingénieur de publication |
+| **Product** (4) | Synthétiseur de retours, Priorisateur de feuille de route, Rédacteur de spécifications, Architecte de l'information |
+| **Research** (4) | Chercheur UX, Analyste concurrentiel, Chercheur de tendances, Synthétiseur d'entretiens utilisateurs |
+| **Growth** (4) | Stratège de lancement, Stratège de contenu, Responsable de la communauté, Responsable du triage du support |
+
+Chaque rôle possède un contrat complet : mission, utilisation appropriée, non-utilisation, entrées attendues, sorties requises, critères de qualité et déclencheurs d'escalade.
+
+## Démarrage rapide
+
+```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
+```
+
+## Quand ne pas utiliser Role OS
+
+- Corrections ponctuelles, fautes de frappe ou bogues évidents
+- Recherches exploratoires sans résultat défini
+- Travaux qui tiennent dans la tête d'une seule personne en 5 minutes
+- Corrections urgentes qui doivent être déployées avant la fin du processus de revue
+- Projets où la rapidité est privilégiée par rapport à la structure
+
+## Preuves
+
+Role OS a été testé sur trois types de tâches différents dans deux référentiels structurellement différents :
+
+**Test 001 — Travail de fonctionnalité** (Écran de l'équipe, Star Freight)
+- Chaîne de 7 rôles, 45 scénarios de test, 0 conflit de rôle.
+- A empêché la contamination provenant de l'ancêtre de la branche, a détecté les inventions improvisées, et a mis en évidence les blocages réels.
+
+**Test 002 — Travail d'intégration** (Câblage de l'état de la campagne, Star Freight)
+- Chaîne de 5 rôles, a résolu la limite architecturale sans mensonges.
+- Les tests anti-fallback ont prouvé que le chemin actif est réel, et non un simple espace réservé.
+
+**Test 003 — Travail d'identité** (Suppression de la contamination, Star Freight)
+- Chaîne de 6 rôles, 51 scénarios de test, y compris une défense durable contre la contamination de l'intégration continue.
+- A corrigé la dérive de la fiction héritée sans se transformer en une refonte complète.
+
+**Phase d'essai de portabilité** (Cohérence des personas, humour lié aux capteurs)
+- Même structure de base, mais langage/domaine/pile différents.
+- adoption (du produit) avec modification du contexte uniquement – aucune modification du contrat principal.
+
+**Traitement complet FT-001** (portlight-desktop)
+- Traitement complet avec personnel affecté, utilisant les rôles de l'ensemble de traitement
+- Contrôle de qualité avant déploiement prouvé, aucune collision de rôles.
+
+**Traitement complet FT-002** (studioflow)
+- Même ensemble de traitement, référentiel structurellement différent (espace de travail créatif vs jeu)
+- Ensemble de traitement portable – aucune modification de contrat nécessaire.
+
+## Propriétés essentielles
+
+Ce sont des éléments non négociables. Si une modification affaiblit l'un de ces éléments, elle doit être rejetée.
+
+- Les limites des rôles sont respectées.
+- Les revues sont rigoureuses.
+- Les escalades restent transparentes.
+- Les tests restent réalisables.
+- La portabilité nécessite une adaptation du contexte, et non une modification profonde.
+
+## Structure du projet
+
+```
+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
+```
+
+## Sécurité
+
+Le rôle OS fonctionne **uniquement localement**. Il copie les modèles Markdown et écrit les fichiers de paquets/de verdicts dans le répertoire `.claude/` de votre dépôt. Il n'accède pas au réseau, ne gère pas les secrets et ne collecte pas de données télémétriques. Aucune opération dangereuse n'est effectuée : toutes les écritures de fichiers utilisent par défaut la fonction "skip-if-exists". Consultez le fichier [SECURITY.md](SECURITY.md) pour connaître la politique complète.
+
+## Statut
+
+**v1.0.0 — Surface large, mêmes règles**
+
+- v0.1 : Opérationnel – 3 essais, 3 acceptations, 0 collision de rôles
+- v0.2 : adoption (du produit) – flux de travail par défaut dans le référentiel principal, portable vers un deuxième référentiel
+- v0.3 : Productivité – ensemble de démarrage, CLI de démarrage, surface de démonstration
+- v0.4 : Ensemble de traitement – 8 rôles de traitement/identité, traitement complet avec personnel affecté, portable entre 2 référentiels
+- v1.0.0 : 32 rôles répartis dans 8 ensembles, CLI complète, traitement prouvé, portabilité multi-référentiels.
+
+## Licence
+
+MIT
+
+---
+
+Créé par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a

package/README.hi.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.md">English</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+# रोल ओएस
+
+<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>
+
+यह एक पोर्टेबल, रिपॉ-आधारित ऑपरेटिंग लेयर है जो रोल अनुबंधों, संरचित पैकेट्स, समीक्षा और एस्केलेशन के माध्यम से काम को निर्देशित करता है, ताकि टीमें बिना किसी विचलन, झूठे समापन या केवल धारणाओं पर आधारित प्रगति दावों के बिना, फीचर कार्य, एकीकरण कार्य, पहचान सुधार और संपूर्ण रिपॉ प्रबंधन कर सकें।
+
+## यह क्या करता है
+
+रोल ओएस उन विशिष्ट विफलताओं को रोकता है जो सामान्य एआई वर्कफ़्लो उत्पन्न करते हैं:
+
+- **विचलन (Drift)** — भूमिकाएं अपने दायरे में ही रहती हैं। उत्पाद का पुन: डिज़ाइन नहीं होता है। फ्रंटएंड दायरे को फिर से परिभाषित नहीं करता है। बैकएंड उत्पाद की दिशा का आविष्कार नहीं करता है।
+- **झूठा समापन (False completion)** — 'पूर्ण' की परिभाषा स्पष्ट होती है। वह काम जो कमियों को छिपाता है, सत्यापन को छोड़ देता है, या किसी अलग समस्या को हल करता है, उसे अस्वीकार कर दिया जाता है।
+- **संदूषण (Contamination)** — फोर्क किए गए या विरासत में मिले प्रोजेक्ट्स में पहचान के अवशेष रहते हैं। रोल ओएस शब्दावली, दृश्यों और मानसिक मॉडलों में क्रॉस-प्रोजेक्ट विचलन का पता लगाता है और उसे अस्वीकार करता है।
+- **धारणा-आधारित प्रगति (Vibes-based progress)** — प्रत्येक हैंडऑफ़ संरचित होता है। प्रत्येक निर्णय सबूत पर आधारित होता है। "यह पूरा हुआ हुआ लगता है" एक मान्य स्थिति नहीं है।
+
+## यह कैसे काम करता है
+
+1. **एक पैकेट बनाएं** — परिभाषित करें कि काम पूरा होने पर क्या मौजूद होना चाहिए।
+2. **एक श्रृंखला के माध्यम से रूट करें** — आवश्यक विशेषज्ञ भूमिकाओं का सबसे छोटा सेट।
+3. **प्रत्येक भूमिका एक हैंडऑफ़ उत्पन्न करती है** — संरचित आउटपुट जो अगली भूमिका के लिए अस्पष्टता को कम करता है।
+4. **समीक्षक अनुबंध के विरुद्ध समीक्षा करता है** — सबूत के आधार पर स्वीकार करता है, अस्वीकार करता है, या अवरुद्ध करता है, न कि केवल धारणा के आधार पर।
+
+## मेमोरी और निरंतरता
+
+रोल ओएस मेमोरी लेयर का स्वामित्व नहीं लेता है और न ही उसे दोहराता है। जहां क्लाउड प्रोजेक्ट मेमोरी मौजूद है, वह निरंतरता की आधिकारिक प्रणाली है — रिपॉ तथ्य, निर्णय, खुले मुद्दे और उपचार इतिहास वहां संग्रहीत होते हैं।
+
+रोल ओएस क्लाउड प्रोजेक्ट मेमोरी के साथ एकीकृत होता है। यह इसे प्रतिस्थापित नहीं करता है।
+
+## पूर्ण उपचार और शिपचेक
+
+पूर्ण उपचार एक आधिकारिक 7-चरण प्रोटोकॉल है जो क्लाउड प्रोजेक्ट मेमोरी (`memory/full-treatment.md`) में परिभाषित है। रोल ओएस रोल अनुबंधों, हैंडऑफ़ और समीक्षक गेटों का उपयोग करके उपचारों को रूट और समीक्षा करता है — यह प्रोटोकॉल को फिर से परिभाषित नहीं करता है।
+
+**शिपचेक** 31-आइटम गुणवत्ता गेट है जो पूर्ण उपचार से पहले चलता है। किसी भी उपचार को शुरू करने से पहले हार्ड गेट A-D पास होने चाहिए। आधिकारिक संदर्भ: `memory/shipcheck.md`।
+
+क्रम: शिपचेक पहले, फिर पूर्ण उपचार। बिना हार्ड गेट पास किए v1.0.0 नहीं।
+
+## 32 भूमिकाएँ, 8 पैकों में विभाजित
+
+| पैक | भूमिकाएँ |
+|------|-------|
+| **Core** (3) | ऑर्केस्ट्रेटर, उत्पाद रणनीतिकार, आलोचक समीक्षक |
+| **Engineering** (7) | फ्रंटएंड डेवलपर, बैकएंड इंजीनियर, टेस्ट इंजीनियर, रिफैक्टर इंजीनियर, परफॉर्मेंस इंजीनियर, डिपेंडेंसी ऑडिटर, सुरक्षा समीक्षक |
+| **Design** (2) | यूआई डिजाइनर, ब्रांड संरक्षक |
+| **Marketing** (1) | लॉन्च कॉपीराइटर |
+| **Treatment** (7) | रेपो रिसर्चर, रेपो ट्रांसलेटर, डॉक्स आर्किटेक्ट, मेटाडेटा क्यूरेटर, कवरेज ऑडिटर, डिप्लॉयमेंट वेरीफायर, रिलीज इंजीनियर |
+| **Product** (4) | फीडबैक सिंथेसाइज़र, रोडमैप प्रायोरिटाइज़र, स्पेसिफिकेशन राइटर, इंफॉर्मेशन आर्किटेक्ट |
+| **Research** (4) | यूएक्स रिसर्चर, प्रतिस्पर्धी विश्लेषक, ट्रेंड रिसर्चर, यूजर इंटरव्यू सिंथेसाइज़र |
+| **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
+```
+
+## रोल ओएस का उपयोग कब नहीं करना चाहिए
+
+- एक पंक्ति में ठीक होने वाले सुधार, टाइपो या स्पष्ट त्रुटियाँ
+- बिना किसी परिभाषित आउटपुट के खोजपूर्ण अनुसंधान
+- ऐसा काम जो 5 मिनट में एक व्यक्ति के दिमाग में समा जाए
+- आपातकालीन सुधार जो समीक्षा प्रक्रिया पूरी होने से पहले जारी करने की आवश्यकता है
+- ऐसे प्रोजेक्ट जहाँ आप संरचना से अधिक गति को महत्व देते हैं
+
+## सबूत
+
+रोल ओएस को दो संरचनात्मक रूप से भिन्न रिपॉ में तीन परीक्षणों में सिद्ध किया गया है:
+
+**परीक्षण 001 — फीचर कार्य** (क्रू स्क्रीन, स्टार फ्रेट)
+- 7-भूमिका श्रृंखला, 45 परीक्षण परिदृश्य, 0 भूमिका टकराव।
+- फोर्क किए गए पूर्वज से संदूषण को रोका, इनलाइन आविष्कार को पकड़ा, ईमानदार अवरोधकों को उजागर किया।
+
+**परीक्षण 002 — एकीकरण कार्य** (कैंपेनस्टेट वायरिंग, स्टार फ्रेट)
+- 5-भूमिका श्रृंखला, आर्किटेक्चरल सीम को बिना किसी झूठे समाधान के हल किया।
+- एंटी-फॉलबैक परीक्षणों ने साबित किया कि लाइव पथ वास्तविक है, न कि केवल एक अस्थायी समाधान।
+
+**परीक्षण 003 — पहचान कार्य** (संदूषण हटाना, स्टार फ्रेट)
+- 6-भूमिका श्रृंखला, 51 परीक्षण परिदृश्य, जिसमें स्थायी CI संदूषण रक्षा शामिल है।
+- विरासत में मिली त्रुटियों को ठीक किया बिना व्यापक पुन: डिज़ाइन में जाने से बचाया।
+
+**पोर्टेबिलिटी परीक्षण** (पर्सोना स्थिरता, सेंसर-हास्य)
+- समान आधार संरचना, लेकिन अलग भाषा/डोमेन/स्टैक।
+- केवल संदर्भ में बदलाव के साथ अपनाया गया है - कोई भी मुख्य अनुबंध संशोधन नहीं।
+
+**पूर्ण उपचार एफटी-001** (पोर्टलाइट-डेस्कटॉप)
+- 7-चरणों वाला, स्टाफ द्वारा संचालित उपचार, जिसमें ट्रीटमेंट पैक की भूमिकाएँ शामिल हैं
+- शिपचेक गेटिंग सिद्ध, कोई भूमिका टकराव नहीं
+
+**पूर्ण उपचार एफटी-002** (स्टूडियोफ्लो)
+- समान उपचार पैक, लेकिन संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
+- उपचार पैक पोर्टेबल है - किसी भी अनुबंध संशोधन की आवश्यकता नहीं है
+
+## मुख्य विशेषताएं
+
+ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
+
+- भूमिका की सीमाएं बरकरार हैं।
+- समीक्षा प्रक्रिया प्रभावी है।
+- शिकायत प्रक्रिया ईमानदार है।
+- परीक्षण योग्य पैकेट बरकरार हैं।
+- पोर्टेबिलिटी के लिए संदर्भ के अनुकूलन की आवश्यकता होती है, न कि मुख्य संरचना में बदलाव की।
+
+## परियोजना संरचना
+
+```
+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
+```
+
+## सुरक्षा
+
+रोल ओएस केवल **स्थानीय रूप से** काम करता है। यह मार्कडाउन टेम्पलेट्स की प्रतियां बनाता है और आपके रिपॉजिटरी के `.claude/` फ़ोल्डर में पैकेट/निर्णय फ़ाइलें लिखता है। यह नेटवर्क तक नहीं पहुंचता है, गोपनीय जानकारी को नहीं संभालता है, और न ही कोई डेटा एकत्र करता है। कोई भी खतरनाक ऑपरेशन नहीं किया जाता है - सभी फ़ाइल लिखने में डिफ़ॉल्ट रूप से "यदि मौजूद है तो छोड़ दें" का उपयोग किया जाता है। पूर्ण नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+
+## स्थिति
+
+**v1.0.0 — व्यापक सतह, समान नियम**
+
+- v0.1: परिचालन - 3 परीक्षण, 3 स्वीकृत, 0 भूमिका टकराव
+- v0.2: अपनाना - मुख्य रिपॉजिटरी में डिफ़ॉल्ट वर्कफ़्लो, दूसरे रिपॉजिटरी में पोर्टेबल
+- v0.3: उत्पाद निर्माण - स्टार्टर पैक, बूटस्ट्रैप सीएलआई, प्रमाण सतह
+- v0.4: उपचार पैक - 8 उपचार/पहचान भूमिकाएँ, पूर्ण स्टाफ द्वारा संचालित उपचार, 2 रिपॉजिटरी में पोर्टेबल
+- v1.0.0: 8 पैकों में 32 भूमिकाएँ, पूर्ण सीएलआई, सिद्ध उपचार, मल्टी-रिपॉजिटरी पोर्टेबिलिटी
+
+## लाइसेंस
+
+MIT
+
+---
+
+द्वारा निर्मित: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a