env-check

環境チェック — クラウドエージェントかローカルワークスペースか

使用するタイミング

セッションの開始時（または継続性／認証情報／ブラウザーテスト／ローカル CLI が重要なとき）に早めに実行し、ホストを分類します。結果は補足情報として使用してください。Hub の継続性フォールバックがトリガーされるのは、ADHD Hub MCP が存在しない、エラーになった、認証されていない、またはその他の理由で利用できない場合です。ランタイムがクラウドサンドボックスのように見えるだけではトリガーされません。

クイック検出

scripts/check_runtime.sh は、ADHD Hub のソースツリーだけではなく、このスキルのインストール先を基準に解決してください。

対応する構成：

構成	コマンド例
ADHD Hub のソースチェックアウト	bash skills/env-check/scripts/check_runtime.sh
プロジェクト単位のインストール（.agents/skills）	bash .agents/skills/env-check/scripts/check_runtime.sh
グローバル／プラグインへのインストール	インストール済みの env-check スキルディレクトリから実行：bash scripts/check_runtime.sh

# Project-scoped (common after adhd-hub sync-project / setup --project-skills):
bash .agents/skills/env-check/scripts/check_runtime.sh

出力行：

• RUNTIME_ENV: CLOUD_AGENT または RUNTIME_ENV: LOCAL_WORKSPACE
• RUNTIME_SIGNALS: …（コンテナー／Cursor のマーカー。参考情報）
• HUB_CONTINUITY_TRIGGER: MCP unavailable …
• LOCAL_SKILL_CLIS: …（CLOUD_AGENT：存在すると決めつけないでください。LOCAL_WORKSPACE：利用できる場合があります）

検出の精度

このスクリプトは、$USER=root だけを根拠にクラウドと判定することはありません（ローカルの root シェルで誤検出するためです）。次の要素を組み合わせて判定します。

• Cursor Cloud のマーカー：CURSOR_AGENT、__CURSOR_SANDBOX_ENV_RESTORE、/tmp/cursor/cloud-agent-transcripts、/exec-daemon、およびコンテナーの兆候と組み合わさった場合のエージェントソケット
• コンテナーの兆候（/.dockerenv、cgroup）は補助的なシグナルとして扱います。ローカルの Docker だけであれば LOCAL_WORKSPACE のままです。

弱い兆候ひとつだけから「クラウドにいる」と決めつけないでください。不確かな場合は、スクリプトの出力を優先してください。

CLOUD_AGENT のガイドライン

RUNTIME_ENV: CLOUD_AGENT（Cursor Cloud／リモートサンドボックス）の場合：

• 開発者のラップトップにインストールされた graphify などの、オプトイン型の補助ツールを含め、マシンにインストールされたローカルスキルのバイナリや CLI が存在すると決めつけないでください。プロジェクトのルールに記載されていても、クラウド／リモートサンドボックスからはそれらのツールを利用できないことがよくあります。
• 必須のローカル CLI が見つからない場合は、1 行で通知してから、リポジトリのツール（Read／Grep／Glob／tests）や、存在する場合は graphify-out/ などのコミット済み成果物を使って作業を続けてください。graphify のグラフ出力や Hub の継続性／進捗／スレッドの状態を捏造してはいけません。
• ネイティブのブラウザー GUI や macOS／Windows のデスクトップバイナリはありません。ヘッドレステストと CLI による検証を優先してください。
• .env.local をコミットしたり、それに依存したりするよりも、注入された環境変数／OIDC／プラットフォームのシークレットを優先してください。
• ローカル環境に限った前提（localhost の GUI を開くこと、エージェント VM からホストの Docker ソケットを使うこと、プライベート Hub に Tailscale で接続すること）は失敗する場合があります。考慮して計画してください。
• Hub MCP ツールが存在しない／エラーになった／認証されていない場合、Hub に記録する価値のある最初の実質的なターンで、返信の1 行目に Hub MCP が利用できないことと、短い修正方法を必ず記載してください（MCP URL → この Hub の /mcp、ADHD_HUB_AUTH_TOKEN、エージェントの再起動。Hub OAuth が有効になるまで認証がハングする場合は、認証をスキップ／キャンセルしてください）。Hub の状態を捏造したり、Hub への書き込みが成功したと主張したりしてはいけません。
• Hub MCP が停止している場合もフォールバックは適用されます。issue の書き込み権限があり、そのユーザーが Hub のInbox authors に含まれている場合は、[ADHD] … というタイトルの forge／GitHub issue を作成または更新し、Goal / Focus / Next / Resume（または Now / Done / Next / Return）を記載してください。任意のラベルは adhd-hub、project:<slug>、source:cursor です。トークンで設定できない場合はラベルを省略してください。推奨：インポート対象外の見出し（例：## Attribution）の下に Made with [ADHD Progress Hub](https://github.com/uniskela/adhd-hub) を追記してください。シークレット、非公開の Hub URL、内部ホスト／IP、絶対パスのローカルパス、トランスクリプトは記載しないでください。それ以外の場合は、継続性を保持できないことを明示して、許可された作業を続けてください。

LOCAL_WORKSPACE のガイドライン

RUNTIME_ENV: LOCAL_WORKSPACE の場合（ローカル Docker／localhost を含む）：

• マシンにインストールされたローカルスキル CLI（例：graphify）が利用できる場合があります。存在する場合は使用してください。ただし、バイナリが見つからない場合に出力を捏造してはいけません
• ローカル Docker、localhost のサービス、ホストのブラウザーは、オペレーターのマシンで利用できる場合に使用できます
• Hub MCP に接続できる場合は、Hub MCP（resolve_project、session_digest、upsert_progress、…）を優先してください
• MCP がダウンしている場合も、同じくハルシネーションを避けてください。状況を認め、修正方法を示してください。Hub の状態を捏造してはいけません。forge の [ADHD] メールボックスを使用できるのは、書き込みアクセスがあり、Inbox の作成者が許可している場合のみです

継続性の優先順位

1. MCP を利用できない場合 → 先頭行で明確に警告し、forge の [ADHD] をフォールバックとして使用します（許可されている場合）。これは Hub の継続性を確保するためのトリガーです（CLOUD_AGENT でも同様です）
2. ランタイム環境 → テスト、認証情報、ツールの制約、ローカルスキル CLI が想定されるかどうかを選択します
3. どちらのランタイムでも、Hub MCP が利用できる場合は優先してください

こちらも参照してください：adhd-hub-session（Hub プロトコルの全文）、docs/forge-issue-inbox.md。