System Health

緊急・必須優先度: 3

災害復旧(Disaster Recovery)

目的: PCクラッシュ、環境移行、チーム拡大のいずれの状況でも、 蓄積された知恵が消失しないことを保証する。

復旧手順(5ステップ)

1
mirrorをclone
mkdir -p ~/work && cd ~/work && git clone git@github-seediv:seediv/mirror.git
mirrorが全workspaceの基盤。setup.shと全workspace設定の実体を含む
2
setup.shで全PJ clone + workspace設定を自動復元
cd ~/work/mirror && bash docs/workspace/setup.sh
全9PJのclone + CLAUDE.md/rules/hooks/ignoreファイルのsymlink設定を一括実行
3
環境変数をVercelから復元
cd ~/work/ippuku && npx vercel link && npx vercel env pull .env
vercel link でプロジェクトを紐付け後、env pull で全シークレット(ENCRYPTION_KEY含む)を復元。各PJで実行
4
SSH鍵をGitHubに登録(未登録の場合)
ssh-keygen -t ed25519 -C "your@email" && cat ~/.ssh/id_ed25519.pub
github-seediv の SSH鍵設定。~/.ssh/config に Host github-seediv の設定も必要
5
動作確認
cd ~/work/mirror && npm run build
ビルド成功を確認。他PJも同様に npm run build で検証

プロジェクト別 環境変数復旧

IPPUKU18 vars
cd ~/work/ippuku && npx vercel link && npx vercel env pull .env
ENCRYPTION_KEY — 紛失すると暗号化済みユーザーデータが永久に復号不能
ENCRYPTION_KEYCLERK_SECRET_KEYNEXT_PUBLIC_CLERK_PUBLISHABLE_KEYSTRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_IDTURSO_DATABASE_URLTURSO_AUTH_TOKENDATABASE_URLCRON_SECRETRESEND_API_KEYRESEND_FROM_ADDRESSNEXT_PUBLIC_APP_URLNEXT_PUBLIC_CLERK_SIGN_IN_URLNEXT_PUBLIC_CLERK_SIGN_UP_URL
Mirror2 vars
cd ~/work/mirror && npx vercel link && npx vercel env pull .env
BASIC_AUTH_USERBASIC_AUTH_PASSWORD

foundations/ 構造(知恵の永続基盤)

foundations/integrated/core/
4つのコアフレームワーク(思考の体系)
ITF_v2_1.mdUSM_v1.mdCEM_v1.mdAAF_v1.md
foundations/integrated/extensions/
拡張フレームワーク(自律運用)
ADDE_v1.md
foundations/integrated/maps/
フレームワーク統合マップ
Framework_Integration_Map.md
foundations/sovereign-ai/
主権AI安全性の体系
ESSENCE.mdARCHITECTURE_v2.mdQuick_Reference.md

永続化される vs ローカルのみ

GitHubに永続化
  • ソースコード(src/)→ GitHub(全10PJ)
  • 設計文書(docs/)→ GitHub
  • CLAUDE.md(各PJ + workspace)→ GitHub
  • workspace設定(rules/hooks/ignore)→ GitHub(mirror内、symlinkで参照)
  • 依存関係定義(package.json)→ GitHub
  • 環境変数(.env の中身)→ Vercel/CF — env pull で復元
  • 本番データベース → Turso(東京リージョン)
△ ローカルのみ(復元可能)
  • node_modules/(npm install で復元)
  • .next/(npm run build で復元)
  • .env ファイル自体(vercel env pull で復元)
  • symlink(setup.sh で自動復元)
  • ローカル開発DB(prisma/dev.db)→ 本番データには影響なし
  • NGC workspace素材(content/docs/policy)→ ローカルのみ(会社元素材)

SIA品質基盤の復元・新プロジェクト作成

PCクラッシュ後の workspace CLAUDE.md 復元、または新サービス開発時のSIA適用手順。

workspace全体を自動復元(推奨)
cd ~/work/mirror && bash docs/workspace/setup.sh
全PJ clone + CLAUDE.md/rules/hooks/ignoreのsymlink設定を一括実行。新PCではこれだけでOK
手動復元(setup.shが使えない場合)
ln -s ~/work/mirror/docs/workspace/CLAUDE_WORKSPACE.md ~/work/CLAUDE.md
CLAUDE.md, .claude/rules/, .claude/hooks/, .claudeignore, .cursorignore を個別にsymlink

プロジェクト別管理リンク

マルチデバイス開発

日常運用優先度: 1
設計思想
GitHub = Single Source of Truth(唯一の正)
ローカル = Working Copy(作業コピー)
学習ループ = data/*.yaml(git管理)
mirrorサイト = 静的HTML(CF Pages Free)
GitHub
MASTER DATA
会社Mac
Primary
自宅Mac
Secondary

3つのリスクと防御策

PCクラッシュ
  • GitHub push完了 = バックアップ完了
  • 10分ルール: 10分以上の作業は即push
  • .env.example を必ず作成・push
先祖返り(Regression)
  • セッション開始儀式: 必ず git pull から
  • 1デバイス1時間ルール: 切り替え時に必ずpush/pull
  • force push禁止(--force-with-leaseのみ)
コンフリクト
  • 作業開始時のgit pullで事前検知
  • 小さく頻繁にコミット(WIP OK)
  • コンフリクト時は落ち着いて差分確認

同期されないデータ(注意)

以下のデータはGitHubで同期されません(gitignored):

.env.local(環境変数)
  • BASIC認証情報
  • .env.example で構造を共有
node_modules/
  • npm install で再現

デバイス切り替えワークフロー

現在のデバイス終了時
  1. 作業を区切りのいいところまで
  2. git add -A && git commit -m "WIP"
  3. git push
  4. GitHubでpush完了を確認
新しいデバイス開始時
  1. git pull
  2. npm install(package.json変更時)
  3. 作業開始

コピペ用プロンプト

Claude Codeに以下をコピペするだけでOK

会社PC終了時
コミット、プッシュをして。
自宅PC開始時
git pull、npm installをして。

新PCセットアップ(初回のみ)

新しいMacを用意した際の手順。mirror 1つcloneすれば全環境が復元される

1
SSH鍵の設定
ssh-keygen -t ed25519 -C "your@email"
~/.ssh/config に Host github-seediv を設定し、GitHubに公開鍵を登録
2
mirrorをclone
mkdir -p ~/work && cd ~/work && git clone git@github-seediv:seediv/mirror.git
mirrorが全workspaceの基盤。setup.shと全workspace設定の実体を含む
3
setup.shを実行
cd ~/work/mirror && bash docs/workspace/setup.sh
全9PJのclone + CLAUDE.md/rules/hooks/ignoreのsymlink設定を一括実行
4
環境変数を復元
cd ~/work/ippuku && npx vercel link && npx vercel env pull .env
Vercel/CF管理のシークレットを各PJで復元。.env.exampleを参考に
5
動作確認
cd ~/work/mirror && npm run build
ビルド成功を確認。他PJも同様に検証
setup.sh実行後の構成
work/
├── CLAUDE.md              → mirror (symlink)
├── .claude/rules/         → mirror (symlinks, 5 files)
├── .claude/hooks/         → mirror (symlinks, 2 files)
├── .claudeignore          → mirror (symlink)
├── .cursorignore          → mirror (symlink)
├── mirror/                IDE基盤 (実体)
├── seehub/                コモンズ
├── ippuku/                問い
├── chigai/                判断軸
├── legacy/                寄付基盤
├── ibuki/                 有料サービス
├── renji/                 フォントツール
├── gun/                   クラスタリングツール
└── mirror-rag/            RAG AI

構想実行管理ルール(中途半端禁止)

緊急・必須優先度: 1
核心原則
GitHub = Single Source of Truth(唯一の正)
ローカル = Working Copy(作業コピー)

「中途半端」とは

定義: ローカルファイルのみを変更し、GitHubに反映していない状態
作業中(一時的な状態): 問題なし
作業完了後もpushしていない: 中途半端(禁止)
セッション終了時にpushしていない: 中途半端(禁止)
別PCに移動する前にpushしていない: 中途半端(禁止)

なぜ禁止すべきか

1. データ消失リスク
PCクラッシュ時に変更が失われる。ローカルファイルのみの変更は復元不可能。
2. 同期の不整合
別PCで作業する際に最新の変更を取得できない。コンフリクトの原因になる。
3. デプロイの不整合
VercelはGitHubのmainブランチからデプロイ。ローカルのみの変更は本番環境に反映されない。
4. 作業の重複
同じ作業を別PCで再度行う必要がある。時間の無駄。

必須ルール

ルール1: 作業開始時
git pull
他デバイスでの変更を取得してから作業開始
ルール2: 作業完了時(必須)
git add -A
git commit -m "変更内容の説明"
git push
GitHubに反映されて初めてバックアップ完了
ルール3: セッション終了時(必須)
Cursor/ClaudeCode使用時: セッション終了前に必ず git push を確認
「コミット・プッシュして」と依頼するのが確実
ルール4: 長時間作業中の定期push(推奨)
10分ルール: 10分以上の作業は即push
作業時間が長いほど、push前の変更が失われるリスクが高い

具体的な実行手順

緊急・必須優先度: 2
コピー可能な依頼文テンプレート
以下のテンプレートをクリックしてコピーし、ClaudeCode/Cursorのチャットに貼り付けて使用してください。
作業開始時(mirrorプロジェクト)
ClaudeCode/Cursorでmirrorプロジェクトの作業を開始する際の依頼文
作業開始前に、mirrorプロジェクト(~/work/mirror)で最新の状態を取得してください。 手順: 1. ~/work/mirror ディレクトリに移動 2. git pull で最新の変更を取得 3. git status で状態を確認 その後、作業を開始してください。
作業開始時(その他プロジェクト)
ClaudeCode/Cursorで他のプロジェクトの作業を開始する際の依頼文
作業開始前に、[プロジェクト名]プロジェクト(~/work/[プロジェクト名])で最新の状態を取得してください。 手順: 1. ~/work/[プロジェクト名] ディレクトリに移動 2. git pull で最新の変更を取得 3. git status で状態を確認 その後、作業を開始してください。 ※ [プロジェクト名] を実際のプロジェクト名に置き換えてください(例: seehub, life, pair など)
作業終了時(mirrorプロジェクト)
ClaudeCode/Cursorでmirrorプロジェクトの作業を終了する際の依頼文
作業が完了しました。mirrorプロジェクト(~/work/mirror)の変更をGitHubに反映してください。 手順: 1. ~/work/mirror ディレクトリに移動 2. git add -A で変更をステージング 3. git commit -m "作業完了: [変更内容の説明]" でコミット 4. git push でGitHubに反映 変更内容の説明は具体的に記入してください(例: "構想: AI-4mode適用領域の分析" / "実装: Headerコンポーネントのリファクタリング" / "改善: 中途半端状態の検証機能追加")。
作業終了時(その他プロジェクト)
ClaudeCode/Cursorで他のプロジェクトの作業を終了する際の依頼文
作業が完了しました。[プロジェクト名]プロジェクト(~/work/[プロジェクト名])の変更をGitHubに反映してください。 手順: 1. ~/work/[プロジェクト名] ディレクトリに移動 2. git add -A で変更をステージング 3. git commit -m "作業完了: [変更内容の説明]" でコミット 4. git push でGitHubに反映 変更内容の説明は具体的に記入してください(例: "構想: AI-4mode適用領域の分析" / "実装: Headerコンポーネントのリファクタリング" / "改善: 中途半端状態の検証機能追加")。 ※ [プロジェクト名] を実際のプロジェクト名に置き換えてください(例: seehub, life, pair など)
セッション終了時(簡易版)
セッション終了前に必ず実行する簡易依頼文
コミット・プッシュして
デバイス切り替え時
会社PCから自宅PCなど、デバイスを切り替える際の依頼文
デバイス切り替えのため、現在の作業内容をGitHubに反映してください。 手順: 1. git add -A で変更をステージング 2. git commit -m "WIP: [作業内容の説明]" でコミット 3. git push でGitHubに反映 ※ WIP(Work In Progress)としてコミットし、後で完了時に正式なコミットメッセージに変更できます。
使い方
1. 上記のテンプレートから該当するものを選択
2. 「コピー」ボタンをクリック
3. ClaudeCode/Cursorのチャットに貼り付け(Cmd+V / Ctrl+V)
4. 必要に応じて[プロジェクト名]や[変更内容の説明]を実際の内容に置き換え
作業開始時
方法1: ClaudeCode/Cursorで依頼(推奨)
ClaudeCode/Cursorのチャットで以下のように依頼:
# 依頼例
「作業開始前にgit pullして最新の状態にしてください」
「最新のコードを取得してください」
方法2: Terminalで手動実行
cd ~/work/mirror# プロジェクトディレクトリに移動
git pull# 最新の変更を取得
git status# 状態確認(オプション)
作業終了時
方法1: ClaudeCode/Cursorで依頼(推奨)
ClaudeCode/Cursorのチャットで以下のように依頼:
# 依頼例(推奨)
「コミット・プッシュして」
「作業内容をGitHubに反映して」
# より具体的な依頼例
「変更をコミットしてGitHubにプッシュしてください」
ヒント: セッション終了前には必ず依頼すること
方法2: Terminalで手動実行
cd ~/work/mirror# プロジェクトディレクトリに移動
git add -A# すべての変更をステージング
git commit -m "作業完了: 変更内容の説明"# コミット(メッセージは具体的に)
git push# GitHubに反映
ヒント: 一括実行も可能 → git add -A && git commit -m "説明" && git push
領域ごとの違い
基本原則: Gitワークフロー(pull → 作業 → commit → push)は 構想設計・実行実装・運用改善のすべてで同じです。
領域による違い(補足):
構想設計:
• コミットメッセージ例: "構想: AI-4mode適用領域の分析"
• 作業の粒度: 大きな概念単位でコミット
• 頻度: 構想がまとまった時点でコミット
実行実装:
• コミットメッセージ例: "実装: Headerコンポーネントのリファクタリング"
• 作業の粒度: 機能単位でコミット
• 頻度: 機能が完成した時点でコミット
運用改善:
• コミットメッセージ例: "改善: 中途半端状態の検証機能追加"
• 作業の粒度: 改善単位でコミット
• 頻度: 改善が完了した時点でコミット
重要: どの領域でも、作業開始時にgit pull、作業終了時にgit pushは必須です
デバイス切り替え時
例: 会社PC → 自宅PC
【会社PC 終了時】
git add -A && git commit -m "WIP: 作業内容" && git push
GitHubでpush完了を確認してから終了
【自宅PC 開始時】
cd ~/work/mirror && git pull

中途半端状態の検証・改善方法

1. 現在の状態を確認
git status# 未コミットの変更を確認
git status --short# 簡潔な表示
git log origin/main..HEAD# 未プッシュのコミットを確認
2. 改善手順(未コミットの変更がある場合)
git add -A# すべての変更をステージング
git commit -m "作業完了: 変更内容"# コミット
git push# GitHubに反映
3. セッション終了前チェックリスト
git status で未コミットの変更がないか確認
☐ すべての変更をコミットしたか確認
git push でGitHubに反映したか確認
☐ GitHubで変更を確認(必要に応じて)

標準作業フロー

1. 作業開始
git pull(他デバイスの変更を取得)
2. 作業中
↓ [ファイル編集]
3. 作業完了
git add -A
git commit -m "変更内容"
git push
4. 確認
↓ GitHubで変更を確認
↓ Vercelで自動デプロイを確認(必要に応じて)

デプロイ管理フロー

Local
Git管理
middleware.ts、YAML、コード
GitHub
seediv/ org
Private repos
Vercel
seediv-命名規則
自動デプロイ
seehub.org
カスタムドメイン
Basic Auth保護
→ 詳細なフロー解説・トラブルシューティング
Single Source of Truth: data/projects.yaml

全プロジェクトのメタデータ、デプロイ状態、認証設定はYAMLで一元管理。npm run generate:projectsで TypeScript に変換。

現在の実装状況

認証方式
BASIC認証(_headers / CF Access)
URL命名規則
[project]-seediv.vercel.app
ドメイン
[project].seehub.org
保護状態
全15ドメイン 401保護

認証方式の選択肢

認証には複数の選択肢があります。mirrorはCF Pages静的エクスポートのため、認証は_headers / CF Accessで対応。他PJはVercel middleware.ts統一。

middleware.ts (Basic Auth)
現在採用中
コードベースで認証を実装
無料
メリット
  • バージョン管理可能
  • 環境変数で制御
  • 全プロジェクト統一
デメリット
  • コード変更が必要
Vercel Password Protection
Vercelダッシュボードで設定
Pro: $20/月〜
メリット
  • GUI設定
  • コード変更不要
デメリット
  • Pro以上で有料
  • プロジェクトごとに設定
Vercel Authentication
Vercelチームメンバーのみアクセス可能
Enterprise: 要問合せ
メリット
  • チーム管理と統合
  • SSO対応
デメリット
  • 外部ユーザーアクセス不可
  • Enterprise向け
Clerk / NextAuth
本格的な認証システム
Clerk: 無料〜
メリット
  • ユーザー管理
  • OAuth対応
  • 本番向け
デメリット
  • 実装コスト高
  • 利用料金
SEEHUB/LIFE/PAIRで使用(Clerk + Basic Auth二重保護)

環境変数

変数名説明デフォルト
MIRROR_WORK_DIRプロジェクトのベースディレクトリ$HOME/work
BASIC_AUTH_USERBasic認証ユーザー名(Vercel用)-
BASIC_AUTH_PASSWORDBasic認証パスワード(Vercel用)-

Git管理

リポジトリ:
github.com/seediv/mirror
ブランチ戦略: main(単一ブランチ、直接プッシュ)
コミットメッセージ規約:
  • Fix: バグ修正
  • Add: 新機能追加
  • Update: 既存機能の更新
  • Refactor: リファクタリング
  • P0/P1/P2: 優先度付きタスク

月次コストサマリー

日常運用優先度: 2
$60
+ ¥2,090
月額合計
$720
+ ¥29,858
年間推定
12
アクティブサブスク
¥562,471
一括払い済(10年)

2026-02-11更新。Google Workspace税込¥2,090/月。MS365は1ヶ月で停止済。MacBook Pro M4 Max ¥514,691(税込)。Vercel Pro $20/月。Resend無料枠でIPPUKU週次メール運用中(~700人まで無料、超過時Developer $20/月へ移行予定)

有料(月額)

サービス概要プラン月額年換算関連PJ
Vercel ProWebサービスのホスティング基盤。手動デプロイ(GitHub Actions dispatch)で意図的に公開Pro$20$240mirror, ippuku, ibuki
Cloudflare Workers Paidseehub/miru/renji/legacy/gun/chigaiのホスティング基盤。手動CLIデプロイPaid$5$60seehub, miru, renji, legacy, gun, chigai
Claude ProAIペアプログラマー。設計・実装・レビューを対話しながら進めるPro$20$240
Cursor Proコード補完・リファクタリングをAIが支援するエディタPro$20$240
Google Workspaceチームのメール・ドキュメント・カレンダー・ストレージをまとめて管理Business Standard¥2,090¥25,080

無料

サービス概要プラン関連PJ備考
GitHub Free全プロジェクトのソースコードを保管・履歴管理する中核Free全PJPrivate repos利用
Clerk Free (Production)ippuku/ibuki/miru/legacy/renji/gun/seehubのクロスドメイン認証。Google OAuth + clerk.seehub.orgFreeippuku, ibuki, miru, legacy, renji, gun, seehub2026-04-06: Development→Production移行。Custom domain clerk.seehub.org。2026-04-07: legacy/renji/gun追加。Allowed Subdomains 7件。MAU 10,000無料
Turso StarterIPPUKUのデータベース。SQLite互換で高速・低レイテンシStarterippukuippuku DB — aws-ap-northeast-1 (東京)。Overages disabled
Supabase FreeLAYERのデータベース。PostgreSQL準拠のマネージドDBFreelayerlayer-tokyo プロジェクト(Tokyo ap-northeast-1)
Resend Freeユーザーへのメール送信基盤。週次リマインダーや認証メールFreelayer, ippukuseehub.org ドメイン認証済み(DKIM/SPF/東京リージョン)。月3,000通まで無料。IPPUKU週次メール + LAYERマジックリンク

有料(一括)

項目概要購入日契約金額
.ORG ドメイン登録 (seehub.org)seehub.orgというインターネット上の住所を10年分確保2025-01-2910年契約¥34,790
完全ドメインプロテクションドメインの不正移管・乗っ取りを防ぐ保険2025-01-2910年契約¥12,990
16インチ MacBook Pro(整備済製品)開発に必要な高性能マシン。全プロジェクトの開発環境2026-01-1914コアCPU / 32コアGPU / Apple M4 Max / スペースブラック¥514,691 (税 ¥42,891)

停止済み

サービス概要金額備考
Microsoft 365 メールエッセンシャルズビジネスメール用途。Google Workspaceに一本化したため停止¥3,9481ユーザー。GoDaddyドメイン購入時にバンドル(¥3,948/年)。1ヶ月で停止済み — Google Workspaceに統一

Google Workspace Business Standard — 利用可能な機能

カテゴリ機能
メール(Gmail)
独自ドメインのビジネスメール(you@seehub.org)
広告なし
迷惑メール・フィッシング対策
ストレージ
1ユーザーあたり 2TB のクラウドストレージ
Gemini(AI機能)
Gmail・ドキュメント・スプレッドシート・スライド・Meet・ドライブ・Chat で利用可能
メール文ドラフト、文章要約、表の分析、スライド案生成、会議の要約
オンライン会議(Google Meet)
最大150人参加
会議の録画機能
ノイズキャンセリング
コラボレーション
Google ドライブ・共有ドライブ
ドキュメント・スプレッドシート・スライドのリアルタイム共同編集
Chat・カレンダー・フォーム・サイト
管理・セキュリティ
管理コンソールからユーザー・端末・権限を一元管理
セキュリティ・監査ログ
最大300ユーザー(Businessエディション共通)

ホスティングコスト管理

日常運用優先度: 3

目的: mirrorはCF Pages Free($0/月)に移行済み。他PJ(ippuku等)はVercel Pro($20/月)を継続。以下はVercel運用PJ向けの管理ルール。

日常ルール

Push
1日1回
Push = デプロイ = コスト
開発
localhost
npm run dev でローカル確認
月間ビルド
75回以内
$20 ÷ $4/h ÷ 4min
プロジェクト
5個
ippuku, mirror, seehub, life, pair

費用がかかる条件

最優先長時間動き続けるプログラム
例: 24時間バックグラウンド処理、1時間以上の重い計算
メモリ長時間確保 → 1時間で約$10-20
中程度同時に複数のビルドを実行
例: 複数プロジェクト同時デプロイ、複数ブランチ同時ビルド
約$0.014/分(対策済み: 順番ビルドに設定)
大量のアクセス
例: 月100万回以上の関数呼び出し、月1TB以上のデータ転送
超過分: $2.00/100万回、$0.10/GB
まとめ: 普通に使う分には$20/月で十分。長時間プログラムだけ注意。
→ Vercel 課金制御(構造的ガード・インシデント記録・3層制御の詳細)

手動Cronスケジュール

月次運用

GitHub Actionsで自動化済み— 毎月1日 9:00 JST(0:00 UTC)に自動実行されます。Vercel Hobby tier(無料枠)を維持するため、Vercel Cronではなく無料のGitHub Actionsを使用しています。手動実行も可能です。

推奨実行スケジュール

実行タイミング毎月1日AUTO
次回自動実行2026年2月1日9:00 JST

利用可能なCronエンドポイント

Health Check
/api/cron/health-check
全プロジェクトのHealth状態を更新
Auto Propose
/api/cron/auto-propose
改善提案を自動生成

実行方法

方法1: Claude Codeに依頼
「mirrorの月次Cronを実行して」
方法2: curlコマンド(Health Check)
curl -X POST https://mirror.seehub.org/api/cron/health-check
方法2: curlコマンド(Auto Propose)
curl -X POST https://mirror.seehub.org/api/cron/auto-propose

Vercel使用制限

日常運用優先度: 5

Hobby tier 制限値

Bandwidth
100 GB / 月
Fluid Provisioned Memory
360 GB-Hrs / 月
Fluid Active CPU
31時間 / 月

Hobby tierでNG構成

x
BullMQ / ジョブキュー
バックグラウンドワーカーが常時稼働し、Fluid Memory/CPUを消費
x
長時間実行関数(10秒超)
Serverless Functionのタイムアウト制限に抵触
x
Websocket / 常時接続
Edge Functionの接続時間制限に抵触
x
Cron(5分以上の間隔以外)
Hobby tierのCronは手動実行 or GitHub Actionsで代替

インシデント記録: 2026-01-29 renewブロック

renewとは
AI-powered Website Regeneration Platform。既存Webサイトから意図を抽出し、新しいコードを生成する6フェーズパイプライン。
問題の構成(非機能)
BullMQ + Redis による6つのバックグラウンドワーカー:
1. harvest.worker — Webサイトクロール(最大50ページ、深度3)
2. intent.worker — Claude APIで意図抽出
3. regenerate.worker — 意図からコード生成
4. validate.worker — コード品質検証
5. switch.worker — デプロイ・切り替え
6. monitor.worker — 本番環境監視
なぜ問題になったか
BullMQワーカーは長時間実行プロセスとしてRedisをポーリングし続ける。Vercelのサーバーレスモデル(リクエスト→レスポンス→終了)と根本的に不適合。ワーカーがアイドル状態でもメモリ/CPUを消費し続け、Fluid Provisioned Memory 4,204 GB-Hrs(99.8%)、Fluid Active CPU 30h32m(97.4%)に達した。
影響
チーム全体が「fair use limits exceeded」でブロック。seehub含む全プロジェクトが402 Payment Required。
対応
vercel project rm renew --scope seedivでプロジェクト削除。ブロック解除待ち。
教訓
ジョブキュー/バックグラウンド処理はVercelに置かない。Railway/Render/Fly.io等の長時間実行対応ホスティングを使用すること。

ジョブキュー代替ホスティング

Railway
$5/月〜。長時間実行、常時接続対応
Render
$7/月〜。Background Workers対応
Fly.io
従量課金。コンテナベースで柔軟

サブスクリプション

参考情報優先度: 3
Vercel Pro
Pro
Vercel
$20/
デプロイ・ホスティング(Pro枠での安定運用)
2026-02-11: Hobby→Pro再アップグレード。2026-04-07: push自動/日次自動デプロイ廃止→全PJ手動デプロイに統一。cronジョブ(IPPUKU週次メール等)に必要
GitHub Free
Free
GitHub
$0/一括
ソースコード管理・バージョン管理
Private repos利用
Cloudflare Workers Paid
Paid
Cloudflare
$5/
CF Workers/Pagesホスティング(6PJ)
2026-04-07: Free→Paid移行。Worker 10MB/CPU 30s/リクエスト10M月。Free時代の3MB制限でgunデプロイ不可→Paid化で解決
Clerk Free (Production)
Free
Clerk
$0/一括
認証・SSO基盤(7サブドメイン共有)
2026-04-06: Development→Production移行。Custom domain clerk.seehub.org。2026-04-07: legacy/renji/gun追加。Allowed Subdomains 7件。MAU 10,000無料
Claude Pro
Pro
Anthropic
$20/
Claude Code・MIRROR Agent基盤
主要開発ツール
Cursor Pro
Pro
Cursor
$20/
AI補助IDE
Claude Codeと併用
Google Workspace
Business Standard
Google
¥2,090/
メール・ドキュメント・カレンダー・AI・ストレージ
月額¥1,900(税抜)+ 消費税¥190 = ¥2,090。2025-12-29 Plus→Standardダウングレード。年間契約なら約¥1,600/月
.ORG ドメイン登録 (seehub.org)
10年契約
Cloudflare Registrar
¥34,790/一括
seehub.org ドメイン登録(10年)
GoDaddy注文 小計¥51,728(税¥0)。年間約¥3,479相当
完全ドメインプロテクション
10年契約
GoDaddy
¥12,990/一括
seehub.org ドメイン保護(10年)
年間約¥1,299相当
Microsoft 365 メールエッセンシャルズ
Essentials
Microsoft (via GoDaddy)
¥3,948/
ビジネスメール
1ユーザー。GoDaddyドメイン購入時にバンドル(¥3,948/年)。1ヶ月で停止済み — Google Workspaceに統一
Turso Starter
Starter
Turso (libSQL)
$0/一括
libSQLデータベース(SQLite互換、エッジ対応)
ippuku DB — aws-ap-northeast-1 (東京)。Overages disabled
Supabase Free
Free
Supabase
$0/一括
PostgreSQLデータベース
layer-tokyo プロジェクト(Tokyo ap-northeast-1)
Resend Free
Free
Resend
$0/一括
トランザクションメール送信・週次リマインダー
seehub.org ドメイン認証済み(DKIM/SPF/東京リージョン)。月3,000通まで無料。IPPUKU週次メール + LAYERマジックリンク

アカウント

Vercel (Personal)デプロイ
Proadmin@seehub.org
seehub.org*.seehub.org
個人アカウント。seedivチーム配下で全プロジェクトをデプロイ。2026-02-11: Hobby→Pro再アップグレード
Vercel Team (seediv)
Proadmin@seehub.orgメインチーム。全プロジェクトはここに所属。2026-02-11: Hobby→Pro再アップグレード
GitHub (seediv)バージョン管理
Freeadmin@seehub.org全リポジトリの管理組織
Stripe Link決済
Standardadmin@seehub.org2025-12-29登録。複数Stripeサービスで利用可能
Clerk (SEEHUB)認証
Freeadmin@seehub.orgSEEHUB認証基盤
AnthropicAI
Proadmin@seehub.orgClaude Pro / Claude Code
Supabase (layer-prod)
Freeadmin@seehub.orgLAYER用PostgreSQL。Tokyo リージョン
Resend (seehub)
Freeadmin@seehub.orgseehub.org ドメイン認証済み。noreply@seehub.org から送信

変更ログ

2026-02-09add
IPPUKU本番インフラ構築 — Turso DB + Vercel自動デプロイ + GDPR対応API
理由: T1 MVP公開に向けた本番基盤の確立
影響: ATLAS OPEN 14→7。本番DB・自動デプロイ・データ削除/エクスポートが稼働
2026-01-12downgrade
Vercel Pro → Hobby ダウングレード + 開発ワークフロー最適化
理由: 月$20コスト削減。無料枠内での運用ルール確立
影響: ビルド・CPU・メモリの使用量を意識した開発フローへ移行
2026-01-12resolve
PC高負荷インシデント — 複数重プロセス同時実行
理由: vercel --yes ×2 + vitest + next build が同時実行
影響: Load Average 27.03 → 4.08 に回復
2026-01-11archive
CLAUDE.md学習ログのアーカイブ化
理由: ファイルサイズ削減(177.6k chars警告対応)
影響: 287KB → 148KB(48%削減)、パフォーマンス改善
2026-01-08add
シークレット検出(gitleaks)とSBOM生成(CycloneDX)の実装
理由: セキュリティ強化とソフトウェアサプライチェーンの透明性確保
影響: 機密情報漏洩の防止、依存関係の可視化、CI/CD品質向上
2026-01-08update
BONDプロジェクトのモノレポ→フラット構造変換
理由: ビルド・デプロイの簡素化、保守性向上
影響: Vercelデプロイ成功、プロジェクト構造のシンプル化
2026-01-08resolve
Vercel予期せぬ超過課金の検出と制御有効化
理由: On-Demand Budget $20設定済みだが、Pause Production DeploymentsがOFFで超過継続
影響: seehubチーム全プロジェクトが一時停止、追加課金停止
2026-01-05add
Runtime Guardrails Engine — Phase 1.4完成、実行基盤完成
理由: LLM出力の安全性担保、コスト制御、センシティブ情報保護
影響: Phase 1 実行基盤 4項目すべて完了
2026-01-05add
自動テスト生成システム — 実行基盤 Track A
理由: テストカバレッジ向上の自動化、テスト自動化の強化
影響: 518 exported functions発見、490テスト生成対象
2026-01-04add
タスクテンプレートページ + PDF Skill — /tasks追加
理由: 繰り返し作業の効率化、実行基盤 P0タスクの構造化
影響: /tasks ページ追加、PDF skill documentation整備

構造的品質保証(SQA)ダッシュボード

10
プロジェクト
5
Level 4
5
Level 3
100%
展開率

プロジェクト別ステータス

mirror
Coordinator
L4+L5p
seehub
North Star
L4
trust
TRUST実装
L4
life
Service
L4
pair
Service
L4
mix
Service
L3
iconiq
Service
L3
bond
Business
L3
root
Business
L3
lens
Business
L3

セキュリティ状況

参考情報優先度: 2
セキュリティ管理 →

現在のセキュリティレベル

認証方式Basic認証 + 環境変数
レート制限実装済み
HTTPS強制実装済み
セキュリティヘッダー実装済み(7種類)

実装済みセキュリティ機能

環境変数対応
全12プロジェクトで環境変数から認証情報を取得
レート制限
10秒間に5回までの認証試行を許可(本番環境)
HTTPS強制
本番環境でHTTPアクセスをHTTPSにリダイレクト
セキュリティヘッダー
HSTS、CSP、X-Frame-Options等7種類を実装
認証失敗ログ
本番環境で認証失敗とレート制限超過をログ記録

セキュリティツーリング(2026-01-08 追加)

シークレット検出gitleaks
APIキー・パスワード等の機密情報漏洩を自動検出
CI統合: secret-detectionジョブ(最初に実行)
ローカル: npm run check:secrets
カスタムルール: Anthropic/Vercel/Clerk/Stripe
SBOM生成CycloneDX
ソフトウェア部品表による依存関係の可視化
形式: CycloneDX 1.5(業界標準)
規模: 634コンポーネント追跡
CI: ビルド成功時にアーティファクト保存(30日)
CI/CD統合
GitHub Actionsでの自動セキュリティチェック
実行順序:
1. Secret Detection(ブロッカー)
2. Lint / Type Check / Test(並列)
3. Build + SBOM生成
4. Quality Gate

セキュリティ監査完了(2026-01-08)

GitHub Private Repo: 全リポジトリがPrivate、Collaboratorは自分のみ
Vercel プロジェクト: 全16プロジェクトでBASIC_AUTH環境変数設定済み
独自ドメインサイト: 全16サイトで認証確認済み(renew修正済み)
→ 詳細を確認

対応プロジェクト(全16プロジェクト)

mirrorseehublayerrenewbondprismonetetrismixleapiconiqi2lensrootpairlifetrust

プロジェクト間依存関係

ビュー:
20
依存関係
31
プロジェクト
6
関係タイプ
4
層間依存

プロジェクト構造(三層モデル)

層間依存フロー

部分構造全体構造5 依存
IPPUKU SEEHUBLEGACY SEEHUBLIFE SEEHUBPAIR SEEHUBREAL SEEHUB
詳細詳細5 依存
ONE Portal ONEONE Portal PRISMONE Portal RENEWNGC External NGC InternalNGC Internal NGC External
全体構造部分構造4 依存
MIRROR LEGACYMIRROR TRUSTSEEHUB IPPUKUSEEHUB LEGACY
詳細全体構造3 依存
MIRU SEEHUBIBUKI SEEHUBMIRROR-RAG MIRROR
全体構造全体構造2 依存
MIRROR SEEHUBSEEHUB MIRROR
詳細部分構造1 依存
IBUKI IPPUKU

凡例

W全体構造
P部分構造
D詳細

AI/Tools戦略

核心的洞察

設計次第で月数十ドルでも10時間/日を十分回せます。「毎日10時間、数十サイトを継続改善」という前提でも、モデルとワークフローの設計次第で高額プランに固定化される必然性はありません。

鍵は: モデル単体に記憶や文脈保持を任せず、外部の記憶・状態管理と組み合わせた設計にすることです。「上位モデルを常時フルコンテキストで回し続ける」スタイルだと確かに数百ドルが見えてきますが、工程分割と外部記憶・要約の徹底で安価帯中心でも回せます。

実績例: 1日10時間運用で月間1,500万トークン → 最適化アプローチで約$37.5/月(従来アプローチ: $375/月以上、90%削減)

低コストで「長期記憶っぽさ」を実現する設計

モデルの使い分け(「山」だけ高性能)
日々の修正・抽出・要約は安価モデル、要件定義の詰めや難所のレビューだけ上位モデル
コンテキスト圧縮(要約+差分+RAG)
毎回丸ごと渡さない。要約+差分+必要箇所のRAGで、都度必要な断片のみを提示
プロジェクトごとの状態管理分離
各サイトの「決定事項/未決事項/次アクション」を短いカードで持ち、長文履歴は検索に回す
出力の再利用とキャッシュ
頻出のプロンプト、スタイルガイド、雛形、既出回答はテンプレ化して再参照
バッチ処理で密度を上げる
類似ページの改善点抽出やQAはまとめて投げ、出力を後段で分配するほうが合計トークンが減る

今後の方向性

現時点(実験中): 基本的なRAG実装、セッション要約の試行、マルチモデル編成の実験。最適化は部分的、無駄な作業もある。
将来的な精査判断: 世界的なプロフェッショナルや優れたチームとして、どんなAIやToolsの組み合わせが妥当なのか精査判断したい。

管理タスク

Coordinator Agentとして、全プロジェクトの健全性を維持するための確認タスク

総タスク数
14
完了
6
要対応
0
期限切れ
14
完了率
43%
!期限切れタスク: 14
確認が必要なタスクがあります
YAML/JSON構造のバリデーション延期期限切れ
data/*.yaml の構造が適切か、スキーマに準拠しているか確認
データ構造管理 | 月次 | 手動最終確認: 2025/12/23
前提条件未整備のため保留。スキーマ定義が先決
YAML/JSON化の機会探索延期期限切れ
TypeScriptコード内にYAML化可能なデータ配列がないか探索
データ構造管理 | 四半期 | 手動最終確認: 2025/12/23
現在のYAML化は十分。次回リファクタリング時に再評価
生成ファイルの整合性確認完了期限切れ
projects-generated.ts, capabilities-generated.ts が最新か確認
データ構造管理 | 週次 | 自動最終確認: 2025/12/23
ビルド時に自動チェック済み(npm run build で自動実行)
CHANGELOG.md の更新確認完了期限切れ
重要な変更がCHANGELOG.mdに記録されているか確認
ドキュメント管理 | 月次 | 手動最終確認: 2025/12/23
2025-12-23の変更を記録済み(タイポグラフィ、レスポンシブ、ツールチップ、セッションプロトコル)
CLAUDE.md の一貫性確認完了期限切れ
各プロジェクトのCLAUDE.mdが最新のテンプレートに準拠しているか
ドキュメント管理 | 四半期 | 手動最終確認: 2025/12/23
開発セッションプロトコルを追加、参照パスを更新済み
ドキュメント構造の最適化完了期限切れ
ドキュメントが適切に分類・整理されているか確認
ドキュメント管理 | 四半期 | 手動最終確認: 2025/12/23
docs/design/role-division/, docs/guides/ai-agent/ を作成、配置設計完了
技術スタックの監査完了期限切れ
各プロジェクトの技術スタックが最新で一貫しているか確認
アーキテクチャ管理 | 四半期 | 手動最終確認: 2025/12/23
projects.yaml更新済み(Next.js 16.0.10, React 19.2.2等)
デザインシステムの一貫性確認完了期限切れ
shared-design-systemが全プロジェクトで適切に使用されているか
アーキテクチャ管理 | 月次 | 手動最終確認: 2025/12/23
タイポグラフィシステム全面更新(Montserrat + Noto Sans JP)、レスポンシブ対応済み
コード品質レビュー延期期限切れ
各プロジェクトのコード品質が基準を満たしているか確認
品質管理 | 月次 | 手動最終確認: 2025/12/23
五層品質モデルでの手動評価は実施済み。自動評価基盤の構築が先決
テストカバレッジ確認延期期限切れ
各プロジェクトのテストカバレッジが適切か確認
品質管理 | 月次 | 手動最終確認: 2025/12/23
テスト基盤の構築が先決。Vitest設定後に再開
プロジェクト間依存関係の確認延期期限切れ
プロジェクト間の依存関係が適切に管理されているか確認
統合管理 | 四半期 | 手動最終確認: 2025/12/23
現在は単一プロジェクト運用。マルチプロジェクト展開時に再開
共有リソースの監査延期期限切れ
shared/配下のリソースが適切に管理されているか確認
統合管理 | 四半期 | 手動最終確認: 2025/12/23
shared/は現在未使用。designSystemはlib/theme/に統合済み
thoughtフレームワークの活用確認延期期限切れ
6 Toolsとプロンプト技法が適切に活用されているか確認
ドキュメント管理 | 四半期 | 手動最終確認: 2025/12/23
ITF v2.0に統合済み。thoughtは参照資料として保持
thought統合の見直し延期期限切れ
thoughtフォルダとmirrorの統合が適切に機能しているか確認
統合管理 | 四半期 | 手動最終確認: 2025/12/23
Foundationページに統合済み。ITF v2.0が主要フレームワークとして機能

今後の予定

GitHub Organization
Private reposをOrg移行
会社正式化後
vercel-pro
Pro → Team プラン
チーム拡大時
resend-free
Resend Free → Developer ($20/月)。月50,000通まで。~12,000ユーザーまで対応
IPPUKUユーザー ~700人超過時
stripe-private
Stripe Connect(遺贈プラットフォーム用)
LEGACY Phase 1