init-effort

Init Effort

エフォートとは、独自のブランチとプルリクエストを必要とする規模の作業です。機能、新しいアプリ、リファクタリング、アーキテクチャの再設計などが該当します。データの編集や小規模な修正などの日常的な保守作業は、このスキルを使わず、現在のチェックアウトで行います。プロジェクトで、日常的な作業に該当するものが定められている場合があります。

このスキルによって作成されたワークツリーで、エフォートの検討と、その後の構築の両方を行います。このセッションを開始したリポジトリを変更せずに保つため、書き込みはワークツリー内だけで行います。新しいプロジェクトの場合は、新しいリポジトリ内だけで行います。

パラメーター

• <worktree-tool>：treehouseや通常のGitワークツリーなど、ワークツリーを作成および解放するツールです。
• <session-host>：エージェントセッションを実行する場所です。例：herdr、Claude Code Desktop、Codex Desktop。
• <agent>：新しいエージェントセッションを開始するコマンドです。例：フラグ付きのclaudeやcodex。

手順

1. 作業場所を決めます： 既存のリポジトリ（現在のリポジトリ、またはアイデアで指定されたリポジトリ）で行うエフォートか、まだリポジトリのない新しいプロジェクトかを決めます。
2. 名前を付けます。 短いケバブケースのエフォート名と、プロジェクトのブランチ命名規則に従ったブランチ名を提案します。プロジェクトに命名規則がない場合は、<area>/<effort>とします。両方についてメンテナーの承認を得ます。
   • 新しいプロジェクトの場合： まずプロジェクト名をいくつか提案し、そのうち一つを決めてもらいます。
3. 新しいプロジェクトの場合のみ、作成します。 使用するライセンスを尋ね、メンテナー名義のMITを推奨します。GitHubリポジトリを公開にするか非公開にするかも尋ねます。その後、project-creation.mdを読み、リポジトリを作成してプッシュします。
4. <worktree-tool>を使い、リモートのデフォルトブランチから新しいブランチにワークツリーを作成します。
   • 作業がローカルのデフォルトブランチにある未プッシュのコミットを基にする場合は、代わりにローカルのブランチから分岐します。
5. アイデアを引き継ぎ用ファイルとして<handoff-folder>/<date>-<effort>.mdに記録します。<handoff-folder>はhandoffスキルの定義に従います。このファイルには、メンテナーから伝えられたアイデア、エフォート、ブランチ、ワークツリーを記載します。
   • 新しいプロジェクトの場合： リポジトリも記載します。
6. 検討セッションを開始します： <session-host>を通じてワークツリー内で<agent>を開始します。ワークツリー、トピックとしてのエフォート、役割としてのthinking、および以下の開始プロンプトを渡します。
   • 別のセッションで実行する場合： メンテナーに実行場所を伝え、<session-host>からプロンプトに取り組んでいるという報告があるか、メンテナーから開始したと伝えられた時点で終了します。

開始プロンプトは1行です。複数行のプロンプトは貼り付けられたテキストとして届き、エージェントのスキルが一度も起動しないためです。

Think through the effort in <handoff path>: grill me on it with the grilling skill, using the prototype skill when a question needs a runnable answer, then write the spec with to-spec and the tickets with to-tickets, and hand over to an orchestrator with the handover skill.

このプロンプトには、エージェントが読み込めるスキルだけが含まれます。

参考資料

• project-creation.md：新しいプロジェクトのリポジトリを作成する手順。名前の確認、セットアップ、最初のコミットについて説明します。