mcpField
R
reference-contract-builder

reference-contract-builder

github.com/postplusaiCreative & media27824 installsUpdated 1d ago
Repository

About reference-contract-builder

reference-contract-builder is an instruction-driven skill for defining how source images, clips, and audio may guide a generation task. It is intended for prompt writers and video workflows that need clear identity, inspiration, and exclusion boundaries.

Key features

  1. 01Inventory reference materials
  2. 02Classify binding and inspiration-only references
  3. 03Mark references excluded from a test
  4. 04Create a machine-readable contract
  5. 05Hand off contract.json

Use cases

  1. 01Set boundaries for benchmark video references
  2. 02Bind product or persona identity in a prompt
  3. 03Specify audio references for a generation test

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/postplusai/postplus-skills --skill reference-contract-builder

After installing, type/reference-contract-builderin Claude Code to confirm it loaded.

Details

From the project README

Reference Contract Builder

Use When

  • A prompt uses benchmark videos, contact sheets, frames, product images, persona images, style boards, or audio references.
  • The model needs explicit learn/do-not-copy boundaries before generation.
  • Some references should bind identity while others should be inspiration-only or excluded from the first test.

Do Not Use When

  • Do not decode the hook or opening mechanism here; use reference-decode.
  • Do not force every reference into "learn from".
  • Do not treat identity references as loose style inspiration unless the user says so.

Core Rule

Every reference set must answer:

  1. Which references bind identity or consistency?
  2. Which references are inspiration-only and must not be copied?
  3. Which references are intentionally excluded for this test?

Default assumption: persona, product, and audio references are strong bindings unless the user explicitly marks them loose, benchmark-only, or weak guidance.

Default Workflow

  1. Inventory the reference set: hook clip, hook-first contact sheet, style board, product image, persona image, audio reference, or other source.
  2. Decide the test purpose: hook rhythm, camera realism, product proof, persona continuity, or another narrow target.
  3. Classify each reference as binding, inspiration-only, or excluded for now.
  4. Create a compact machine-readable contract when it is useful.
  5. Print or return the contract before final prompt writing.

Output Shape

The artifact contains testPurpose, mayLearn, mustNotCopy, and excludedReferences. Add user-specific binding notes around that output when the prompt has real product, persona, or audio references.

Stop Conditions

  • Stop when required user intent, source evidence, or owned input artifacts are missing and guessing would change the result.
  • If an owned CLI or script command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.

Handoff

  • Hand contract.json to video-request-architect or the prompt writer.
  • If the reference's hook logic is still unclear, hand to reference-decode first.

Public Command Boundary

  • Choose the smallest matching command or workflow from the user input and run it directly.
  • If an owned CLI or script command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.
  • This public skill is instruction-driven. Produce the artifact described by the workflow directly from the available evidence.
  • Do not call private provider/runtime paths or unpublished local tools.
  • If the CLI returns a quote-confirmation challenge, run postplus quote confirm --json --challenge-file <challenge.json> and retry with the returned token.

Comments

Markdown supported