the-frame-ai 0.2.0 → 0.3.0

package/README.hi.md

@@ -0,0 +1,335 @@
+# THE Frame
+
+FRAME — AI-सहायता प्राप्त एकल विकास के लिए फ्रेमवर्क
+
+[🇺🇸 English](README.md) | [🇨🇳 中文](README.zh.md) | [🇮🇳 हिंदी](README.hi.md) | [🇯🇵 日本語](README.ja.md) | [🇩🇪 Deutsch](README.de.md) | [🇪🇸 Español](README.es.md) | [🇷🇺 Русский](README.ru.md)
+
+## FRAME क्या है?
+
+**FRAME (Framework for AI-Assisted Solo Development)** Claude Code के साथ उत्पाद बनाने वाले एकल डेवलपर्स के लिए एक फ्रेमवर्क है। यह अव्यवस्थित AI-सहायता प्राप्त विकास को एक पूर्वानुमानित प्रक्रिया में बदलता है — विचार से लेकर डिप्लॉय तक — मेमोरी, संरचना और गलतियों से सुरक्षा के साथ।
+
+यदि आप Claude Code के साथ अकेले कोई उत्पाद बना रहे हैं और एक टीम की तरह काम करना चाहते हैं — FRAME आपके लिए है।
+
+## FRAME कौन सी समस्याएं हल करता है?
+
+| समस्या | FRAME क्या प्रदान करता है |
+|--------|--------------------------|
+| सत्रों के बीच संदर्भ खोना | प्रोजेक्ट मेमोरी और सत्र शुरू होने पर स्वचालित स्थिति डंप |
+| कार्यों और प्राथमिकताओं में अव्यवस्था | 6-चरण वर्कफ़्लो: अनुसंधान → योजना → निर्माण → समीक्षा → शिप → प्रतिबिंब |
+| कुछ महत्वपूर्ण तोड़ने का डर | सेफ्टी हुक्स विनाशकारी कमांड को चलने से पहले ब्लॉक करते हैं |
+| दोहराव वाले नियमित कार्य | पूर्ण विकास चक्र के लिए 34 तैयार कमांड |
+| निर्भरताओं वाली जटिल सुविधाएं | स्वतंत्र कार्यों के लिए समानांतर सब-एजेंट |
+| एकल कार्य के लिए कोई संरचना नहीं | Roadmap, STATE.md, MAP.md — हमेशा जानें आप कहां हैं और आगे क्या है |
+
+## FRAME के साथ कैसे काम करें
+
+```
+अनुसंधान → योजना → निर्माण → समीक्षा → शिप → प्रतिबिंब
+```
+
+प्रत्येक सत्र एक चक्र है। `/frame:daily` से शुरू करें, `/frame:ship` के साथ समाप्त करें।
+
+**अनुसंधान** — बनाने से पहले समझें
+`/frame:research <विषय>` चलाएं — Claude कोडबेस, बाहरी स्रोतों का पता लगाता है और अगले चरण के लिए संदर्भ बनाता है।
+
+**योजना** — कार्यों में विभाजित करें
+`/frame:plan <सुविधा>` अनुसंधान को अनुमानों के साथ एक ठोस कार्य सूची में बदलता है।
+
+**निर्माण** — लागू करें
+`/frame:build` TDD के साथ क्रमिक रूप से कार्य निष्पादित करता है (एक बार में 1–3)। कई स्वतंत्र कार्यों के लिए — `/frame:wave` उन्हें समानांतर बैचों में चलाता है। अटक गए — `/frame:unstuck`। बग मिला — `/frame:debug`।
+
+**समीक्षा** — डिप्लॉय करने से पहले जांचें
+`/frame:review` स्वचालित जांच चलाता है और एक चेकलिस्ट देता है: परीक्षण, प्रकार, सुरक्षा, प्रदर्शन।
+
+**शिप** — डिप्लॉय करें और रिकॉर्ड करें
+`/frame:ship` कमिट करता है, वैकल्पिक पुश/PR, और प्रोजेक्ट मेमोरी अपडेट करता है।
+
+**प्रतिबिंब** — सीखें और सुधारें
+डिप्लॉय के बाद `/frame:retrospective` मेट्रिक्स अपडेट करता है और भविष्य के सत्रों के लिए पैटर्न कैप्चर करता है।
+
+## उदाहरण
+
+### नई सुविधा: Google प्रमाणीकरण जोड़ें
+
+```
+/frame:daily
+# → वर्तमान प्रोजेक्ट स्थिति और क्या योजना है देखें
+
+/frame:research "Google OAuth"
+# → Claude कोडबेस का अध्ययन करता है: वर्तमान auth कैसे काम करता है,
+#   कौन से पैटर्न पहले से उपयोग किए जा रहे हैं, क्या जोड़ना है
+
+/frame:plan "Google OAuth"
+# → एक ठोस कार्य सूची प्राप्त करें:
+#   1. Google OAuth क्रेडेंशियल कॉन्फ़िगर करें
+#   2. कॉलबैक रूट जोड़ें
+#   3. सत्रों से कनेक्ट करें
+#   4. UI में बटन जोड़ें
+
+/frame:checkpoint
+# → एक रिस्टोर पॉइंट सेव करें — अगर कुछ गलत हो जाए, तो रोलबैक कर सकते हैं
+
+/frame:wave
+# → कार्य 1–4 स्वतंत्र हैं, Claude उन्हें समानांतर में चलाता है
+
+/frame:review
+# → स्वचालित जांच: परीक्षण, प्रकार, सुरक्षा
+
+/frame:ship
+# → कमिट, वैकल्पिक पुश/PR, प्रोजेक्ट मेमोरी अपडेट
+```
+
+### बग: पासवर्ड रीसेट के बाद उपयोगकर्ता लॉग इन नहीं कर सकते
+
+```
+/frame:daily
+# → संदर्भ पुनर्स्थापित करें, देखें कि बग पहले से योजना में है या इसे जोड़ें
+
+/frame:debug "login after reset"
+# → Claude व्यवस्थित रूप से जांचता है: लॉग, रीसेट फ्लो, सत्र, टोकन
+# → आपको कोड में एक विशिष्ट स्थान के साथ एक परिकल्पना मिलती है
+
+# यदि कारण तुरंत मिल जाए:
+/frame:checkpoint                        # फिक्स से पहले रिस्टोर पॉइंट
+/frame:fast "fix: invalidate old session after password reset"
+# → Claude एक लक्षित फिक्स करता है, एक रिग्रेशन टेस्ट लिखता है
+
+# यदि कारण अस्पष्ट हो — गहराई में जाएं:
+/frame:forensics
+# → इस क्षेत्र में परिवर्तनों के git इतिहास का विश्लेषण करता है,
+#   वह कमिट ढूंढता है जिसने व्यवहार तोड़ा
+
+/frame:checkpoint
+/frame:fast "fix: ..."                   # मिले कारण को ठीक करें
+
+/frame:review
+# → पुष्टि करें कि फिक्स ने अन्य लॉगिन परिदृश्यों को नहीं तोड़ा
+
+/frame:ship
+```
+
+### सुधार: डैशबोर्ड लोडिंग तेज करें
+
+```
+/frame:daily
+
+/frame:performance
+# → बेसलाइन प्राप्त करें: bundle आकार, लोड समय, Lighthouse स्कोर
+#   संख्याएं याद रखें — अंत में तुलना के लिए चाहिए होंगी
+
+/frame:research "dashboard performance"
+# → Claude डैशबोर्ड कोड का विश्लेषण करता है: भारी कंपोनेंट,
+#   अनावश्यक अनुरोध, क्या कैश या lazy-load किया जा सकता है
+
+/frame:plan "dashboard optimization"
+# → प्रभाव अनुमानों के साथ कार्य सूची:
+#   1. भारी चार्ट को lazy load करें
+#   2. API अनुरोधों को कैश करें
+#   3. माउंट पर डुप्लिकेट अनुरोध हटाएं
+
+/frame:build
+# → क्रमिक, प्रत्येक कार्य एक परीक्षण के साथ
+
+/frame:performance
+# → बेसलाइन से तुलना करें: वास्तविक सुधार देखें
+
+/frame:ship
+```
+
+## अंदर क्या है
+
+FRAME प्रदान करता है:
+
+- **6-चरण वर्कफ़्लो**: अनुसंधान → योजना → निर्माण → समीक्षा → शिप → प्रतिबिंब
+- **34 कमांड**: त्वरित कार्यों से लेकर पूर्ण सुविधा विकास चक्र तक
+- **5 AI एजेंट**: शोधकर्ता, योजनाकार, निर्माता, समीक्षक, शैतान का वकील
+- **सेफ्टी हुक्स**: विनाशकारी ऑपरेशन ब्लॉक करते हैं, गुणवत्ता गेट लागू करते हैं
+- **Git सुरक्षा**: चेकपॉइंट, रोलबैक, वर्कट्री, पॉज/रिज्यूम
+
+## पूर्वापेक्षाएं
+
+- Node.js >= 18
+- Git (प्रोजेक्ट एक git रिपॉजिटरी होनी चाहिए)
+
+## त्वरित शुरुआत
+
+```bash
+# यदि आवश्यक हो तो git रेपो इनिशियलाइज़ करें
+git init && git commit --allow-empty -m "init"
+
+# FRAME इंस्टॉल करें
+npx the-frame-ai init
+
+# इस प्रोजेक्ट में Claude Code खोलें और चलाएं:
+/frame:init    # कोडबेस स्कैन करता है, MAP.md भरता है
+/frame:daily   # हर दिन आपका प्रवेश बिंदु
+```
+
+## कमांड
+
+### कोर — यहां से शुरू करें
+
+ये 7 कमांड एकल dev कार्य का 90% कवर करते हैं:
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:daily` | किसी भी ब्रेक के बाद **यहां से शुरू करें** — क्या हुआ, आगे क्या है |
+| `/frame:research <विषय>` | नई सुविधा की योजना बनाने से पहले |
+| `/frame:plan <सुविधा>` | अनुसंधान को एक कार्ययोग्य कार्य सूची में बदलें |
+| `/frame:build` | TDD के साथ 1–3 कार्य लागू करें (क्रमिक) |
+| `/frame:wave` | 4+ स्वतंत्र कार्य लागू करें (समानांतर सब-एजेंट) |
+| `/frame:review` | डिप्लॉय करने से पहले — स्वचालित जांच + चेकलिस्ट |
+| `/frame:ship` | कमिट, वैकल्पिक पुश/PR, मेमोरी अपडेट करें |
+
+### चरण के अनुसार सभी कमांड
+
+<details>
+<summary>अनुसंधान</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:research <विषय>` | नई सुविधा की योजना बनाने से पहले |
+| `/frame:explain <फ़ाइल>` | यह कोड ऐसा क्यों दिखता है? |
+| `/frame:why <विषय>` | निर्णय इतिहास खोजें |
+</details>
+
+<details>
+<summary>योजना</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:plan <सुविधा>` | अनुसंधान को एक कार्ययोग्य कार्य सूची में बदलें |
+| `/frame:add-task` | काम बाधित किए बिना योजना में कार्य जोड़ें |
+</details>
+
+<details>
+<summary>निर्माण</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:build` | TDD के साथ योजना लागू करें (1–3 कार्य, क्रमिक) |
+| `/frame:wave` | समानांतर बैचों में 4+ स्वतंत्र कार्य लागू करें |
+| `/frame:fast <कार्य>` | 30 मिनट से कम का त्वरित कार्य |
+| `/frame:debug <समस्या>` | व्यवस्थित बग जांच |
+| `/frame:forensics` | कुछ क्यों टूटा इसकी गहरी जांच |
+| `/frame:refactor` | TDD सेफ्टी नेट के साथ रिफैक्टर |
+| `/frame:migrate` | रोलबैक योजना के साथ DB/API/deps माइग्रेशन |
+</details>
+
+<details>
+<summary>समीक्षा</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:review` | डिप्लॉय करने से पहले — स्वचालित जांच + चेकलिस्ट |
+| `/frame:health` | पूर्ण प्रोजेक्ट स्वास्थ्य जांच |
+| `/frame:check-deps` | सुरक्षा ऑडिट + पुराने पैकेज |
+| `/frame:performance` | Bundle आकार और Lighthouse ऑडिट |
+</details>
+
+<details>
+<summary>शिप</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:ship` | कमिट, वैकल्पिक पुश/PR, मेमोरी अपडेट करें |
+| `/frame:checkpoint` | जोखिम भरे बदलाव से पहले git टैग सेव करें |
+| `/frame:rollback` | चेकपॉइंट पर रोलबैक करें |
+</details>
+
+<details>
+<summary>प्रतिबिंब</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:retrospective` | डिप्लॉय के बाद — मेमोरी और मेट्रिक्स अपडेट करें |
+| `/frame:sprint-check` | रोडमैप के विरुद्ध साप्ताहिक प्रगति |
+| `/frame:cleanup-memory` | पुरानी मेमोरी ट्रिम और आर्काइव करें |
+</details>
+
+<details>
+<summary>दैनिक और उपयोगिताएं</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:daily` | दिन की शुरुआत — क्या हुआ, आगे क्या है |
+| `/frame:status` | पूर्ण स्थिति डंप (git, मेमोरी, ब्लॉकर्स) |
+| `/frame:note` | एक पैटर्न, निर्णय, या एंटी-पैटर्न कैप्चर करें |
+| `/frame:unstuck` | अटक गए? अनब्लॉक करने के लिए 3 ठोस विकल्प प्राप्त करें |
+| `/frame:context` | वर्तमान कार्य संदर्भ दिखाएं |
+| `/frame:init` | पहली बार चलाएं — कोडबेस स्कैन करें, MAP.md भरें |
+| `/frame:doctor` | FRAME इंस्टॉलेशन सत्यापित करें |
+| `/frame:pause` / `/frame:resume` | मध्य-कार्य स्थिति सेव और पुनर्स्थापित करें |
+</details>
+
+<details>
+<summary>उन्नत</summary>
+
+| कमांड | कब उपयोग करें |
+|-------|--------------|
+| `/frame:worktree` | समानांतर प्रयोगों के लिए अलग git वर्कट्री |
+| `/frame:headless` | स्वायत्त CI मोड (कोई इंटरैक्शन नहीं) |
+| `/frame:estimate <कार्य>` | शुरू करने से पहले स्कोप और समय अनुमान |
+</details>
+
+## हुक्स
+
+FRAME `.claude/hooks/` में 4 हुक्स इंस्टॉल करता है। वे स्वचालित रूप से चलते हैं।
+
+| हुक | ट्रिगर | क्या करता है | अक्षम करने के लिए |
+|-----|--------|-------------|-----------------|
+| `safety-net.sh` | Bash से पहले | `rm -rf` और `DROP TABLE/DATABASE` ब्लॉक करता है | `.claude/settings.local.json` से हटाएं |
+| `git-safety.sh` | Bash से पहले | फोर्स पुश, `reset --hard` ब्लॉक करता है, `git add -A` पर चेतावनी देता है | `.claude/settings.local.json` से हटाएं |
+| `quality-gate.sh` | फ़ाइल लिखने के बाद | बदली गई फ़ाइल पर typecheck + lint चलाता है | `.claude/settings.local.json` से हटाएं |
+| `session-init.sh` | सत्र शुरू | वर्तमान चरण/कार्य दिखाता है; 24h से अधिक दूर होने पर पूर्ण संदर्भ डंप | `.claude/settings.local.json` से हटाएं |
+
+## कॉन्फ़िगरेशन
+
+FRAME को `.frame/config.json` के माध्यम से कॉन्फ़िगर किया जाता है। मुख्य सेटिंग्स:
+
+```json
+{
+  "quality": {
+    "commands": {
+      "typecheck": "npx tsc --noEmit",
+      "test": "npx vitest run",
+      "lint": "npx eslint .",
+      "build": "npm run build"
+    }
+  }
+}
+```
+
+## CLI
+
+```bash
+npx the-frame-ai init [target-dir]     # FRAME इंस्टॉल करें
+npx the-frame-ai update [target-dir]   # कमांड, एजेंट, हुक्स अपडेट करें
+npx the-frame-ai doctor [target-dir]   # इंस्टॉलेशन स्वास्थ्य जांचें
+npx the-frame-ai version               # CLI संस्करण दिखाएं
+```
+
+`update` केवल कमांड, एजेंट और हुक्स अपडेट करता है। प्रोजेक्ट फ़ाइलें (STATE.md, MAP.md, memory/, आदि) कभी ओवरराइट नहीं होती हैं।
+
+## इंस्टॉलेशन के बाद प्रोजेक्ट संरचना
+
+```
+.claude/
+  commands/          # 34 FRAME कमांड
+  agents/            # 5 AI एजेंट
+  hooks/             # 4 सेफ्टी हुक्स
+.frame/
+  config.json        # FRAME कॉन्फ़िगरेशन
+.planning/
+  STATE.md           # वर्तमान स्थिति
+  MAP.md             # प्रोजेक्ट मैप
+  ROADMAP.md         # रोडमैप
+  memory/            # प्रोजेक्ट मेमोरी
+  specs/             # सुविधा विशिष्टताएं
+  reviews/           # समीक्षा परिणाम
+  reports/           # रिपोर्ट (दैनिक, deps, गुणवत्ता, स्प्रिंट)
+```
+
+## लाइसेंस
+
+MIT

package/README.ja.md

@@ -0,0 +1,335 @@
+# THE Frame
+
+FRAME — AI支援ソロ開発のためのフレームワーク
+
+[🇺🇸 English](README.md) | [🇨🇳 中文](README.zh.md) | [🇮🇳 हिंदी](README.hi.md) | [🇯🇵 日本語](README.ja.md) | [🇩🇪 Deutsch](README.de.md) | [🇪🇸 Español](README.es.md) | [🇷🇺 Русский](README.ru.md)
+
+## FRAMEとは？
+
+**FRAME（Framework for AI-Assisted Solo Development）** は、Claude Codeでプロダクトを構築するソロ開発者のためのフレームワークです。混沌としたAI支援開発を、メモリ・構造・ミス防止機能を備えた予測可能なプロセスへと変えます — アイデアからデプロイまで。
+
+Claude Codeで一人でプロダクトを作っていて、チームのように働きたいなら — FRAMEはあなたのためにあります。
+
+## FRAMEが解決する問題
+
+| 問題 | FRAMEが提供するもの |
+|------|-------------------|
+| セッション間でコンテキストを失う | プロジェクトメモリとセッション開始時の自動状態ダンプ |
+| タスクと優先順位の混乱 | 6フェーズワークフロー：調査 → 計画 → 構築 → レビュー → リリース → 振り返り |
+| 重要なものを壊す恐れ | セーフティフックが破壊的コマンドを実行前にブロック |
+| 繰り返しのルーティンタスク | 完全な開発サイクルに対応した34の既製コマンド |
+| 依存関係のある複雑な機能 | 独立したタスクのための並列サブエージェント |
+| ソロ作業の構造不足 | Roadmap、STATE.md、MAP.md — 現在地と次のステップを常に把握 |
+
+## FRAMEの使い方
+
+```
+調査 → 計画 → 構築 → レビュー → リリース → 振り返り
+```
+
+各セッションは1サイクルです。`/frame:daily` で始め、`/frame:ship` で終わります。
+
+**調査** — 作る前に理解する
+`/frame:research <トピック>` を実行 — Claudeがコードベースと外部ソースを探索し、次のステップのためのコンテキストを構築します。
+
+**計画** — タスクに分解する
+`/frame:plan <機能>` が調査を見積もり付きの具体的なタスクリストに変換します。
+
+**構築** — 実装する
+`/frame:build` がTDDでタスクを順次実行します（1〜3件ずつ）。多くの独立したタスクには — `/frame:wave` が並列バッチで実行します。行き詰まったら — `/frame:unstuck`。バグを発見したら — `/frame:debug`。
+
+**レビュー** — デプロイ前に確認する
+`/frame:review` が自動チェックを実行し、チェックリストを提供します：テスト、型、セキュリティ、パフォーマンス。
+
+**リリース** — デプロイして記録する
+`/frame:ship` がコミット、オプションのプッシュ/PR、プロジェクトメモリの更新を行います。
+
+**振り返り** — 学んで改善する
+デプロイ後に `/frame:retrospective` でメトリクスを更新し、将来のセッションのためのパターンを記録します。
+
+## 使用例
+
+### 新機能：Google認証を追加する
+
+```
+/frame:daily
+# → 現在のプロジェクト状態と計画内容を確認
+
+/frame:research "Google OAuth"
+# → Claudeがコードベースを調査：現在のauthの仕組み、
+#   すでに使われているパターン、追加が必要なもの
+
+/frame:plan "Google OAuth"
+# → 具体的なタスクリストを取得：
+#   1. Google OAuthクレデンシャルを設定
+#   2. コールバックルートを追加
+#   3. セッションに接続
+#   4. UIにボタンを追加
+
+/frame:checkpoint
+# → 復元ポイントを保存 — 何か問題が起きたらロールバック可能
+
+/frame:wave
+# → タスク1〜4は独立しているため、Claudeが並列で実行
+
+/frame:review
+# → 自動チェック：テスト、型、セキュリティ
+
+/frame:ship
+# → コミット、オプションのプッシュ/PR、プロジェクトメモリ更新
+```
+
+### バグ：パスワードリセット後にユーザーがログインできない
+
+```
+/frame:daily
+# → コンテキストを復元し、バグが既に計画にあるか確認または追加
+
+/frame:debug "login after reset"
+# → Claudeが体系的に確認：ログ、リセットフロー、セッション、トークン
+# → コード内の具体的な場所を示す仮説を取得
+
+# 原因がすぐに判明した場合：
+/frame:checkpoint                        # 修正前の復元ポイント
+/frame:fast "fix: invalidate old session after password reset"
+# → Claudeがピンポイントの修正を行い、リグレッションテストを書く
+
+# 原因が不明な場合 — 深く掘り下げる：
+/frame:forensics
+# → この領域の変更のgit履歴を分析し、
+#   動作を壊したコミットを特定
+
+/frame:checkpoint
+/frame:fast "fix: ..."                   # 特定した原因を修正
+
+/frame:review
+# → 修正が他のログインシナリオを壊していないことを確認
+
+/frame:ship
+```
+
+### 改善：ダッシュボードの読み込みを高速化する
+
+```
+/frame:daily
+
+/frame:performance
+# → ベースラインを取得：バンドルサイズ、読み込み時間、Lighthouseスコア
+#   数値を記録 — 最後の比較に必要
+
+/frame:research "dashboard performance"
+# → Claudeがダッシュボードコードを分析：重いコンポーネント、
+#   冗長なリクエスト、キャッシュまたは遅延読み込みできるもの
+
+/frame:plan "dashboard optimization"
+# → 影響見積もり付きのタスクリスト：
+#   1. 重いチャートを遅延読み込み
+#   2. APIリクエストをキャッシュ
+#   3. マウント時の重複リクエストを削除
+
+/frame:build
+# → 順次実行、各タスクにテスト付き
+
+/frame:performance
+# → ベースラインと比較：実際の改善を確認
+
+/frame:ship
+```
+
+## 内容
+
+FRAMEが提供するもの：
+
+- **6フェーズワークフロー**：調査 → 計画 → 構築 → レビュー → リリース → 振り返り
+- **34コマンド**：クイックタスクから完全な機能開発サイクルまで
+- **5つのAIエージェント**：リサーチャー、プランナー、ビルダー、レビュアー、悪魔の代弁者
+- **セーフティフック**：破壊的操作をブロック、品質ゲートを強制
+- **Git安全機能**：チェックポイント、ロールバック、ワークツリー、一時停止/再開
+
+## 前提条件
+
+- Node.js >= 18
+- Git（プロジェクトはgitリポジトリである必要があります）
+
+## クイックスタート
+
+```bash
+# 必要に応じてgitリポジトリを初期化
+git init && git commit --allow-empty -m "init"
+
+# FRAMEをインストール
+npx the-frame-ai init
+
+# このプロジェクトでClaude Codeを開いて実行：
+/frame:init    # コードベースをスキャンし、MAP.mdを埋める
+/frame:daily   # 毎日のエントリーポイント
+```
+
+## コマンド
+
+### コア — ここから始める
+
+この7つのコマンドがソロ開発作業の90%をカバーします：
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:daily` | 休憩後は**ここから始める** — 何が完了し、次は何か |
+| `/frame:research <トピック>` | 新機能の計画前 |
+| `/frame:plan <機能>` | 調査を実行可能なタスクリストに変換 |
+| `/frame:build` | TDDで1〜3タスクを実装（順次） |
+| `/frame:wave` | 4つ以上の独立したタスクを実装（並列サブエージェント） |
+| `/frame:review` | デプロイ前 — 自動チェック + チェックリスト |
+| `/frame:ship` | コミット、オプションのプッシュ/PR、メモリ更新 |
+
+### フェーズ別全コマンド
+
+<details>
+<summary>調査</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:research <トピック>` | 新機能の計画前 |
+| `/frame:explain <ファイル>` | このコードがこうなっている理由は？ |
+| `/frame:why <トピック>` | 意思決定の履歴を検索 |
+</details>
+
+<details>
+<summary>計画</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:plan <機能>` | 調査を実行可能なタスクリストに変換 |
+| `/frame:add-task` | 作業を中断せずに計画にタスクを追加 |
+</details>
+
+<details>
+<summary>構築</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:build` | TDDで計画を実装（1〜3タスク、順次） |
+| `/frame:wave` | 4つ以上の独立したタスクを並列バッチで実装 |
+| `/frame:fast <タスク>` | 30分以内のクイックタスク |
+| `/frame:debug <問題>` | 体系的なバグ調査 |
+| `/frame:forensics` | 何かが壊れた原因の深掘り |
+| `/frame:refactor` | TDDセーフティネットでリファクタリング |
+| `/frame:migrate` | ロールバック計画付きのDB/API/deps移行 |
+</details>
+
+<details>
+<summary>レビュー</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:review` | デプロイ前 — 自動チェック + チェックリスト |
+| `/frame:health` | プロジェクト全体のヘルスチェック |
+| `/frame:check-deps` | セキュリティ監査 + 古いパッケージ |
+| `/frame:performance` | バンドルサイズとLighthouse監査 |
+</details>
+
+<details>
+<summary>リリース</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:ship` | コミット、オプションのプッシュ/PR、メモリ更新 |
+| `/frame:checkpoint` | リスクのある変更前にgitタグを保存 |
+| `/frame:rollback` | チェックポイントにロールバック |
+</details>
+
+<details>
+<summary>振り返り</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:retrospective` | デプロイ後 — メモリとメトリクスを更新 |
+| `/frame:sprint-check` | ロードマップに対する週次進捗 |
+| `/frame:cleanup-memory` | 古いメモリのトリムとアーカイブ |
+</details>
+
+<details>
+<summary>日常 & ユーティリティ</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:daily` | 1日の始まり — 何が完了し、次は何か |
+| `/frame:status` | 完全な状態ダンプ（git、メモリ、ブロッカー） |
+| `/frame:note` | パターン、決定、またはアンチパターンを記録 |
+| `/frame:unstuck` | 行き詰まった？ブロックを解除する3つの具体的な選択肢を取得 |
+| `/frame:context` | 現在の作業コンテキストを表示 |
+| `/frame:init` | 初回実行 — コードベースをスキャン、MAP.mdを埋める |
+| `/frame:doctor` | FRAMEのインストールを確認 |
+| `/frame:pause` / `/frame:resume` | タスク途中の状態を保存・復元 |
+</details>
+
+<details>
+<summary>上級</summary>
+
+| コマンド | 使用タイミング |
+|---------|-------------|
+| `/frame:worktree` | 並列実験のための隔離されたgitワークツリー |
+| `/frame:headless` | 自律CIモード（インタラクションなし） |
+| `/frame:estimate <タスク>` | 開始前のスコープと時間見積もり |
+</details>
+
+## フック
+
+FRAMEは `.claude/hooks/` に4つのフックをインストールします。自動的に実行されます。
+
+| フック | トリガー | 機能 | 無効化方法 |
+|-------|---------|------|----------|
+| `safety-net.sh` | Bash実行前 | `rm -rf` と `DROP TABLE/DATABASE` をブロック | `.claude/settings.local.json` から削除 |
+| `git-safety.sh` | Bash実行前 | フォースプッシュ、`reset --hard` をブロック、`git add -A` に警告 | `.claude/settings.local.json` から削除 |
+| `quality-gate.sh` | ファイル書き込み後 | 変更されたファイルにtypecheck + lintを実行 | `.claude/settings.local.json` から削除 |
+| `session-init.sh` | セッション開始 | 現在のフェーズ/タスクを表示；24時間以上離れていた場合は完全なコンテキストダンプ | `.claude/settings.local.json` から削除 |
+
+## 設定
+
+FRAMEは `.frame/config.json` で設定します。主要な設定：
+
+```json
+{
+  "quality": {
+    "commands": {
+      "typecheck": "npx tsc --noEmit",
+      "test": "npx vitest run",
+      "lint": "npx eslint .",
+      "build": "npm run build"
+    }
+  }
+}
+```
+
+## CLI
+
+```bash
+npx the-frame-ai init [target-dir]     # FRAMEをインストール
+npx the-frame-ai update [target-dir]   # コマンド、エージェント、フックを更新
+npx the-frame-ai doctor [target-dir]   # インストールの健全性を確認
+npx the-frame-ai version               # CLIバージョンを表示
+```
+
+`update` はコマンド、エージェント、フックのみを更新します。プロジェクトファイル（STATE.md、MAP.md、memory/ など）は上書きされません。
+
+## インストール後のプロジェクト構造
+
+```
+.claude/
+  commands/          # 34のFRAMEコマンド
+  agents/            # 5つのAIエージェント
+  hooks/             # 4つのセーフティフック
+.frame/
+  config.json        # FRAME設定
+.planning/
+  STATE.md           # 現在の位置
+  MAP.md             # プロジェクトマップ
+  ROADMAP.md         # ロードマップ
+  memory/            # プロジェクトメモリ
+  specs/             # 機能仕様
+  reviews/           # レビュー結果
+  reports/           # レポート（日次、deps、品質、スプリント）
+```
+
+## ライセンス
+
+MIT