Prometheus Context Bootstrap
Install the compact resident contract, path-scoped stack rules, and project-local skill copies. The bootstrap owns only marked regions. It preserves prose outside those markers and refuses a corrupt marker pair or a symlink that resolves outside the target project.
Generated files carry VLBV as the single verification method: the marked
<!-- kbd-policy:begin/end --> block (verification VLBV, compiler exception
retired, no cadence exception, execution only at B4 — the boundary packet, once —
or B5, an owner-authorized repair rerunning only affected checks), a first-action
recovery protocol that works without hooks, and precedence over built-in TDD,
verify and apply workflow skills. CLAUDE.md imports @AGENTS.md, so Claude
Code reads the same policy. When the harness provides an agent team, review,
audit, verification, and integration-checker roles remain dormant until B4. Unit,
mock-only, filtered-function, and per-edit test loops do not count as proof.
Boundaries are defined in kbd-process-orchestrator/references/boundaries.md.
Selected method and phase authority
The managed resident and path-scoped templates carry compact references to the
active phase's method-context.md and adopted contract, not another authority
ledger. Signed canonical KBD status/decisions remain authoritative; the waypoint
is their derived position view. Session-start and pre-compaction hooks restore
pointers and a labelled derived snapshot (lib/hooks/method-reanchor.mjs); a
missing or stale index is reported explicitly. The index is produced by
scripts/kbd-method-context.mjs in the mini pack; a bootstrapped project without
the pack reads the existing index and does not invent one.
Recovery preserves the latest authorized supersession, original evidence, candidate freshness, consumed budgets and unresolved effects, and reconciles uncertain effects before retry. The templates retain the complete agreed value-phase boundary and keep execution authority separate: no task, hour, commit, reviewer or compiler boundary, and no stack-rule compiler or completed-change example, opens generated-code verification. Host-policy conflicts are surfaced before dependent action without changing operator-owned prose outside the marked regions. Template guidance is instruction-only unless a named host boundary enforces it; no global context rewrite, universal interception, release or automatic-successor authority is implied.
Run from the mini pack
From a standalone mini checkout:
node scripts/prometheus-context-bootstrap.mjs --path <project> --stacks rust,typescript
node scripts/prometheus-context-bootstrap.mjs --path <project> --stacks rust,typescript --check
From the copy vendored inside the-boss:
node resources/prometheus-skills-mini/scripts/prometheus-context-bootstrap.mjs --path . --stacks typescript,rust
node resources/prometheus-skills-mini/scripts/prometheus-context-bootstrap.mjs --path . --stacks typescript,rust --check
Every run prints a RESIDENT line: the words in the managed region against a
900-word ceiling, plus the project's own words outside it. Only the managed
region counts toward the ceiling; operator prose and other tools' regions are
reported, never charged. --check fails when the managed region exceeds the
ceiling.
Every run also prints a POLICY line. --check fails when the governing file
lacks exactly one kbd-policy block stating verification: VLBV, or when the
managed region of the governing file or a stack rule carries retired
compiler-exception or opt-in VLBV wording or an /opsx:* command (removed in
OpenSpec 2.0). The same wording in operator prose outside the markers is printed
as STALE for manual cleanup and never rewritten.
Use --dry-run to print the complete write plan without changing files. If
--stacks is absent, a root Cargo.toml selects Rust and a root package.json
selects TypeScript.
Installed context
- a marked resident block in
AGENTS.md, or in the in-project target of an existingAGENTS.mdsymlink; - an
@AGENTS.mdimport in a separateCLAUDE.md; - marked
.claude/rules/rust.mdand/ortypescript.mdregions; - copied
prometheus-context-bootstrapand, for Rust,prometheus-rust-workspaceskills under both.agents/skills/and.claude/skills/; - missing append-only
.prometheuscontext files and directories.
The Rust path rule loads prometheus-rust-workspace, which routes
rust-best-practices, rust-async-patterns, rust-mcp-server-generator, and
the specialized catalog only when relevant. Dependency and protocol pins in the
target project remain authoritative.
Shared UI and team defaults
Bootstrap also installs the offline UI catalog, shared protocol (preserving a project override), short UI pointers in both entrypoints and recovery data. It adopts a sole or explicitly selected existing project team using creator install-project; ambiguous teams require selection. UI roles use prometheus-ui-ux, reviewers prometheus-ui-review, backend-only work no UI context. New helpers use TypeScript 7 compiled to Node .mjs.
Delivery cadence context
When .prometheus/cadence-binding.json exists, read that small binding and carry its profile/root into the execution dispatch. Load delivery-cadence only for cadence-enabled work. Its configured build-and-run boundary, publication frequency and pending failure obligations survive compaction; do not substitute test suites or silently reset the run. No profile means no additional cadence context.