groove-admin-install

groove-admin-install

成果

すべての groove バックエンドが依存関係の順にインストールされ、コンパニオンスキルと groove スキルのシンボリックリンクが用意され（初回インストールでは、これらがないとインストールは完了しません）、AGENTS.md にセッションのブートストラップが記載され、リポジトリを使用できる状態になっています。

受け入れ条件

• タスクとメモリのバックエンドがインストールされている（または、ステップが失敗した場合はその旨が明確に報告されている）
• コンパニオンスキルがインストールされている（find-skills、agent-browser、pdf-to-markdown） — 必須。ステップ 4 の後に各 SKILL.md が存在することを確認する
• プラットフォームのシンボリックリンク — .claude/skills/groove* と .cursor/skills/groove* が .agents/skills/groove* を参照している — 毎回のインストールで必須
• インストールされた内容の概要がユーザーに表示され、コンパニオンとシンボリックリンクの状況が ✓/✗ で示されている

手順

順番に実行します。

1. .groove/index.md が存在しない場合は、/groove-admin-config --defaults を実行して、すべてのデフォルト設定をプロンプトなしで作成します
2. /groove-utilities-task-install を実行します — 設定済みのタスクバックエンド（例：beans）をインストールします
3. /groove-utilities-memory-install を実行します — メモリディレクトリを作成します
4. コンパニオンスキルをインストールします（必須 — 省略しないでください）： 初回インストール時とその後のすべての実行時に、.agents/skills/ 配下に以下のスキルがあることを確認します。SKILL.md がない場合は、対応する npx skills add コマンドを実行します。一時的な失敗の場合は1回再試行し、その後失敗を報告します（3つすべてのインストールが成功するまで、インストールは完了していません）。
   • find-skills（ダウンロード）：test -f .agents/skills/find-skills/SKILL.md または npx skills add https://github.com/vercel-labs/skills --skill find-skills
   • agent-browser（ダウンロード）：test -f .agents/skills/agent-browser/SKILL.md または npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser
   • pdf-to-markdown（埋め込み）：test -f .agents/skills/pdf-to-markdown/SKILL.md または npx skills add andreadellacorte/groove --skill pdf-to-markdown
   • その後、3つの SKILL.md パスそれぞれに対して test -f を実行して確認します。1つでも欠けている場合は停止し、インストールが未完了であることを報告します（成功したと伝えないでください）。
   • それぞれの状態をインストール済み／既に存在／失敗として報告します
5. プラットフォームのスキルディレクトリをシンボリックリンクで同期します（必須 — 省略しないでください）： groove-* コマンドが解決されるように、Groove スキルを各エディターのスキルツリーにリンクする必要があります。
   • 必要に応じて親ディレクトリを作成します：mkdir -p .claude/skills .cursor/skills（Claude Code では .claude/skills/、Cursor では .cursor/skills/ が必要です）
   • .agents/skills/ 配下で groove から始まる各ディレクトリについて：
     • .claude/skills/<name> を作成し、../../.agents/skills/<name> を指すシンボリックリンクにします
     • .cursor/skills/<name> を作成し、../../.agents/skills/<name> を指すシンボリックリンクにします
   • 次を実行します：mkdir -p .claude/skills .cursor/skills && for skill in .agents/skills/groove*; do name=$(basename "$skill"); ln -sfn "../../.agents/skills/$name" ".claude/skills/$name"; ln -sfn "../../.agents/skills/$name" ".cursor/skills/$name"; done
   • 注：ln -sfn（リンクをたどらない）を使用してください。既存のディレクトリシンボリックリンクに対して ln -sf を使うと、そのリンクをたどってリンク先ディレクトリ内にネストしたシンボリックリンクを作成します
   • 確認：.agents/skills/ 配下に少なくとも1つの groove-* 名が存在し、対応するシンボリックリンクが .claude/skills/ と .cursor/skills/ に存在することを確認します
   • 次のように報告します："✓ プラットフォームのシンボリックリンクを更新しました（.claude/skills/、.cursor/skills/）" または失敗を報告します
6. フックとキャッシュディレクトリをスキャフォールドします：
   • .groove/hooks/ が存在しない場合は作成します
   • .groove/.cache/ が存在しない場合は、.gitkeep とともに作成します
   • .groove/hooks/start.md が存在しない場合は、次の内容で作成します：

     # フック：セッション開始
     
     `/groove-daily-start` の最後に自動的に実行されます。
     セッション開始時のタスクを自動化するには、`## Actions` に項目を追加します。
     
     ## Actions
     
     
     

   • .groove/hooks/end.md が存在しない場合は、次の内容で作成します：

     # フック：セッション終了
     
     `/groove-daily-end` の最後に自動的に実行されます。
     セッション終了時のタスクを自動化するには、`## Actions` に項目を追加します。
     
     ## Actions
     
     
     

   • フックの状態を作成済み／既に存在として報告します
7. Git 戦略を適用します — .groove/index.md の git.* サブキーから .groove/.gitignore を作成します（ルールは /groove-admin-config を参照してください）

制約

• 実行前に .groove/index.md を読み、tasks.backend と git.* の設定を確認してください
• .groove/index.md が存在しない場合は、最初に /groove-admin-config を実行して（ステップ 1）、作成してください
• バックエンドの依存関係の順序を守ってください：タスク → メモリ → コンパニオン
• 各ステップで、インストール済み／すでに存在／失敗のいずれかを報告してください
• AGENTS.md の更新はセクションごとに追記し、その他すべての内容を保持してください
• タスクまたはメモリのインストールに失敗した場合は、その旨を明確に報告して続行してください — ユーザーがコンパニオンとシンボリックリンクを必要とする場合があります
• ステップ 4～5（コンパニオンスキル＋シンボリックリンク）はインストールを成功させるために必須です：両方のステップが成功するまで「インストール完了」と報告しないでください。 これは意図的な仕様です。初回のブートストラップで、Cursor と Claude Code からスキルを検出できる状態にする必要があります。
• コンパニオンスキル（find-skills、agent-browser、pdf-to-markdown）はここにハードコードされており、設定ファイルから読み込まれません
• 最終的な概要を報告してください（プラットフォームのシンボリックリンクの行を含めてください）：

  ✓ task backend (beans)
  ✓ memory backend — memory dirs ready
  ✓ companion: find-skills
  ✓ companion: agent-browser
  ✓ companion: pdf-to-markdown
  ✓ platform symlinks (.claude/skills/, .cursor/skills/)
  ✓ hooks: .groove/hooks/ ready