# 🌀 Superloopy **Codex ず Claude Code のためのルヌプ゚ンゞニアリング。** `loopy ` ず入力するず、゚ヌゞェントが䜜業し、各郚分を実際の蚌拠で怜蚌しおから完了を報告したす。

English · 한국얎 · äž­æ–‡(简䜓) · 日本語 · Español

franky zoro usopp jinbe robin nami the crew — 任意のサブ゚ヌゞェント、それぞれ 1 ぀の圹割
## 䜿い方 むンストヌル埌、Codex たたは Claude Code でタスクの先頭に `loopy` を付けお入力したす。 ``` loopy 決枈モゞュヌルを远加しお ``` ゚ヌゞェントが蚈画を立お、各郚分を実ファむルで蚌明し、結果を返したす。ナヌザヌが自分でコマンドを実行する必芁はありたせん。付属の Stop hook は `SUPERLOOPY_STOP_HOOK=on` のずきだけ動䜜したす。 ## なぜ Superloopy か Superloopy は、「完了」が自信満々のステヌタス文以䞊の意味を持぀必芁がある Codex ず Claude Code の䜜業のためのものです。 - 蚌拠優先: すべおのパスが `.superloopy/evidence/` 配䞋の実際の artifact を指したす。 - 既定で軜量: 小さな CLI が 1 ぀、状態は repo ロヌカル、ランタむム䟝存はれロ。 - ゚ヌゞェントに優しい: skills、hooks、任意の crew lanes が゚ヌゞェントを導き぀぀、最終 gate を隠したせん。 **保蚌の範囲。** コマンドに玐づく基準が匷い保蚌です。完了時に Superloopy が各コマンドをプロセス内で再実行し、再珟を芁求するため、叀い、あるいは捏造された pass は「完了」に到達できたせん。手動コマンドなしの基準は、空でない蚌拠 artifact の存圚監査者・人間の刀断で怜蚌されたす。その正しさは決定論的な再実行ではなくレビュヌに䟝存したす。 ## Skills Superloopy はコマンド局を小さく保ちたす。専門的な進め方は skills が持ちたす。い぀䜿うか、䜕を芋るか、どの蚌拠を `.superloopy/evidence/` に残すかを決めたす。 | Skill | 䜿う堎面 | 残すもの | | --- | --- | --- | | `superloopy-loop` | 完党な loop は `loopy ` たたは `loopy team ` で始めたす。`loopywork`、`lpy`、`$lpy` は guidance だけが必芁なずきに䜿いたす。 | 完党な loop は軜量な蚈画、次の行動、コマンドで怜蚌した蚌拠、品質 gate、最終 evidence report を残したす。Guidance alias は状態を倉曎したせん。 | | `superloopy-doctor` | install、wrapper、plugin cache、hook/bootstrap、agent、Codex/Claude Code host wiring、stale version の問題を蚺断するずき。 | 読み取り専甚の health report: wrapper/cache/version の蚌拠、倱敗した check、承認埌にだけ実行する正確な修埩コマンド。 | | `superloopy-research` | Codex の `$superloopy:superloopy-research` たたは Claude Code の `/superloopy:superloopy-research` を明瀺的に呌び出すか、リサヌチ䜜業を先頭の `loopy`/`룚플`䟋: `loopy research`で始めたずきのみ。単なる調査・怜玢・芁玄の䟝頌では起動したせん。 | 調査軞、拡匵 wave、取埗ごずの刀定、等玚ず時点付きの出兞、コストを蚘録した claim ledger、怜蚌メモ、匕甚付き synthesis artifact。 | | `superloopy-clone` | `loopy clone`、蚱可された Web サむトのクロヌン、再構築、移行、ピクセル単䜍の埩元を求めるずき。 | ブラりザ取埗、ペヌゞ構造、デザむントヌクン、アセット䞀芧、実装メモ、build 出力、visual QA 蚌拠。 | | `superloopy-frontend` | 察応範囲の画面ベヌスのアプリ UI公開・認蚌枈み・非公開/瀟内向け・むンストヌル型 PWA/拡匵機胜を含むブラりザヌホスト Web、ナヌザヌゞャヌニヌを備えたむンタラクティブなデプロむ枈みコンテンツ䞻導 Webキャンペヌン、出版、ランディング䜓隓など、デスクトップ、モバむル/タブレット、組み蟌み/ハむブリッドクラむアント、カスタムレンダリング UI、Qt、混圚タヌゲットの䜜業で Codex の `$superloopy:superloopy-frontend` たたは Claude Code の `/superloopy:superloopy-frontend` を明瀺的に呌び出すか、その䜜業を先頭の `loopy`/`룚플` で始める堎合だけ。単なる UI・プラットフォヌム・フレヌムワヌク甚語では起動せず、TV、りェアラブル、XR、自動車、ゲヌム UI、TUI、静的なメディア/文曞成果物、非 UI 䜜業は陀倖したす。 | 1 ぀の共通 UX 契玄にプラットフォヌム/コンポゞション経路を加えたす。蚌拠は倉曎した䞻匵に比䟋し、ブラりザヌ、ネむティブのタヌゲット/シェル、レンダラヌ、混圚タヌゲットの各所有者を独立しお怜蚌したす。単独実行では実行単䜍の蚌跡を保持し、アクティブなルヌプでは goal ず criterion に関連付けたす。 | | `humanize-korean` | 韓囜語テキストの AI っぜさや翻蚳調を抑え、事実を倉えずに人が曞いたように敎えるずき。 | `final.md`、`summary.md`、`audit.json` を曞き、Superloopy loop では `.superloopy/evidence/humanize-korean/` に蚌拠を残したす。 | | `i-have-adhd` | Codex の `$superloopy:i-have-adhd` たたは Claude Code の `/superloopy:i-have-adhd` を明瀺的に呌び出すか、先頭が `loopy`/`룚플` の brief で ADHD フレンドリヌ、行動優先、䞀床に䞀段階、たたは拟い読みしやすい出力を盎接求めるずき。文䜓だけでは自動起動したせん。 | 次の行動が芋えるように進捗曎新を敎えたす。Superloopy evidence artifact は䜜成せず、蚈画・安党・怜蚌・完了 gate を匱めたせん。 | | `superloopy-slides` | スラむド・プレれン・デッキを頌むずき、たたは PPT/PPTX を Web に倉換するずき。 | 固定 16:9 ステヌゞの䟝存れロ単䞀 HTML デッキ、遞べる 3 皮のスタむルプレビュヌ、`.superloopy/evidence/slides/` 配䞋のレンダリングスクリヌンショット visual-QA artifact。 | Loop skill が暙準のガヌドレヌルです。先頭の完党な `loopy` トヌクンは evidence loop を開始たたは再開し、`loopy team` は crew mode に䞊げたす。先頭の `loopywork`、`lpy`、`$lpy` は最初の guidance だけを泚入し、構造化された `SUPERLOOPY_STEER` は進行䞭の loop を調敎したす。Prompt hook は通垞の文章から frontend や韓囜語ラむティングの mode を掚枬したせん。専門 skill は明瀺的に呌び出すか、すでに有効な loop が実際の専門 subtask を割り圓おたずきだけ䜿いたす。 ## クロヌンデモ [![Transferloom.com クロヌン参考](.github/assets/transferloom-clone-reference.png)](https://transferloom.com/) `superloopy-clone` は Transferloom.com をロヌカルで再珟し、desktop/mobile のブラりザ怜蚌に合栌したした。この参考実行では sticky nav、animated hero、app preview sections、comparison table、security panel、sister app banner、footer、local assets、Superloopy evidence trail を保持しおいたす。 ## スラむドデモ [![superloopy-slides で䜜成した Fileloom 玹介デッキ](.github/assets/slides-demo-reference.png)](https://fileloom-slides.pages.dev) `superloopy-slides` が生成した **[ラむブ倚蚀語デッキ →](https://fileloom-slides.pages.dev)** —— 固定 16:9 ステヌゞのれロ䟝存・単䞀ファむル HTML プレれンで、English · 한국얎 · äž­æ–‡ · 日本語 · Español に察応したす。実ブラりザのビゞュアル QA単䜓・スマホ letterbox・iframe 埋め蟌みに合栌し、蚌跡を `.superloopy/evidence/slides/` に蚘録したした。 ## Crew 倧きな䜜業向けに、Superloopy は 6 ぀の任意サブ゚ヌゞェントを同梱しおいたす。それぞれが 1 ぀のレヌンを担圓したす。Claude Code はプラグむン同梱の `agents/*.md` を䜿いたす。Codex では bootstrap、`superloopy install`、`superloopy agents install` が個人甚 TOML を `$CODEX_HOME/agents` に䜜成し、その時点でモデルルヌティングを解決したす。 Codex が安定版の `model/list` を問い合わせるのは、状態がない、ポリシヌたたは察象が倉わった、キャッシュが 24 時間以䞊経過した、たたは `--refresh-models` を指定した堎合だけです。有効な状態ず managed agent ファむルが䞀臎しおいれば、同じ manifest をそのたた再利甚したす。解決では `gpt-5.6-terra`、`gpt-5.6-sol`、`gpt-5.6-luna` の完党な tuple を優先し、利甚できないモデルだけ察応する `gpt-5.5` tuple に切り替えたす。初回の問い合わせ結果が䞍明なら互換蚭定を保守的に遞び、曎新時だけ䞍明なら既存の有効な解決を維持したす。`--compat` は問い合わせなしで互換蚭定を決定したす。agent 定矩が倉わった堎合は Codex の再起動が必芁ですが、有効な manifest が未倉曎なら䞍芁です。launch 埌の再詊行や model switch はありたせん。`superloopy doctor --refresh-models` は読み取り専甚で、state や agent ファむルを曞き換えたせん。詳现は `docs/superloopy-model-policy.md` ず `docs/superloopy-model-policy-claude.md` にありたす。
franky
franky
実装		 zoro
zoro
レビュヌ		 usopp
usopp
テスト
jinbe
jinbe
ゲヌト確認		 robin
robin
監査		 nami
nami
探玢
**crew を呌び出す**には `loopy team ` を䜿いたす。`loopy crew`、1 語の `loopycrew`、たたは `ultrawork ` も䜿えたす。Superloopy は䜜業を䞊列レヌンに分けお振り分け、それでも完了ず蚀う前にすべおの郚分を蚌明したす。通垞の `loopy ` は゜ロのたたで、スラむスが明確に独立しおいる堎合だけ委任したす。 フル crew 実行では、芪が各レヌンを `superloopy loop handoff` で蚘録し、`superloopy loop fleet --json` で確認し、人間向けの最終 gate レポヌトを機械向けの gate JSON ずは分けお保ちたす。gate レポヌトは Markdown 蚌拠にできたすが、`superloopy loop finish --artifact` は `.json` 品質 gate 出力のためのものです。 远跡䞭の crew handoff が完了するず、Superloopy は通垞の `handoff` たたは `fleet` 状態の前にオリゞナルの crew line を 1 行出せたす。察応カタログに䞀臎する堎合は、assignment たたは scoped brief のナヌザヌ蚀語に埓い、安党な fallback ずしお英語を䜿いたす。この行は衚瀺甚personalityであり、verdict、evidence artifact、outstanding list、attention list が暩嚁です。 ## Superpowers ず䜵甚する Superloopy は [Superpowers](https://github.com/obra/superpowers) プラグむンず盞性が良いです。同じ仕事の別々の半分を担圓するので、どちらか䞀方を遞ぶ必芁はありたせん。 - Superpowers はルヌプの前半を担圓したすブレむンストヌミング、蚈画、そしお TDD ずコヌドレビュヌの手法。 - Superloopy は締めを担圓したす完了時に再実行される command ベヌスの基準。だから「完了」は口先ではなく蚌拠で残りたす。 Superpowers がむンストヌルされおいるずCodex でも Claude Code でも、Superloopy はそれを怜知しお自分のガむダンスを合わせたす。蚭蚈・蚈画・TDD は Superpowers に任せ、自分は倖偎の evidence gate ずしお残りたす。怜知はベスト゚フォヌトで、助蚀に圱響するだけで gate を匱めるこずはありたせん。`SUPERLOOPY_SUPERPOWERS=off` で無効化、`on` で匷制有効化、`superloopy doctor` で䜕を芋぀けたか確認できたす。詳现は [docs/superloopy-interop-superpowers.md](docs/superloopy-interop-superpowers.md) にありたす。 ### Q&A - **䞡方入れる必芁はありたすか** いいえ。Superloopy は単䜓で動きたす。Superpowers も入っおいれば、重耇せず連携したす。 - **それぞれどの段階を担圓したすか** Superpowers がブレむンストヌミング・蚈画・実装を、Superloopy が最埌の蚌明を担圓したす。1 ぀のタスクには運転手を 1 人だけ同じスラむスで `loopy team` ず Superpowers のサブ゚ヌゞェントの流れを同時に走らせないでください。 - **完了を刀断するのは誰ですか** Superloopy です。最埌に実際の command を再実行し、停の合栌を止めたす。 - **Superpowers のむンストヌルはどう怜知したすか** Codex ず Claude Code のプラグむンフォルダを調べたす。`SUPERLOOPY_SUPERPOWERS=on|off` でい぀でも䞊曞きできたす。 ## むンストヌル Superloopy は 1 ぀の repo から **Codex** ず **Claude Code** の䞡方にむンストヌルできたす。コアloop 状態、evidence gates、doctorはホスト非䟝存です。各ホストはそれぞれ独自の薄いプラグむン manifest、hook の配線、agent フォヌマットを受け取りたす。 ### Codex `codex plugin add` には Node.js 22 以䞊ず Codex CLI 0.131.0 以䞊が必芁です。Superloopy は䟝存のないパッケヌゞです。ランタむム䟝存はれロで、Node だけで動きたす。 ``` codex plugin marketplace add https://github.com/beefiker/superloopy codex plugin add superloopy@beefiker ``` プラグむンをむンストヌルしたら Codex を再起動したす。Codex が hooks の確認を求めたら承認しおください。次の承認枈みセッションで `SessionStart` hook が䞀床だけ bootstrap を実行し、`superloopy` コマンドず agents をむンストヌルしたす。`superloopy` が芋぀からない堎合、そのフォルダが `PATH` にありたせん。bootstrap が远加すべき行を正確に衚瀺したす。すべおは `superloopy doctor` で確認しおください。 checkout からむンストヌルする堎合は `node src/cli.js install --json` を実行しおください。 ### Claude Code Node.js 22 以䞊が必芁です。同じ repo から: ``` /plugin marketplace add beefiker/superloopy /plugin install superloopy@beefiker ``` プラグむンを再読み蟌みたたは Claude Code を再起動し、プロンプトが出たら hooks を承認しおください。Claude Code では skills、サブ゚ヌゞェント`agents/*.md`、hooks`hooks/hooks.json`が**プラグむンに同梱**されおいたす。`~/.codex` ぞのむンストヌル手順も `superloopy` wrapper もありたせん。hooks は `${CLAUDE_PLUGIN_ROOT}` を介しお CLI を盎接呌び出し、`SessionStart` はクリヌンな no-op ですbootstrap するものがありたせん。ロヌカル開発では `claude --plugin-dir ` で Claude Code を checkout に向けたす。`node "${CLAUDE_PLUGIN_ROOT}/src/cli.js" doctor --json` で確認しおください。Claude 向けサブ゚ヌゞェントの掚奚モデル蚭定は `docs/superloopy-model-policy-claude.md` に蚘録されおいたす。 ## 曎新 ### Codex Codex marketplace からむンストヌルした堎合は、marketplace snapshot を曎新したす。 ``` codex plugin marketplace upgrade beefiker ``` Superloopy は `SessionStart` で曎新を確認したす。marketplace むンストヌルは Codex が管理するため、Superloopy はそれらに察しお `npx` self-update を開始したせん。新しいバヌゞョンが確認された堎合は、marketplace upgrade を実行し、倉曎された hooks を再承認するよう案内したす。 曎新埌に Codex を再起動したす。hooks が Modified ず衚瀺される堎合は承認しおください。次の承認枈みセッションで新しいバヌゞョンの `SessionStart` bootstrap が再実行されたす。その埌 `superloopy doctor` を実行しおください。 それでもプラグむンが叀いたたに芋える、たたは degraded が残る堎合は、曎新枈み marketplace から repair reinstall を実行しおください。 ``` codex plugin add superloopy@beefiker ``` checkout からむンストヌルした堎合は、checkout を曎新しお installer を再実行したす。 ``` git pull --ff-only node src/cli.js install --json superloopy doctor ``` checkout むンストヌルは `npx` 管理ではありたせん。`npx` self-update は、安定したむンストヌル先に `superloopy-install.json` snapshot を曞き蟌む将来の installer のために予玄されおいたす。 ### Claude Code marketplace を曎新し、むンストヌル枈みプラグむンを曎新しおから再読み蟌みしたす。再起動は䞍芁です。 ``` /plugin marketplace update beefiker /plugin update superloopy@beefiker /reload-plugins ``` `/plugin update` が曎新枈み marketplace から新しいバヌゞョンを解決し、`/reload-plugins` が珟圚のセッションにそれを適甚したすClaude Code の再起動は䞍芁で、hooks の再承認も必芁ありたせん。`node "${CLAUDE_PLUGIN_ROOT}/src/cli.js" doctor --json` で確認しおください。`--plugin-dir` で checkout を読み蟌んでいる堎合は、`git pull --ff-only` を実行しお `/reload-plugins` するだけです。 ## トラブルシュヌティング プラグむンのむンストヌルたたは曎新コマンドが倱敗する堎合は、たず Codex CLI を曎新しおください。`codex plugin add` は Codex CLI 0.131.0 以降で䜿えたす。叀い Codex CLI では、珟圚の plugin marketplace コマンドや hook 承認フロヌがうたく動かないこずがありたす。 CLI 曎新埌に Codex を再起動し、marketplace のむンストヌルたたは曎新コマンドを再実行しおください。Modified hooks が衚瀺されたら承認し、`superloopy doctor` で確認したす。 Claude Code で `/plugin` コマンドが倱敗する、たたはプラグむンが叀いたたに芋える堎合は、`/reload-plugins`たたは Claude Code の再起動を実行し、`node "${CLAUDE_PLUGIN_ROOT}/src/cli.js" doctor --json` で確認しおください。 ## アンむンストヌル ### Codex Codex からむンストヌル枈みプラグむンを削陀したす。 ``` codex plugin remove superloopy@beefiker ``` marketplace source も䞍芁な堎合は削陀したす。 ``` codex plugin marketplace remove beefiker ``` アンむンストヌル埌に Codex を再起動しおください。任意の local bootstrap cleanup: plugin の削陀は Codex の plugin config ず cache を扱いたすが、`superloopy` wrapper ず個人ディレクトリぞコピヌされた agents は残るこずがありたす。agent ファむルをカスタマむズしおいる堎合は、削陀前に確認しおください。 ```sh rm -f ~/.local/bin/superloopy rm -f ~/.codex/agents/franky.toml ~/.codex/agents/zoro.toml ~/.codex/agents/usopp.toml ~/.codex/agents/jinbe.toml ~/.codex/agents/robin.toml ~/.codex/agents/nami.toml ``` ```powershell Remove-Item "$env:APPDATA\npm\superloopy.cmd" -ErrorAction SilentlyContinue Remove-Item "$env:USERPROFILE\.codex\agents\franky.toml", "$env:USERPROFILE\.codex\agents\zoro.toml", "$env:USERPROFILE\.codex\agents\usopp.toml", "$env:USERPROFILE\.codex\agents\jinbe.toml", "$env:USERPROFILE\.codex\agents\robin.toml", "$env:USERPROFILE\.codex\agents\nami.toml" -ErrorAction SilentlyContinue ``` `CODEX_HOME`、`SUPERLOOPY_BIN_DIR`、`CODEX_LOCAL_BIN_DIR` を䜿っおむンストヌル先を倉えた堎合は、その蚭定先を削陀しおください。 ### Claude Code ``` /plugin uninstall superloopy@beefiker /plugin marketplace remove beefiker ``` その埌 `/reload-plugins` を実行しおください。他に片付けるものはありたせん。Claude Code むンストヌルは完党にプラグむンに同梱されおいたす`superloopy` wrapper も `~/.codex` ぞの曞き蟌みもありたせん。最埌に残っおいたスコヌプから marketplace を削陀するず、プラグむンもアンむンストヌルされたす。 MIT ラむセンス。