paw-ps-publish-ready-check

公開準備状況の確認

概要

製品が本番環境への投入、公開、または販売の基準を満たしているかを判断する、厳密な品質評価ワークフローです。表面的な承認ではなく、明確な品質基準を適用することで、準備状況を過大に評価しないようにします。

引数： 非対話型で実行する場合は --headless / -H を受け付けます。

出力： 準備状況レポート（HTML）、ギャップ分析、該当する場合は修正リストを含む最終判定。

---

パイプライン

ステージ 1：バンドルの読み込み

./references/01-load-bundle.md を読み込みます。

パッケージ化された製品バンドルを収集し、関連する標準とコンテキストファイルをすべて特定します。評価対象の製品の種類と、適用される標準を確認します。

進行条件： 製品バンドルが見つかり、製品の種類が特定されたら次に進みます。

ステージ 2：品質の評価

./references/02-assess-quality.md を読み込みます。

機能性、完全性、明確さ、使いやすさ、ドキュメントのすべての側面に品質基準を体系的に適用します。定義された基準に照らして各側面を採点します。

進行条件： すべての品質面の評価と採点が完了したら次に進みます。

ステージ 3：ギャップの確認

./references/03-check-gaps.md を読み込みます。

リリースを妨げる具体的な要因を特定します。ギャップを重大（修正必須）、重要（修正推奨）、軽微（あると望ましい）に分類します。実行可能な修正リストを作成します。

進行条件： すべてのギャップが深刻度の分類とともに記録されたら次に進みます。

ステージ 4：判定の生成

./references/04-generate-verdict.md を読み込みます。

最終判定を下します：本番準備完了、公開準備完了、販売準備完了、または準備未完了。目標とする準備レベルに応じて適切な基準を適用します。

進行条件： 判定を出し、記録したら完了です。

---

有効化時

1. 製品ワークスペースのルートを特定します：{project-root}/.pawbytes/prodig-suites/
2. .pawbytes/prodig-suites/active-product.md が存在する場合は、アクティブな製品を特定します
3. アクティブな製品がなく、ヘッドレスモードでもない場合は、ユーザーに次の指定を求めます：
   • 製品スラッグ（評価する製品）
   • 目標とする準備レベル（production / publish / sellable）
4. ステージ 1 からパイプラインを開始します

---

準備レベル

レベル	定義	品質基準
本番準備完了	完成しており、機能し、対象ユーザーが利用できる	中核機能が動作し、ドキュメントが十分で、重大なバグがない
公開準備完了	形式が整い、仕上がっており、公開プラットフォームでの公開準備ができている	本番準備完了に加え、プロフェッショナルな見せ方ができており、プラットフォームの要件を満たしている
販売準備完了	完成して洗練されており、販売に必要なすべての素材がそろっている	公開準備完了に加え、マーケティング素材、価格設定、サポート資料がそろっている

階層： 販売準備完了には公開準備完了が必要であり、公開準備完了には本番準備完了が必要です。

---

入力ソース

ソース	ファイルパス	用途
製品バンドル	.pawbytes/prodig-suites/products/{product-slug}/bundle/	パッケージ化された製品ファイル
出力標準	.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/output-standards.md	品質基準
製品コンテキスト	.pawbytes/prodig-suites/products/{product-slug}/product-context.md	製品の種類と要件
製品概要	.pawbytes/prodig-suites/products/{product-slug}/product-brief.md	範囲と約束事項
製品に関する決定事項	.pawbytes/prodig-suites/products/{product-slug}/product-decisions.md	これまでの決定事項

最低要件： 製品バンドルが存在する必要があります。ワークスペースに標準がない場合は、リファレンスから読み込めます。

---

出力構造

.pawbytes/prodig-suites/products/{product-slug}/
├── readiness-report.html         # Structured assessment (HTML)
├── readiness-report.md           # Plain text version
├── gap-analysis.md               # Detailed gap breakdown
├── fix-list.md                   # Actionable fixes (if not ready)
└── product-decisions.md          # Appended verdict

次の場所に記録する日次ログエントリー：

.pawbytes/prodig-suites/memory/paw-ps-sidecar/daily/YYYY-MM-DD.md

---

リファレンス検索プロトコル

1. ./references/readiness-criteria.csv を読み込みます — 製品の種類別の基準をまとめた簡易インデックスです
2. 製品の種類に該当する基準の行を特定します
3. ステージ 2 の評価で、該当する基準を適用します
4. 必要な場合に限り、./references/frameworks/ の詳細な標準を参照します

---

出力仕様

各実行で、次の内容を出力します。

• アクションの種類： 準備状況の評価
• 判定： 本番環境対応／公開可能／販売可能／準備未完了
• 保存されるファイル：
  • readiness-report.html — 構造化された評価
  • readiness-report.md — プレーンテキスト版
  • gap-analysis.md — ギャップの内訳
  • fix-list.md — （準備未完了の場合）実行可能な修正項目
• 推奨事項： 判定に基づく次のステップ
• ファイルの保存先： .pawbytes/prodig-suites/products/{product-slug}/

---

ヘッドレスモード

--headless または -H を指定して実行した場合：

1. .pawbytes/prodig-suites/active-product.md からアクティブな製品の読み込みを試みます
2. 見つからない場合は、最後に変更された製品ワークスペースを検索します
3. 引数で指定されていない場合、目標とする準備レベルを publish-ready に設定します
4. プロンプトなしですべてのステージを実行します
5. 前提事項があればレポートに記載します
6. 次のステータスコードで終了します。
   • 0：準備完了（判定が目標に一致）
   • 1：準備未完了（ギャップあり）
   • 2：エラー（入力が不足）

---

品質ゲート

ステージ	ゲート条件
バンドルの読み込み	製品バンドルが見つかり、製品の種類が特定されている
品質の評価	すべての品質項目が採点されている
ギャップの確認	すべてのギャップが重大度とともに記録されている
判定の生成	根拠を示して判定が出されている

---

必須事項

このワークフローでは、表面的な承認ではなく、明確な品質基準を適用する必要があります。

1. 形式的な承認をしない — すべての判定を根拠で裏付けること
2. ギャップを明確にする — すべての阻害要因を記録し、隠さないこと
3. 正直に評価する — 不具合のある製品を出荷するより、リリースを延期すること
4. ユーザーに明確に伝える — 修正項目は具体的で、実行可能であること
5. 基準を守る — 基準を適用し、引き下げないこと

---

エスカレーション先

シグナル	連絡先	理由
品質上の問題が見つかった	paw-ps-agent-product-builder	専門担当者と修正を調整する
基準が不明確	paw-ps-strategist	品質要件を明確にする
確認対象の製品が複数ある	paw-ps-agent-product-builder	一括調整を行う