<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Best-Practices on ROBOCO</title>
    <link>https://roboco.io/ja/tags/best-practices/</link>
    <description>Recent content in Best-Practices on ROBOCO</description>
    <generator>Hugo</generator>
    <language>ja</language>
    <lastBuildDate>Sat, 14 Mar 2026 10:00:00 +0900</lastBuildDate>
    <atom:link href="https://roboco.io/ja/tags/best-practices/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>OpenClaw：世界最大のバイブコーディングプロジェクトから学ぶ9つのベストプラクティス</title>
      <link>https://roboco.io/ja/posts/openclaw-vibe-coding-best-practices/</link>
      <pubDate>Sat, 14 Mar 2026 10:00:00 +0900</pubDate>
      <guid>https://roboco.io/ja/posts/openclaw-vibe-coding-best-practices/</guid>
      <description>&lt;blockquote&gt;&#xA;&lt;p&gt;「かつてチームを率いていたことがある。私の下には多くのソフトウェアエンジニアがいた。あのときも、彼らが私の望むやり方とまったく同じコードを書くわけではないという点を受け入れなければならなかった」 – Peter Steinberger&lt;sup id=&#34;fnref:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;/blockquote&gt;&#xA;&lt;figure&gt;&lt;img src=&#34;https://roboco.io/posts/images/Dohyun.png&#34;&gt;&lt;figcaption&gt;&#xA;      &lt;h4&gt;チョン・ドヒョン - ROBOCO首席コンサルタント&lt;/h4&gt;&#xA;    &lt;/figcaption&gt;&#xA;&lt;/figure&gt;&#xA;&#xA;&lt;hr&gt;&#xA;&lt;p&gt;OpenClawはGitHubで最も多くのスターを集めたソフトウェアリポジトリ（31万以上のスター）であり、大規模なAI支援「バイブコーディング」の決定的なケーススタディです。&lt;sup id=&#34;fnref:2&#34;&gt;&lt;a href=&#34;#fn:2&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;2&lt;/a&gt;&lt;/sup&gt; オーストリアの開発者Peter Steinbergerが3〜8個の並列AIエージェントインスタンスを活用して構築したこのプロジェクトは&lt;sup id=&#34;fnref:3&#34;&gt;&lt;a href=&#34;#fn:3&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;3&lt;/a&gt;&lt;/sup&gt;、たった1人の開発者が30万LOC規模のTypeScriptモノレポ、20以上のメッセージング統合、3つのプラットフォーム向けネイティブアプリをオーケストレーションできることを示しています。しかも、コードのほとんどを自分では読まずに、です。&lt;sup id=&#34;fnref1:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;このプロジェクトの名前は、激動の過程を経てきました。2025年11月、AnthropicのClaudeをベースに1時間で作られたプロトタイプ &lt;strong&gt;Clawdbot&lt;/strong&gt; が始まりでした。2026年1月にGitHubで公開されると1日で9,000スターを集めて爆発的に成長しましたが、Anthropicの商標権に関する警告を受けて &lt;strong&gt;Moltbot&lt;/strong&gt; に改名せざるをえませんでした。続いて、なりすましアカウントや悪意あるnpmパッケージなどのセキュリティ事故が起きたことで、わずか3日後に再び &lt;strong&gt;OpenClaw&lt;/strong&gt; へと名前を変えました。&lt;sup id=&#34;fnref:4&#34;&gt;&lt;a href=&#34;#fn:4&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;4&lt;/a&gt;&lt;/sup&gt; 2026年2月、SteinbergerはOpenAIに加わって「次世代のパーソナルエージェント」を率いることになり、OpenClawはOpenAIが支援する独立財団へ移管されました。&lt;sup id=&#34;fnref:5&#34;&gt;&lt;a href=&#34;#fn:5&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;皮肉なことに、Steinberger本人は「vibe coding」という表現を蔑称だと呼び「agentic engineering」を好むのですが&lt;sup id=&#34;fnref:6&#34;&gt;&lt;a href=&#34;#fn:6&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;6&lt;/a&gt;&lt;/sup&gt;、OpenClawはこの潮流を代表するプロジェクトになりました。&lt;sup id=&#34;fnref:7&#34;&gt;&lt;a href=&#34;#fn:7&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;7&lt;/a&gt;&lt;/sup&gt; この記事では、OpenClawのリポジトリ構造、ワークフロー、コミュニティ運営のあり方を分析し、そこから抽出した実践可能なベストプラクティスを整理します。&lt;/p&gt;&#xA;&lt;h2 id=&#34;tldr&#34;&gt;TL;DR&lt;/h2&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;OpenClawは、1人の開発者が複数のAIエージェントを調律して大規模なTypeScriptモノレポとネイティブアプリを運営した、代表的なバイブコーディングの事例です。&lt;/li&gt;&#xA;&lt;li&gt;中核となるパターンは、生きている&lt;code&gt;AGENTS.md&lt;/code&gt;、明確なPR規範、自動化された品質ゲート、並列エージェントの調整ルールです。&lt;/li&gt;&#xA;&lt;li&gt;バイブコーディングの熟練は、コードを自分で多く書く能力よりも、コードを書くシステムを設計し統制する能力へと移っていきます。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;1-openclawは実際に何をするのか&#34;&gt;1. OpenClawは実際に何をするのか&lt;/h2&gt;&#xA;&lt;p&gt;OpenClawは&lt;strong&gt;セルフホスト型のパーソナルAIアシスタント&lt;/strong&gt;であり、メッセージングプラットフォームを大規模言語モデルにつなぎます。ChatGPTやClaudeのWebインターフェースとは違い、OpenClawはユーザーのローカルマシンで動作し、ユーザーがすでに使っているチャネルと接続します。WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Matrix、LINEなど15以上のチャネルをサポートしています。READMEはこれを簡潔にこう説明します。&lt;em&gt;&amp;ldquo;あなたのデバイス上で直接動くパーソナルAIアシスタント。&amp;rdquo;&lt;/em&gt;&lt;sup id=&#34;fnref:8&#34;&gt;&lt;a href=&#34;#fn:8&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;アーキテクチャの中心にあるのは、ローカルの&lt;strong&gt;Gatewayデーモン&lt;/strong&gt;です。これはポート18789で動作するWebSocketベースのコントロールプレーンで、入ってきたメッセージをそれぞれ独立したAIエージェントへルーティングします。各エージェントは自分だけのワークスペース、メモリ、そしてMarkdownファイル（&lt;code&gt;SOUL.md&lt;/code&gt;、&lt;code&gt;MEMORY.md&lt;/code&gt;、&lt;code&gt;USER.md&lt;/code&gt;）で定義された個性を持ちます。&lt;sup id=&#34;fnref:9&#34;&gt;&lt;a href=&#34;#fn:9&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;9&lt;/a&gt;&lt;/sup&gt; エージェントは単に会話するだけではありません。シェルコマンドの実行、CDPを通じたブラウザ制御、スケジュール管理、cronジョブの実行、ハートビートシステムによる能動的な連絡まで行います。&lt;sup id=&#34;fnref:10&#34;&gt;&lt;a href=&#34;#fn:10&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;10&lt;/a&gt;&lt;/sup&gt; &lt;strong&gt;ClawHub&lt;/strong&gt;というスキルマーケットプレイスには、1,700以上のコミュニティ製の拡張が登録されています。&lt;sup id=&#34;fnref:11&#34;&gt;&lt;a href=&#34;#fn:11&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;11&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;技術スタックはTypeScriptベースの &lt;strong&gt;pnpmモノレポ&lt;/strong&gt;（Node.js 22以上）で、Swift（macOS/iOS）とKotlin（Android）で書かれたネイティブのコンパニオンアプリを含みます。テストはVitestとV8カバレッジ70%以上を基準に運用されています。&lt;sup id=&#34;fnref:12&#34;&gt;&lt;a href=&#34;#fn:12&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;2-リポジトリに表れるai支援開発の痕跡&#34;&gt;2. リポジトリに表れるAI支援開発の痕跡&lt;/h2&gt;&#xA;&lt;p&gt;バイブコーディングの最も明確な証拠は、コミット履歴にあります。初期にはAnthropicのClaude Codeで開発されていたため、コミットに &lt;strong&gt;「claude」が共同作成者（co-author）&lt;/strong&gt; として頻繁に登場します。しかしSteinbergerが2026年2月にOpenAIに加わって以降は、&lt;code&gt;codex/issue-issue-41258-20260312044119&lt;/code&gt;のような &lt;strong&gt;OpenAI Codexエージェントが自律的に生成したブランチ&lt;/strong&gt; が目立って増えました。1つのリポジトリにClaudeとCodex、2つのAIコーディングエージェントの痕跡が共存しているわけです。READMEはむしろこう明記しています。&lt;strong&gt;&amp;ldquo;AI/vibe-coded PRs welcome!&amp;rdquo;&lt;/strong&gt;&lt;sup id=&#34;fnref1:8&#34;&gt;&lt;a href=&#34;#fn:8&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;8&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;Steinberger個人のワークフローはとくに印象的です。彼は &lt;strong&gt;Codex CLIのインスタンスを3〜8個、3x3のターミナルグリッドで同時に実行&lt;/strong&gt;しており、そのほとんどは別々のワークツリーではなく同じフォルダで作業しています。&lt;sup id=&#34;fnref1:3&#34;&gt;&lt;a href=&#34;#fn:3&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;3&lt;/a&gt;&lt;/sup&gt; 各エージェントは&lt;code&gt;AGENTS.md&lt;/code&gt;のルールに導かれてアトミックなコミットを作ります。彼は &lt;strong&gt;2026年1月の1か月だけで6,600以上のコミット&lt;/strong&gt;を残しましたが、見かけ上は20人規模のチームの速度でも、実際には1人とAIエージェントたちの組み合わせです。&lt;sup id=&#34;fnref2:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt; プロンプトは時が経つほど短くなっており、いまでは通常1〜2文とスクリーンショット1枚で十分で、スクリーンショットが入力の約50%を占めています。&lt;sup id=&#34;fnref:13&#34;&gt;&lt;a href=&#34;#fn:13&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;13&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;&lt;code&gt;CONTRIBUTING.md&lt;/code&gt;は、コミュニティがAI支援のPRをどう扱うべきかを規範化しています。&lt;sup id=&#34;fnref:14&#34;&gt;&lt;a href=&#34;#fn:14&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;PRのタイトルまたは説明にAIの使用有無を明示すること&lt;/li&gt;&#xA;&lt;li&gt;テストの水準を明記すること（未テスト／軽くテスト済み／十分にテスト済み）&lt;/li&gt;&#xA;&lt;li&gt;可能ならプロンプトまたはセッションログを含めること&lt;/li&gt;&#xA;&lt;li&gt;生成されたコードが何をするのかを理解していることを確認すること&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;文書はこう締めくくられます。&lt;em&gt;&amp;ldquo;ここではAIのPRを一級市民として扱う。ただ、レビュアーがどこを重点的に見るべきかわかるように透明性がほしいだけだ。&amp;rdquo;&lt;/em&gt;&lt;sup id=&#34;fnref1:14&#34;&gt;&lt;a href=&#34;#fn:14&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;14&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;3-agentsmdとclaudemdの設定パターン&#34;&gt;3. AGENTS.mdとCLAUDE.mdの設定パターン&lt;/h2&gt;&#xA;&lt;p&gt;OpenClawのリポジトリで最も再現可能性の高いイノベーションは、&lt;strong&gt;&lt;code&gt;AGENTS.md&lt;/code&gt;ファイル&lt;/strong&gt;です。&lt;sup id=&#34;fnref1:12&#34;&gt;&lt;a href=&#34;#fn:12&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;12&lt;/a&gt;&lt;/sup&gt; これはコードベースで作業するすべてのAIコーディングエージェントのための包括的な指示文書です。&lt;code&gt;CLAUDE.md&lt;/code&gt;は同じファイルを指すシンボリックリンクで、Claude CodeとCodex系のエージェントが同一の指示を読むことを保証します。ルールも明確です。&lt;em&gt;&amp;ldquo;リポジトリのどこであれ新しい&lt;code&gt;AGENTS.md&lt;/code&gt;を追加するときは、必ずそれを指す&lt;code&gt;CLAUDE.md&lt;/code&gt;のシンボリックリンクも一緒に追加すること。&amp;rdquo;&lt;/em&gt;&lt;sup id=&#34;fnref2:12&#34;&gt;&lt;a href=&#34;#fn:12&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;12&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;このファイルは、AIエージェントのための組織的記憶装置として機能します。Steinbergerはこれを &lt;strong&gt;「組織の傷跡が蓄積された痕跡（organizational scar tissue）の集まり」&lt;/strong&gt; と表現しますが、それは何かがうまくいかないたびにCodex自身が段階的に内容を追加してきたからです。&lt;sup id=&#34;fnref1:13&#34;&gt;&lt;a href=&#34;#fn:13&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;13&lt;/a&gt;&lt;/sup&gt; 中核となるセクションは次のとおりです。&lt;/p&gt;</description>
    </item>
  </channel>
</rss>
