superpowers-mcp 6.4.1 → 6.4.3

package/docs/skill-compositions.hi.md

@@ -0,0 +1,220 @@
+# Superpowers MCP: Skill संयोजन और वर्कफ़्लो पाइपलाइन
+
+[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md) | [Español](skill-compositions.es.md) | [Português (BR)](skill-compositions.pt-BR.md) | [हिन्दी](skill-compositions.hi.md)
+
+> **प्रामाणिक स्रोत:** यह अंग्रेज़ी दस्तावेज़ canonical है। skill व्यवहार बदलने पर पहले इसे अपडेट करें, फिर अनुवाद sync करें।
+
+
+## 1. वर्कफ़्लो चुनें
+
+ये prompts **इंटरैक्टिव वर्कफ़्लो लॉन्चर** हैं, सर्वर-साइड स्वचालन नहीं। किसी एक को चुनने से वार्तालाप में संरचित निर्देश जुड़ते हैं; होस्ट एजेंट के पास फ़ाइल, टर्मिनल और Git एक्सेस होना चाहिए और हर चरण में `read_skill` कॉल करना चाहिए। जब भी किसी skill को डिज़ाइन अनुमोदन, योजना समीक्षा या ब्रांच-समापन निर्णय चाहिए, वर्कफ़्लो रुकता है।
+
+| लक्ष्य | MCP Prompt | यह क्या करता है |
+| :--- | :--- | :--- |
+| नई सुविधा बनाएँ | `feature-pipeline` | पूर्ण इंटरैक्टिव सुविधा वर्कफ़्लो शुरू करता है। |
+| जटिल बग की जाँच व सुधार करें | `structured-debug` | संरचित डिबगिंग वर्कफ़्लो शुरू करता है। |
+| बड़े रीफ़ैक्टर या माइग्रेशन की योजना बनाएँ | रीफ़ैक्टर परिदृश्य सहित `skill-composition` | Pipeline 3 अनुशंसित करता है; अभी कोई समर्पित लॉन्चर prompt नहीं है। |
+| लेगेसी कोडबेस स्थिर करें | लेगेसी परिदृश्य सहित `skill-composition` | Pipeline 4 अनुशंसित करता है; अभी कोई समर्पित लॉन्चर prompt नहीं है। |
+
+पोर्टेबल आह्वान विधि आपके क्लाइंट का **MCP Prompts मेनू** है। Slash-command नाम क्लाइंट अनुसार बदलते हैं और उनमें कॉन्फ़िगर MCP सर्वर नाम शामिल हो सकता है। सामान्य चैट में prompt नाम का उल्लेख मात्र से यह गारंटी नहीं कि क्लाइंट वह MCP prompt लाएगा।
+
+यही मार्गदर्शिका MCP क्लाइंटों को `guide://superpowers/skill-compositions` के रूप में एक्सपोज़ की जाती है।
+
+### पूर्वापेक्षाएँ
+
+- लक्ष्य रिपॉज़िटरी, फ़ाइलों, टर्मिनल और Git तक एक्सेस वाली एजेंट सत्र में चलाएँ।
+- Worktree निर्माण हेतु Git रिपॉज़िटरी तथा ब्रांच व डायरेक्टरी बनाने की अनुमति चाहिए।
+- `subagent-driven-development` हेतु होस्ट-प्रदत्त मल्टी-एजेंट टूल चाहिए। अनुपलब्ध होने पर `feature-pipeline` इनलाइन फ़ॉलबैक के रूप में `executing-plans` उपयोग करता है।
+- Push, pull request, merge और विनाशकारी सफ़ाई स्पष्ट उपयोगकर्ता निर्णय बने रहते हैं।
+
+## 2. Skill संयोजन क्यों महत्वपूर्ण हैं
+
+`superpowers-mcp` के 15 मुख्य skills संपूर्ण सॉफ़्टवेयर विकास जीवनचक्र (SDLC) को कवर करते हैं: आवश्यकता खोज, आर्किटेक्चर योजना, पृथक workspace सेटअप, टेस्ट-चालित विकास (TDD) और व्यवस्थित डिबगिंग से लेकर पूर्ण सत्यापन, कोड समीक्षा और ब्रांच एकीकरण तक।
+
+जहाँ हर atomic skill सटीक इंजीनियरिंग टूल की तरह काम करता है, उत्पादन-स्तरीय विकास हेतु **वर्कफ़्लो ऑर्केस्ट्रेशन** चाहिए। Skill संयोजन तदर्थ AI इंटरैक्शन को अनुशासित, पुनरुत्पादनीय और सुरक्षा-संरक्षित इंजीनियरिंग पाइपलाइनों में बदल देते हैं।
+
+---
+
+## 3. मुख्य आर्किटेक्चर सिद्धांत
+
+Skills संयोजित करते समय ये पाँच सुरक्षा तंत्र हमेशा लागू करें:
+
+1. **पहले पृथक्करण (Git Worktrees द्वारा)**: जब भी कई subagents समन्वयित करें या स्वतंत्र परिकल्पनाएँ समानांतर डिबग करें, फ़ाइलसिस्टम रेस कंडीशन और workspace प्रदूषण से बचने हेतु हमेशा `superpowers:using-git-worktrees` उपयोग करें।
+2. **डिफ़ॉल्ट TDD**: पहले असफल टेस्ट (Red-Green-Refactor चक्र) के बिना कोई कोड संशोधन नहीं, ताकि रिग्रेशन सुरक्षा गारंटीकृत हो।
+3. **दोहरी-परत समीक्षा गेट**: कार्य-स्तरीय spec अनुपालन जाँच या सुविधा-स्तरीय ब्रांच समीक्षा (`requesting-code-review` / `receiving-code-review`) कभी न छोड़ें।
+4. **पूर्ण होने से पहले पूर्ण सत्यापन**: done कहने या ब्रांच मर्ज करने से पहले संपूर्ण टेस्ट सूट, टाइप-चेकर और linter (`verification-before-completion`) चलाएँ।
+5. **Remote-सुरक्षा सीमा (केवल स्थानीय commits)**: Commits स्थानीय रखें — योजना या मानव साथी कहे बिना push/pull/fetch नहीं। साझा ref से `--no-track` (या पहले commit से पहले `--unset-upstream`) के साथ ब्रांच बनाएँ ताकि सुविधा ब्रांच कभी साझा ब्रांच को ट्रैक न करे, और साझा ब्रांच कभी rewrite न करें (`git revert` ही एकमात्र उपाय है जो आप स्वयं लगाते हैं)।
+
+---
+
+## 4. चार मानक वर्कफ़्लो पाइपलाइन
+
+### Pipeline 1: एंड-टू-एंड सुविधा विकास
+**उपयुक्त:** नई सुविधाएँ, बड़े मॉड्यूल या मुख्य सबसिस्टम संवर्धन बनाना।
+
+```mermaid
+flowchart LR
+    F1[brainstorming] --> F2[writing-plans]
+    F2 --> F3[using-git-worktrees]
+    F3 --> F4["subagent-driven-development / executing-plans (with TDD)"]
+    F4 --> F5[verification-before-completion]
+    F5 --> F6[requesting-code-review]
+    F6 --> F7[finishing-a-development-branch]
+```
+
+| चरण | Skill | उत्तरदायित्व व सुपुर्दगी |
+| :--- | :--- | :--- |
+| **1. आवश्यकता व डिज़ाइन** | `brainstorming` | आशय, बाधाएँ, आर्किटेक्चर निर्णय और edge cases स्पष्ट करें; साझा समझ पुष्ट करें, योजना-हैंडऑफ़ समीक्षा चलाएँ और डिज़ाइन Spec आउटपुट करें। |
+| **2. योजना निर्माण** | `writing-plans` | Spec को Recommended Skills सहित छोटे, परीक्षणयोग्य कार्यों में बाँटें। |
+| **3. Workspace पृथक्करण** | `using-git-worktrees` | मुख्य ब्रांच और सक्रिय कार्य की रक्षा हेतु पृथक Git worktree बनाएँ। |
+| **4. कार्य निष्पादन** | `subagent-driven-development` या `executing-plans` | होस्ट समर्थित हो तो ताज़ा subagents उपयोग करें; अन्यथा इनलाइन निष्पादित करें। कार्यान्वयन कार्यों हेतु `test-driven-development` लोड करें और Red ➔ Green ➔ Refactor लागू करें। |
+| **5. पूर्ण सूट सत्यापन** | `verification-before-completion` | शून्य रिग्रेशन हेतु पूर्ण टेस्ट सूट, linter और टाइप जाँच चलाएँ; जब कोई टेस्ट कमांड न हो, आर्टिफ़ैक्ट पुनः खोलें और अनुरोध के हर भाग का हिसाब दें। |
+| **6. प्रतिकूल समीक्षा** | `requesting-code-review` | समीक्षा पैकेज जोड़ें और व्यापक कोड व आर्किटेक्चर समीक्षाएँ करें। |
+| **7. ब्रांच समापन** | `finishing-a-development-branch` | विलंबित निष्कर्ष निर्यात करें (PR चेकलिस्ट या committed follow-ups फ़ाइल), फिर उपलब्ध merge/PR/keep विकल्प प्रस्तुत करें और केवल उपयोगकर्ता-चुना विकल्प निष्पादित करें। |
+
+---
+
+### Pipeline 2: संरचित समस्या-निवारण व बहु-विफलता डिबगिंग
+**उपयुक्त:** जटिल बग, flaky टेस्ट, कई टेस्ट विफलताएँ या उत्पादन घटनाएँ।
+
+```mermaid
+flowchart LR
+    D1[systematic-debugging] --> D2[using-git-worktrees]
+    D2 --> D3[dispatching-parallel-agents]
+    D3 --> D4[test-driven-development]
+    D4 --> D5[verification-before-completion]
+    D5 --> D6[requesting-code-review]
+    D6 --> D7[finishing-a-development-branch]
+```
+
+1. **`systematic-debugging`**: मूल कारणों की जाँच करें और विफलताओं को भिन्न, परीक्षणयोग्य परिकल्पनाओं में बाँटें।
+2. **`using-git-worktrees`**: समानांतर जाँच हेतु पृथक worktrees प्रावधानित करें ताकि टेस्ट हस्तक्षेप रुके।
+3. **`dispatching-parallel-agents`**: प्रत्येक परिकल्पना मान्य/अमान्य करने हेतु समवर्ती subagents भेजें।
+4. **`test-driven-development`**: लक्षित बगफ़िक्स लगाने से पहले न्यूनतम असफल पुनरुत्पादन टेस्ट लिखें।
+5. **`verification-before-completion`**: मान्य करें कि सभी रिपॉज़िटरी टेस्ट स्वच्छ आउटपुट सहित पास हों।
+6. **`requesting-code-review`** (और `receiving-code-review`): सुधार डेल्टा की समीक्षा करें, रक्षात्मक रिग्रेशन कवरेज सुनिश्चित करें और समीक्षा निष्कर्ष सुलझाएँ।
+7. **`finishing-a-development-branch`**: बगफ़िक्स ब्रांच मर्ज करें, अस्थायी worktrees हटाएँ और workspace साफ़ करें।
+
+---
+
+### Pipeline 3: बड़ा रीफ़ैक्टरिंग व सिस्टम माइग्रेशन
+**उपयुक्त:** आर्किटेक्चर रीफ़ैक्टर, फ़्रेमवर्क माइग्रेशन या सेवा पृथक्करण।
+
+```mermaid
+flowchart LR
+    R1[brainstorming] --> R2["writing-plans (skeleton-first)"]
+    R2 --> R3[using-git-worktrees]
+    R3 --> R4[subagent-driven-development]
+    R4 --> R5[verification-before-completion]
+    R5 --> R6[requesting-code-review]
+    R6 --> R7[finishing-a-development-branch]
+```
+
+1. **`brainstorming`**: इंटरफ़ेस अनुबंध, संक्रमण रणनीतियाँ और समता मानदंड परिभाषित करें।
+2. **`writing-plans` (Skeleton-First मोड)**: पहले सभी सबसिस्टमों में सबसे पतला एंड-टू-एंड slice डिज़ाइन करें।
+3. **`using-git-worktrees`**: समर्पित दीर्घजीवी माइग्रेशन worktrees स्थापित करें।
+4. **`subagent-driven-development`**: प्रति-कार्य अनिवार्य समीक्षा गेट सहित चरणबद्ध रीफ़ैक्टर कार्य निष्पादित करें।
+5. **`verification-before-completion`** + **`requesting-code-review`**: पूर्ण रिग्रेशन सत्यापन और आर्किटेक्चर समीक्षा।
+6. **`finishing-a-development-branch`**: माइग्रेशन ब्रांच मर्ज करें, worktrees साफ़ करें और डिलीवरी अंतिम करें।
+
+---
+
+### Pipeline 4: लेगेसी कोडबेस सुरक्षा-जाल
+**उपयुक्त:** स्वचालित टेस्ट कवरेज या सुसंगत पैटर्न रहित लेगेसी कोडबेस।
+
+```mermaid
+flowchart LR
+    L1[brainstorming] --> L2[writing-plans]
+    L2 --> L3["test-driven-development (characterization)"]
+    L3 --> L4[systematic-debugging]
+    L4 --> L5[verification-before-completion]
+```
+
+1. **`brainstorming`**: महत्वपूर्ण व्यवसाय पथ और उच्च-जोखिम मॉड्यूल पहचानें।
+2. **`writing-plans`**: characterization और सीमा टेस्ट जोड़ने का रोडमैप बनाएँ।
+3. **`test-driven-development`**: TDD characterization गार्ड से मौजूदा व्यवहारों पर golden-master और रिग्रेशन टेस्ट लिखें (mutate, विफलता सत्यापित, VCS से restore, stay green)।
+4. **`systematic-debugging`**: टेस्ट आधार स्थापित करते समय उभरे छिपे दोषों का मूल-कारण खोजें।
+5. **`verification-before-completion`**: स्वचालित CI टेस्ट अवरोध सुदृढ़ करें।
+
+### Meta Skill: सत्र फॉरेंसिक
+
+चार पाइपलाइनों से बाहर, **`diagnosing-superpowers`** डिस्क पर ट्रांसक्रिप्ट से पिछली सत्र की गड़बड़ी का पुनर्निर्माण करता है: intake साक्षात्कार, सत्र खोज, उद्धृत साक्ष्य सहित समानांतर विश्लेषक रिपोर्ट, फिर वैकल्पिक स्क्रब बंडल या GitHub issue मसौदा। जब सत्र योजना अनदेखा करे, कार्य दोहराए या अव्याख्येय परिणाम दे — और जब निष्कर्ष upstream का हो, तो मेंटेनर रिपोर्ट भी मसौदित करता है। MCP सर्वर केवल skill सामग्री परोसता है; एजेंट होस्ट की ट्रांसक्रिप्ट फ़ाइलें अपने टूलों से पढ़ता है, इसलिए कोई ट्रांसक्रिप्ट सर्वर सीमा पार नहीं करती।
+
+---
+
+## 5. योजनाओं में skill मेटाडेटा स्कीमा
+
+`writing-plans` द्वारा जेनरेट योजनाओं में हर कार्य हेतु अनुशंसित skills निर्दिष्ट करें:
+
+```markdown
+### Task 1: Implement Token Authentication Middleware
+- **Goal**: Validate JWT tokens and extract user claims
+- **Target Files**: `src/auth/jwt.ts`, `tests/auth/jwt.test.ts`
+- **Recommended Skill**: `superpowers:test-driven-development`
+- **Task Brief**:
+  1. Write failing test for expired and invalid signatures (FAIL)
+  2. Implement minimal signature verification (PASS)
+  3. Refactor with strict type safety
+```
+
+### नियंत्रक-से-subagent प्रेषण प्रोटोकॉल
+जब नियंत्रक एजेंट कार्य subagent भेजता है:
+1. नियंत्रक योजना कार्य में निर्दिष्ट `Recommended Skill` पढ़ता है।
+2. नियंत्रक निर्देश इंजेक्ट करता है या subagent को `read_skill(skill_name)` से वह skill लोड करने हेतु मार्गदर्शित करता है।
+3. Subagent उस skill की सख्त पद्धति से निष्पादित करता है (उदा. Red-Green-Refactor)।
+
+---
+
+## 6. नेटिव MCP Prompts संदर्भ
+
+`superpowers-mcp` IDEs (Cursor, Antigravity, VS Code, Devin Desktop) में नेटिव, उपयोग-तैयार MCP prompts देता है:
+
+| MCP Prompt | तर्क | उद्देश्य |
+| :--- | :--- | :--- |
+| **`feature-pipeline`** | आवश्यक `feature_name`, वैकल्पिक `requirements` | एंड-टू-एंड सुविधा विकास हेतु इंटरैक्टिव लॉन्चर। |
+| **`structured-debug`** | `issue_description`, `failing_tests` | व्यवस्थित डिबगिंग और वैकल्पिक मल्टी-एजेंट जाँच हेतु इंटरैक्टिव लॉन्चर। |
+| **`skill-composition`** | `scenario` | सुविधा, debug, refactor या लेगेसी कार्यों हेतु गतिशील skill संयोजन अनुशंसक। |
+| **`session-start`** | - | आधारभूत Superpowers संदर्भ और skill आह्वान नियम इंजेक्ट करता है। |
+| **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD कार्य कार्यान्वयनकर्ता subagent prompt टेम्पलेट। |
+| **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD प्रति-कार्य spec व गुणवत्ता समीक्षक prompt टेम्पलेट। |
+| **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD सुधार-राउंड सीमित पुनः-समीक्षक prompt टेम्पलेट। |
+| **`spec-reviewer`** | `spec_file` | प्रतिकूल डिज़ाइन spec समीक्षक prompt टेम्पलेट। |
+| **`plan-reviewer`** | `plan_file`, `spec_file` | प्रतिकूल कार्यान्वयन योजना समीक्षक prompt टेम्पलेट। |
+
+---
+
+## 7. व्यावहारिक उपयोग मार्गदर्शिका
+
+`superpowers-mcp` इंस्टॉल होने पर नेटिव MCP prompt से शुरू करें और उसके निर्देशों को आवश्यक skills लोड करने दें।
+
+### विधि A: MCP Prompts मेनू (अनुशंसित)
+MCP prompts समर्थित क्लाइंट में:
+1. पुष्टि करें कि कॉन्फ़िगर `superpowers` MCP सर्वर जुड़ा है।
+2. **नई सुविधा विकास**: `feature-pipeline` चुनें और `feature_name` तथा वैकल्पिक `requirements` दें।
+3. **समस्या-निवारण व बगफ़िक्स**: `structured-debug` चुनें और त्रुटि लॉग या असफल टेस्ट नाम चिपकाएँ।
+4. **कस्टम / आर्किटेक्चर कार्य**: अपने परिदृश्य हेतु सर्वोत्तम पाइपलाइन AI से अनुशंसित कराने हेतु `skill-composition` चुनें।
+
+आपका क्लाइंट नेमस्पेस्ड slash command भी एक्सपोज़ कर सकता है। `/feature-pipeline` पोर्टेबल मानने के बजाय सटीक सिंटैक्स हेतु उसका prompt picker देखें।
+
+### विधि B: प्राकृतिक-भाषा फ़ॉलबैक
+आप एजेंट से नामित वर्कफ़्लो अनुसरण करने को कह सकते हैं, पर यह गारंटी नहीं कि क्लाइंट नेटिव MCP prompt लाएगा। नियतात्मक उपयोग हेतु MCP Prompts मेनू से चुनें।
+- *"कृपया [सुविधा नाम] बनाने हेतु `feature-pipeline` अनुसरण करें।"*
+- *"इस त्रुटि पर `structured-debug` वर्कफ़्लो चलाएँ: [त्रुटि / trace चिपकाएँ]।"*
+- *"[मॉड्यूल] रीफ़ैक्टर करने हेतु `docs/skill-compositions.hi.md` से Refactoring Pipeline लागू करें।"*
+
+### 💬 इंटरैक्टिव चरण-दर-चरण वॉकथ्रू उदाहरण:
+```text
+[You]: (Selects the `feature-pipeline` MCP prompt and enters "coupon code checkout system".)
+  ↓
+[AI]: (Loads brainstorming with `read_skill`) "Understood. Does the coupon have an expiry date, and can it stack with site-wide sales?"
+  ↓
+[You]: "It has an expiry date, and it cannot stack."
+  ↓
+[AI]: (After design approval, loads `writing-plans`) "Created implementation plan at docs/superpowers/plans/... Please review."
+  ↓
+[You]: "Looks good, proceed."
+  ↓
+[AI]: (Creates or verifies a worktree ➔ uses SDD or the inline fallback ➔ implements via TDD ➔ verifies ➔ reviews ➔ presents branch-finishing choices)
+  ↓
+[AI]: "All tasks and full test suite passed (100%). Code review clean. Branch ready for merge!"
+```

package/docs/skill-compositions.ja.md

@@ -1,12 +1,36 @@
 # Superpowers MCP: スキル構成 & ワークフローパイプライン (Skill Compositions & Workflow Pipelines)
 
-[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md)
+[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md) | [Español](skill-compositions.es.md) | [Português (BR)](skill-compositions.pt-BR.md) | [हिन्दी](skill-compositions.hi.md)
 
 > **重要:** これらの MCP prompts は対話型ワークフローランチャーであり、サーバー側の自動化ではありません。クライアントの MCP Prompts メニューから選択してください。slash command の構文はクライアントごとに異なります。エージェントにはファイル、ターミナル、Git へのアクセスが必要で、各段階で `read_skill` を呼び出します。設計承認、計画レビュー、ブランチ完了時にはユーザーの判断を待ちます。完全なガイドは `guide://superpowers/skill-compositions` でも取得できます。
 
 > **正典（Source of Truth）：** 本英語版が原本です。スキルの振る舞いが変わったら英語版を先に更新し、翻訳を同期してください。
 
-## 1. スキル構成が重要な理由 (Why Skill Compositions Matter)
+## 1. ワークフローを選択する (Choose a Workflow)
+
+これらの prompt は**対話型ワークフローランチャー**であり、サーバー側の自動化ではありません。いずれかを選択すると構造化された指示が会話に追加されます。ホストエージェントはファイル、ターミナル、Git へのアクセスを持ち、各段階で `read_skill` を呼び出す必要があります。スキルが設計承認、計画レビュー、ブランチ完了の判断を求める場合、ワークフローはユーザーの決定を待ちます。
+
+| 目的 | MCP Prompt | 内容 |
+| :--- | :--- | :--- |
+| 新機能を開発する | `feature-pipeline` | 完全な対話型機能開発ワークフローを開始します。 |
+| 複雑なバグを調査・修正する | `structured-debug` | 構造化デバッグワークフローを開始します。 |
+| 大規模なリファクタリングや移行を計画する | リファクタリングシナリオ付き `skill-composition` | パイプライン 3 を推奨します。専用のランチャー prompt はまだありません。 |
+| レガシーコードベースを安定化させる | レガシーシナリオ付き `skill-composition` | パイプライン 4 を推奨します。専用のランチャー prompt はまだありません。 |
+
+移植性のある呼び出し方法はクライアントの **MCP Prompts メニュー**です。slash-command 名はクライアントごとに異なり、設定済み MCP サーバー名を含む場合があります。通常のチャットで prompt 名に触れただけでは、クライアントがその MCP prompt を取得する保証はありません。
+
+本ガイドは MCP クライアント向けに `guide://superpowers/skill-compositions` としても公開されています。
+
+### 前提条件 (Prerequisites)
+
+- 対象リポジトリ、ファイル、ターミナル、Git にアクセスできるエージェントセッションで実行してください。
+- worktree の作成には Git リポジトリと、ブランチおよびディレクトリを作成する権限が必要です。
+- `subagent-driven-development` にはホスト提供のマルチエージェントツールが必要です。利用できない場合、`feature-pipeline` はインラインの代替として `executing-plans` を使用します。
+- push、pull request、マージ、破壊的なクリーンアップは引き続きユーザーの明示的な判断事項です。
+
+---
+
+## 2. スキル構成が重要な理由 (Why Skill Compositions Matter)
 
 `superpowers-mcp` に含まれる 15 のコアスキルは、要件の明確化、アーキテクチャ設計、分離されたワークスペースの構築、テスト駆動開発 (TDD)、体系的なデバッグから、完全検証、コードレビュー、ブランチ統合に至るまで、ソフトウェア開発ライフサイクル (SDLC) 全体を網羅しています。
 
@@ -14,7 +38,7 @@
 
 ---
 
-## 2. コアアーキテクチャ原則 (Core Architectural Principles)
+## 3. コアアーキテクチャ原則 (Core Architectural Principles)
 
 スキルを組み合わせる際は、常に以下の 5 つの安全防御メカニズムを適用してください。
 
@@ -26,7 +50,7 @@
 
 ---
 
-## 3. 4つの標準スキル構成パイプライン (Four Standard Workflow Pipelines)
+## 4. 4つの標準スキル構成パイプライン (Four Standard Workflow Pipelines)
 
 ### パイプライン 1: エンドツーエンド新機能開発 (Feature Development Pipeline)
 **推奨用途：** 新機能のスクラッチ開発、主要モジュールの追加、コアプロセスのリファクタリング。
@@ -35,11 +59,10 @@
 flowchart LR
     F1[brainstorming] --> F2[writing-plans]
     F2 --> F3[using-git-worktrees]
-    F3 --> F4[subagent-driven-development / executing-plans]
-    F4 --> F5[test-driven-development]
-    F5 --> F6[verification-before-completion]
-    F6 --> F7[requesting-code-review]
-    F7 --> F8[finishing-a-development-branch]
+    F3 --> F4["subagent-driven-development / executing-plans (with TDD)"]
+    F4 --> F5[verification-before-completion]
+    F5 --> F6[requesting-code-review]
+    F6 --> F7[finishing-a-development-branch]
 ```
 
 | ステップ | スキル (Skill) | 責務と成果物 |
@@ -47,11 +70,10 @@ flowchart LR
 | **1. 要件と設計** | `brainstorming` | 要件、制約、アーキテクチャ上の決定事項を整理し、共通理解の確認とプランニング・ハンドオフ・レビューを経て仕様書 (Spec) を出力。 |
 | **2. 計画策定** | `writing-plans` | 仕様書を独立して検証可能なタスクリストに分解し、Recommended Skill を明記。 |
 | **3. 環境分離** | `using-git-worktrees` | 独立した Git Worktree を作成し、メインブランチと作業環境を保護。 |
-| **4. タスク実行** | `subagent-driven-development` | 独立したサブエージェントを順次起動し、クリーンなコンテキストでタスクを実行。 |
-| **5. ロジック実装** | `test-driven-development` | 各タスクのビジネスロジックに対して Red ➔ Green ➔ Refactor を厳格に適用。 |
-| **6. フルテスト検証** | `verification-before-completion` | フルテストスイート、Linter、型チェックを実行し、回帰がないことを確認。テストコマンドが無い場合は成果物を再度開き、要求事項を漏れなく確認。 |
-| **7. コードレビュー** | `requesting-code-review` | レビューパッケージを生成し、多角的なコード＆アーキテクチャレビューを実施。 |
-| **8. ブランチ完了** | `finishing-a-development-branch` | 保留所見をエクスポート（PR チェックリストまたは follow-ups ファイル）してから、マージ/PR、Worktree の整理、一時ブランチの削除を実施。 |
+| **4. タスク実行** | `subagent-driven-development` または `executing-plans` | ホストが対応している場合は新しいサブエージェントを使用し、対応していない場合はインラインで実行。実装タスクでは `test-driven-development` を読み込み、Red ➔ Green ➔ Refactor を適用。 |
+| **5. フルテスト検証** | `verification-before-completion` | フルテストスイート、Linter、型チェックを実行し、回帰がないことを確認。テストコマンドが無い場合は成果物を再度開き、要求事項を漏れなく確認。 |
+| **6. コードレビュー** | `requesting-code-review` | レビューパッケージを生成し、多角的なコード＆アーキテクチャレビューを実施。 |
+| **7. ブランチ完了** | `finishing-a-development-branch` | 保留所見をエクスポート（PR チェックリストまたは follow-ups ファイル）してから、マージ/PR、Worktree の整理、一時ブランチの削除を実施。 |
 
 ---
 
@@ -123,7 +145,7 @@ flowchart LR
 
 ---
 
-## 4. スキル作成とメタデータ標準 (Skill Authoring & Metadata Standards)
+## 5. スキル作成とメタデータ標準 (Skill Authoring & Metadata Standards)
 
 `writing-plans` で作成する実装計画において、各タスクに推奨スキルを指定できます：
 
@@ -146,7 +168,7 @@ flowchart LR
 
 ---
 
-## 5. ネイティブ MCP Prompts 一覧
+## 6. ネイティブ MCP Prompts 一覧
 
 `superpowers-mcp` は主要な MCP クライアント（Cursor、Antigravity、VS Code、Devin Desktop など）で利用可能な標準 Prompts を提供します：
 
@@ -164,7 +186,7 @@ flowchart LR
 
 ---
 
-## 6. IDE での実際の操作方法 (How to Use in Practice)
+## 7. IDE での実際の操作方法 (How to Use in Practice)
 
 `superpowers-mcp` を設定すれば、**15 個の個別スキル名を覚える必要は一切ありません**。以下の 2 つの方法で簡単に利用できます：
 

package/docs/skill-compositions.ko.md

@@ -1,20 +1,44 @@
 # Superpowers MCP: 스킬 조합 및 워크플로우 파이프라인 (Skill Compositions & Workflow Pipelines)
 
-[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md)
+[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md) | [Español](skill-compositions.es.md) | [Português (BR)](skill-compositions.pt-BR.md) | [हिन्दी](skill-compositions.hi.md)
 
 > **중요:** 이 MCP prompts는 대화형 워크플로 런처이며 서버 측 자동화가 아닙니다. 클라이언트의 MCP Prompts 메뉴에서 선택하세요. slash command 문법은 클라이언트마다 다릅니다. 에이전트는 파일, 터미널, Git에 접근할 수 있어야 하며 각 단계에서 `read_skill`을 호출합니다. 설계 승인, 계획 검토, 브랜치 마무리 단계에서는 사용자 결정을 기다립니다. 전체 가이드는 `guide://superpowers/skill-compositions`에서도 읽을 수 있습니다.
 
 > **단일 소스(Source of Truth):** 이 영어 문서가 정본입니다. 스킬 동작이 바뀌면 영어 문서를 먼저 갱신하고 번역을 동기화하세요.
 
-## 1. 스킬 조합이 중요한 이유 (Why Skill Compositions Matter)
+## 1. 워크플로 선택하기 (Choose a Workflow)
+
+이 prompt들은 **대화형 워크플로 런처**이며 서버 측 자동화가 아닙니다. 하나를 선택하면 구조화된 지침이 대화에 추가됩니다. 호스트 에이전트는 파일, 터미널, Git에 접근할 수 있어야 하며 각 단계에서 `read_skill`을 호출해야 합니다. 스킬이 설계 승인, 계획 검토 또는 브랜치 마무리 결정을 요구하면 워크플로가 사용자 결정을 기다립니다.
+
+| 목표 | MCP Prompt | 내용 |
+| :--- | :--- | :--- |
+| 새 기능 개발 | `feature-pipeline` | 완전한 대화형 기능 개발 워크플로를 시작합니다. |
+| 복잡한 버그 조사 및 수정 | `structured-debug` | 구조화된 디버깅 워크플로를 시작합니다. |
+| 대규모 리팩토링 또는 마이그레이션 계획 | 리팩토링 시나리오와 함께 `skill-composition` | 파이프라인 3을 권장합니다. 전용 런처 prompt는 아직 없습니다. |
+| 레거시 코드베이스 안정화 | 레거시 시나리오와 함께 `skill-composition` | 파이프라인 4를 권장합니다. 전용 런처 prompt는 아직 없습니다. |
+
+이식성 있는 호출 방법은 클라이언트의 **MCP Prompts 메뉴**입니다. slash-command 이름은 클라이언트마다 다르며 구성된 MCP 서버 이름을 포함할 수 있습니다. 일반 채팅에서 prompt 이름을 언급하는 것만으로는 클라이언트가 해당 MCP prompt를 가져온다는 보장이 없습니다.
+
+본 가이드는 MCP 클라이언트에 `guide://superpowers/skill-compositions`로도 노출됩니다.
+
+### 사전 요구사항 (Prerequisites)
+
+- 대상 저장소, 파일, 터미널, Git에 접근할 수 있는 에이전트 세션에서 실행하세요.
+- worktree 생성에는 Git 저장소와 브랜치 및 디렉터리 생성 권한이 필요합니다.
+- `subagent-driven-development`에는 호스트가 제공하는 멀티에이전트 도구가 필요합니다. 사용할 수 없으면 `feature-pipeline`이 인라인 대안으로 `executing-plans`를 사용합니다.
+- push, pull request, 병합, 파괴적인 정리는 계속 사용자의 명시적 결정 사항입니다.
+
+---
+
+## 2. 스킬 조합이 중요한 이유 (Why Skill Compositions Matter)
 
 `superpowers-mcp`의 15개 핵심 스킬은 요구사항 명확화, 아키텍처 설계, 격리된 작업 환경 구축, 테스트 주도 개발(TDD), 체계적 디버깅부터 전체 검증, 코드 리뷰, 브랜치 통합에 이르기까지 소프트웨어 개발 라이프사이클(SDLC) 전반을 다룹니다.
 
-각 스킬은 단독으로도 정밀한 엔지니어링 도구 역할을 하지만, 실제 프로덕션 개발에는 **워크플로우 오케스트레이션(편성)**이 필수적입니다. 스킬 조합(Skill Composition)을 통해 임의적인 AI 상호작용을 체계적이고 재현 가능하며 안전하게 보호되는 엔지니어링 파이프라인으로 전환합니다.
+각 스킬은 단독으로도 정밀한 엔지니어링 도구 역할을 하지만, 실제 프로덕션 개발에는 **워크플로우 오케스트레이션(편성)** 이 필수적입니다. 스킬 조합(Skill Composition)을 통해 임의적인 AI 상호작용을 체계적이고 재현 가능하며 안전하게 보호되는 엔지니어링 파이프라인으로 전환합니다.
 
 ---
 
-## 2. 핵심 아키텍처 원칙 (Core Architectural Principles)
+## 3. 핵심 아키텍처 원칙 (Core Architectural Principles)
 
 스킬을 조합할 때는 항상 다음 5가지 안전 보호 메커니즘을 준수해야 합니다:
 
@@ -26,7 +50,7 @@
 
 ---
 
-## 3. 4대 표준 스킬 조합 파이프라인 (Four Standard Workflow Pipelines)
+## 4. 4대 표준 스킬 조합 파이프라인 (Four Standard Workflow Pipelines)
 
 ### 파이프라인 1: 엔드투엔드 새 기능 개발 (Feature Development Pipeline)
 **권장 시나리오:** 새 기능 초기 개발, 주요 모듈 추가, 핵심 프로세스 리팩토링.
@@ -35,11 +59,10 @@
 flowchart LR
     F1[brainstorming] --> F2[writing-plans]
     F2 --> F3[using-git-worktrees]
-    F3 --> F4[subagent-driven-development / executing-plans]
-    F4 --> F5[test-driven-development]
-    F5 --> F6[verification-before-completion]
-    F6 --> F7[requesting-code-review]
-    F7 --> F8[finishing-a-development-branch]
+    F3 --> F4["subagent-driven-development / executing-plans (with TDD)"]
+    F4 --> F5[verification-before-completion]
+    F5 --> F6[requesting-code-review]
+    F6 --> F7[finishing-a-development-branch]
 ```
 
 | 단계 | 스킬 (Skill) | 역할 및 산출물 |
@@ -47,11 +70,10 @@ flowchart LR
 | **1. 요구사항 및 설계** | `brainstorming` | 요구사항, 제약사항, 아키텍처 결정을 명확히 하고 공유 이해 확인과 플래닝 핸드오프 리뷰를 거쳐 설계 스펙(Spec) 산출. |
 | **2. 계획 수립** | `writing-plans` | 스펙을 독립 검증 가능한 태스크 목록으로 분해하고 Recommended Skill 명시. |
 | **3. 환경 격리** | `using-git-worktrees` | 격리된 Git Worktree를 생성하여 메인 브랜치와 작업 환경 보호. |
-| **4. 태스크 실행** | `subagent-driven-development` | 독립된 서브에이전트를 순차 실행하여 깨끗한 컨텍스트 유지. |
-| **5. 로직 구현** | `test-driven-development` | 각 태스크의 비즈니스 로직에 대해 Red ➔ Green ➔ Refactor 주기 엄격 준수. |
-| **6. 전체 검증** | `verification-before-completion` | 전체 테스트 스위트, Linter, 타입 검사를 실행하여 회귀가 없음을 확인. 테스트 명령이 없으면 산출물을 다시 열어 요청 사항을 빠짐없이 점검. |
-| **7. 코드 리뷰** | `requesting-code-review` | 리뷰 패키지를 생성하고 다각적인 코드 및 아키텍처 리뷰 수행. |
-| **8. 브랜치 마무리** | `finishing-a-development-branch` | 보류 발견을 내보낸 뒤(PR 체크리스트 또는 follow-ups 파일) 병합/PR, Worktree 정리, 임시 브랜치 삭제를 수행. |
+| **4. 태스크 실행** | `subagent-driven-development` 또는 `executing-plans` | 호스트가 지원하면 새 서브에이전트를 사용하고, 지원하지 않으면 인라인으로 실행. 구현 태스크에는 `test-driven-development`를 로드하고 Red ➔ Green ➔ Refactor를 적용. |
+| **5. 전체 검증** | `verification-before-completion` | 전체 테스트 스위트, Linter, 타입 검사를 실행하여 회귀가 없음을 확인. 테스트 명령이 없으면 산출물을 다시 열어 요청 사항을 빠짐없이 점검. |
+| **6. 코드 리뷰** | `requesting-code-review` | 리뷰 패키지를 생성하고 다각적인 코드 및 아키텍처 리뷰 수행. |
+| **7. 브랜치 마무리** | `finishing-a-development-branch` | 보류 발견을 내보낸 뒤(PR 체크리스트 또는 follow-ups 파일) 병합/PR, Worktree 정리, 임시 브랜치 삭제를 수행. |
 
 ---
 
@@ -119,11 +141,11 @@ flowchart LR
 
 ### 메타 스킬: 세션 포렌식 (Session Forensics)
 
-네 가지 파이프라인 밖에, **`diagnosing-superpowers`**는 디스크의 트랜스크립트에서 과거 세션의 문제 경위를 재구성합니다: 인테이크 인터뷰, 세션 탐색, 인용 증거가 있는 병렬 애널리스트 보고서, 그리고 선택적으로 스크럽된 번들이나 GitHub 이슈 초안. 세션이 계획을 무시했거나 작업을 반복했거나 설명할 수 없는 결과를 냈을 때 사용하고, 소견이 업스트림에 속하면 메인테이너 보고도 대신 작성합니다. MCP 서버는 스킬 내용 제공만 담당하며, 에이전트가 자체 도구로 호스트의 기록 파일을 읽기 때문에 트랜스크립트가 서버를 경유하지 않습니다.
+네 가지 파이프라인 밖에, **`diagnosing-superpowers`** 는 디스크의 트랜스크립트에서 과거 세션의 문제 경위를 재구성합니다: 인테이크 인터뷰, 세션 탐색, 인용 증거가 있는 병렬 애널리스트 보고서, 그리고 선택적으로 스크럽된 번들이나 GitHub 이슈 초안. 세션이 계획을 무시했거나 작업을 반복했거나 설명할 수 없는 결과를 냈을 때 사용하고, 소견이 업스트림에 속하면 메인테이너 보고도 대신 작성합니다. MCP 서버는 스킬 내용 제공만 담당하며, 에이전트가 자체 도구로 호스트의 기록 파일을 읽기 때문에 트랜스크립트가 서버를 경유하지 않습니다.
 
 ---
 
-## 4. 계획 기반 스킬 구성 스키마 (Plan-Driven Skill Metadata Schema)
+## 5. 계획 기반 스킬 구성 스키마 (Plan-Driven Skill Metadata Schema)
 
 `writing-plans`로 생성된 구현 계획에서 각 태스크별 권장 스킬을 지정할 수 있습니다:
 
@@ -146,7 +168,7 @@ flowchart LR
 
 ---
 
-## 5. 네이티브 MCP Prompts 레퍼런스
+## 6. 네이티브 MCP Prompts 레퍼런스
 
 `superpowers-mcp`는 주요 IDE(Cursor, Antigravity, VS Code, Devin Desktop 등)에서 즉시 사용할 수 있는 표준 Prompts를 제공합니다:
 
@@ -164,7 +186,7 @@ flowchart LR
 
 ---
 
-## 6. IDE에서 실제로 사용하는 방법 (How to Use in Practice)
+## 7. IDE에서 실제로 사용하는 방법 (How to Use in Practice)
 
 `superpowers-mcp`를 설정하면 **15개의 개별 스킬 이름을 일일이 기억할 필요가 없습니다**. 아래의 두 가지 간단한 방법으로 시작할 수 있습니다:
 

package/docs/skill-compositions.md

@@ -1,6 +1,6 @@
 # Superpowers MCP: Skill Compositions & Workflow Pipelines
 
-[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md)
+[English](skill-compositions.md) | [繁體中文](skill-compositions.zh-TW.md) | [日本語](skill-compositions.ja.md) | [한국어](skill-compositions.ko.md) | [Español](skill-compositions.es.md) | [Português (BR)](skill-compositions.pt-BR.md) | [हिन्दी](skill-compositions.hi.md)
 
 > **Source of truth:** this English document is canonical. Update it first when skill behavior changes, then sync the translations.