role-os 2.0.0 → 2.1.0

package/README.hi.md

@@ -2,10 +2,8 @@
   <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">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="600">
 </p>
 
 <p align="center">
@@ -52,6 +50,35 @@ roleos start "something completely novel"
 
 यह सिस्टम कभी भी किसी गलत स्तर पर काम को लागू नहीं करता है। यह बताता है कि इसने प्रत्येक स्तर को क्यों चुना और वैकल्पिक विकल्प भी प्रदान करता है।
 
+**एक कमांड से सक्रिय निष्पादन:**
+
+```bash
+roleos run "fix the crash in save handler"
+# → Created run: run-1234
+# → Entry: MISSION (bugfix)
+# → Started step 0: Repo Researcher → diagnosis-report
+# → Guidance: Required sections: entrypoints, module-map, build-test-commands
+
+roleos next                    # Start the next step
+roleos complete diagnosis.md   # Complete the active step with artifact
+roleos explain                 # Show full run state and guidance
+roleos resume                  # Continue an interrupted run
+roleos report                  # Generate completion report
+roleos friction                # Measure operator touches
+```
+
+**जब चीजें गलत हो जाती हैं तो हस्तक्षेप:**
+
+```bash
+roleos retry 0                 # Retry a failed step
+roleos reroute 1 "Frontend Developer" "UI bug"  # Swap a role
+roleos escalate "Test Engineer" "Repo Researcher" "missed edge case" "re-diagnose"
+roleos block 2 "waiting for API spec"
+roleos reopen 0 "found issue in review"
+```
+
+यह सिस्टम डिस्क पर डेटा संग्रहीत करता है (`.claude/runs/`), इसलिए बाधित सत्र बिना किसी समस्या के फिर से शुरू हो जाते हैं। प्रत्येक चरण में ऑपरेटर के मार्गदर्शन शामिल हैं: क्या उत्पन्न करना है, आवश्यक अनुभाग और समाप्ति की शर्तें।
+
 **एक बार रूट होने के बाद:**
 
 1. **प्रत्येक भूमिका एक हैंडऑफ़ उत्पन्न करती है:** संरचित आउटपुट जिसमें ऐसे प्रमाण शामिल होते हैं जो अगले भूमिका के लिए अस्पष्टता को कम करते हैं।
@@ -97,19 +124,24 @@ roleos start "something completely novel"
 npx role-os init
 
 # Describe what you need — Role OS picks the right level:
-roleos start "fix the crash in save handler"
+roleos run "fix the crash in save handler"
+# → Creates run, picks bugfix mission, starts first step with guidance
+
+# Step through:
+roleos next                    # Start next step
+roleos complete artifact.md    # Complete with artifact
+roleos explain                 # Show full state
+roleos report                  # Completion report
 
 # Or go manual:
+roleos start "fix the crash"   # Entry decision only (no run)
 roleos packet new feature
 roleos route .claude/packets/my-feature.md
 roleos review .claude/packets/my-feature.md accept
-roleos status
 
 # Explore missions and packs:
 roleos mission list
-roleos mission show bugfix
 roleos packs list
-roleos packs show feature
 ```
 
 ## रोल ओएस का उपयोग कब नहीं करना चाहिए
@@ -148,6 +180,12 @@ roleos packs show feature
 - समान उपचार पैक, संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
 - उपचार पैक पोर्टेबल - किसी अनुबंध संशोधन की आवश्यकता नहीं
 
+**"गोल्डन रन" पर विचार-मंथन** (एमसीपी सर्वर मार्केटप्लेस विषय)
+- 9 भूमिकाओं की श्रृंखला, 4 विश्लेषक समानांतर में, क्रॉस-परीक्षा + विवाद ग्राफ का खंडन
+- 4 चुनौतियां जारी की गईं, 3 दावों को संकुचित किया गया, 1 अनसुलझा — स्वस्थ दबाव, कोई गतिरोध नहीं
+- प्रस्तुत कलाकृतियों से 16+ ट्रेस लिंक "ट्रूथ-लेयर" परमाणुओं तक
+- पूरी श्रृंखला की प्रामाणिकता सिद्ध: सत्य → परमाणु → विवाद → संश्लेषण → विस्तार → न्यायाधीश → प्रस्तुत करना → ट्रेस
+
 ## मुख्य विशेषताएं
 
 ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
@@ -166,7 +204,9 @@ role-os/
   src/
     entry.mjs                  ← Unified entry: mission → pack → free routing
     entry-cmd.mjs              ← `roleos start` CLI command
-    mission.mjs                ← 6 named mission types (feature, bugfix, treatment, docs, security, research)
+    run.mjs                    ← Persistent run engine: create → step → pause → resume → report
+    run-cmd.mjs                ← `roleos run/resume/next/explain/complete/fail` + interventions
+    mission.mjs                ← 7 named mission types (feature, bugfix, treatment, docs, security, research, brainstorm)
     mission-run.mjs            ← Mission runner: create → step → complete → report
     mission-cmd.mjs            ← `roleos mission` CLI commands
     route.mjs                  ← 31-role routing + dynamic chain builder
@@ -175,14 +215,17 @@ role-os/
     escalation.mjs             ← Auto-routing for blocked/rejected/split
     evidence.mjs               ← Structured evidence + role-aware requirements
     dispatch.mjs               ← Runtime dispatch manifests for multi-claude
-    artifacts.mjs              ← 20 per-role artifact contracts + 7 pack handoffs
+    artifacts.mjs              ← 30 per-role artifact contracts + 7 pack handoffs
     decompose.mjs              ← Composite task detection + splitting
     composite.mjs              ← Dependency-ordered execution + recovery
     replan.mjs                 ← Mid-run adaptive replanning
     calibration.mjs            ← Outcome recording + weight tuning
     hooks.mjs                  ← 5 lifecycle hooks for runtime enforcement
     session.mjs                ← Session scaffolding + doctor
-  test/                        ← 527 tests across 20 test files
+    brainstorm.mjs             ← Evidence modes, request validation, finding/synthesis/judge schemas
+    brainstorm-roles.mjs       ← Role-native schemas, input partitioning, blindspot enforcement, cross-exam
+    brainstorm-render.mjs      ← Two-layer rendering: lexical bans, render schemas, debate transcript
+  test/                        ← 894 tests across 30 test files
   starter-pack/                ← Drop-in role contracts, policies, schemas, workflows
 ```
 
@@ -212,6 +255,8 @@ role-os/
 | **Mission library** | 6 नामित मिशन (फ़ीचर-शिप, बगफिक्स, ट्रीटमेंट, डॉक्स-रिलीज़, सुरक्षा-हार्डनिंग, रिसर्च-लॉन्च)। प्रत्येक मिशन में पैकेट, भूमिका श्रृंखला, कलाकृति प्रवाह, एस्केलेशन शाखाएँ, और आंशिक परिभाषा शामिल है। सभी 6 मिशनों का परीक्षण किया गया है और उन्हें बेहतर बनाया गया है। | ✓ जारी किया गया |
 | **Mission runner** | रन बनाएं, ट्रैक की गई स्थिति के साथ चरणों से गुजरें, ईमानदारी से रिपोर्टिंग के साथ पूरा करें/विफल करें। अवरुद्ध चरणों का प्रसार, श्रृंखला से बाहर एस्केलेशन चेतावनियाँ, और अंतिम चरण को फिर से खोलने की सुविधा। | ✓ जारी किया गया |
 | **Unified entry** | `roleos start` कमांड स्वचालित रूप से मिशन, पैकेट, या स्वतंत्र रूटिंग का चयन करता है। आत्मविश्वास स्कोर, विकल्पों, और संयुक्त पहचान के साथ एक वैकल्पिक प्रणाली। | ✓ जारी किया गया |
+| **Persistent runs** | `roleos run` डिस्क-आधारित निष्पादन बनाता है। `resume`, `next`, `explain`, `complete`, `fail`। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, फिर से खोलें। चरण-स्तरीय मार्गदर्शन। घर्षण माप। | ✓ जारी किया गया |
+| **Brainstorm** | दो-स्तरीय आर्किटेक्चर: सत्य (भूमिका-आधारित स्कीमा, उत्पत्ति परमाणु, क्रॉस-परीक्षा विवाद ग्राफ) + प्रस्तुत करना (5 अलग-अलग आवाजें, शब्द संबंधी प्रतिबंध, बहस का प्रतिलेख)। ट्रेस लिंक साबित करते हैं कि प्रत्येक प्रस्तुत दावा एक "ट्रूथ" परमाणु से मेल खाता है। "गोल्डन रन": 894 परीक्षण। | ✓ जारी किया गया |
 
 ## 6 मिशन
 
@@ -223,23 +268,47 @@ role-os/
 | `docs-release` | दस्तावेज़ | 2 | दस्तावेज़ लिखें/अपडेट करें, रिलीज़ नोट्स |
 | `security-hardening` | सुरक्षा | 4 | खतरे का मॉडल, ऑडिट, कमजोरियों को ठीक करें, फिर से ऑडिट करें, सत्यापन |
 | `research-launch` | अनुसंधान | 4 | प्रश्न तैयार करें, अनुसंधान करें, निष्कर्षों को दस्तावेज़ करें, निर्णय लें |
+| `brainstorm` | विचार-मंथन | 9 | ट्रेस करने योग्य असहमति और निर्णय के साथ संरचित बहु-दृष्टिकोण जांच। |
 
 प्रत्येक मिशन में ईमानदार-आंशिक परिभाषाएँ शामिल हैं - जब कोई कार्य रुक जाता है, तो सिस्टम यह दस्तावेज़ करता है कि क्या पूरा हो गया है और क्या शेष है, बजाय इसके कि वह झूठा दावा करे कि कार्य पूरा हो गया है।
 
+### विचार-मंथन मिशन
+
+यह "एआई विचार-मंथन" नहीं है। विचार-मंथन मिशन **कानून के तहत विशिष्ट भूमिकाएं हैं, जिसमें ट्रेस करने योग्य असहमति और निर्णय-आधारित आउटपुट होता है।**
+
+```bash
+roleos run "explore product directions for a developer tool discovery platform"
+# → MISSION: Brainstorm (Structured Inquiry)
+#   Chain: 4 Analysts (parallel) → Normalize → Cross-Examine → Rebut → Synthesize → Expand → Judge
+```
+
+**यह क्या अलग बनाता है:**
+
+- **लेयर 1 (सत्य):** चार विश्लेषक भूमिका-आधारित स्कीमा (संदर्भ मानचित्र, उपयोगकर्ता मूल्य मानचित्र, यांत्रिकी मानचित्र, स्थिति मानचित्र) उत्पन्न करते हैं — कोई साझा पाठ नहीं। प्रत्येक भूमिका पर "ब्लाइंडस्पॉट" लागू किया जाता है: प्रतिबंधित वाक्यांश, प्रतिबंधित दावे के प्रकार, फ़िल्टर किए गए इनपुट विभाजन। परमाणु उत्पत्ति जानकारी रखते हैं। एक निर्देशित क्रॉस-परीक्षा ग्राफ लक्षित चुनौतियां उत्पन्न करता है। मूल विश्लेषक दबाव में बचाव करते हैं, संकुचित करते हैं या वापस लेते हैं।
+
+- **लेयर 2 (प्रस्तुत करना):** पांच अलग-अलग मानवीय आवाजें (सीमा ज्ञापन, क्षेत्र नोट्स, सिस्टम स्केच, दावा संक्षिप्त, क्रॉस-परीक्षा प्रतिलेख) हैं, जिनमें शब्द संबंधी प्रतिबंध हैं जो आवाजों के एक होने से रोकते हैं। संश्लेषण "सत्य" का उपयोग करता है, कभी भी प्रस्तुत पाठ का नहीं। दोनों परतें हमेशा उपलब्ध होती हैं।
+
+- **श्रृंखला की प्रामाणिकता:** प्रत्येक प्रस्तुत वाक्य एक "ट्रूथ-लेयर" परमाणु से जुड़ा होता है। संश्लेषण निर्देशों में परमाणुओं का उल्लेख होता है। क्रॉस-परीक्षा वास्तविक दावा आईडी को लक्षित करती है। विवाद ग्राफ उत्पाद है, पाठ नहीं।
+
+**सिद्ध:** v0.4 "गोल्डन रन" — 894 परीक्षण, पूरी श्रृंखला की प्रामाणिकता सत्यापित। पूर्ण कलाकृति श्रृंखला के लिए [`examples/golden-run.md`](examples/golden-run.md) देखें।
+
 ## स्थिति
 
-- v0.1–v0.4: आधार – परीक्षण, अपनाना, उपचार पैकेज, शुरुआती पैकेज।
-- v1.0.0: 32 भूमिकाएँ, पूर्ण कमांड-लाइन इंटरफेस, सिद्ध उपचार, मल्टी-रिपो पोर्टेबिलिटी।
-- v1.0.2: भूमिका ऑपरेटिंग सिस्टम लॉकिंग (बूटस्ट्रैप सत्य सुधार, init --force)।
+- v0.1–v0.4: आधार — परीक्षण, अपनाना, उपचार पैकेज, शुरुआती पैकेज।
+- v1.0.0: 32 भूमिकाएँ, पूर्ण कमांड-लाइन इंटरफ़ेस (CLI), सिद्ध उपचार, मल्टी-रिपो पोर्टेबिलिटी।
+- v1.0.2: भूमिका ऑपरेटिंग सिस्टम (OS) लॉकिंग (बूटस्ट्रैप सत्य सुधार, init --force)।
 - v1.1.0: 31 भूमिकाएँ, पूर्ण रूटिंग स्पाइन, संघर्ष का पता लगाना, वृद्धि, प्रमाण, डिस्पैच, 7 सिद्ध टीम पैकेज। 35 निष्पादन परीक्षण। 212 परीक्षण।
-- v1.2.0: कैलिब्रेटेड पैकेज डिफ़ॉल्ट विकल्प के रूप में प्रचारित। स्वचालित चयन, विसंगति का पता लगाना, वैकल्पिक सुझाव, फ्री-रूटिंग बैकअप। 246 परीक्षण।
-- v1.3.0: परिणाम कैलिब्रेशन, मिश्रित-कार्य विघटन, समग्र निष्पादन, अनुकूलन योजना। 317 परीक्षण।
-- v1.4.0: सेशन स्पाइन – `roleos init claude`, `roleos doctor`, रूट कार्ड, /roleos-route + /roleos-review + /roleos-status कमांड। 335 परीक्षण।
-- v1.5.0: हुक स्पाइन – रनटाइम प्रवर्तन के लिए 5 लाइफसाइकिल हुक। 358 परीक्षण।
-- v1.6.0: आर्टिफैक्ट स्पाइन – 20 प्रति-भूमिका आर्टिफैक्ट अनुबंध, 7 पैकेज हैंडऑफ अनुबंध, संरचनात्मक सत्यापन। 385 परीक्षण।
-- v1.7.0: पूर्णता का प्रमाण – वास्तविक कार्य पूरे स्टैक के माध्यम से चलाए जाते हैं। `roleos artifacts` कमांड-लाइन इंटरफेस। संरचनात्मक सुधारों पर ईमानदार वृद्धि। 398 परीक्षण।
-- v1.8.0: मिशन लाइब्रेरी (फेज एस) – 6 नामित मिशन, रनर इंजन, पूर्णता रिपोर्ट। 6 वास्तविक परीक्षण रनों से सुरक्षित किया गया। 481 परीक्षण।
-- **v1.9.0**: एकीकृत प्रवेश पथ (फेज टी) – `roleos start` स्वचालित रूप से मिशन, पैकेज या फ्री रूटिंग का निर्णय लेता है। बैकअप प्रणाली, समग्र पता लगाना, प्रवेश-पथ तुलना परीक्षण। 527 परीक्षण।
+- v1.2.0: कैलिब्रेटेड पैकेज डिफ़ॉल्ट विकल्प के रूप में। स्वचालित चयन, बेमेल का पता लगाना, वैकल्पिक सुझाव, फ्री-रूटिंग फ़ॉलबैक। 246 परीक्षण।
+- v1.3.0: परिणाम कैलिब्रेशन, मिश्रित-कार्य अपघटन, समग्र निष्पादन, अनुकूली पुनर्योजना। 317 परीक्षण।
+- v1.4.0: सेशन स्पाइन — `roleos init claude`, `roleos doctor`, रूट कार्ड, /roleos-route + /roleos-review + /roleos-status कमांड। 335 परीक्षण।
+- v1.5.0: हुक स्पाइन — रनटाइम प्रवर्तन के लिए 5 लाइफसाइकिल हुक। 358 परीक्षण।
+- v1.6.0: आर्टिफैक्ट स्पाइन — 20 प्रति-भूमिका आर्टिफैक्ट अनुबंध, 7 पैकेज हैंडऑफ़ अनुबंध, संरचनात्मक सत्यापन। 385 परीक्षण।
+- v1.7.0: पूर्णता का प्रमाण — वास्तविक कार्य पूरे स्टैक के माध्यम से चलाए जाते हैं। `roleos artifacts` CLI। संरचनात्मक सुधारों पर ईमानदार वृद्धि। 398 परीक्षण।
+- v1.8.0: मिशन लाइब्रेरी (फेज S) — 6 नामित मिशन, रनर इंजन, पूर्णता रिपोर्ट। 6 वास्तविक परीक्षण रनों से सुरक्षित किया गया। 481 परीक्षण।
+- v1.9.0: एकीकृत प्रवेश पथ (फेज T) — `roleos start` स्वचालित रूप से मिशन बनाम पैकेज बनाम फ्री रूटिंग का निर्णय लेता है। फ़ॉलबैक सीढ़ी, समग्र पता लगाना, प्रवेश-पथ तुलना परीक्षण। 527 परीक्षण।
+- **v2.0.0**: ऑपरेटर घर्षण सुधार (फेज U) — `roleos run` स्थायी डिस्क-समर्थित रन बनाता है। फिर से शुरू करें, अगला, समझाएं, पूरा करें, विफल। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, पुनः खोलें। प्रत्येक चरण में चरण-स्थानीय मार्गदर्शन। घर्षण माप। 6 घर्षण परीक्षण। 613 परीक्षण।
+- **v2.0.1**: हैंडबुक ऑडिट, शुरुआती दस्तावेज़, परीक्षण गणना सुधार। 617 परीक्षण।
+- **v2.1.0**: ब्रेनस्टॉर्म मिशन (v0.4) — कानून के तहत विशिष्ट भूमिकाएँ, पता लगाने योग्य असहमति, निर्णय-वाहक आउटपुट। दो-स्तरीय आर्किटेक्चर (सत्य + रेंडर), क्रॉस-परीक्षा अनुमति मैट्रिक्स, विवाद ग्राफ, गोल्डन रन प्रमाण। 7 मिशन, 50 भूमिकाएँ, 8 पैकेज। 894 परीक्षण।
 
 ## लाइसेंस
 

package/README.it.md

@@ -2,10 +2,8 @@
   <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">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/role-os/readme.png" alt="Role OS" width="600">
 </p>
 
 <p align="center">
@@ -15,7 +13,7 @@
   <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 sistema operativo multi-Claude che assegna personale, definisce i percorsi, convalida e gestisce le attività attraverso 31 contratti di ruolo specializzati. Crea pacchetti di attività, assembla il team giusto in base alla corrispondenza dei ruoli, rileva problemi prima dell'esecuzione, indirizza automaticamente le operazioni di ripristino quando un'attività viene bloccata o rifiutata e richiede prove strutturate in ogni decisione.
+Un sistema operativo multi-Claude che assegna personale, definisce i percorsi, convalida e gestisce i processi attraverso 50 contratti di ruolo specializzati. Crea pacchetti di attività, assembla il team giusto in base alla corrispondenza dei ruoli, rileva eventuali problemi prima dell'esecuzione, reindirizza automaticamente le attività in caso di blocco o rifiuto e richiede prove strutturate in ogni decisione.
 
 ## Cosa fa
 
@@ -28,7 +26,7 @@ Role OS è il modo professionale di utilizzare multi-Claude. Previene i problemi
 
 ## Come funziona
 
-Descrivi la tua attività. Role OS determina automaticamente il livello di orchestrazione appropriato.
+Descrivi la tua attività. Role OS decide automaticamente il livello di orchestrazione appropriato.
 
 ```bash
 roleos start "fix the crash in save handler"
@@ -47,20 +45,49 @@ roleos start "something completely novel"
 **La gerarchia di fallback:**
 
 1. **Missione** — quando l'attività corrisponde a un flusso di lavoro ricorrente consolidato (correzione di bug, trattamento, rilascio di funzionalità, documentazione, sicurezza, ricerca). Catena di ruoli nota, flusso di artefatti, rami di escalation e definizioni parziali chiare.
-2. **Pacchetto** — quando l'attività appartiene a una famiglia nota, ma non corrisponde a una missione completa. 7 pacchetti di team calibrati con selezione automatica e protezioni contro le incompatibilità.
-3. **Instradamento libero** — quando l'attività è nuova, complessa o incerta. Assegna un punteggio a tutti i 31 ruoli in base al contenuto del pacchetto e crea una catena dinamica.
+2. **Pacchetto** — quando l'attività appartiene a una famiglia nota ma non ha una struttura di missione completa. 7 pacchetti di team calibrati con selezione automatica e protezioni contro errori.
+3. **Routing libero** — quando l'attività è nuova, complessa o incerta. Valuta tutti i 31 ruoli in base al contenuto del pacchetto e crea una catena dinamica.
+
+Il sistema non forza mai l'esecuzione di un'attività attraverso un livello di astrazione errato. Spiega perché ha scelto ogni livello e offre alternative.
+
+**Un comando per avviare l'esecuzione:**
+
+```bash
+roleos run "fix the crash in save handler"
+# → Created run: run-1234
+# → Entry: MISSION (bugfix)
+# → Started step 0: Repo Researcher → diagnosis-report
+# → Guidance: Required sections: entrypoints, module-map, build-test-commands
+
+roleos next                    # Start the next step
+roleos complete diagnosis.md   # Complete the active step with artifact
+roleos explain                 # Show full run state and guidance
+roleos resume                  # Continue an interrupted run
+roleos report                  # Generate completion report
+roleos friction                # Measure operator touches
+```
 
-Il sistema non forza mai un'attività attraverso un livello di astrazione errato. Spiega perché ha scelto ogni livello e offre alternative.
+**Interventi in caso di problemi:**
 
-**Una volta instradata:**
+```bash
+roleos retry 0                 # Retry a failed step
+roleos reroute 1 "Frontend Developer" "UI bug"  # Swap a role
+roleos escalate "Test Engineer" "Repo Researcher" "missed edge case" "re-diagnose"
+roleos block 2 "waiting for API spec"
+roleos reopen 0 "found issue in review"
+```
+
+I processi vengono salvati su disco (`.claude/runs/`), quindi le sessioni interrotte possono essere riprese correttamente. Ogni fase include una guida per l'operatore: cosa produrre, sezioni richieste e condizioni di arresto.
+
+**Una volta definito il percorso:**
 
 1. **Ogni ruolo produce un passaggio** — output strutturato con elementi di prova che riducono l'ambiguità per il ruolo successivo.
-2. **La revisione critica avviene in base al contratto** — accetta, rifiuta o blocca in base a prove strutturate, non a impressioni.
-3. **Il ripristino avviene automaticamente** — le attività bloccate o rifiutate vengono indirizzate al risolutore appropriato con una motivazione, il tipo di ripristino e gli artefatti richiesti.
+2. **La revisione verifica rispetto al contratto** — accetta, rifiuta o blocca in base a prove strutturate, non a impressioni.
+3. **Il percorso di ripristino viene attivato automaticamente** — le attività bloccate o rifiutate vengono reindirizzate al risolutore appropriato, con una motivazione, il tipo di ripristino e l'artefatto richiesto.
 
-## Stato di implementazione nell'organizzazione
+## Stato di implementazione a livello di organizzazione
 
-Lo stato di implementazione a livello di organizzazione (coda, decisioni, registri di controllo, pacchetti di blocco per repository) si trova in un repository privato separato: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Questo repository è il prodotto; quello è lo stato operativo.
+Lo stato di implementazione a livello di organizzazione (coda, decisioni, registri di controllo, pacchetti di blocco per repository) è contenuto in un repository privato separato: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout). Questo repository contiene il prodotto; quello è lo stato operativo.
 
 ## Memoria e continuità
 
@@ -85,11 +112,11 @@ Ordine: controllo di qualità, quindi elaborazione completa. Nessuna versione 1.
 | **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** (3) | Generatore di feedback, Prioritizzatore della roadmap, Redattore di specifiche. |
+| **Product** (3) | Generatore di feedback, Prioritizzatore di roadmap, Redattore di specifiche. |
 | **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 utilizzarlo, quando non utilizzarlo, input previsti, output richiesti, standard di qualità e trigger di escalation. Ogni ruolo può essere indirizzato; `roleos route` può raccomandare uno qualsiasi di essi in base al contenuto del pacchetto.
+Ogni ruolo ha un contratto completo: missione, quando utilizzarlo, quando non utilizzarlo, input richiesti, output necessari, standard di qualità e trigger di escalation. Ogni ruolo può essere indirizzato — `roleos route` può suggerirne uno qualsiasi in base al contenuto del pacchetto.
 
 ## Guida rapida
 
@@ -97,19 +124,24 @@ Ogni ruolo ha un contratto completo: missione, quando utilizzarlo, quando non ut
 npx role-os init
 
 # Describe what you need — Role OS picks the right level:
-roleos start "fix the crash in save handler"
+roleos run "fix the crash in save handler"
+# → Creates run, picks bugfix mission, starts first step with guidance
+
+# Step through:
+roleos next                    # Start next step
+roleos complete artifact.md    # Complete with artifact
+roleos explain                 # Show full state
+roleos report                  # Completion report
 
 # Or go manual:
+roleos start "fix the crash"   # Entry decision only (no run)
 roleos packet new feature
 roleos route .claude/packets/my-feature.md
 roleos review .claude/packets/my-feature.md accept
-roleos status
 
 # Explore missions and packs:
 roleos mission list
-roleos mission show bugfix
 roleos packs list
-roleos packs show feature
 ```
 
 ## Quando non utilizzare Role OS
@@ -148,6 +180,12 @@ Role OS è stato testato in tre scenari diversi in due repository strutturalment
 - Stesso pacchetto di trattamento, repository strutturalmente diverso (spazio di lavoro creativo vs gioco)
 - Pacchetto di trattamento portatile: non sono necessarie modifiche al contratto
 
+**Esempio di esecuzione ottimale** (argomento del marketplace dei server MCP)
+- Catena di 9 ruoli, 4 analisti in parallelo, esame incrociato + grafico di contestazione e replica.
+- 4 sfide proposte, 3 affermazioni raffinate, 1 irrisolta — pressione sana, non stallo.
+- Oltre 16 collegamenti di tracciamento dagli artefatti generati agli elementi fondamentali di verità.
+- Catena di custodia completa dimostrata: verità → elementi → contestazione → sintesi → espansione → giudizio → rendering → tracciamento.
+
 ## Proprietà fondamentali
 
 Queste sono non negoziabili. Se una modifica ne indebolisce una, rifiutarla.
@@ -166,7 +204,9 @@ role-os/
   src/
     entry.mjs                  ← Unified entry: mission → pack → free routing
     entry-cmd.mjs              ← `roleos start` CLI command
-    mission.mjs                ← 6 named mission types (feature, bugfix, treatment, docs, security, research)
+    run.mjs                    ← Persistent run engine: create → step → pause → resume → report
+    run-cmd.mjs                ← `roleos run/resume/next/explain/complete/fail` + interventions
+    mission.mjs                ← 7 named mission types (feature, bugfix, treatment, docs, security, research, brainstorm)
     mission-run.mjs            ← Mission runner: create → step → complete → report
     mission-cmd.mjs            ← `roleos mission` CLI commands
     route.mjs                  ← 31-role routing + dynamic chain builder
@@ -175,14 +215,17 @@ role-os/
     escalation.mjs             ← Auto-routing for blocked/rejected/split
     evidence.mjs               ← Structured evidence + role-aware requirements
     dispatch.mjs               ← Runtime dispatch manifests for multi-claude
-    artifacts.mjs              ← 20 per-role artifact contracts + 7 pack handoffs
+    artifacts.mjs              ← 30 per-role artifact contracts + 7 pack handoffs
     decompose.mjs              ← Composite task detection + splitting
     composite.mjs              ← Dependency-ordered execution + recovery
     replan.mjs                 ← Mid-run adaptive replanning
     calibration.mjs            ← Outcome recording + weight tuning
     hooks.mjs                  ← 5 lifecycle hooks for runtime enforcement
     session.mjs                ← Session scaffolding + doctor
-  test/                        ← 527 tests across 20 test files
+    brainstorm.mjs             ← Evidence modes, request validation, finding/synthesis/judge schemas
+    brainstorm-roles.mjs       ← Role-native schemas, input partitioning, blindspot enforcement, cross-exam
+    brainstorm-render.mjs      ← Two-layer rendering: lexical bans, render schemas, debate transcript
+  test/                        ← 894 tests across 30 test files
   starter-pack/                ← Drop-in role contracts, policies, schemas, workflows
 ```
 
@@ -192,54 +235,80 @@ Il sistema operativo del ruolo opera **solo localmente**. Copia i modelli Markdo
 
 ## Il sistema operativo
 
-| Livello. | Cosa fa | Stato |
+| Livello | Cosa fa | Stato |
 |-------|-------------|--------|
-| **Routing** | Assegna un punteggio a tutti i 31 ruoli in base al contenuto del pacchetto, spiega le raccomandazioni, valuta la confidenza. | ✓ Implementato. |
-| **Chain builder** | Assembla catene ordinate per fasi dai ruoli valutati, orientate al tipo di pacchetto, ma non vincolate a modelli. | ✓ Implementato. |
-| **Conflict detection** | Convalida in 4 passaggi: conflitti gravi, sequenza, ridondanza, lacune di copertura. Suggerimenti per la correzione. | ✓ Implementato. |
-| **Escalation** | Indirizza automaticamente le attività bloccate/rifiutate/divise al risolutore appropriato con la motivazione e gli artefatti richiesti. | ✓ Implementato. |
-| **Evidence** | Prove strutturate specifiche per il ruolo nelle decisioni. Controlli di sufficienza. 12 tipi di prove. | ✓ Implementato. |
-| **Dispatch** | Genera manifesti di esecuzione per multi-claude. Profili degli strumenti per ruolo, prompt di sistema, budget. | ✓ Implementato. |
-| **Trials** | Roster completo dimostrato: 30/30 attività di successo + 5/5 test negativi. 7 test dei pacchetti completati. | ✓ Completo. |
-| **Team Packs** | 7 pacchetti calibrati con selezione automatica, protezioni contro le incompatibilità e fallback con instradamento libero. | ✓ Implementato. |
-| **Outcome calibration** | Registra i risultati delle esecuzioni, calibra i pesi dei pacchetti/ruoli in base ai risultati, regola le soglie di confidenza. | ✓ Implementato. |
-| **Mixed-task decomposition** | Rileva attività composte, le divide in pacchetti secondari, assegna i pacchetti e preserva le dipendenze. | ✓ Implementato. |
-| **Composite execution** | Esegue i pacchetti secondari nell'ordine delle dipendenze con il passaggio degli artefatti, il ripristino dei rami e la sintesi. | ✓ Implementato. |
-| **Adaptive replanning** | Le modifiche all'ambito, le scoperte o i nuovi requisiti durante l'esecuzione aggiornano il piano senza doverlo riavviare. | ✓ Implementato. |
-| **Session spine** | `roleos init claude` crea i file CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` verifica la configurazione. Le schede di instradamento dimostrano l'utilizzo. | ✓ Implementato. |
-| **Hook spine** | 5 "hook" del ciclo di vita (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Applicazione delle policy: promemoria sulle "route card", controllo sull'utilizzo degli strumenti, assegnazione di ruoli ai "subagent", verifica del completamento. | ✓ Implementato. |
-| **Artifact spine** | 20 contratti per ruolo relativi agli artefatti. 7 contratti per il passaggio di consegne tra "pack". Validazione strutturale. Controlli di completezza della "catena". I ruoli successivi non devono mai indovinare ciò che hanno ricevuto. | ✓ Implementato. |
-| **Mission library** | 6 missioni denominate (implementazione di funzionalità, correzione di bug, ottimizzazione, rilascio della documentazione, rafforzamento della sicurezza, avvio della ricerca). Ogni missione definisce il "pack", la catena di ruoli, il flusso degli artefatti, i percorsi di escalation e una definizione parziale e trasparente. Tutte e 6 le missioni sono state testate e ottimizzate. | ✓ Implementato. |
-| **Mission runner** | Creazione di esecuzioni, passaggio graduale con tracciamento dello stato, completamento/fallimento con reportistica trasparente. Propagazione dei passaggi bloccati, avvisi di escalation al di fuori della catena, riapertura dell'ultimo passaggio. | ✓ Implementato. |
-| **Unified entry** | Il comando `roleos start` decide automaticamente tra l'utilizzo di una missione, di un "pack" o di un percorso libero. Sistema di fallback con punteggi di affidabilità, alternative e rilevamento composito. | ✓ Implementato. |
-
-## 6 missioni
+| **Routing** | Valuta tutti i 31 ruoli in base al contenuto del pacchetto, spiega le raccomandazioni, valuta la confidenza. | ✓ Implementato |
+| **Chain builder** | Assembla catene ordinate per fase dai ruoli valutati, orientato al tipo di pacchetto, non vincolato a modelli. | ✓ Implementato |
+| **Conflict detection** | Convalida in 4 passaggi: conflitti evidenti, sequenza, ridondanza, lacune di copertura. Suggerimenti per la correzione. | ✓ Implementato |
+| **Escalation** | Reindirizza automaticamente le attività bloccate/rifiutate/divise al risolutore appropriato con motivazione e artefatto richiesto. | ✓ Implementato |
+| **Evidence** | Prove strutturate e specifiche per il ruolo nelle decisioni. Controlli di completezza. 12 tipi di prove. | ✓ Implementato |
+| **Dispatch** | Genera manifesti di esecuzione per multi-claude. Profili degli strumenti per ruolo, prompt di sistema, budget. | ✓ Implementato |
+| **Trials** | Roster completo dimostrato: 30/30 attività di successo + 5/5 test negativi. 7 test di pacchetto completati. | ✓ Completo |
+| **Team Packs** | 7 pacchetti calibrati con selezione automatica, protezioni contro errori e fallback con routing libero. | ✓ Implementato |
+| **Outcome calibration** | Registra i risultati delle esecuzioni, regola i pesi dei pacchetti/ruoli in base ai risultati e adatta le soglie di confidenza. | ✓ Implementato |
+| **Mixed-task decomposition** | Rileva attività complesse, le suddivide in pacchetti secondari, assegna i pacchetti e preserva le dipendenze. | ✓ Implementato |
+| **Composite execution** | Esegue i pacchetti secondari in ordine di dipendenza, trasferendo gli artefatti, gestendo il ripristino dei rami e la sintesi. | ✓ Implementato |
+| **Adaptive replanning** | Modifiche, scoperte o nuovi requisiti durante l'esecuzione aggiornano il piano senza doverlo riavviare. | ✓ Implementato |
+| **Session spine** | `roleos init claude` crea i file CLAUDE.md, /roleos-route, /roleos-review, /roleos-status. `roleos doctor` verifica la configurazione. Le schede di routing indicano l'impegno. | ✓ Implementato |
+| **Hook spine** | 5 hook del ciclo di vita (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop). Applicazione di regole: promemoria sulle schede di routing, controllo sull'uso degli strumenti, assegnazione di ruoli ai subagent e verifica della completezza. | ✓ Implementato |
+| **Artifact spine** | 30 contratti per ruolo relativi agli artefatti. 7 contratti di passaggio dei pacchetti. Validazione strutturale. Controlli di completezza della catena. Gli altri ruoli non devono mai indovinare cosa hanno ricevuto. | ✓ Implementato |
+| **Mission library** | 7 missioni denominate (feature-ship, bugfix, treatment, docs-release, security-hardening, research-launch, brainstorm). Ognuna definisce pacchetti, catena di ruoli, flusso di artefatti, rami di escalation e una definizione parziale e onesta. Tutte e 7 sono state testate. | ✓ Implementato |
+| **Mission runner** | Crea esecuzioni, esegui passo dopo passo con tracciamento dello stato, completa o fallisci con reportistica onesta. Propagazione dei passaggi bloccati, avvisi di escalation fuori catena, riapertura dell'ultimo passaggio. | ✓ Implementato |
+| **Unified entry** | `roleos start` decide automaticamente tra missione, pacchetto o routing libero. Sistema di fallback con punteggi di confidenza, alternative e rilevamento di attività complesse. | ✓ Implementato |
+| **Persistent runs** | `roleos run` crea esecuzioni basate su file. Comandi: `resume`, `next`, `explain`, `complete`, `fail`. Interventi: reindirizzamento, escalation, riprova, blocco, riapertura. Guida specifica per ogni passaggio. Misurazione dell'attrito. | ✓ Implementato |
+| **Brainstorm** | Architettura a due livelli: verità (schemi nativi per ruolo, atomi di provenienza, grafo di contestazione incrociata) + rendering (5 voci distinte, divieti lessicali, trascrizione del dibattito). I collegamenti di traccia dimostrano che ogni affermazione resa corrisponde a un atomo di verità. Esecuzione di riferimento: 894 test. | ✓ Implementato |
+
+## 7 missioni
 
 | Missione | Pacchetto | Ruoli | Quando utilizzarla |
 |---------|------|-------|-------------|
-| `feature-ship` | Funzionalità | 5 | Erogazione completa di una funzionalità: definizione dell'ambito → specifica → implementazione → test → revisione |
-| `bugfix` | Correzione di bug | 4 | Diagnosi della causa principale, correzione, test, verifica |
-| `treatment` | Ottimizzazione | 4 | Controllo della qualità + rifinitura + documentazione + verifica tramite CI + revisione |
-| `docs-release` | Documentazione | 2 | Scrittura/aggiornamento della documentazione, note di rilascio |
+| `feature-ship` | funzionalità | 5 | Consegna completa della funzionalità: ambito → specifica → implementazione → test → revisione |
+| `bugfix` | correzione di bug | 4 | Diagnosi della causa principale, correzione, test, verifica |
+| `treatment` | ottimizzazione | 4 | Controllo + rifinitura + documentazione + verifica CI + revisione |
+| `docs-release` | documentazione | 2 | Scrittura/aggiornamento della documentazione, note di rilascio |
 | `security-hardening` | Sicurezza | 4 | Modello delle minacce, audit, correzione delle vulnerabilità, nuovo audit, verifica |
-| `research-launch` | Ricerca | 4 | Formulazione della domanda, ricerca, documentazione dei risultati, decisione |
+| `research-launch` | ricerca | 4 | Formulazione della domanda, ricerca, documentazione dei risultati, decisione |
+| `brainstorm` | brainstorming | 9 | Indagine strutturata con molteplici prospettive, con disaccordo tracciabile e output con verdetto |
+
+Ogni missione include definizioni parziali e oneste: quando il lavoro si blocca, il sistema documenta ciò che è stato completato e ciò che rimane, invece di dichiarare falsamente il completamento.
+
+### Missione di brainstorming
+
+Non "brainstorming dell'IA". La missione di brainstorming è **un insieme di ruoli specializzati, con disaccordo tracciabile e output con verdetto.**
+
+```bash
+roleos run "explore product directions for a developer tool discovery platform"
+# → MISSION: Brainstorm (Structured Inquiry)
+#   Chain: 4 Analysts (parallel) → Normalize → Cross-Examine → Rebut → Synthesize → Expand → Judge
+```
+
+**Cosa la rende diversa:**
+
+- **Livello 1 (verità):** Quattro analisti emettono schemi nativi per ruolo (ContextMap, UserValueMap, MechanicsMap, PositioningMap) — non prosa condivisa. Ogni ruolo è soggetto a controlli per evitare punti ciechi: frasi vietate, tipi di affermazioni vietate, partizioni di input filtrate. Gli atomi contengono informazioni sulla provenienza. Un grafo di contestazione incrociata genera sfide mirate. Gli analisti originali difendono, restringono o ritraggono le loro affermazioni sotto pressione.
+
+- **Livello 2 (rendering):** Cinque voci umane distinte (Boundary Memo, Field Notes, System Sketch, Claim Brief, Cross-Exam Transcript) con restrizioni lessicali che impediscono la convergenza delle voci. La sintesi utilizza informazioni verificate, ma non produce testo. Entrambi i livelli sono sempre disponibili.
+
+- **Catena di custodia:** Ogni frase generata può essere ricondotta a un elemento del livello di verità. Le istruzioni di sintesi fanno riferimento a questi elementi. Le domande di controinterrogatorio si basano su identificativi di pretese reali. Il grafo delle controversie è il risultato, non il testo.
 
-Ogni missione include definizioni parziali e trasparenti: quando il lavoro si blocca, il sistema documenta ciò che è stato completato e ciò che rimane, invece di fornire una falsa impressione di completamento.
+**Verificato:** Versione 0.4, test completi — 894 test, catena di custodia completamente verificata. Consultare [`examples/golden-run.md`](examples/golden-run.md) per la catena completa degli artefatti.
 
 ## Stato
 
-- v0.1–v0.4: Fondamenta: test, adozione, "pack" di ottimizzazione, "pack" di avvio
-- v1.0.0: 32 ruoli, interfaccia a riga di comando completa, ottimizzazione collaudata, portabilità multi-repository
-- v1.0.2: Blocco del sistema operativo dei ruoli (correzioni per garantire la veridicità, `init --force`)
-- v1.1.0: 31 ruoli, "spina dorsale" completa per il routing, rilevamento dei conflitti, escalation, evidenza, dispatch, 7 "pack" di team collaudati. 35 esecuzioni di prova. 212 test.
-- v1.2.0: "Pack" calibrati promossi a impostazione predefinita. Selezione automatica, rilevamento delle incongruenze, suggerimento di alternative, fallback per il routing libero. 246 test.
-- v1.3.0: Calibrazione dei risultati, decomposizione dei compiti misti, esecuzione composita, riprogrammazione adattiva. 317 test.
-- v1.4.0: "Spina dorsale" della sessione: `roleos init claude`, `roleos doctor`, "route card", comandi `/roleos-route + /roleos-review + /roleos-status`. 335 test.
-- v1.5.0: "Spina dorsale" dei "hook": 5 "hook" del ciclo di vita per l'applicazione delle policy in fase di esecuzione. 358 test.
-- v1.6.0: "Spina dorsale" degli artefatti: 20 contratti per ruolo relativi agli artefatti, 7 contratti per il passaggio di consegne tra "pack", validazione strutturale. 385 test.
-- v1.7.0: Prova di completamento: attività reali eseguite sull'intera piattaforma. Interfaccia a riga di comando `roleos artifacts`. Escalation trasparente in caso di correzioni strutturali. 398 test.
-- v1.8.0: Libreria di missioni (Fase S): 6 missioni denominate, motore di esecuzione, report di completamento. Ottimizzate da 6 esecuzioni di prova reali. 481 test.
-- **v1.9.0**: Percorso di accesso unificato (Fase T) - `roleos start` decide automaticamente tra l'utilizzo di una missione, di un "pack" o di un percorso libero. Sistema di fallback, rilevamento composito, test di confronto del percorso di accesso. 527 test.
+- v0.1–v0.4: Fondamenta — test, adozione, pacchetto di trattamento, pacchetto di avvio
+- v1.0.0: 32 ruoli, interfaccia a riga di comando completa, trattamento verificato, portabilità multi-repository
+- v1.0.2: Blocco del sistema operativo dei ruoli (correzioni iniziali della verità, init --force)
+- v1.1.0: 31 ruoli, infrastruttura di routing completa, rilevamento dei conflitti, escalation, prove, dispatch, 7 pacchetti di team verificati. 35 esecuzioni di prova. 212 test.
+- v1.2.0: Pacchetti calibrati promossi a impostazione predefinita. Selezione automatica, rilevamento delle incongruenze, suggerimenti alternativi, fallback di routing libero. 246 test.
+- v1.3.0: Calibrazione dei risultati, decomposizione di attività complesse, esecuzione composita, riprogrammazione adattiva. 317 test.
+- v1.4.0: Infrastruttura delle sessioni — `roleos init claude`, `roleos doctor`, schede di routing, comandi /roleos-route + /roleos-review + /roleos-status. 335 test.
+- v1.5.0: Infrastruttura degli hook — 5 hook del ciclo di vita per l'applicazione in fase di esecuzione. 358 test.
+- v1.6.0: Infrastruttura degli artefatti — 20 contratti di artefatti specifici per ruolo, 7 contratti di trasferimento di pacchetti, convalida strutturale. 385 test.
+- v1.7.0: Dimostrazione del completamento — attività reali eseguite sull'intera piattaforma. Interfaccia a riga di comando `roleos artifacts`. Escalation trasparente per le correzioni strutturali. 398 test.
+- v1.8.0: Libreria di missioni (Fase S) — 6 missioni denominate, motore di esecuzione, report di completamento. Rafforzata da 6 esecuzioni di prova reali. 481 test.
+- v1.9.0: Percorso di accesso unificato (Fase T) — `roleos start` decide automaticamente tra missione, pacchetto o routing libero. Scala di fallback, rilevamento composito, test di confronto del percorso di accesso. 527 test.
+- **v2.0.0**: Ottimizzazione dell'esperienza utente (Fase U) — `roleos run` crea esecuzioni persistenti supportate dal disco. Riprendi, successivo, spiega, completa, fallisci. Interventi: reindirizza, aumenta, riprova, blocca, riapri. Guida specifica per ogni passaggio. Misurazione dell'attrito. 6 test di attrito. 613 test.
+- **v2.0.1**: Revisione del manuale, documentazione per principianti, correzioni del conteggio dei test. 617 test.
+- **v2.1.0**: Missione di brainstorming (v0.4) — ruoli specializzati nel campo legale, disaccordo tracciabile, output con valore probatorio. Architettura a due livelli (verità + rendering), matrice di autorizzazioni per il controinterrogatorio, grafo delle controversie, prova di esecuzione completa. 7 missioni, 50 ruoli, 8 pacchetti. 894 test.
 
 ## Licenza