Brand Soul — Cacao Web Studio が作成したオープンソースフレームワーク
永続的なブランドコンテキストを作成し、魅力的な神話を作り出さないでください。発明よりも、証拠、明確な決定、未解決の質問を優先します。
Brand Soul は Cacao Web Studio によって作成、ブランド化、保守されています。互換性のあるエージェント間で技術スキル名 brand-soul を維持してください。
更新の確認
セッションの最初の Brand Soul ターンで、バンドルされたスクリプト、Python 3、およびネットワーク実行が利用可能な場合、Brand Soul スキルディレクトリから（またはスクリプトの絶対パスを使用して）以下を実行します。
python3 scripts/check_for_updates.py --json
チェッカーは、成功したリリース結果を24時間キャッシュします。ステータスが update_available の場合、インストールされているバージョンと安定版の違いをユーザーに一度だけ伝え、返されたリリースURLを含め、python3 scripts/update_skill.py を提案します。ユーザーが更新を選択しない限り、要求された Brand Soul の作業を続行します。current、ahead、unavailable、ランタイムがない場合、およびネットワークエラーは、サイレントかつ非ブロッキングとして扱います。
更新が存在するという理由だけでスキルインストールを変更しないでください。update_skill.py は、ユーザーが明示的に更新を要求した場合にのみ実行します。--auto オプションは、個別に設定されたオプトイン自動化のためだけであり、メジャーバージョンを決して超えてはなりません。
モードを選択する
ユーザー向けの Brand Soul セッションの開始時に、ホストに対話的な誘導または選択ツールが存在する場合は、それを使用して利用可能なモードを提示します。選択肢はタップ可能にします。通常の Markdown リストでボタンをシミュレートしないでください。ホストに対話的な選択機能がない場合は、短い番号付きのフォールバックを提示します。
- 既存のブランド向けに構築: 公開または非公開の証拠がすでにあるブランドを調査し、その Brand Soul リポジトリを作成します。
- 新しいブランドアイデア向けに構築: ブランド自体がまだ存在しない場合に、意図的なアイデンティティ選択を促進します。
- 既存の Brand Soul を更新: 新しい情報をレイヤーごとに分類し、履歴を保存し、保護された変更を創業者の承認を通じてルーティングします。
- 既存の Brand Soul を監査または消費: 評価するか、発見を再実行せずに承認されたコンテキストをロードします。
Brand Soul リポジトリがない、ワークスペースが空である、またはローカルの証拠がないことは、ブランドの成熟度について何も示しません。リポジトリの状態からブランドを新しいものとして分類しないでください。Build パスを選択する前に、既存のブランドと新しいブランドアイデアのどちらかをユーザーに選択するよう促します。
Build については references/methodology.md を読んでください。Update または承認については references/governance.md を読んでください。Audit または評価設計については references/evaluation.md を読んでください。リポジトリを作成、検証、または消費する前に、必ず references/contract.md を読んでください。
不可侵のルール
- 表現を書く前に、マーケティング言語を使わずにブランドを説明します。
- 歴史、動機、関係、製品特性、文化的意味、信念、優先順位、主張、証拠を決して発明しないでください。
- 正規の素材と提案、矛盾、ギャップ、未解決の質問を分離します。
- 創業者の記憶、創業者の解釈、創業者の意図、観察された行動、検証された事実を異なる証拠として扱います。
- 推測された素材を事実に昇格させないでください。確信度は許可を与えるものではありません。
- 検証された真実と創業者承認済みのアイデンティティを保護します。戦略に明示的に挑戦し、表現は上位レイヤーの制約内でのみ最適化します。
- オンボーディングおよび創業者の発見中は、1ターンにつき1つのユーザー向けの質問をします。回答を待ってから次の質問をし、すべての回答を保存し、統合中にそれらを一緒に分析します。信頼できる証拠がすでに答えていることを質問しないでください。
- 明示的で範囲が定められた創業者の承認を要求します。会話上の沈黙、熱意、または保護されたコンテンツをレビューせずに「正式にする」というリクエストは承認ではありません。
- その中心的な説明が変更されずに競合他社に当てはまる可能性がある場合、保護されたアイデンティティを完成させないでください。
- 実質的な矛盾を表面化させます。洗練された表現でそれらを決して解決しないでください。
ビルドワークフロー
- インタラクティブモード選択を使用して、ユーザーが既存のブランド向けに構築しているのか、新しいブランドアイデア向けに構築しているのかを判断します。これをワークスペースから推測しないでください。
- 既存のブランドの場合、最初の発見質問として主要なウェブサイトを尋ねます。
- 後のターンでは、公式のソーシャルプロフィール、マーケットプレイス、小売業者、ディレクトリ、プレス、レビュー、アプリストアのページ、および関連するプライベートファイルを個別に尋ねます。これらをアンケートにまとめないでください。
- 提供されたソースが範囲を明確にしない場合にのみ、リポジトリがカバーする市場、製品ライン、または事業単位を尋ねます。
- アクセスまたはストレージに必要な場合に、ソースの許可と機密ソースの取り扱いを確立します。別の日付が実質的に重要でない限り、現在の日付をデフォルトの証拠カットオフとして使用します。
- 創業者にインタビューする前に、アクセス可能なソースを検査します。それらをインベントリし、安定した証拠IDを割り当て、事実上の主張、繰り返される言語、オファー、オーディエンス、視覚的信号、時系列、矛盾、ギャップを抽出します。
maturity、evidence_coverage、identity_coherenceを独立して評価します。リポジトリの状態は、これらのフィールドのいずれの証拠でもありません。- 簡潔な証拠概要を返し、その後、結果として生じるギャップと矛盾についてのみインタビューします。ターンごとに1つの具体的な質問をし、その回答を必要とする観察された証拠またはギャップを述べます。ユーザー向けの表現で抽象的な監査ラベルを避けます。
- 各回答を事実の主張、記憶、解釈、アイデンティティの決定、または戦略の決定として保存しますが、ユーザーがこれらの内部分類を理解することを要求しないでください。
- 新しいブランドの場合、ビジネスの現実を1つの具体的な質問ずつ収集し、次にコストと境界を含む2つまたは3つの実質的に異なる方向性を提案し、創業者に選択または拒否を要求します。
- 重要な保護された質問が決定準備完了になった後にのみ、正規のファイルを草案します。他のすべての素材は
governance/issues.yamlに配置します。 - 置換テストとブランド整合性チェックを実行します。
- 明示的な創業者の承認を取得し、マニフェストに記録し、正確な保護ファイルの SHA-256 にバインドします。
scripts/validate_brand_repository.py <repository>を実行し、未解決の高重大度の問題を報告します。
リポジトリを初期化するには、次のコマンドを実行します。
python3 scripts/initialize_brand_repository.py <output-parent> --brand-name "Example Brand" --founder "Founder Name"
更新ワークフロー
- 結論を変更する前に、新しい証拠を登録します。
- 影響を受けるレイヤーと、変更が修正、進化、表現のいずれであるかを分類します。
- 矛盾、主張、決定、および下流の結果を確認します。
- 提案された保護された変更を
governance/issues.yamlに配置します。 references/governance.mdで要求される場合、創業者の承認を取得します。- 正規ファイルを更新し、重要な決定記録を追加し、承認ハッシュを更新し、置き換えられた根拠を保存します。
- 検証します。古い承認ハッシュをそのままにしないでください。
監査ワークフロー
brand-context.yamlをロードします。サポートされていない契約バージョンまたは必須ファイルの欠落がある場合は拒否します。- コンテンツを評価する前に、保護されたハッシュを検証し、未解決の高重大度の問題を読み取ります。
- 事実、アイデンティティ、ストーリー、主張、境界、文化、ボイス、ポジショニング、決定、および独自性の整合性を確認します。
- すべての次元を
pass、fail、またはcannot-determineとしてマークし、リポジトリのレコードIDまたは見出しを引用します。 - 是正を推奨します。ユーザーが別途 Update を要求し、創業者の承認が利用可能でない限り、監査中に保護されたアイデンティティを編集しないでください。
完了ゲート
ファイルが存在するという理由だけでリポジトリが完了したと判断しないでください。以下が必要です。
- 重要な事実がトレーサブルであるか、明示的に未検証であること。
- 高重大度の矛盾が可視化されていること。
- 保護されたコンテンツが創業者によって承認され、ハッシュが有効であること。
- 境界と緊張が、証拠があるか、意図的に選択された場合にのみ存在すること。
- 中心的なアイデンティティが置換テストに合格すること。
- 戦略が真実およびアイデンティティと区別可能であること。
- 新しいエージェントが元の会話なしで契約をロードできること。
これらのゲートがすべて満たされていない場合、draft および usable_with_gaps リポジトリを許可します。制限事項を明確に述べてください。