quickstart

/quickstart

目的はひとつです。 AgentOps の機能と、新しいユーザーが最初に行うべきことを手短に伝えます。

このワークフローは必ず実行してください。説明するだけではいけません。

実行手順

ステップ 1：セットアップを検出する

git rev-parse --is-inside-work-tree >/dev/null 2>&1 && echo "GIT=true" || echo "GIT=false"
command -v ao >/dev/null && echo "AO=true" || echo "AO=false"
command -v bd >/dev/null && echo "BD=true" || echo "BD=false"
[ -d .agents ] && echo "AGENTS=true" || echo "AGENTS=false"
[ -d "$HOME/.agents" ] && echo "GLOBAL_AGENTS=true" || echo "GLOBAL_AGENTS=false"
[ -n "${CODEX_THREAD_ID:-}" ] || [ "${CODEX_INTERNAL_ORIGINATOR_OVERRIDE:-}" = "Codex Desktop" ] && echo "CODEX=true" || echo "CODEX=false"

ステップ 2：AgentOps の機能を示す

次の内容をそのまま出力してください（追加や図は不可）。

AgentOps is the operational layer for coding agents.

It gives your coding agent four things it doesn't have by default:

  Bookkeeping — sessions capture learnings, findings, and reusable context in .agents/
  Validation  — /council, /pre-mortem, and /vibe challenge plans and code before shipping
  Primitives  — skills, execution packets, and the ao CLI give you building blocks for almost any interaction
  Flows       — /research, /implement, /validate, and /rpi can run alone or compose end to end

Key skills: /rpi  /research  /validate  /implement  /council  /pre-mortem  /swarm  /status
Fresh-session orientation: `ao session bootstrap`, then `ao inject` / `ao corpus inject --query "<topic>"`
Full reference: /quickstart --catalog

ステップ 3：次のアクションをひとつ示す

最初に該当する行に合わせ、そのメッセージを出力してください。

条件	メッセージ
GIT=false + AO=true + GLOBAL_AGENTS=true	"🗂 Git リポジトリの外ですが、~/.agents にグローバルコーパスがあります。グローバルナレッジのワークフロー：\n 1. /curate --mode=harvest — すべてのリポジトリの .agents/ をスキャンし、成果物を ~/.agents/learnings/ に昇格させます\n 2. /compile — 情報を抽出、統合し、相互リンクされた Wiki を .agents/compiled/ に書き込みます（cwd から実行します。claude CLI がある場合は AGENTOPS_COMPILE_RUNTIME=claude-cli を設定してください。API キーは不要です）\n 3. /inject — コンパイル済みのコーパスを、今後のセッション向けのプレイブック、信念の書、実行時ブリーフィングに変換します\n 4. /status — フライホイールの健全性スナップショット\nここで新しいリポジトリローカルのプロジェクトを始める場合は、まず git init を実行してください。"
GIT=false	"⚠ Git リポジトリ内ではありません。まず git init を実行してください。\n （グローバルな ~/.agents コーパスを使う場合は、.agents/ があるディレクトリから /quickstart を実行するか、/curate --mode=harvest、/compile、/inject を参照してください。）"
AO=false + CODEX=true	"📦 まず ao CLI をインストールしてください：\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\n次に、/rpi \"a small goal\" を実行して最初のサイクルを開始します。\nPRODUCT.md、README.md、PROGRAM.md が必要な場合は、コアシードの後に /bootstrap を使用してください。"
AO=false	"📦 まず ao CLI をインストールしてください：\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\n次に、/rpi \"a small goal\" を実行して最初のサイクルを開始します。\nPRODUCT.md、README.md、PROGRAM.md が必要な場合は、コアシードの後に /bootstrap を使用してください。"
AGENTS=false + CODEX=true	"🌱 ao はインストール済みですが、ここでは初期化されていません。\n ao quick-start を実行して、再現可能なコアシードを適用してください。ao quickstart は安定版のエイリアスです。\n 次に、プロダクト／運用レイヤー（PRODUCT.md、README.md、PROGRAM.md/AUTODEV.md、オプションのフック）が必要な場合に限り、/bootstrap を実行してください。\n次に、/rpi \"a small goal\" を実行して最初のサイクルを開始します。"
AGENTS=false	"🌱 ao はインストール済みですが、ここでは初期化されていません。\n ao quick-start を実行して、再現可能なコアシードを適用してください。ao quickstart は安定版のエイリアスです。\n 次に、プロダクト／運用レイヤー（PRODUCT.md、README.md、PROGRAM.md/AUTODEV.md、オプションのフック）が必要な場合に限り、/bootstrap を実行してください。\n次に、/rpi \"a small goal\" を実行して最初のサイクルを開始します。"
BD=false + CODEX=true	"✅ Codex プラグインの準備ができています。\n /rpi \"your goal\" — /discovery → /crank → /validate の全パイプライン\n /research <topic> — コードベースを調査します\n デフォルトのインストールではフックは使われません。ネイティブフックは install-codex.sh --with-hooks でオプションとして有効にできます。\n 必要に応じて、従来の明示的なフォールバックコマンド ao codex ensure-start / ao codex ensure-stop も引き続き使用できます。\n 手動での回避策：ao codex status\nイシュートラッキングが必要ですか？ brew install boshu2/agentops/beads && bd init --prefix <prefix>"
BD=false	"✅ フライホイールが稼働中です。今すぐ開始できます：\n /rpi \"your goal\" — /discovery → /crank → /validate の全パイプライン\n /validate — 最近の作業を完了し、学びを記録します\n /research <topic> — コードベースを調査します\nイシュートラッキングが必要ですか？ brew install boshu2/agentops/beads && bd init --prefix <prefix>"
BD=true + CODEX=true	"✅ Codex のフルスタックの準備ができています。\n ao reconcile --json — git、CI、リリース、beads、.agents の整合性を確認します\n bd ready — 重大度の高い調整結果を解消した後、未完了の作業を確認します\n /rpi \"your goal\" — 新しい目標を最初から開始します\n デフォルトのインストールではフックは使われません。ネイティブフックは install-codex.sh --with-hooks でオプションとして有効にできます。\n 必要に応じて、従来の明示的なフォールバックコマンド ao codex ensure-start / ao codex ensure-stop も引き続き使用できます。\n 手動での回避策：ao codex status"
BD=true	"✅ フルスタックの準備ができています。\n ao reconcile --json — git、CI、リリース、beads、.agents の整合性を確認します\n bd ready — 重大度の高い調整結果を解消した後、未完了の作業を確認します\n /rpi \"your goal\" — 新しい目標を最初から開始します\n /status — 現在のセッション状態を確認します"
新しいプロジェクトを始めますか？/scaffold <language> <name> を実行すると、ベストプラクティスに沿ったプロジェクト構成を生成できます。

---

例

初回セットアップ

ユーザーの入力: /quickstart

動作: エージェントがツールを検出し、1 行のステータスを表示して、次に実行する唯一のアクションを案内します。

セットアップ済みの場合

ユーザーの入力: /quickstart

動作: エージェントがスタック全体の準備ができていることを検出し、ao reconcile --json、bd ready、または /rpi "your goal" を提案します。

トラブルシューティング

問題	解決策
スキルがインストールされていない	bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)
フックの有効化	AgentOps 3.0 にはフックがありません。フックをインストールする ao コマンドやフラグはなく、CI が正式なゲートです。フックはオプトイン方式で、hooks-authoring スキルを使って自分で作成します。
フライホイールのカウントが 0	初回セッションです。/rpi "a small goal" を実行して開始します
スキルのカタログ全体を確認したい	「すべてのスキルを表示して」と尋ねるか、references/full-catalog.md を参照してください

参考ドキュメント

• references/quickstart.feature — 実行可能な仕様：セットアップを検出し（git/ao/bd/.agents）、状態に応じた次のアクションを推奨します（soc-qk4b）

• references/getting-started.md

• references/troubleshooting.md

• references/full-catalog.md

関連項目

• scaffold — プロジェクトのひな形作成とコンポーネントの生成