chief-init について
chief-initは、短いヒアリングを通じてプロジェクトの`.chief/project.md`を作成するスキルです。chief-agentのプロジェクト情報を整えるチーム向けに、前提条件の確認と既存設定の確認・バックアップを行います。
主な機能
- 01chief-agentの導入確認
- 02プロジェクト情報のヒアリング
- 03Markdown草案の確認
- 04上書き前のバックアップ
- 05`.chief/project.md`のみ作成
活用シーン
- 01リポジトリの技術スタックと開発コマンドの記録
- 02chief-agent向けプロジェクト情報の設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thaitype/ chief --skill chief-initインストール後、Claude Code で/chief-initを入力して読み込まれたか確認します。
詳細
プロジェクトの .chief/project.md を初期設定します。このスキルが作成するのはこのファイルのみです。マイルストーン、ルール、その他の .chief/ コンテンツは、chief-agent が必要になった時点で後から作成します。
手順
1. 事前確認
- フレームワークがインストールされていることを確認します。.agents/agents/chief-agent.md
が存在しない場合は、まず/chief-install` を実行するようユーザーに伝え、停止します。 .chief/project.mdがすでに存在するか確認します。- 存在する場合 → ユーザーに「
.chief/project.mdはすでに存在します。更新/上書き/キャンセルしますか?」と尋ねます。 - 上書きする場合は、処理を進める前に現在のファイルを
.chief/project.md.bakにバックアップします。 - 更新する場合は、まず現在の内容を読み取り、インタビューを改訂として扱います。
- キャンセルする場合は、停止します。
- 存在する場合 → ユーザーに「
.chief/が存在しない場合は作成します。
2. ユーザーに質問する
以下のトピックについて、一度に短い質問を1つずつ行います。質問は要点を絞り、次に進む前に回答を待ちます。ユーザーが「skip」または「n/a」と答えたトピックは省略します。
- プロジェクト名と1行の概要。
- 技術スタック — 主要な言語、フレームワーク、ランタイム、データベース、主要ライブラリ。
- 開発コマンド — 依存関係のインストール、開発環境の実行、テスト、lint、型チェック、ビルドの方法。
- アーキテクチャの概要 — 主なパターン(例:Repository Pattern、Service Layer、ヘキサゴナル、モノレポなど)。
- ディレクトリ構成 — トップレベルのフォルダーとその内容。
- 重要な開発ルール — 開発者が従うべき規約(コミット形式、ブランチポリシー、フォーマット、テスト要件など)。
トピックについてユーザーがわからない場合は、リポジトリ内で確認できるファイル(package.json、pyproject.toml、Cargo.toml、Makefile、README.md など)を参考に妥当なデフォルトを提案し、確認します。
3. 下書きを提示して確認する
提案する .chief/project.md の内容を、フォーマット済みの Markdown として表示します。その後、一度だけ「これを .chief/project.md に書き込みますか?」と尋ねます。
ユーザーが変更を求めた場合は反映し、再度確認します。確認は最大3ラウンドまでとし、合意が難しい場合は現在の下書きを書き込み、手動で編集できることを伝えます。
4. ファイルを書き込む
.chief/project.md に書き込みます。以下の構成を使用します(空のセクションはプレースホルダーの文章を残さず省略します)。
# Project Configuration
## Project
{name and one-line summary}
## Development Commands
{commands as a list or table}
## Architecture Overview
### Tech Stack
{...}
### Key Architectural Patterns
{...}
### Directory Structure
{...}
### Important Development Rules
{...}
5. 次のステップ
ユーザーに以下を伝えます。
.chief/project.mdの設定が完了しました。chief-agent はプロジェクトのコンテキストを把握するためにこのファイルを読み取ります。- マイルストーンを開始するには
/chief-planを実行します(.chief/milestone-N/は必要になった時点で作成されます)。 - マイルストーンの計画後に自律的に実行するには
/chief-autopilotを実行します。 - ルールは後から
.chief/_rules/_standard/、_contract/、_goal/、_verification/に追加できます。chief-agent は最初のルールが作成された時点で、適切なサブフォルダーを作成します。
重要なルール
- このスキルが作成するのは
.chief/(存在しない場合のみ)と.chief/project.mdのみです。マイルストーン、ルール用サブフォルダー、_template/を作成してはいけません。 - ユーザーの明示的な確認なしに、既存の
project.mdを上書きしてはいけません。必ず先に.bakにバックアップします。 .agents/agents/chief-agent.mdが存在しない場合は、処理を進めず、ユーザーに/chief-installを実行するよう案内します。- インタビューは簡潔にします。一度に焦点を絞った質問を1つだけ行い、複数の質問をまとめて尋ねてはいけません。
- 参考資料:canonical layout の例は chief リポジトリの
docs/example-chief/にあります。