Harness Intelligence Wiki
CLIScaffold Model

Scaffold Baseline

Versioned source of scaffoldable skills, prompts, hooks, and metadata

A scaffold baseline is the versioned content bundle used by the CLI to render agent skills, hooks, prompt specs, subagent templates, harness mirrors, lint metadata, and catalog metadata.

Sources

  • Stable remote baseline: latest GitHub release under baseline/stable/*.
  • Bundled fallback baseline: shipped inside the npm executable package.
  • Local test baseline: DP_BASELINE_URL=file:///absolute/path/to/scaffold-baseline.
  • Optional control-plane metadata source: DP_CONTROL_PLANE_URL.

Invariants

  • Baseline releases use baseline/stable/* tags, separate from npm executable tags such as v*.
  • Content-only baseline changes can ship without a new CLI binary when they fit the existing catalog schema.
  • --baseline bundled and DP_BASELINE=bundled force the offline fallback.
  • --refresh-baseline and DP_BASELINE_REFRESH=1 refetch the stable remote baseline.
  • Archive downloads are checksum verified before extraction.
  • Shared baseline manifest, artifact, provenance, pack, and required-tool shapes belong to Shared Scaffold Model.

Owned Data

  • Pack catalog
  • Skill catalog
  • Tool catalog
  • Hook catalog
  • Lint asset catalog
  • Shared hook and script assets
  • Subagent templates
  • Selected skill directories

The CLI still owns archive download, extraction, filesystem writes, terminal interaction, repo detection, and update behavior.

On this page