TheMattBerman/landing-page-factory

ページビルド

ビルド品質は戦略的忠実性の後、それより前ではありません。

このステージでは、信頼とコンバージョンにとって重要なものを保持しながらページを組み立てます。

必須入力

1. workspace/pages/[page-name]/strategy.json
2. workspace/brand/profile.md
3. workspace/brand/palette.json
4. workspace/pages/[page-name]/copy.md
5. workspace/pages/[page-name]/visuals/
6. references/anti-slop.md（このスキルにバンドル）

戦略が欠落している場合は停止してください。

workspace/pages/[page-name]/visuals/manifest.json が存在する場合は、それを正規の機械可読ビジュアルソースとして使用します。 プロバイダのメタデータが信頼、忠実性、フォールバック履歴に影響を与える場合は、それを無視しないでください。

保存階層

以下の順序で適用します：

1. 信頼に重要なカテゴリの慣習を維持する
2. メカニズムの伝達ニーズを維持する
3. ブランドのビジュアルアイデンティティを維持する
4. レイアウトのリズムとインタラクション品質を向上させる
5. 1〜4を歪めない場合にのみ、アンチ・スロップのテイスト改善を適用する

アンチ・スロップは品質フィルターであり、再設計のライセンスではありません。

ビルド前チェックリスト

HTMLを生成する前に、以下を確認します：

• ページタイプが確認されている
• コンバージョンメカニズムが確認されている
• プルーフ在庫がロードされている
• トラストキューが選択されている
• ビジュアルマニフェストがビルド可能な画像パスに解決されている
• 必要なカテゴリ慣習が維持されている
• CTAの宛先が既知である
• レイアウトの選択が1行で正当化されている

いずれかが偽の場合は、停止するかダウングレードします。

ルーティングロジック

物理製品ルート

ページタイプがプロダクト主導の場合に使用します。

ファーストビューには以下を含める必要があります：

• 明確な製品またはメカニズムのビジュアル
• オファーヘッドライン
• CTA
• トラストキュー

SaaS / アプルート

ファーストビューには以下を含める必要があります：

• 必要な場合、保存されたスクリーンショットまたはUI処理
• 成果のヘッドライン
• トラストキュー
• CTA

リード獲得ルート

ファーストビューには以下を含める必要があります：

• フォーム + 摩擦低減要素 または
• 既知の宛先への明確なCTA

権威 / サービスルート

以下を含める必要があります：

• ファーストビューでの権威キュー
• 早期のプルーフセクション
• 信頼と適合性に関する異議処理

規制対象ルート

以下を含める必要があります：

• プルーフが部分的である場合、確実性をダウングレード
• メタデータ内のコンプライアンスレビューフラグ

デザインルール

• 単一HTMLファイル
• 最低768pxと1024pxのブレークポイントでレスポンシブ
• セマンティックHTML
• 可視フォーカス状態
• すべての画像にaltテキスト
• 明示的に要求されない限り、ビルダーの帰属表示なし
• ソースのトラストキューを上書きするインポートされたテイストパターンなし

アンチ・スロップの使用法

references/anti-slop.md をロードし、保存階層の後（前ではない）に適用します。

ビルド後QAテーブル

これを workspace/pages/[page-name]/qa.md に書き込み、meta.json に要約します：

チェック	合格？	備考
メカニズムがファーストビューで表示可能
主要プルーフがファーストビューで表示可能
CTAがファーストビューにある
トラストキューがファーストビューにある
捏造されたプルーフがない
禁止されたスロップパターンがない
モバイルでの折りたたみがチェックされている
コントラストがチェックされている
altテキストが存在する
カテゴリの慣習が維持されている

メタデータ契約

meta.json には以下を含める必要があります：

• brand
• page
• page_type
• mechanism_type
• template_route
• CTA_destination
• proof_items（来歴サマリー付き）
• risk_reversal_present
• compliance_flags
• review_flags
• preserved_elements
• deviations_from_source
• images_used
• sections_present
• build_confidence

ビジュアルマニフェストが存在する場合は、以下も含めます：

• hero_image
• image_provider_policy
• images_used（単なるファイル名ではなく、構造化オブジェクトとして）
• レビューやQAに関連する場合は、プロバイダとフォールバックのコンテキスト

ビルドヘルパー

scripts/resolve-visual-assets.py --page-name [page-name] を使用して、visuals/manifest.json をHTMLおよびmeta.json用のビルド可能な画像メタデータに変換します。

次に、scripts/prepare-build-meta.py --page-name [page-name] --resolved-assets [file] を使用して、解決されたアセットを決定論的な選択フィールドとともに meta.json にマージします：

• hero_image
• mechanism_image
• lifestyle_image
• og_image
• image_slots.hero
• image_slots.mechanism
• image_slots.lifestyle
• image_slots.og

次に、skills/page-build/scripts/html-image-context.py --meta workspace/pages/[page-name]/meta.json を使用して、次のようなリテラルなHTML対応値を出力します：

• hero_img_src
• hero_img_alt
• mechanism_img_src
• mechanism_img_alt
• lifestyle_img_src
• lifestyle_img_alt
• og_image_path

最小限の実行可能ビルダー：

• skills/page-build/scripts/build-page.py --page-name [page-name] これは strategy.json、meta.json、html-image-context.json を消費し、実際の index.html スキャフォールドを書き込みます。

スキルローカルのスクリプトを、スキルフォルダのみをアップロードするCoworkやその他のエージェントランタイムの主要インターフェースとして使用します。 リポジトリルートの /scripts コピーはローカル開発の便宜であり、パッケージ化の要件ではありません。

評価リファレンス

採点基準と合格閾値については、skills/page-qa/references/eval-rubric.md を参照してください。 アンチ・スロップパターンについては、references/anti-slop.md（このスキルにバンドル）を参照してください。

停止 / 続行ロジック

以下の場合は停止します：

• リードアクションページのCTAの宛先が不明である
• ページが欠落しているプルーフに依存している
• 必要なトラストキューをサポートできない

以下の場合はダウングレードして続行します：

• ビジュアルアセットは部分的だが、ニュートラルなサポートレイアウトがまだ機能する
• プルーフが軽いが、ページがソフトな主張に再構成されている

出力

以下を書き込みます：

• workspace/pages/[page-name]/index.html
• workspace/pages/[page-name]/meta.json
• workspace/pages/[page-name]/qa.md

QA出力なしのビルドは不完全です。