paw-ps-product-package-assembler

製品パッケージの組み立て

概要

このワークフローでは、実行フェーズの成果物をまとめ、一貫性のある、本番環境で利用できるパッケージを作成します。実行担当の出力を収集し、製品タイプごとの要件に照らして完全性を確認し、構造化されたバンドルに整理して包括的なマニフェストを生成することで、出力が散在する草稿ではなく、統一された一つの製品として感じられるようにします。

引数： 対話なしで実行する場合は、--headless / -H を指定できます。

出力： 整理されたディレクトリ構造、完全性レポート、パッケージングマニフェストを含む、パッケージ化された製品バンドル。

譲れない条件： 出力が散在する草稿ではなく、一つの製品として感じられるようにする必要があります。

起動時

{project-root}/.pawbytes/config/config.yaml と {project-root}/.pawbytes/config/config.user.yaml（ルートレベルと ps セクション）から利用可能な設定を読み込みます。設定ファイルが見つからない場合は、いつでも paw-ps-setup でモジュールを設定できることをユーザーに伝えてください。以下を解決します。

• {user_name}（null）— ユーザーを名前で呼びます
• {communication_language}（English）— すべてのコミュニケーションで使用します
• {document_output_language}（English）— 生成するドキュメントの内容に使用します
• {output_directory}（.pawbytes/prodig-suites）— ベースとなる出力パス

共有メモリとして {project-root}/.pawbytes/prodig-suites/index.md を読み込みます。出力基準として {project-root}/.pawbytes/prodig-suites/output-standards.md を読み込みます。

製品コンテキストの解決： メモリからアクティブな製品を特定するか、引数として製品スラッグを受け取ります。製品のワークスペースは .pawbytes/prodig-suites/products/{product-slug}/ にあることを想定しています。製品を特定できない場合は、ユーザーに尋ねてください。

--headless または -H が渡された場合は、対話なしで全パイプラインを実行します。成果物を収集し、完全性を確認し、バンドルを整理して、マニフェストを生成します。

それ以外の場合は、ユーザーに挨拶して対象の製品を確認し、以下のステージを順に進めます。

パイプライン

このワークフローは4つのステージで進行します。各ステージでは、コンパクション後も状態を保持するため、ドキュメントをキャッシュとして使うパターンに従ってパッケージングステータスファイルを更新します。

ステージ	目的	参照先
1. 成果物の収集	実行担当からすべての実行成果物を収集する	./references/01-gather-artifacts.md を読み込む
2. 完全性の確認	製品タイプごとの要件に照らして確認する	./references/02-check-completeness.md を読み込む
3. バンドルの整理	一貫性のあるパッケージに構成する	./references/03-organize-bundle.md を読み込む
4. マニフェストの生成	パッケージマニフェストと注記を作成する	./references/04-generate-manifest.md を読み込む

進行方法： 各ステージでは、次のステージを読み込む前に、結果を packaging-status.md に記録します。中断された場合は、packaging-status.md を読んで最後に完了したステージから再開します。

パッケージングステータスファイル

すべての進捗は {project-root}/.pawbytes/prodig-suites/products/{product-slug}/packaging-status.md に記録されます。このファイルは出力成果物であると同時に、復旧用キャッシュでもあります。

---
product: '{product-slug}'
status: 'in-progress'  # pending | in-progress | complete | incomplete
current_stage: '01-gather-artifacts'
created: 'ISO-8601'
updated: 'ISO-8601'
artifacts_found: 0
artifacts_packaged: 0
missing_items: []
---

成果物のソース

成果物は実行担当の出力から収集されます。

ソース	内容	マニフェストファイル
ディスカバリーエージェント	調査レポート、ブリーフ、仕様書	discovery-manifest.json
ストラテジスト	戦略ドキュメント、計画	strategy-manifest.json
実行エージェント	コンテンツ、コード、デザイン、メディア	executor-manifest.json
統合ワークフロー	統合された成果物	synthesis-manifest.json

製品タイプと完全性の基準

製品タイプごとに必要な成果物は異なります。

製品タイプ	必要な成果物
ドキュメント	メインドキュメント、アウトライン、調査メモ
アプリケーション	コードパッケージ、README、ドキュメント
キャンペーン	クリエイティブアセット、コピー、戦略ブリーフ
レポート	レポートドキュメント、データソース、方法論
プレゼンテーション	スライドデッキ、発表者ノート、配布資料

出力構造

.pawbytes/prodig-suites/products/{product-slug}/package/
├── manifest.json           # Package manifest
├── completeness-report.md  # What's present, what's missing
├── packaging-notes.md      # Special considerations
├── artifacts/              # All gathered artifacts
│   ├── {artifact-1}
│   ├── {artifact-2}
│   └── ...
└── metadata/               # Supporting metadata
    ├── source-manifests/
    └── audit-trail.json

メモリーの契約

読み取り：

• {project-root}/.pawbytes/prodig-suites/index.md — モジュールの状態
• {project-root}/.pawbytes/prodig-suites/output-standards.md — 出力基準
• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/product-context.md — 製品コンテキスト
• 実行フェーズのエグゼキューターのマニフェスト

書き込み：

• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/packaging-status.md — パッケージングの進捗状況
• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/package/ — パッケージ化されたバンドル
• {project-root}/.pawbytes/prodig-suites/daily/{date}.md — 日次ログ（追記、[Packaging] タグ付き）

エスカレーション先

シグナル	転送先
エグゼキューターの出力が不足	paw-ps-agent-product-builder（実行を再度行うため）
アーティファクトが不完全	該当するエグゼキューターエージェント
品質上の問題	paw-ps-quality-reviewer
エクスポートの必要性	paw-ps-export-handler

出力の契約

パッケージングの成果物には、すべて次の内容を含めます。

• アクションの種類： バンドル化、完全性チェック、整理
• 保存したファイル： 作成したすべてのファイルのパス
• 完全性ステータス： 存在するものと不足しているもの
• 推奨事項： 次のステップ（品質レビュー、再実行など）
• パッケージの場所： バンドルの解決済みパス