DEV Community

Cover image for Paperclip：オープンソースフレームワークで一人会社を経営する方法
Akira
Akira

Posted on • Originally published at apidog.com

Paperclip：オープンソースフレームワークで一人会社を経営する方法

Paperclipは、AIエージェントを従業員のように管理できるオープンソースのワンパーソンカンパニーフレームワークです。組織図、予算、ハートビートスケジューリング、ガバナンス承認、監査ログを備え、コマンド一発でローカルに立ち上げられます。エージェントは実作業を担当し、ユーザーは取締役会として意思決定に集中できます。

今すぐApidogを試す

2026年にはワンパーソンカンパニーの運営は“全部自分でやる”ことではなく、AIエージェントのチームに作業を割り振り、戦略に専念することを意味します。Paperclipはそのためのオープンソースフレームワークで、ソロ創業者が組織図・予算・ガバナンス・AIタスクトラッカーを自己ホストダッシュボードで一元管理できます。API設計やモック・テストにApidogを利用中なら、Paperclipが理想的なオーケストレーション層になります。ApidogでAPI契約、Paperclipでエージェント管理。本記事ではPaperclipの仕組みと、今日からの導入方法を具体的に解説します。

💡最初のPaperclipハートビートの前に、Apidog (無料) を入手してください。タスクの説明にモックURLを埋め込むことで、エージェントは完璧な契約に基づいて構築できます（コストゼロ、予期せぬ事態もゼロ）。その後、Apidogテストが予算を使い果たす前にずれを検知し、ライブAPIに切り替えます。

Paperclipとは何か？ワンパーソンカンパニーフレームワークがApidogユーザーにとって重要な理由

Paperclipのタグラインは「OpenClawが従業員なら、Paperclipは会社である」。

PaperclipはAIエージェントの集団を、役職・報告ライン・月次予算・戦略目標を持つ構造化組織に変えるNode.jsサーバー+React UI。単なるチャットボットやプロンプトマネージャー、ワークフローUIではなく、自律型企業のコントロールプレーンです。

2026年、AIエージェント利用が拡大する中で、多くのソロ創業者は混沌を管理している状況。Paperclipはこれを「実企業が従業員を管理する」のと同じ構造で解消します。

  • 組織図 — 各エージェントに役割/マネージャーを割当て
  • イシュー/タスク — すべての作業は担当・優先度・ステータスでトラッキング
  • 目標 — タスクは常に会社のミッションに紐付き、エージェントが“なぜ”を理解
  • ハートビート — スケジュールに従いタスク受信→作業→報告を自動化
  • 予算 — 月間トークン消費上限を強制、超過時は自動停止
  • ガバナンス — エージェント採用や主要決定は必ずあなたが承認

ApidogでAPI設計・モック→Paperclipでエージェント管理。この組み合わせでAPI契約と作業指示・予算・進捗を明確に区分できます。

ソロ創業者がApidog単独よりPaperclip併用を選ぶ理由

ApidogはAPI設計・テストに特化していますが、目標分解・タスク進捗・コスト可視化・監査ログまではカバーしません。Paperclipを追加することで、ソロ創業者でも“人が方向性を設定しAIが実行”するソフトウェア会社のオペレーティングシステムを手に入れられます。

Paperclip主要機能とApidogの役割

ハートビート: Apidog互換のエージェントアクティベーションループ

ハートビートはPaperclipのコア実行単位。1サイクルでエージェントは:

  1. GET /api/agents/me で自身情報を取得
  2. GET /api/companies/:id/issues?status=todo,in_progress でタスク受信箱を取得
  3. GET /api/issues/:id で親目標までのコンテキストを取得
  4. 作業実行（コード記述・API呼び出し・コンテンツ生成等）
  5. PATCH /api/issues/:id でステータス更新と作業内容コメントを送信

Apidogのモックサーバーを使えば、開発中はモックでテストし、本番ではコード変更なしでライブAPIへ切替可能。Apidogのリクエスト検証機能がAPI契約のズレを初期段階で検知します。

組織図と目標階層 ApidogをAPI層として

Paperclipの目標階層は「会社→チーム→エージェント→タスク」。タスク担当エージェントは常に祖先チェーンを受取るため、個々の作業が全体戦略と連動します。ApidogはAPI仕様層として、タスク説明にApidogエンドポイントを明記。API仕様を更新すれば、全エージェントが自動的に最新契約を参照できます。

予算執行: Apidogワークフローでの予算の暴走を止める

各エージェントにbudgetMonthlyCentsを設定。spentMonthlyCentsが上限に達したらタスク受諾不可。Apidogモックと組み合わせれば、トークンコストゼロでエージェント作業を検証、本番稼働時のみコスト発生という運用が可能です。

ApidogとPaperclipのセットアップ手順

ゼロコンフィグのローカル起動 Apidogはすぐに接続

Paperclipはコマンド一発でローカル起動:

npx paperclipai onboard --yes

組み込みPostgreSQLが自動セットアップされ、http://localhost:3100でUI起動。Dockerも外部サービスも不要。

次にUIから会社作成・目標定義:

"Build the #1 AI-powered API monitoring tool to $1M MRR."

エージェント例（claude_localアダプター）:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

タスク説明にApidogモックサーバーのURLを埋め込み、エージェントがAPI仕様をコンテキストとして利用できるようにします。

Apidogモックとエージェントタスクの接続

タスク説明（Markdown例）:

## タスク: /usersエンドポイントにページネーションを追加

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**受け入れ条件:**
- エンドポイントは `page` および `limit` クエリパラメータを受け入れる
- `{ data: [], total: 0, page: 1 }` のエンベロープを返す
- エッジケース (page=0, limit>100) のユニットテストカバレッジ

エージェントはこれを元に、Apidogモックを呼び出して仕様確認・実装・フィードバックを行います。

Apidog+Paperclipでのエージェント管理・タスク・ハートビート実行

Paperclip Apidogパイプラインを通じたイシュー管理

CLIでタスクのライフサイクルをフル操作:

# Apidog仕様に従ったエンドポイント実装タスクを作成
pnpm paperclipai issue create \
  --company-id  \
  --title "Apidog仕様に従ってPOST /webhooksエンドポイントを実装" \
  --description "Apidogコレクションを参照: http://localhost:4523/..."

# タスクステータス一覧
pnpm paperclipai issue list --company-id  --status in_progress

# タスクの解放
pnpm paperclipai issue release

各変更は不変ログに記録され、誰が何をしたかを完全トレース可能です。

ガバナンスと承認フローもCLIで管理

# 保留中承認の確認
pnpm paperclipai approval list --company-id 

# 新エージェント採用の承認
pnpm paperclipai approval approve  \
  --decision-note "承認しました。最初のスプリントにはApidogモックを使用してください。"

エージェントの自律性は維持しつつ、最終判断・承認は必ずあなたが行えます。

Paperclip+Apidogスタックのテスト・ガバナンス・コスト管理

Paperclip/Apidogユニットテスト実行

PaperclipはVitestによるユニットテスト、PlaywrightによるE2Eテストを同梱。実行例:

# ユニットテスト
pnpm test:run

# E2Eテスト
pnpm test:e2e

# サーバーヘルスチェック
curl http://localhost:3100/api/health

ユニットテストはイシュー状態遷移・予算執行・ハートビート・エージェント認証などコアロジックを網羅。新しいAIプロバイダー追加時も、テストを通せば既存オーケストレーションの安全性を担保できます。

ソロ運営ではコードレビューアがいないため、ユニットテスト＋Apidog契約テストが品質保証の要となります。

3層の品質スタック: Paperclip+Apidog+ユニットテスト

  1. Apidog…API契約定義＆自動契約テスト
  2. Paperclip…タスク受け入れ基準にApidog仕様を参照
  3. ユニットテスト（Vitest）…実装が仕様に合致することを確認

この構成で、ピアレビューのないソロ体制でも品質確保が可能です。

結論

Paperclipはソロ創業者を会社に変えるオープンソース・ワンパーソンカンパニーフレームワーク。組織図・予算・ガバナンス・目標アライメント・ハートビート・監査証跡をAIエージェント管理に導入できます。

ApidogでAPI設計・テストをしている開発者は、Paperclipを加えることで“APIはApidog、運営はPaperclip”という理想的な分担が実現。Apidogのモックサーバー＋契約テスト、Paperclipのガバナンス機能を活用し、初日から本番レベルの運用が可能です。

導入ステップ:

  • npx paperclipai onboard --yesでローカルブートストラップ
  • http://localhost:3100で会社・目標作成
  • 予算付きエージェント追加＆ApidogモックURLをタスクに設定
  • pnpm test:runでユニットテスト通過を確認
  • タスク承認後、エージェント実行＆監査ログ確認

ワンパーソンカンパニーはもう比喩ではありません。Paperclip×Apidogで現実的な運用アーキテクチャになります。

よくある質問

Paperclipとは何ですか？ AIエージェントを組織図・予算・ハートビートスケジューリング・ガバナンスで統括する、Node.jsサーバー＋React UIのオープンソースワンパーソンカンパニーフレームワークです。人間の従業員の代わりにAIエージェントでソフトウェア会社を運営できます。

PaperclipはApidogとどのように統合されますか？ Apidogはエージェントの作業するAPI契約を定義し、Paperclipのタスク説明にApidogモックURLを埋め込みます。エージェントは開発中にそのモックを呼び出し、最終実装はApidog契約テストで検証。Paperclipがオーケストレーション、ApidogがAPI仕様を担います。

Paperclipは本当にソロ創業者向けですか？ はい。ゼロコンフィグでローカルセットアップ（npx paperclipai onboard --yes）、予算管理でコスト暴走防止、ハートビートで自動化。Tailscale統合でスマートフォンからも管理可。同じ設定でローカル→クラウド移行も可能。

ユニットテストはどう実行しますか？ Vitestの場合pnpm test:run、Playwright E2Eテストはpnpm test:e2e。ヘルスチェックはhttp://localhost:3100/api/healthで。

PaperclipはどんなAIエージェントに対応？ Claude（ローカル/OpenClaw）、Codex、Cursor、Gemini、OpenCode、HTTP APIやローカルプロセスで動作するエージェント全般。アダプター追加で拡張可能です。

Paperclipはオープンソースですか？ MITライセンスでgithub.com/paperclipai/paperclipにて公開。プラグインSDK、アダプターパッケージ、スキル定義は@paperclipai/*スコープのNPMパッケージとして配布。

Top comments (0)