bagisto-shop-advance-theme-development

Shop Advance テーマの開発

インストール済み Bagisto のコマース、拡張機能、コンテンツ、ランタイムの契約を維持しながら、独自性のあるストアフロントを構築します。Bagisto の公式規約に従い、ドキュメントの内容を対象のチェックアウトに照らして調整し、有効化する前に動作を検証します。

絶対に守るルール

• 作業を始める前に、適用されるリポジトリの指示ファイルをすべて読みます。
• インストール済みのコードと設定を、実行時の信頼できる唯一の情報源として扱います。意図の確認には、公式のバージョン対応 Bagisto ソースを使用します。
• テーマコード、表示名、名前空間、パッケージパス、チャネル、ロケール、ビルドパス、ツールのバージョン、コマンドは、すべてパラメーター化するか特定します。
• ユーザーとリポジトリのポリシーで許可されない限り、Bagisto Shop のソース、vendor/、生成済みのビルド出力、依存関係、ロックファイル、稼働中のチャネル設定は編集しません。
• 疎なビューオーバーレイ／パッケージを優先します。アップグレード対象となる範囲についてユーザーの同意を得た場合に限り、フルフォークを作成します。
• インストール済みの Shop パッケージから、完全なアセットランタイムを特定します。ビューのフォールバックが Vite／JavaScript／CSS の継承を意味するわけではありません。
• レイアウトのランタイム上の役割、レンダーイベント、コントローラー変数、ルート、フォームフィールド、API の形状、商品タイプの動作、有効な拡張機能を維持します。
• 設定の編集はマージのみとします。兄弟テーマ、プロバイダー、自動読み込みのマッピングを削除したり、shop-default を暗黙に変更したりしません。
• ドライランと競合チェックを行います。強制的な公開、削除、ディレクトリのシンボリックリンクへの置き換え、破壊的なデータのシード、競合の自動上書きは行いません。
• コピー元または派生元のソースには、インストール済み Bagisto のライセンス通知を正確に維持します。配布前にテーマ独自のライセンスを明示的に選び、バンドルするすべてのアセットの再配布条件を確認します。
• 生成されたデザインの推奨は候補として扱い、権威あるものとはみなしません。コマースの分かりやすさ、アクセシビリティ、パフォーマンス、ライセンス、マーチャントの制御、インストール済みの依存関係、Bagisto のランタイム契約を損なう提案は採用しません。
• デザインの知見には、このスキルにバンドルされた bagisto-ui-ux の知識とジェネレーターのみを使用します。実行時に別のデザインスキルを要求、検出、インポート、呼び出ししてはいけません。
• 「動的」、「管理画面から制御可能」、「すべての機能が動作する」は、証拠を要する主張として扱います。成功したビルドやホームページのスクリーンショットから推測せず、表示されるすべての画面と、インストール済みで有効なすべてのコマースの利用フローを洗い出します。
• デザインツールが推奨したという理由だけで、アニメーションライブラリ、UI フレームワーク、アイコンパッケージ、リモートフォント、外部スクリプト、その他の依存関係を追加してはいけません。まずインストール済みの機能を確認し、依存関係やネットワークの変更について許可を得ます。
• いずれかのチャネルでテーマを選択する前にビルドと検証を完了します。ロールバックの手順を明確にします。

参考ファイル — 現在のタスクに必要なものだけを読み込む

ファイル	読み込むタイミング
workflow.md	ワークフロー全体と完了の定義を確認するとき

必須のサブスキル： 変更を完了と判断する前に、bagisto-change-verification を使用してください。