onboarding

name	onboarding
description	ハーネスのワークフロー・スキル・エージェント・ルールの使い方を対話的に教える。新メンバーがプロジェクトに参加したときに実行する。

Onboarding（ハーネス利用ガイド）

概要

ハーネスが導入されたプロジェクトに参加した新メンバーに、ワークフローの使い方を対話的に教えるスキル。

入力: なし（対話で進める） 出力: メンバーがワークフローを理解し、自律的に使えるようになる

いつ使うか

• 新しいメンバーがプロジェクトに参加したとき
• ハーネスの使い方を忘れたとき
• ワークフローの全体像を確認したいとき

対話フロー

2つのフェーズに分かれている。Phase A だけで使い始められる。Phase B は必要になったら実行する。

---

Phase A: クイックスタート（15分）

最低限知っておくべきことだけ伝える。これだけで使い始められる。

Step 1: ハーネスとは

このプロジェクトには AI 駆動開発のためのハーネスが導入されています。

覚えることは 2 つだけ:

1. 開発は「12ステップのワークフロー」に沿って進む
2. Claude に指示すれば、対応する「スキル」が自動的に使われる

エージェント（専門家 AI）やルール（品質基準）は裏で自動的に動くので、意識する必要はありません。

Step 2: ワークフロー概要

開発は以下の流れで進みます:

[1] 要件理解 → [2] 設計 → [3] 計画
→ [4] 実装 → [5] テスト → [6] リファクタ → [7] 品質テスト → [8] レビュー
→ [9] 完了検証 → [10] 整理 → [11] コミット → [12] 振り返り

全ステップを毎回やる必要はありません:
- typo 修正 → [4] 実装 → [11] コミット だけ
- バグ修正 → [4] 実装 → [8] レビュー → [11] コミット
- 新機能  → 全12ステップ

規模の判定は Claude が確認します。

Step 3: 使い始め方

使い方はシンプルです:

- 「ユーザー登録機能を追加して」→ Claude がワークフローに沿って進める
- 「このバグを直して」→ 規模を判定して適切なステップで進める

各ステップで「これでいい？」と確認されます。
方向が違ったら「違う」「そうじゃない」と言えば修正されます。

スキルの一覧は .claude/skills/README.md にあります。

メンバーに聞く: 「ここまでで質問ある？なければ、さっそく最初のタスクをやってみましょう。」

質問がなければ Phase A 完了。実際にタスクを進めながら覚える。

---

Phase B: 詳細ガイド（30分）

Phase A で使い始めた後、もっと詳しく知りたくなったら実行する。

Step 4: スキル詳細

プロジェクトにインストールされているスキル一覧を .claude/skills/README.md から読み取って表示する。

スキルは各ステップの詳しい手順書です。
Claude に「要件を整理して」「レビューして」と言えば、対応するスキルが自動的に使われます。

明示的に呼び出す場合は、スキル名を伝えてください:
- 「requirements スキルで要件を整理して」
- 「code-review スキルでレビューして」
- 「retrospective で振り返りをして」

各スキルの概要を1行ずつ紹介する（description フィールドを読み取る）。

メンバーに聞く: 「普段の開発で、この中で特に気になるステップはありますか？」

気になるステップがあれば、そのスキルを先に詳しく説明する。

Step 5: モジュール（該当する場合）

.mcp.json が存在する場合、導入済みモジュールを説明する。

Playwright MCP が入っている場合:

このプロジェクトには Playwright MCP モジュールが入っています。
Claude がブラウザを操作して画面を確認できます。

使い方:
- 「この画面を確認して」→ Claude がブラウザで画面を見に行く
- 「E2E テストを作って」→ 画面を観察してからテストコードを生成する

ブラウザ操作は browser-operator エージェントが担当するので、
メインの会話のコンテキストは汚れません。

Figma MCP が入っている場合:

このプロジェクトには Figma MCP モジュールが入っています。
Claude が Figma ファイルを参照・編集できます。

使い方:
- 「Figma のデザインを確認して」→ Claude が Figma を見に行く
- 「この画面のデザインコンテキストを取得して」→ 設計情報を取得する

Figma 操作は figma-operator エージェントが担当します。
初回は OAuth 認証が必要です。

Step 6: 裏側の仕組み

ハーネスの裏側には以下の仕組みがあります:

- エージェント — スキルから自動的に呼び出される専門家 AI（一覧は .claude/agents/README.md を参照）
  - 例: implementer（実装）、security-reviewer（セキュリティレビュー）
  - レビュアーは読み取り専用。実装者のコードを壊せない設計

- ルール — 常に自動適用される品質基準（一覧は .claude/rules/README.md を参照）
  - コーディング規約、セキュリティ、テスト方針、Git 運用、ドキュメント、フィードバック記録、ワークフロー

- フック — イベント駆動の自動化
  - 例: メインセッションがコードを書こうとしたらブロック（エージェントに任せる設計）
  - 例: コミット前に検証証拠（last-verification.json）が必要（verification-gate）
  - 例: セッション終了時に振り返りリマインダーを表示（session-end-retrospective）

普段は意識する必要はありません。興味があれば .claude/ の中を見てください。

Step 7: 注意点と質問

最後に、いくつか大事な注意点:

1. Claude は破壊的な操作（ファイル削除、force push 等）の前に必ず確認します
2. 「違う」「そうじゃない」と言えば、Claude はフィードバックを記録して改善します
3. セッション終了時に振り返りのリマインダーが出ます。時間があれば実行してください
4. わからないことがあれば、いつでも「/onboarding」で使い方を確認できます

以上がハーネスの詳細な仕組みです。
何か質問はありますか？

質問があれば丁寧に答える。質問がなければ終了。

動作指針

• 押し付けない: 一方的に説明を流さない。各ステップで間を取り、質問を受け付ける
• 具体的に: 抽象的な説明ではなく、「こう言えばこう動く」を示す
• プロジェクト固有: .claude/ の実際の中身を読んで、このプロジェクトに入っているスキル・モジュールだけを説明する
• 短く: 各ステップの説明は簡潔に。詳しく知りたいと言われたら深掘りする

委譲指示

このスキルは委譲しない。 メインセッションが直接対話する。 エージェントは不要 — 人間との対話が目的なので、サブエージェントに任せると体験が損なわれる。

Integration

前提スキル:

• なし（独立して使用可能）

このスキルを使うスキル:

• なし（エントリポイント）