Positioning Bridge

Positioning Bridge는 초안이 대상 고객, 채널, 퍼널 단계, 로케일, 캠페인에 맞는 회사 메시지를 담고 있는지 확인합니다.

회사는 버전 관리되는 하나의 positioning pack을 유지합니다. 작성자는 CLI, MCP 호스트, 또는 TypeScript 라이브러리를 통해 동일한 정책을 사용합니다. 모든 결과는 그 원인이 된 정확한 pillar, claim, rule, campaign, competitor, source를 명시합니다.

확인하는 항목

결과는 pass, needs_revision, blocked 중 하나입니다. 종합 브랜드 점수는 없습니다. 결정적(deterministic)인 근거와 모델 기반 근거는 별도로 구분되어 표시됩니다.

Related MCP server: MCP Gatekeeper

예제 실행하기

요구 사항: Node.js 22 이상 및 npm.

git clone https://github.com/shashank-sn/positioning-bridge.git
cd positioning-bridge
npm ci
npm run build
node dist/cli/main.js validate --pack examples/acme/positioning.yaml

통과하는 가상의 초안을 확인합니다:

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로 종료합니다. locale을 생략하면 pack의 defaultLocale을 사용합니다.

기존 파일을 덮쓰지 않고 스타터 pack을 생성합니다:

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

이 프로젝트는 MIT 라이선스로 GitHub에서 오픈소스입니다. positioning-bridge는 아직 npm에 게시되지 않았으며, so 위의 클론 워크플로를 사용하여 0.1.0을 사용합니다.

MCP 호스트 연결

저장소를 빌드한 다음 호스트에 절대 경로의 pack 경로와 실행 파일 경로를 지정합니다:

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

서버는 시작 시 하나의 pack을 로드하고 네 가지 읽기 전용 도구를 노출합니다:

• get_positioning_context는 적용되는 정책과 구조화된 사유를 반환합니다;

• create_content_brief는 필수, 승인, 금지, 고지 정책을 반환합니다;

• check_content는 결과, 범위, 기능, 입력된 항목을 반환합니다;

• explain_positioning_item은 정책 또는 생성된 항목 ID와 파라미터를 받습니다.

pack을 변경한 후에는 프로세스를 다시 시작합니다. MCP 가이드에 도구 입력, 출력, Codex 명령, 작성자 시퀀스가 있습니다.

positioning pack

pack에는 다음이 포함됩니다:

• 대상 고객, 채널, 퍼널 단계, locale에 대한 컨텍스트 카탈로그;

• 승인, 가시성, 검증, 만료 상태를 포함한 근거 출처;

• pillars와 승인된 claim, 검토 필수 claim, 또는 금지된 claim;

• 등록된 경쟁사와 미등록 비교에 대한 적용 규칙;

• 캠페인 내러티브, 목표 동작, 필수 메시지, 제외 사항;

• 결정적 모순, 고지, 언어, 캠페인 규칙.

ID는 안정적이며 모든 참조는 서버 시작 전에 검증됩니다. 자세한 내용은 pack 참조, 생성된 JSON 스키마, 및 완전한 예시 Acme pack을 참조하세요.

확실성과 안전 경계

확인된 모순은 명시적 결정적 규칙에서 비롯한 것입니다. 선택적인 SemanticReviewer는 Paraphrase와 문맥 충돌을 보고할 수 있습니다. 해당 결과는 model_assisted로 유지되고, 기본적으로 사람 검토를 거쳐, 자체적으로 차단할 수 없습니다.

기본 실행 시간 동작:

• 네트워크 요청을 보내지 않음;

• 제출된 초안을 저장하지 않음;

• 설정된 pack 경로만 로드함;

• pack 및 콘텐츠 크기 상한 적용;

• 정책 변경 또는 게시 도구를 노출하지 않음.

Positioning Bridge는 제공된 정책과 제공된 근거 상태를 검사한다. 외부 사실, 법적 승인, 고객 동의 또는 출처의 실재성을 증명하지는 않는다.

Hold Your Voice와 함께 사용하기

Positioning Bridge와 Hold Your Voice는 별도의 게이트입니다. Positioning Bridge는 메시지 정책과 근거를 검사합니다. HYV는 음성과 언어 패턴을 검사합니다. 두 패키지는 서로를 import하지 않으며, 어느 결과도 게재 승인을 의미하지 않습니다.

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는 포맷팅, 린팅, 엄격한 타입, 테스트 및 커버리지, schema 변경 여부, 아키텍처 방향, 문서 링크, 프로덕션 빌드, 라이브 stdio 핸드셰이크를 검사합니다. npm run smoke:package는 정확한 버전을 패키징하고, allowlist와 Markdown 링크를 확인하고, 새 임시 프로젝트에 설치한 후 바이너리, 라이브러리 부가, 예제 검증, MCP 핸드셰이크를 확인합니다.

컴포넌트 경계는 architecture.md와 실행 가능한 architecture policy에 있으며, 릴리스 절차는 operations.md에 있습니다.

프로젝트 상태

0.1.0은 로컬 우선 기반입니다. 호스팅된 제어 플레인, 웹 UI, 원격 모델 공급, CMS 크롤러, 게시 워크플로우, 성과 분석은 포함하지 않습니다. 이러한 경계는 ADR 0001에 기록되어 있습니다.

변경 시 CONTRIBUTING.md를 먼저 읽으세요. 재현 가능한 버그와 범위가 정해진 기능 요청은 GitHub Issues를 사용하세요. 설정과 설계 질문은 GitHub Discussions를 사용하세요. 취약점은 SECURITY.md의 비공개 경로로 신고하세요.

MIT 라이선스입니다. LICENSE를 참고하세요.