sherpy-cli-planner

Sherpy CLI プランナー

Sherpy CLI の prompt コマンドを使用して、必要に応じて各ステップ専用の指示を読み込み、Sherpy の計画パイプライン全体を実行します。14 個のスキルファイルを個別にインストールする代わりに、トークン効率の高い方法を提供します。すべての指示は sherpy バイナリに埋め込まれています。

前提条件

sherpy CLI がインストールされている必要があります。 次のコマンドで確認してください。

sherpy --help

インストールされていない場合：

go install github.com/validkeys/sherpy@latest

使用方法

/sherpy-cli-planner [output-directory]

ディレクトリが指定されていない場合は、ユーザーに「計画ドキュメントをどこに作成しますか？」と尋ねます。

続行する前に、ユーザーがパスを指定するまで待ちます。

パイプライン

sherpy-flow と同じ 12 ステップですが、個別のスキルではなく sherpy prompt を使用して指示を読み込みます。

Step 1   Gap Analysis Worksheet         → gap-analysis-worksheet.md
Step 2   Business Requirements          → business-requirements.yaml
Step 3   Technical Requirements         → technical-requirements.yaml
Step 4   Style Anchors Collection       → style-anchors/index.yaml + *.md
Step 5   Implementation Planner         → milestones.yaml + milestone-m*.tasks.yaml
Step 6   UX/Wireframe Planning          → wireframe-spec.yaml + wireframes/*.pen (conditional)
Step 7   Implementation Plan Review     → implementation-plan-review.yaml
Step 8   Definition of Done             → milestones.yaml (enhanced with acceptance_criteria)
Step 9   Architecture Decision Records  → adrs/INDEX.md + adrs/ADR-*.md
Step 10  Delivery Timeline              → timeline.yaml
Step 11  QA Test Plan                   → qa-test-plan.yaml
Step 12  Developer Summary              → developer-summary.md
Step 13  Executive Summary              → executive-summary.md

すべての成果物は次の場所に自動的に整理されます。

<output-directory>/
├── requirements/       (requirements, gap analysis)
├── implementation/
│   ├── milestones.yaml (with optional acceptance_criteria)
│   └── tasks/          (milestone task files)
├── ux/                 (wireframe spec + Pencil wireframes)
│   ├── wireframe-spec.yaml
│   ├── wireframes.pen
│   └── PAGE-001.png
├── delivery/           (timeline, QA test plan)
├── architecture/
│   └── adrs/           (ADRs)
├── artifacts/          (reviews, interview transcripts, style anchors, etc.)
└── summaries/          (developer & executive summaries)

プロセス

ステップ 0：CLI の確認とプロンプトの一覧表示

開始前に、CLI がインストールされていることを確認し、利用可能なプロンプトを表示します。

sherpy prompt --list

これに失敗した場合は、CLI をインストールするようユーザーに案内し、終了します。

ステップ 1：出力ディレクトリの決定

パラメーターとしてディレクトリが指定されていない場合は、ユーザーに尋ねます。

「計画ドキュメントをどこに作成しますか？」

ユーザーの回答を待ちます。指定されたパスを base_directory として保存します。

この段階ではフォルダーを作成しないでください。 ファイルの生成時に、必要に応じてフォルダーを作成します。

ステップ 2：既存の成果物をスキャン

整理された構成内に既存のファイルがあるか、base_directory を確認します。

成果物	想定される場所	完了を示すステップ
gap-analysis-worksheet.md	requirements/	ステップ 1
business-requirements.yaml	requirements/	ステップ 2
technical-requirements.yaml	requirements/	ステップ 3
style-anchors/index.yaml	artifacts/style-anchors/	ステップ 4
milestones.yaml	implementation/	ステップ 5
milestone-m*.tasks.yaml	implementation/tasks/	ステップ 5
wireframe-spec.yaml	ux/	ステップ 6
implementation-plan-review.yaml	artifacts/	ステップ 7
acceptance_criteria を含む milestones.yaml	implementation/	ステップ 8
adrs/INDEX.md	architecture/adrs/	ステップ 9
timeline.yaml	delivery/	ステップ 10
qa-test-plan.yaml	delivery/	ステップ 11
developer-summary.md	summaries/	ステップ 12
executive-summary.md	summaries/	ステップ 13

成果物の検出ロジック：

• base_directory 内の想定される場所を確認します
• ファイルが存在する場合、そのステップは完了したものとみなします

ステップ 3：パイプラインの状況を表示

作業を始める前に、パイプラインの状況を視覚的に表示します。

## Sherpy CLI Planner — [Project Directory]

 ✓  Step 1   Gap Analysis Worksheet
 ✓  Step 2   Business Requirements
 →  Step 3   Technical Requirements        ← resuming here
 ○  Step 4   Style Anchors Collection
 ○  Step 5   Implementation Planner
 ○  Step 6   UX/Wireframe Planning
 ○  Step 7   Implementation Plan Review
 ○  Step 8   Definition of Done
 ○  Step 9   Architecture Decision Records
 ○  Step 10  Delivery Timeline
 ○  Step 11  QA Test Plan
 ○  Step 12  Developer Summary
 ○  Step 13  Executive Summary

Resuming from Step 3. Type "start over" to restart from Step 1,
or specify a step number to jump to a specific point.

凡例： ✓ 完了 · → 現在 · ○ 未実施

次に尋ねます。

「ステップ [n]：[Step Name] から続けますか？（yes / start over / jump to step N）」

続行する前に、確認が得られるまで待ちます。

ステップ 4：各ステップを実行

未実施のステップごとに、sherpy prompt で指示を読み込み、それに従います。

ステップの実行パターン

すべてのステップで、次の手順を実行します。

1. 指示を読み込みます。

   sherpy prompt -t <prompt-type>
   

2. 表示された指示に従ってステップを完了します

3. 完了後、出力を検証します（YAML の場合）。

   sherpy validate -t <type> -f <output-file> --strict
   

4. 次のステップに進む前に、ユーザーに確認を求めます。

   「ステップ [n] が完了しました。ステップ [n+1] に進みますか？（yes / no / jump to N）」

重要な実行ルール：

1. ユーザーの明示的な確認なしに、次のステップへ絶対に進まないでください — ステップが完了するたびに必ず待ってください
2. ステップ 4（スタイルアンカーの収集）を自動的にスキップしてはいけません — スキップを希望する場合も、必ずユーザーに確認し、リスクについて警告してください
3. 必要な入力が存在しない場合（例：ステップ 5 にスタイルアンカーが必要な場合）は、続行する前に停止してユーザーに警告してください

ステップ固有のコマンド

ステップ 1：ギャップ分析ワークシート

# Load instructions
sherpy prompt -t gap-analysis-worksheet

# Follow the instructions, then continue...

ステップ 2：ビジネス要件

# Load instructions
sherpy prompt -t business-requirements-interview

# After generating business-requirements.yaml, validate:
sherpy validate -t business-requirements -f {base_directory}/requirements/business-requirements.yaml --strict

ステップ 3：技術要件

# Load instructions
sherpy prompt -t technical-requirements-interview

# After generating technical-requirements.yaml, validate:
sherpy validate -t technical-requirements -f {base_directory}/requirements/technical-requirements.yaml --strict

ステップ 4：スタイルアンカーの収集

# Load instructions
sherpy prompt -t style-anchors-collection

# Follow the instructions...
# No validation needed (produces markdown files)

ステップ 5：実装プランナー

# Load instructions
sherpy prompt -t implementation-planner

# After generating milestones.yaml, validate:
sherpy validate -t milestones -f {base_directory}/implementation/milestones.yaml --strict

# After generating milestone task files, validate each:
sherpy validate -t milestone-tasks -f {base_directory}/implementation/tasks/milestone-m0.tasks.yaml --strict
sherpy validate -t milestone-tasks -f {base_directory}/implementation/tasks/milestone-m1.tasks.yaml --strict
# ... for each milestone

ステップ 6：UX／ワイヤーフレームの計画（条件付き — UI の変更がなければ自動的にスキップします）

# Load instructions
sherpy prompt -t ux-wireframe-planning

# After generating wireframe-spec.yaml, validate:
sherpy validate -t wireframe-spec -f {base_directory}/ux/wireframe-spec.yaml --strict

ステップ 7：実装計画のレビュー

# Load instructions
sherpy prompt -t implementation-plan-review

# Follow the instructions...
# No validation needed (produces review document)

ステップ 8：完了の定義

# Load instructions
sherpy prompt -t definition-of-done

# After enhancing milestones.yaml, validate:
sherpy validate -t milestones -f {base_directory}/implementation/milestones.yaml --strict

ステップ 9：アーキテクチャ決定記録

# Load instructions
sherpy prompt -t architecture-decision-record

# Follow the instructions...
# No validation needed (produces markdown files)

ステップ 10：デリバリーのタイムライン

# Load instructions
sherpy prompt -t delivery-timeline

# After generating timeline.yaml, validate:
sherpy validate -t timeline -f {base_directory}/delivery/timeline.yaml --strict

ステップ 11：QA テスト計画

# Load instructions
sherpy prompt -t qa-test-plan

# After generating qa-test-plan.yaml, validate:
sherpy validate -t qa-test-plan -f {base_directory}/delivery/qa-test-plan.yaml --strict

ステップ 12：開発者向け要約

# Load instructions
sherpy prompt -t developer-summary

# Follow the instructions...
# No validation needed (produces markdown file)

ステップ 13：エグゼクティブサマリー

# Load instructions
sherpy prompt -t executive-summary

# Follow the instructions...
# No validation needed (produces markdown file)

ステップ 5：最終サマリー

すべてのステップが完了したら、次のサマリーを表示します。

## Planning Complete! 🎉

All artifacts have been generated and validated:

✓ Requirements documented
✓ Implementation planned with TDD tasks
✓ Delivery timeline established
✓ QA test plan created
✓ Summaries generated

Files are organized in: {base_directory}/

Next steps:
1. Review the developer summary: {base_directory}/summaries/developer-summary.md
2. Share the executive summary with stakeholders
3. Begin implementation using the task files in implementation/tasks/

Run validation at any time:
  sherpy validate -t <type> -f <file> --strict

遷移ルール

sherpy-flow と同じです。

ステップ間の移行：

• 次に進む前に、必ずユーザーの確認を待ちます
• ユーザーは「start over」と入力してステップ 1 に戻せます
• ユーザーは「jump to N」と入力して、指定したステップにスキップできます
• ユーザーからステップをスキップするよう求められた場合は、依存関係について警告します

ステップのスキップ：

• ファイルが存在する場合、ステップ 1～3（要件）はスキップできます
• ステップ 4（スタイルアンカー）は、警告なしにスキップしないでください — 実装のずれが生じるリスクを示します
• ステップ 5～12 は要件に依存します — 要件がない場合は停止します

エラー処理：

• 検証に失敗した場合は、停止してエラーを表示します
• ユーザーは YAML を修正して、検証を再実行する必要があります
• 検証に合格するまで先に進まないでください
• CLI コマンドが失敗した場合は、エラーを表示して停止します

CLI リファレンス

利用可能なプロンプトの一覧表示：

sherpy prompt --list

特定のプロンプトの読み込み：

sherpy prompt -t <prompt-type>

YAML の検証：

sherpy validate -t <type> -f <file> --strict

ドキュメントタイプの一覧表示：

sherpy types

sherpy-flow との比較

機能	sherpy-flow	sherpy-cli-planner
スキルファイルが必要	はい（14 ファイル）	いいえ（CLI を使用）
トークンのオーバーヘッド	高（約 720K）	低（約 80K）
読み込まれる指示	最初にすべて	各ステップで必要に応じて
検証	手動	CLI による自動化
オフラインで動作	はい	はい（コンテンツを埋め込み）
対象ユーザー	CLI を使わないユーザー	CLI ユーザー

注記

• sherpy CLI はビルド時にすべてのプロンプトコンテンツを埋め込むため、ネットワークは不要です
• 各 sherpy prompt の呼び出しでは、そのステップの指示全体が出力されます
• YAML を生成する各ステップの後に検証が組み込まれています
• sherpy-flow と同じ 12 ステップですが、読み込み方法が異なります
• スタイルアンカー（ステップ 4）は重要です — 警告なしにスキップしないでください