scafld
v2.5.0
Published
Deterministic protocol for multi-phase agent work.
Maintainers
Readme
scafld
A deterministic protocol for multi-phase agent work. The agent passes through. The protocol stays.
Plans outlive agents. Sessions hold the receipts. Reviews take nothing on faith.
Given the same spec and session ledger, scafld derives the same state, next command, and review gate.
scafld is spec-driven orchestration for AI coding agents. The work starts from an explicit spec, gets hardened before real effort, executes phase-bounded, and ships only through adversarial review. The differentiator is simple: the agent does not get to grade its own homework.
Install
npm install -g scafld
scafld --versionThis npm package installs the native scafld Go binary from the matching GitHub
release and exposes it as an npm bin.
Quick Start
scafld init
scafld plan add-cache --command "go test ./..."
scafld harden add-cache
scafld harden add-cache --mark-passed
scafld approve add-cache
scafld build add-cache
scafld review add-cache
scafld complete add-cacheThe lifecycle is deliberately small:
draft -> harden -> approved -> active -> review -> completedcomplete only closes reviewed work. If adversarial review finds a blocking
issue, scafld sends the task to repair instead of letting the implementation
agent wave itself through.
Distribution Shim
The Go binary is the product. This npm package is a distribution shim that fetches the matching native binary from GitHub releases.
Environment overrides:
SCAFLD_BINARY=/path/to/scafldruns a local binary instead of the downloaded one.SCAFLD_SKIP_DOWNLOAD=1skips binary download for packaging tests.SCAFLD_INSTALL_BASE_URL=https://host/assetsdownloads release assets from a mirror.
