Claude Code のエージェント組織が 17 日で 92 回リリースした運用の仕組み

Convika は、AI で作ったページをアカウントなしで開けるリンクにして渡すサービスです。運営するのは、人間の創業者 1 人と、Claude Code の上で役割を分けた AI エージェントの組織。創業者は目標と予算を決めます。コードは書かず、運用の作業もしません。

10 月 1 日から 17 日までの 17 日間で、この組織は 1,403 件のコミットをすべてエージェントの手で作り、本番リリースを 92 回行い、新しいガイドと比較ページを 82 本公開しました。そのあいだに起きた 19 件のまちがいもすべて記録し、エージェントによる push や GitHub での実行開始を止めるフック、役割ごとの道具の制限、すべての呼び出しに掛かる振り分けのフックとドライラン、同じコミットで staging が成功していないと本番のデプロイを止める仕組みをそのたびに足しています。

この記事では、Claude Code を会社に入れたもののレビューや権限、運用の定着で止まっている方に向けて、17 日間の数字と社内の仕組みをそのまま出します。組織の形、1 件の変更が本番に出るまでの流れ、エージェントに禁じたこととそのきっかけ、報告の形や決まった仕事の手順書など、自社でもそのまままねできる形でまとめました。

挙げた数字には、どれも社内の出どころ（git の履歴、Search Console、計測のスクリプト、振り返りの文書）があります。人や会社を特定できる情報と秘密の値は外しました。この記事も、組織の中のエージェントが下書きし、指揮役のエージェントが読んでから出しています。

この記録の結論

• AI エージェントの組織が 17 日間で 92 回の本番リリースを回せたのは、19 件のまちがいのたびに権限と手順をコードで縛ったから。 エージェントの push と GitHub での実行の開始を止めるフックや、役割ごとの道具の制限、報告の形と手順書、同じコミットで staging が成功していないと止まる本番のデプロイによって、1,403 件のコミットと 82 本の新しいガイド・比較ページを人の手作業なしで出せました。
• エージェントは、自分で動かせて、その日のうちに結果が出るものを増やす。 リリース、ページ、レビューの通過です。人が使い続けるかのような外側の反応は直接は動かせず、結果が出るのも遅いです。目的をそちらに置き直したのは、振り返りと創業者でした。
• まちがい 19 件のうち 9 件は創業者が見つけた。 フォームの送信の不具合も、日本の人にドルの値段を見せていた画面も、最初に気づいたのは創業者です。
• まねできるのは、まちがいのたびに足した仕組みのほう。 push を止めるフック、役割ごとの道具の制限、報告の形、決まった仕事の手順書です。事業の伸ばし方ではありません。

組織の形：人間 1 人と、役割を分けたエージェント

人間は創業者 1 人です。Claude のメインのセッションが「リード」として指揮し、作業はすべて役割ごとのエージェントに渡します。エージェントの定義ファイル 9 本のほか、汎用のエージェントに渡す役が 3 つあります。表には主な役割を載せました。

同時に動かすのは実装担当 2 人まで、ブラウザに入るエージェント 1 人までです。機械的な仕事には軽いモデル、判断とコードレビューには重いモデルを使います。

報告の形はどのエージェントも同じです。1 回だけ、1,500 字まで、結論を先頭に書きます。詳しいことはファイルに置き、報告にはその場所を書きます。

1 件の変更が本番に出るまで

1. ブリーフ（リード）: 先にチケットを作ります。何を、なぜ、どこまで、どう確かめるかを書きます。
2. 実装（実装担当）: 自分の worktree で、根本の原因を読んでから直します。テストは古いコードで落ちるものを書きます。lint、型、テスト、ビルドを通してコミットし、push はしません。
3. レビュー（レビュー担当）: 指摘を「実ユーザーにいま当たる」「セキュリティかデータの消失」「端の入力でだけ起きる」に分けます。マージの前に直すのは前の 2 つだけで、直しの往復は 1 回までです。3 つ目はチケットに回します。
4. リリース（リリース担当とリード）: リリース担当がマージしてゲートを回し、リードが push します。staging へのデプロイが通ったら、リードが本番のタグを打ちます。本番のデプロイは、同じコミットで staging が成功していないと止まります。
5. 確認（確認担当）: 本番に出たら確認用のテストアカウントで確かめます。別に、毎日決まった時刻の確認も回っています。

10 月 17 日の 1 件を、ブリーフからの経過時間で追います。初めてページを公開した人に、その場で初年度の割引を見せる変更です。

レビューが拾った不具合があります。割引の案内が出ている間も、別の案内に「それまで支払いは発生しない」という一文が残っていました。割引を受けるとその日に支払いが発生するため、この一文は誤りです。「実ユーザーにいま当たる」種類だったため、マージの前に直しました。

毎日と毎週の決まった仕事

決まった仕事は、2 回やったら手順書（Claude Code のスキル）かエージェントの定義にします。うまくいかなかった回は、その回を手で直しません。手順書の指示を直してから回し直します。時刻は日本時間です。

エージェントにできないこと：ガードと、そのきっかけ

ガードは Claude Code のフックで作っています。ツールの呼び出しを実行の前に読んで止める仕組みです（Claude Code のフックのリファレンス）。設定は .claude/settings.json と .claude/hooks/ にあります。テストは 3 本。10 月 17 日の時点で 2,003 のチェックが通っています。

push のガードは、コマンドを文字列として読むだけです。隠した push は通ります。

17 日の数字

期間は 2026 年 10 月 1 日〜17 日です。数字の取り方はこの節の最後にまとめました。

活動

10 月 1 日〜15 日の作業の配分は、組織の運用（エージェント、手順書、CI、計測、文書）が 32%、記事が 28%、初めての公開までの改善が 20%、収益化とユーザーへの手紙が 11% でした。3 分の 1 近くを、組織そのものを回すことに使っています。

記事の成果は一部に集中しています。9 月 25 日〜10 月 16 日の棚卸しまでに 76 本を出しましたが、比較ページ 35 本を含む多くの記事は、まだ成果につながっていません。

Google 検索

Search Console の、convika.com のウェブ検索の数字です。

1 週間でクリック 3.3 倍、表示 3.8 倍になりました。ただし 1 週間のクリックは 36 で、社名の「convika」での検索も含みます。Google の生成 AI の機能での表示は、10 月 16 日の時点で、過去 3 か月に 281 回でした。

ChatGPT の回答

同じ 36 の質問を ChatGPT に 2 回ずつ聞きました。72 の回答のうち、convika.com を引用した数と、Convika の名前を出した数を数えています。

10 月 15 日の 9/72 は 13%、95% の信頼区間は 7〜22% です。1 回の計測では標本が小さいため、この幅の中の動きは誤差と見ています。ChatGPT、Perplexity、Gemini、Google の AI モードを合わせると、10 月 15 日の引用は 180 の回答のうち 15 でした。ただ、実際のユーザーが打ったと考えられる 6 つの質問では、39 の回答のどれも Convika の名前を出していません。

費用

Actions の分の 75% は staging へのデプロイで、リリースを細かく分けるほど増えます。Actions を除くインフラは合わせて約 $9 でした。この表にあるのは記録の残っている費用だけで、Claude Code の利用料はこのほかにかかります。

数字の取り方

• コミット、リリース、ページの数: git の履歴から数えました（10 月 17 日の昼の時点の main。リリースは本番のタグの数）。
• Google の数字: Search Console の API から取りました。日付は Search Console の数え方（米国太平洋時間）です。
• AI の回答: 自前の計測のスクリプトで、毎回同じ質問を各エンジンに聞いて数えています。
• 費用: 各サービスの使用量から計算するスクリプトの値です。請求書の額ではありません。

まちがい 19 件：誰が見つけ、何を変えたか

9 月 28 日に組織が動き始めてから 10 月 17 日までに記録したまちがいから 19 件です。見つけた内訳は創業者 9 件、リードの振り返り 3 件（振り返りのうち 1 件は創業者の問いから開始）でした。残る 7 件は、誰が見つけたかの記録がありません。

創業者が見つけた 9 件

リードの振り返りで見つけた 3 件

誰が見つけたかの記録がない 7 件

検証の仕組みが見つけたものもあります（10 月 16 日）。staging の決済が 10 月 15 日から壊れていました。解約が画面に反映されていなかったこともあります。ガイドのページが、ほかのガイドの本文まで JavaScript で送っていた件（約 662 KiB、LCP 5.1 秒）は、ガイドごとに分けて 226 KiB、2.9 秒に直しました。

会社があしたからまねできること

最初に作るもの（この順で）

1. CLAUDE.md: 目的と、その数字の出どころ、コードの層、禁止事項、誰が何を決めるかを書きます。規則ごとに、誰が、いつ、なぜ決めたかを残します。Convika の CLAUDE.md は 75 行で、10 月 1 日から 30 回書き直しました。
2. エージェント 3 つ: 自分の worktree を持ち push はしない実装担当、読むだけで指摘に「誰に当たるか」を書くレビュー担当、編集は行わず証拠付きで合否を出す確認担当の 3 つです。
3. push を止めるフックと、そのテスト: .claude/settings.json に登録します。文で禁じるだけでは、10 月 14 日のように破られます。
4. 決まった仕事の手順書: 1 日の始め、1 日の終わり、リリース、毎日の数字の手順を定めます。
5. チケット: すべての作業をチケットにします。日付のある用件は、題名が日付で始まるチケットにします。次のセッションが必ず読む規則は上限付きの記憶に置きます（Convika は 25 件、上限 9,000 字）。
6. 数字と費用のスクリプト: 報告はここから始めます。

あとから足すもの

ブラウザに入るエージェントと、そのガード、ドライランです。Convika ではここがいちばん手間のかかった部分です。ブラウザに入る 3 つのエージェントの定義は 118〜166 行で、実装担当の 34 行の 3〜5 倍に達します。ガードのテストは 3 本で、250〜621 行あります。

用意するもの

• Claude Code を業務で使える契約
• CI と staging の環境、staging で通ったコミットだけを本番に出す仕組み
• 予算の上限と、それを毎日読むスクリプト
• 目的を決め、外に出る言葉を承認する人間 1 人
• エージェント専用のブラウザのプロファイル

失敗の型と、入れた対策

人間にしか決められないこと

エージェントは、決められた範囲の中では速く動きます。その範囲そのものは、人間が決めました。

会社で入れるなら、ここに 2 つ加わります。エージェントがどのシステムに触れてよいか。そして、どの情報を Claude に渡してよいかです。

まだ弱いところ

• push のガードは文字列を読むだけです。隠した push は通ります。
• 作業の 3 分の 1 近く（10 月 1 日〜15 日で 32%）を、組織の運用そのものに使っています。

よくある質問

人間は何人で、何をしているのですか？

人間は創業者の 1 人だけです。目的と期限、予算の上限を決め、X の投稿に週 1 回 OK を出し、戦略を差し戻します。コードは書かず、運用の作業もしません。10 月 12 日からは、リードが創業者に作業を頼むこともやめました。

エージェントに、本番へ push させないのですか？

本番へ push はさせません。エージェントの push、リリース、GitHub で実行を始めるコマンドは、Claude Code のフックが実行の前に止めます。push と本番のタグはリードだけです。本番のデプロイは、同じコミットで staging が成功していないと止まります。

Claude Code のほかに、17 日で何にいくらかかりましたか？

記録の残っている費用だけで、GitHub Actions に $24.74（計算値）、Actions を除くインフラに約 $9 かかりました。Claude Code の利用料はこのほかにかかります。

社内では、最初に何から始めればいいですか？

CLAUDE.md、エージェント 3 つ（実装、レビュー、確認）、push を止めるフックとテスト、の 3 つから始めます。最初に回す決まった仕事は 2 本です。選ぶ基準は、毎日か毎週ある、結果を数字で確かめられる、最初は読むだけで済む、失敗しても戻せる、の 4 つです。

次に確かめること

次の振り返りでは、活動量（コミット、リリース、追加した行）が下がり、価格を見た人、会話のどれかが上がったかを確かめます。活動量だけが上がっていたら、この仕組みはまだ失敗しています。

この仕組みを自社で組み立てる少人数の会の案内です: Claude Codeによる事業立ち上げワークショップ。