Positioning Bridge

[(https://github.com/shashank-sn/positioning-bridge/actions/workflows/ci.yml) [ (LICENSE)

Positioning Bridge は、ドラフトが対象オーディエンス、チャネル、フネル段階、ロケール、キャンペーンに対して、企業の正しいメッセージをーテいているかを確認します。

企業は、バージョン管理された唯一の positionパックー「1つ」の position パックを保持します。ライターーは、CLI、MCPホスト、実もしくはデープスクリプト ライブラリを通じて同じポリシーを使用します。各結果には、その原因となった柱、主張、ルール、キャンペーン、競合者、出元が具体的に示されます。

Check 対象

判定は pass、needs_revision、blocked のいすれかです。合卒的なブランド・スコアは存在しません。決定また論的なエビデンスとモデル補助のエビデンスは、それぞれラベル付けされて別別に維持されます。

Related MCP server: MCP Gatekeeper

実行例をす

要件:Node.js 22 以降と npm

GXP1 & placeholder;

成功する架空のドラフトを確認:

node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --content examples/acme/drafts/pass.md \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --campaign campaign.launch

stdin から確認し、構造化された結果を維持する:

printf '%s\n' 'Acme trains on customer content.' | node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --stdin \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --json

このコマンドは、pass では 0、needs_revision または blocked では 1、使用法また設定エラーでは 2 で終りします。ロケールが略は、パックの defaultLocale 使用されます。

既存のファイを上書きすずに開始パックを作成します:

node dist/cli/main.js init --output company-positioning.yaml

positioning-bridge は npm に公開されていないため、上記のクローン手順を 0.1.0 に使用します。プロジェクトは GitHub で MIT ラセンスでオプンソースです。

MCPホストを接続

リポジトリーをビルドしたら、ホストに絶対パス・パックのパス・実行ファイのパスを渡します:

{
  "mcpServers": {
    "positioning-bridge": {
      "command": "node",
      "args": [
        "/absolute/path/to/positioning-bridge/dist/cli/main.js",
        "serve",
        "--pack",
        "/absolute/path/to/company-positioning.yaml"
      ]
    }
  }
}

サー server は起動時に 1 つのパックをロードし、4 つの読み取り専用ツールを公開します:

• get_positioning_context は、適用可能なポリシーと関連する Groundedions を返します。

• create_content_brief は、必須・承認済・禁止・開示リツール を返します。

• check_content は、判定、カバレッジ、能力、型付き所見を返します。

• explain_positioning_item は、ポリシーまた発行された所見 ID とコンテキストを受け取ります。

パックを変更したらプセスを再起動してください。MCPガイド には、ツールの入力、出力、Codex コマンド、ライターの操作手順が含まれています。

ポジショニングパック

パックには以下が含まれます:

• オーディエンス、チャネル、ファネル段階、ロケールのコンテキストカタログ;

• 承認・可視性・検証・期限満了状態を保持するエビデンスソース;

• 柱と承認済み・要レビュー・禁止主張。

• 名付けるれた競合者と、未登録の比較に対するエンフォースメント;

• キャンペーンストート、期待クリックション、必要メッセージ、除外条件;

• 決定性的な矛盾、開示、言語、キャンペーン・ルール。

ID は安定的で、すべての参照はサー起動前に検証されます。パック・リファレンス、生成された JSON Schema、架空の Acme パック を参照してください。

確実性と安全の境界

確認され又是确实した建築矛盾は、明示的・決定的なルールから降ります。任意の SemanticReviewer は、副λを確認し、文脈上の確を報告できます。これらの所見は mode_assisted のまま残り、デフォルトでは手動確認が候補で、単独でブロックできません。

デフォルトの実行時動作:

• ネットワッククエストを行いません;

• 提出されドラフトを保存しません;

• 設定のみ (構成) パックパスをロードします;

• パック and のサイズを制限します;

• ポリシー変更やパブリーするツールを提供しません。

Positioning Bridge は、受け渡するポリシーと stated エビデンス状態を検証します。外部事実、法的承認、カスタマー許可、あるいは情報元の真正性を保証するものではありません。

Hold your Voice together

Positioning Bridge と Hold Your Voice は別々のゲーとして残ります。Positioning Bridge はメッセージの保存とエビデンスを確認し、Hold Your Voice は、音声と言語パターンを確認します。のパッケージも相互をインポートせず、またいすしかの結果も公開承認ではありません。

TypeScriptライブラリ

import { PositioningService, loadPack } from "positioning-bridge";

const pack = await loadPack("./company-positioning.yaml");
const service = new PositioningService(pack);
const result = await service.checkContent({
  content: "draft text",
  context: {
    audienceId: "primary-buyer",
    channelId: "website",
    funnelStageId: "consideration",
    localeId: "en",
  },
});

MCP 構築は positioning-bridge/mcp からエクスポートされます。JSON Schema は positioning-bridge/schema からエクスポートされます。

開発と検証

npm ci
npm run verify
npm run smoke:package

npm run verify は、フォーマット、lint、厳格型、テスト、テスト、カバレッジ、スキーマ意向シド、アーキーテチャンの向、ドキュメントリンク、プロダクションのビルド、および実機の stdio handshake をチェックします。 npm run smoke:package は、正確な 0.1.0 版をパックし、allowlist と Markdownリンクを検証し、クリーンーな一時プロジェクトへ install して、その binary、ライブラリエクスポート、example の検証、MCP のハンドシェイクを確認します。

コンポーネント境界は architechture.md と、実行可能 architecture policy にあります。发布操作は operations.md にあります。

プロジェクトの状況

0.1.0 はローカルファーストの基盤です。管理ループーン、Web UI、遠隔モデル・ブロバイダ、CMS クローラー、公開ワークフロー、パフォーマンス分析含まれません。その境界は ADR 001 に記録されています。

変更前には CONTRIBUTION.md をお読みください。再現可能なバグやの限定的な機能要望は GitHub Issues をご利用ください。セットアップや設計に関する質問は GitHub Discussions をご利用ください。脆弱性は SECURITY.md のプライベート経路から報告してください。

MIT でライセンスされています。LICENSE を参照してください。